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

> Mantieni sincronizzata la directory del tuo team Wave con Entra ID (Azure AD)

<Info>
  Disponibile nei piani **Teams** ed **Enterprise**. Si tratta di un'integrazione a livello di organizzazione, configurata da un amministratore.
</Info>

L'integrazione con Microsoft Entra ID mantiene la directory del tuo team Wave sincronizzata con il tuo tenant Microsoft Entra ID (ex Azure Active Directory). Le modifiche ai dipendenti, tra cui nuovi assunti, aggiornamenti di ruolo e partenze, fluiscono in Wave in tempo reale tramite le notifiche di modifica di Microsoft Graph.

## Come connettersi

<Steps>
  <Step title="Apri l'integrazione">
    Vai su **Integrazioni → Microsoft Entra ID** (solo per amministratori).
  </Step>

  <Step title="Connettiti con un account amministratore">
    Clicca su **Connetti** e accedi con un account Microsoft che abbia accesso amministratore al tuo tenant Azure.
  </Step>

  <Step title="Autorizza Wave">
    Autorizza Wave a leggere la tua directory.
  </Step>

  <Step title="Abilita la sincronizzazione automatica">
    Attiva **Sincronizzazione automatica** per applicare automaticamente tutte le future modifiche alla directory in Wave, oppure gestisci le sincronizzazioni manualmente.
  </Step>
</Steps>

Wave richiede le autorizzazioni di autenticazione e aggiornamento dei token, oltre all'accesso in lettura ai profili utente e ai membri della directory.

## Cosa viene sincronizzato

| Campo Entra ID                                 | Campo utente Wave             |
| ---------------------------------------------- | ----------------------------- |
| Nome, cognome, nome visualizzato               | Nome                          |
| Email di lavoro (`mail` / `userPrincipalName`) | Email                         |
| Telefono cellulare                             | Telefono cellulare            |
| Telefono/i di lavoro                           | Telefono ufficio              |
| Titolo professionale                           | Titolo professionale          |
| Città / sede ufficio                           | Città                         |
| Preferenza lingua                              | Lingua                        |
| Foto del profilo                               | Avatar (proxied tramite Wave) |

**Direzione di sincronizzazione**: Entra ID → Wave (solo in entrata)

**Quando**: In tempo reale tramite sottoscrizioni Microsoft Graph (webhook), più aggiornamento manuale su richiesta

## Funzionalità

* **Sincronizzazione in tempo reale**: le modifiche ai dipendenti appaiono in Wave in pochi minuti tramite le notifiche di modifica di Microsoft Graph.
* **Disattivazione automatica**: quando un dipendente viene rimosso da Entra ID, il suo account Wave viene disattivato.
* **Foto del profilo**: le foto vengono recuperate da Entra e proxied tramite Wave, così si caricano senza richiedere un accesso Microsoft.
* **Rinnovo automatico della sottoscrizione**: le sottoscrizioni webhook di Microsoft Graph scadono periodicamente. Wave le rinnova automaticamente affinché la connessione rimanga attiva.
* **Anteprima importazione**: visualizza tutti gli utenti Entra ID prima di abilitare la sincronizzazione automatica.

## Limitazioni e requisiti

* Gli utenti guest (il cui UPN contiene `#EXT#`) hanno la loro email ottenuta dal campo `mail`.
* Si tratta di un'integrazione a livello di organizzazione. I singoli membri del team non si connettono separatamente.
* Richiede un tenant Azure Active Directory con consenso amministratore.

## Disconnessione

Vai su **Integrazioni → Microsoft Entra ID** e clicca su **Disconnetti**. Questo rimuove l'integrazione, revoca l'accesso di Wave e annulla la registrazione della sottoscrizione Graph. Gli utenti Wave esistenti non vengono eliminati.