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

# Microsoft Entra ID

> Mantén el directorio de tu equipo de Wave sincronizado con Entra ID (Azure AD)

<Info>
  Disponible en los planes **Teams** y **Enterprise**. Es una integración a nivel de organización, configurada por un administrador.
</Info>

La integración con Microsoft Entra ID mantiene el directorio de tu equipo de Wave sincronizado con tu inquilino de Microsoft Entra ID (anteriormente Azure Active Directory). Los cambios de empleados, incluyendo nuevas contrataciones, actualizaciones de rol y salidas, se reflejan en Wave en tiempo real a través de las notificaciones de cambio de Microsoft Graph.

## Cómo conectar

<Steps>
  <Step title="Abre la integración">
    Ve a **Integraciones → Microsoft Entra ID** (solo administradores).
  </Step>

  <Step title="Conecta con una cuenta de administrador">
    Haz clic en **Conectar** e inicia sesión con una cuenta de Microsoft que tenga acceso de administrador a tu inquilino de Azure.
  </Step>

  <Step title="Autoriza a Wave">
    Autoriza a Wave para leer tu directorio.
  </Step>

  <Step title="Activa la sincronización automática">
    Activa la **Sincronización automática** para aplicar todos los cambios futuros del directorio a Wave automáticamente, o gestiona las sincronizaciones de forma manual.
  </Step>
</Steps>

Wave solicita permisos de autenticación y actualización de tokens, más acceso de lectura a los perfiles de usuario y los miembros del directorio.

## Qué se sincroniza

| Campo de Entra ID                                            | Campo de usuario de Wave          |
| ------------------------------------------------------------ | --------------------------------- |
| Nombre, apellido, nombre para mostrar                        | Nombre                            |
| Correo electrónico de trabajo (`mail` / `userPrincipalName`) | Correo electrónico                |
| Teléfono móvil                                               | Teléfono móvil                    |
| Teléfono(s) de trabajo                                       | Teléfono de trabajo               |
| Cargo                                                        | Cargo                             |
| Ciudad / ubicación de oficina                                | Ciudad                            |
| Preferencia de idioma                                        | Idioma                            |
| Foto de perfil                                               | Avatar (enviado a través de Wave) |

**Dirección de sincronización**: Entra ID → Wave (solo entrante)

**Cuándo**: en tiempo real a través de suscripciones de Microsoft Graph (webhooks), más actualización manual a demanda

## Funcionalidades

* **Sincronización en tiempo real**: los cambios de empleados aparecen en Wave en pocos minutos a través de las notificaciones de cambio de Microsoft Graph.
* **Desactivación automática**: cuando un empleado es eliminado de Entra ID, su cuenta de Wave se desactiva.
* **Fotos de perfil**: las fotos se obtienen de Entra y se envían a través de Wave, por lo que se cargan sin requerir un inicio de sesión de Microsoft.
* **Renovación automática de suscripción**: las suscripciones de webhook de Microsoft Graph caducan periódicamente. Wave las renueva automáticamente para mantener la conexión activa.
* **Vista previa de importación**: visualiza todos los usuarios de Entra ID antes de activar la sincronización automática.

## Limitaciones y requisitos

* Los usuarios invitados (cuyo UPN contiene `#EXT#`) tienen su correo electrónico obtenido del campo `mail`.
* Esta es una integración a nivel de organización. Los miembros individuales del equipo no se conectan por separado.
* Requiere un inquilino de Azure Active Directory con consentimiento de administrador.

## Desconectar

Ve a **Integraciones → Microsoft Entra ID** y haz clic en **Desconectar**. Esto elimina la integración, revoca el acceso de Wave y cancela la suscripción de Graph. Los usuarios de Wave existentes no se eliminan.