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

> Mantenha o diretório da sua equipe no Wave sincronizado com o Entra ID (Azure AD)

<Info>
  Disponível nos planos **Teams** e **Enterprise**. Esta é uma integração no nível organizacional, configurada por um administrador.
</Info>

A integração com Microsoft Entra ID mantém o diretório da sua equipe no Wave sincronizado com o seu tenant do Microsoft Entra ID (anteriormente Azure Active Directory). Alterações de funcionários — incluindo novas contratações, atualizações de função e saídas — fluem para o Wave em tempo real via notificações de mudança do Microsoft Graph.

## Como Conectar

<Steps>
  <Step title="Abra a integração">
    Acesse **Integrações → Microsoft Entra ID** (somente administradores).
  </Step>

  <Step title="Conecte com uma conta de administrador">
    Clique em **Conectar** e faça login com uma conta Microsoft que tenha acesso de administrador ao seu tenant Azure.
  </Step>

  <Step title="Autorize o Wave">
    Autorize o Wave a ler o seu diretório.
  </Step>

  <Step title="Ative a sincronização automática">
    Ative a **Sincronização automática** para aplicar automaticamente todas as alterações futuras do diretório ao Wave, ou gerencie as sincronizações manualmente.
  </Step>
</Steps>

O Wave solicita permissões de autenticação e atualização de token, além de acesso de leitura a perfis de usuário e membros do diretório.

## O Que É Sincronizado

| Campo no Entra ID                                 | Campo do usuário no Wave     |
| ------------------------------------------------- | ---------------------------- |
| Nome, sobrenome, nome de exibição                 | Nome                         |
| E-mail de trabalho (`mail` / `userPrincipalName`) | E-mail                       |
| Celular                                           | Celular                      |
| Telefone(s) comercial(is)                         | Telefone comercial           |
| Cargo                                             | Cargo                        |
| Cidade / localização do escritório                | Cidade                       |
| Preferência de idioma                             | Idioma                       |
| Foto de perfil                                    | Avatar (via proxy pelo Wave) |

**Direção da sincronização**: Entra ID → Wave (somente de entrada)

**Quando**: Em tempo real via assinaturas do Microsoft Graph (webhooks), além de atualização manual sob demanda

## Funcionalidades

* **Sincronização em tempo real**: as alterações de funcionários aparecem no Wave em minutos via notificações de mudança do Microsoft Graph.
* **Desativação automática**: quando um funcionário é removido do Entra ID, sua conta Wave é desativada.
* **Fotos de perfil**: as fotos são obtidas do Entra e disponibilizadas via proxy pelo Wave, carregando sem necessidade de login na Microsoft.
* **Renovação automática de assinatura**: as assinaturas de webhook do Microsoft Graph expiram periodicamente. O Wave as renova automaticamente para manter a conexão ativa.
* **Prévia de importação**: visualize todos os usuários do Entra ID antes de ativar a sincronização automática.

## Limitações e Requisitos

* Usuários convidados (cujo UPN contém `#EXT#`) têm seu e-mail obtido do campo `mail`.
* Esta é uma integração no nível organizacional. Os membros individuais da equipe não se conectam separadamente.
* Requer um tenant do Azure Active Directory com consentimento de administrador.

## Desconectar

Acesse **Integrações → Microsoft Entra ID** e clique em **Desconectar**. Isso remove a integração, revoga o acesso do Wave e cancela o registro da assinatura do Graph. Os usuários Wave existentes não são excluídos.