> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usuarios

> Crea y gestiona usuarios en tu directorio: sus perfiles, los estados del ciclo de vida y la diferencia entre suspender y eliminar.

Un **usuario** es una persona de tu directorio. Cada usuario tiene una identidad de inicio de sesión, un
perfil formado por atributos y un estado que refleja en qué punto de su
ciclo de vida se encuentra. Los usuarios se gestionan desde **Directorio** en la barra de
navegación de la izquierda (en **Identity**), en la pestaña **Usuarios**. La lista muestra el
nombre, el estado, el nombre de usuario, el dominio, el correo electrónico principal, el rol, el origen y la
actividad de inicio de sesión de cada usuario.

<Note>
  Usa estos pasos para gestionar usuarios de uno en uno. Para añadir muchos usuarios a la vez, consulta
  [Importar usuarios](/es/identity/directory/importing-users) o sincronízalos desde un
  sistema de RR. HH. con [Directory Sync](/es/identity/directory/directory-sync).
</Note>

## Crear un usuario

<Steps>
  <Step title="Ve a Directory">
    Ve a **Directorio** en la barra de navegación de la izquierda (en
    **Identity**).
  </Step>

  <Step title="Abre la pestaña Users">
    Selecciona la pestaña **Usuarios** si aún no está seleccionada.
  </Step>

  <Step title="Añade un usuario">
    Selecciona **+ User** en la esquina superior derecha. Se abre un formulario de perfil vacío.
  </Step>

  <Step title="Introduce los datos esenciales">
    Asigna al usuario un nombre, un nombre de usuario y al menos una dirección de correo electrónico. El
    nombre de usuario y un dominio forman juntos la forma en que el usuario inicia sesión.
  </Step>

  <Step title="Añade un correo electrónico adicional (opcional)">
    Selecciona **+ Add** en **Additional Emails** si quieres una dirección alternativa
    para su invitación, como un correo personal.
  </Step>

  <Step title="Completa el resto del perfil">
    Añade cualquier otro dato integrado (números de teléfono, direcciones, un rol) y completa
    los atributos personalizados que hayas definido en tu
    [esquema](/es/identity/directory/schema).
  </Step>

  <Step title="Crea">
    Selecciona **Crear**. El usuario se crea con el estado **pending**.
  </Step>

  <Step title="Envía la invitación (opcional)">
    Después de crear el usuario, un mensaje te pregunta si quieres enviar la invitación
    ahora. Elige la dirección de correo electrónico que debe recibir la invitación, como
    su dirección del trabajo o personal, y selecciona **Send now**. O selecciona
    **Later** para cerrar el mensaje y enviar la invitación desde el menú del usuario
    cuando estés listo.
  </Step>
</Steps>

Un usuario creado de esta forma tiene como **origen** el haberse añadido manualmente, lo que
lo distingue de los usuarios incorporados por importación o sincronización con RR. HH.

## El perfil de usuario

Un perfil es una colección de facetas. Algunas son integradas; el resto son los atributos
personalizados que defines. Las facetas integradas incluyen:

| Faceta | Notas |
| - | - |
| **Nombre** | El nombre del usuario, que se usa para crear su nombre visible. |
| **Correos electrónicos** | Una o más direcciones de correo electrónico, cada una con una etiqueta como trabajo o personal. Una es el correo electrónico principal. |
| **Números de teléfono** | Cero o más números, cada uno etiquetado. |
| **Direcciones** | Cero o más direcciones, cada una etiquetada. |
| **Nombre de usuario y dominio** | Juntos, el identificador con el que el usuario inicia sesión. |
| **Rol** | El rol que tiene el usuario, que determina lo que puede hacer en Iru. Consulta [Administradores y roles](/es/identity/administration/administrators-and-roles). |
| **Estado** | En qué punto de su ciclo de vida se encuentra el usuario: pending, active o suspended. |
| **Origen** | De dónde procede el usuario: añadido manualmente, importado o sincronizado desde un sistema de RR. HH. |

Además de estos, cada **atributo personalizado** que definas aparece en el perfil en
su categoría. Consulta
[Esquema](/es/identity/directory/schema) para ver cómo
se construye el esquema.

<Info>
  Los atributos de un perfil son la materia prima que usan las aplicaciones y
  las políticas. Una aplicación asigna atributos de perfil a los datos de identidad
  que recibe, y un [Auto Group](/es/identity/directory/auto-groups) puede
  calcular su pertenencia a partir del valor de un atributo.
