> ## 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.

# Descripción general del directorio

> El registro de referencia de tus usuarios: los usuarios, los atributos de perfil que los describen y los grupos en los que los organizas.

El **Directorio** es donde gestionas quiénes son tus usuarios. Contiene tus
**usuarios**, los **atributos de perfil** que describen a cada uno y los **grupos**
en los que los organizas. Todo lo demás en Iru Identity se basa en el directorio:
las aplicaciones conceden acceso a sus usuarios y grupos, y las políticas de autenticación
deciden cómo inician sesión esos usuarios.

En el panel, el Directorio reúne estas secciones:

<CardGroup cols={2}>
  <Card title="Usuarios" icon="user" href="/es/identity/directory/users">
    Cada usuario de tu organización, con un perfil, un estado y un registro de
    cómo se añadió.
  </Card>

  <Card title="Esquema" icon="table-list" href="/es/identity/directory/schema">
    El esquema de campos integrados y personalizados que puede contener cada perfil de usuario.
  </Card>

  <Card title="Grupos" icon="users" href="/es/identity/directory/groups">
    Colecciones de usuarios a las que asignas acceso como una unidad (manuales, integrados o
    automáticos).
  </Card>

  <Card title="Grupos automáticos" icon="wand-magic-sparkles" href="/es/identity/directory/auto-groups">
    Grupos cuya pertenencia se calcula a partir de un atributo y se mantiene actualizada
    por sí sola.
  </Card>

  <Card title="Importar usuarios" icon="file-arrow-up" href="/es/identity/directory/importing-users">
    Incorpora usuarios de forma masiva desde un archivo y revisa los resultados.
  </Card>

  <Card title="Sincronización del directorio" icon="building-user" href="/es/identity/directory/directory-sync">
    Sincroniza usuarios desde un HRIS o una solución de directorio para que el directorio se mantenga actualizado
    automáticamente.
  </Card>

  <Card title="Roles" icon="user-shield" href="/es/identity/administration/administrators-and-roles">
    El rol que tiene cada usuario, que determina lo que puede hacer en Iru.
  </Card>
</CardGroup>

## Qué contiene el directorio

```mermaid theme={null}
flowchart TD
  subgraph dir["Directorio"]
    users["Usuarios<br/>todas las personas de tu organización"]
    attrs["Atributos de perfil<br/>campos integrados y personalizados"]
    groups["Grupos<br/>manuales, integrados, automáticos"]
  end
  attrs --- users
  users --- groups
  attrs -. "pueden impulsar" .-> groups
  groups -->|"asignados a"| apps["Aplicaciones"]
```

* Los **usuarios** son todas las personas de tu organización representadas en el directorio. Cada uno tiene un perfil, una identidad
  de inicio de sesión y un estado que refleja en qué punto de su ciclo de vida se encuentra.
* Los **atributos de perfil** son los campos que puede contener un perfil: facetas integradas
  como el nombre, el correo electrónico y el teléfono, además de cualquier atributo personalizado que definas en tu
  [esquema](/es/identity/directory/schema).
* Los **grupos** son colecciones de usuarios. Asignas acceso a un grupo una vez, y
  todas las personas que lo forman heredan ese acceso. Consulta [Grupos](/es/identity/directory/groups).

## Cómo llegan los usuarios al directorio

Hay tres formas de añadir usuarios, y puedes combinarlas a medida que cambien tus necesidades.

<CardGroup cols={3}>
  <Card title="Añadir manualmente" icon="user-plus">
    Crea un usuario manualmente desde **Directory → Users**. Ideal para unos pocos usuarios o una
    prueba rápida.
  </Card>

  <Card title="Importar desde un archivo" icon="file-csv">
    Sube un CSV para crear muchos usuarios a la vez. Consulta
    [Importar usuarios](/es/identity/directory/importing-users).
  </Card>

  <Card title="Sincronizar desde tu sistema de RR. HH." icon="building-user">
    Conecta un sistema de RR. HH. para que los usuarios se creen, actualicen y eliminen
    automáticamente de forma programada. Consulta
    [Directory Sync](/es/identity/directory/directory-sync).
  </Card>
</CardGroup>

Cada usuario registra un **origen**, de dónde procede, por ejemplo, si se añadió
manualmente, se importó desde un archivo o se sincronizó desde un sistema de RR. HH. conectado. El origen
aparece en la lista de usuarios para que siempre puedas ver cómo llegó alguien al
directorio.

<Tip>
  La entrada manual y la importación CSV son ideales para empezar. Cuando tu sistema de RR. HH.
  sea el sistema de referencia sobre quién trabaja en tu empresa, conéctalo para que el
  directorio se mantenga actualizado por sí solo a medida que los usuarios se incorporan, cambian de rol y se van.
</Tip>

## El ciclo de vida del usuario

Las personas se incorporan, cambian de puesto y dejan tu organización, y su registro en el directorio
las acompaña a través de un pequeño conjunto de estados.

```mermaid theme={null}
flowchart LR
  join["Se incorpora"] --> pending["Pending"]
  pending -->|"primer inicio de sesión / activación"| active["Active"]
  active -->|"permiso / baja"| suspended["Suspended"]
  suspended -->|"regresa"| active
  active -->|"se va definitivamente"| removed["Removed"]
  suspended -->|"se va definitivamente"| removed
```

| Estado | Qué significa |
| - | - |
| **Pendiente** | El usuario se ha creado pero aún no está activo. Es el punto de partida de un usuario recién añadido o importado. |
| **Activo** | El usuario está totalmente habilitado y puede iniciar sesión y acceder a las aplicaciones que tiene asignadas. |
| **Suspended** | El acceso del usuario está bloqueado, pero se conservan su registro e historial. Úsalo cuando alguien esté de permiso o en proceso de baja. |

La suspensión es reversible; puedes restablecer a un usuario suspendido y vuelve
al estado que tenía antes. Eliminar a un usuario es permanente y está pensado para
usuarios que se han ido definitivamente. La diferencia entre suspender y eliminar,
y cómo invitar a los usuarios a terminar de configurar sus cuentas, se explica en
[Usuarios](/es/identity/directory/users).

## Dónde se usa el directorio

El directorio es la base sobre la que se apoya el resto de Iru Identity:

* Las **aplicaciones** conceden acceso a través de grupos asignados y asignan atributos
  de perfil a los datos de identidad que recibe cada aplicación. Consulta
  [Asignar acceso](/es/identity/applications/assigning-access).
* Las **políticas de autenticación** evalúan al usuario que inicia sesión y deciden lo que
  debe demostrar. Consulta
  [Políticas de autenticación](/es/identity/authentication/authentication-policies).
* Los **Auto Groups** leen atributos de perfil para calcular su pertenencia
  automáticamente. Consulta [Auto Groups](/es/identity/directory/auto-groups).

<Note>
  ¿Eres nuevo en Iru Identity? Empieza por [Conceptos clave](/es/identity/getting-started/key-concepts)
  para conocer el conjunto completo de objetos y, después, sigue la
  [Guía de inicio rápido](/es/identity/getting-started/quickstart) para configurar tu primer
  inicio de sesión.
</Note>