</Info>

## Buscar y filtrar usuarios

La lista de usuarios se puede filtrar, buscar y guardar como **vistas** reutilizables,
algo útil cuando tu directorio supera unos pocos usuarios.

### Filtros

Añade un **filtro** para acotar la lista por cualquier atributo, integrado (estado, dominio,
rol, fecha de creación) o un atributo personalizado que hayas definido. Elige el atributo,
selecciona un operador como **equals** y establece el valor; añade más de un filtro
para combinar condiciones.

<Frame caption="Un filtro que acota la lista a un único dominio.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/users-filter.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=3bea4cb85e442947633e34f860a8379b" alt="La lista Users filtrada por Domain equals accuhive.com, que se muestra como un chip de filtro extraíble encima de la lista." width="2000" height="1131" data-path="assets/media/images/users-filter.webp" />
</Frame>

### Filtros IQL

Para consultas más precisas, cambia la lista de **Estándar** a **IQL** y escribe
el filtro como una expresión [IQL](/es/identity/getting-started/iql-expressions),
por ejemplo, `domain == "accuhive.com"`. Es el mismo lenguaje de expresiones que
impulsa las reglas de Auto Groups y la asignación.

<Frame caption="El mismo filtro escrito como expresión IQL.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/users-iql-filter.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=12a4fa1b64be41c759d49fefa326a3ec" alt="La lista Users en modo IQL con la expresión domain == accuhive.com en la barra de búsqueda y un botón Revert." width="2000" height="1135" data-path="assets/media/images/users-iql-filter.webp" />
</Frame>

### Vistas guardadas

Cuando hayas creado un filtro que vayas a reutilizar, abre **Options → Create view**, asígnale
un nombre y guárdalo. La vista recuerda tus filtros, para que puedas volver al
mismo subconjunto del directorio con un solo clic.

<Frame caption="Guardar el filtro actual como una vista con nombre.">
  <img src="https://mintcdn.com/iru/yv46VZ-WbN1GdStp/assets/media/images/users-create-view.webp?fit=max&auto=format&n=yv46VZ-WbN1GdStp&q=85&s=535016d06d2310eadab3cb6df5b48571" alt="La opción Create view con un campo de nombre establecido en Accuhive.com y un botón Save." width="2000" height="1129" data-path="assets/media/images/users-create-view.webp" />
</Frame>

## Estados de los usuarios

Un usuario siempre tiene uno de tres estados, y puedes filtrar la lista de usuarios por
estado.

<CardGroup cols={3}>
  <Card title="Pendiente" icon="hourglass-half">
    Creado pero aún no activo. Es el punto de partida de un usuario recién añadido o importado,
    antes de que termine de configurar su cuenta.
  </Card>

  <Card title="Activo" icon="circle-check">
    Totalmente habilitado. El usuario puede iniciar sesión y acceder a las aplicaciones que tiene
    asignadas.
  </Card>

  <Card title="Suspendido" icon="ban">
    El acceso está bloqueado, pero se conservan el registro y el historial. El usuario
    no puede iniciar sesión hasta que se le restablezca.
  </Card>
</CardGroup>

### Suspender frente a eliminar

Ambas acciones impiden que un usuario inicie sesión, pero son herramientas diferentes para situaciones
diferentes.

<AccordionGroup>
  <Accordion title="Suspender (reversible)" icon="user-lock">
    La suspensión bloquea el acceso de un usuario y mantiene intactos su registro, su perfil y su
    historial. Al restablecer a un usuario suspendido, vuelve al estado que
    tenía antes, por lo que es la opción adecuada cuando alguien está de permiso,
    bajo investigación o en proceso de baja, pero aún no se ha ido del todo. Puedes suspender a un
    usuario tanto si está activo como si sigue pendiente.
  </Accordion>

  <Accordion title="Eliminar (permanente)" icon="user-xmark">
    Eliminar a un usuario borra su registro del directorio. Recurre a esto solo cuando un
    usuario se haya ido definitivamente y ya no necesites conservar su identidad. Cuando
    tu sistema de RR. HH. está conectado, una baja en él puede eliminar usuarios del
    directorio automáticamente; consulta
    [Directory Sync](/es/identity/directory/directory-sync).
  </Accordion>
</AccordionGroup>

<Warning>
  Eliminar a un usuario no se puede deshacer. Si existe alguna posibilidad de que el usuario
  regrese, o necesitas conservar su historial, suspéndelo.
</Warning>

## Invitar a usuarios

Un usuario recién creado queda en estado **pending** hasta que termina de configurar su cuenta.
Invitar a un usuario envía una invitación a su correo electrónico con un enlace seguro para
completar la configuración inicial, incluido el registro de un
[autenticador](/es/identity/authentication/authenticators), como una passkey.

De forma predeterminada, las invitaciones se envían al **correo electrónico principal** del usuario. Si el perfil tiene
un correo electrónico adicional (normalmente una dirección personal), puedes enviar la invitación
allí. Hazlo cuando el usuario no pueda abrir su buzón del trabajo hasta que
tenga una passkey.

* Puedes invitar a un solo usuario desde su perfil, o invitar a usuarios pendientes de forma
  masiva desde la lista de usuarios.
* Las invitaciones caducan **48 horas** después de enviarse. Puedes reenviar una si
  se pasó por alto o ha caducado; enviar una nueva invitación sustituye a cualquier invitación anterior
  de ese usuario.

<Note>
  La **primera invitación** de un tenant es la excepción. Se envía al
  [propietario de la cuenta](/es/identity/administration/administrators-and-roles) del tenant y sigue
  siendo válida hasta **14 días**, siempre que ese propietario de la cuenta no haya iniciado sesión todavía.
  Todas las invitaciones posteriores usan el plazo de 48 horas.
</Note>

### Reenviar invitaciones de forma masiva

<Steps>
  <Step title="Abre los usuarios pendientes">
    Ve a **Directorio** en la barra de navegación de la izquierda (en
    **Identity**). Selecciona la pestaña **Usuarios** si aún no está seleccionada. Abre
    **Preset Views** y elige **Pendiente**.
  </Step>

  <Step title="Abre Resend invites">
    Selecciona los **puntos suspensivos** en la esquina superior derecha y, después, selecciona **Resend invites**.
  </Step>

  <Step title="Elige el correo electrónico de destino">
    Usa **Set all to** para enviar todas las invitaciones seleccionadas a **Primary email** o
    **First additional email**. Desmarca o marca las casillas para excluir o incluir
    usuarios. Para elegir una dirección para un usuario, abre el desplegable **Correo electrónico** de esa fila
    y elige la dirección.
  </Step>

  <Step title="Envía">
    Selecciona **Enviar**.
  </Step>
</Steps>

### Reenviar una invitación a un usuario

<Steps>
  <Step title="Abre el usuario">
    Ve a **Directorio** en la barra de navegación de la izquierda (en
    **Identity**). Selecciona la pestaña **Usuarios** si aún no está seleccionada y, después,
    abre el registro del usuario.
  </Step>

  <Step title="Reenvía la invitación">
    Selecciona los **puntos suspensivos** y, después, selecciona **Resend invite**.
  </Step>

  <Step title="Elige qué correo electrónico recibe la invitación">
    Selecciona el correo electrónico principal o uno adicional y, después, selecciona **Enviar**.
  </Step>
</Steps>

<Tip>
  Si un usuario pierde el acceso a sus autenticadores, usa **Reset** desde el perfil del
  usuario. Un restablecimiento elimina sus autenticadores registrados, finaliza sus sesiones
  activas y lo devuelve al estado **pending**; después, envía una nueva invitación para que
  pueda registrar un autenticador nuevo. (El envío de una invitación está bloqueado mientras un usuario
  todavía tenga autenticadores, por eso primero se restablece).
</Tip>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Da forma a tus perfiles" icon="table-list" href="/es/identity/directory/schema">
    Define los atributos personalizados que puede contener cada perfil de usuario.
  </Card>

  <Card title="Organiza a los usuarios en grupos" icon="users" href="/es/identity/directory/groups">
    Asigna acceso a grupos en lugar de a personas para que escale.
  </Card>

  <Card title="Importa de forma masiva" icon="file-arrow-up" href="/es/identity/directory/importing-users">
    Añade muchos usuarios a la vez desde un archivo CSV.
  </Card>

  <Card title="Automatiza el ciclo de vida" icon="building-user" href="/es/identity/directory/directory-sync">
    Deja que tu sistema de RR. HH. cree, actualice y elimine usuarios por ti.
  </Card>
</CardGroup>
