Disponibile nel piano Enterprise. Solo i proprietari dell’organizzazione possono configurare Sync Directory.
Panoramica
SCIM (System for Cross-domain Identity Management) 2.0 collega Wave Connect al tuo identity provider in modo che gli account utente vengano gestiti automaticamente. Quando aggiungi, aggiorni o rimuovi un utente nel tuo IdP, la modifica si riflette in Wave Connect senza alcuna azione manuale. Wave Connect espone le risorse SCIMUsers e Groups con GET, POST, PUT, PATCH e DELETE. I filtri supportano un singolo confronto eq di primo livello, che è ciò che gli identity provider usano per cercare un utente tramite userName o externalId.
Configurazione
1
Apri Sync Directory
Vai su Impostazioni → Sicurezza. Nella scheda Sync Directory, clicca su Configura per aprire la finestra Configura SCIM.
2
Copia l'endpoint SCIM
L’Endpoint SCIM è
https://app.wavecnct.com/api/scim. Copialo. Il tuo identity provider lo chiama URL tenant o URL di base.3
Crea un token SCIM
Clicca su Crea token, dai un nome al token e clicca su Crea. Copia il token subito. Viene mostrato una sola volta. Il token viene inviato dal tuo IdP come bearer token.
4
Configura il tuo identity provider
Nel tuo IdP, configura il provisioning automatico per Wave Connect usando l’endpoint e il token. Mappa gli attributi dei tuoi utenti sugli attributi SCIM riportati qui sotto.
5
Testa il provisioning
Assegna un utente di test nel tuo IdP e verifica che il suo account Wave Connect compaia in Utenti con nome, email e team corretti.
I token SCIM compaiono anche nella scheda Token in Impostazioni → Sicurezza, con l’ambito Gestisci SCIM. Puoi eliminare un token da lì per interrompere l’accesso del tuo IdP. I token vengono eliminati automaticamente se l’organizzazione lascia il piano Enterprise.
Guide per identity provider
Microsoft Entra ID
Configurazione passo passo dell’applicazione aziendale, mapping degli attributi e offboarding.
Okta e Google Workspace
Segui i passaggi generici di questa pagina. Usa l’endpoint come URL di base e il token come bearer token.
Mappatura degli attributi
Wave Connect legge questi attributi dalla risorsa SCIMUser:
I numeri di telefono vengono validati e salvati in formato internazionale. I valori non validi e i segnaposto composti solo da un’estensione vengono scartati invece di far fallire la richiesta. Un
locale non supportato da Wave Connect ricade sull’inglese.
L’estensione enterprise department non viene salvata nel profilo. L’assegnazione dei team in base al reparto può essere abilitata dal supporto Wave Connect.
Quando viene creato un utente e l’email appartiene già a un membro della tua organizzazione, viene aggiornato il membro esistente. Se l’email appartiene a un account Wave Connect personale su uno dei tuoi domini verificati, quell’account viene spostato nella tua organizzazione e mantenuto, incluso il suo biglietto e i suoi contatti.
Mappatura dei team
Quando SCIM è abilitato, i gruppi nel tuo identity provider vengono sincronizzati in Wave Connect come team. Ad esempio, i gruppi assegnati all’applicazione Wave Connect in Microsoft Entra ID vengono creati automaticamente come team in Wave Connect. I membri assegnati a un gruppo vengono aggiunti al team corrispondente. IldisplayName del gruppo diventa il nome del team e l’externalId del gruppo viene salvato nel team. Se esiste già un team con lo stesso nome, il gruppo viene unito a quel team. Un utente appartiene a un solo team, quindi se un utente fa parte di più gruppi prevale l’ultimo di cui è stato effettuato il provisioning. Un’organizzazione può avere fino a 75 team. Eliminare un gruppo elimina il team. I suoi utenti vengono mantenuti e i suoi contatti vengono spostati nell’organizzazione.
Questo ti permette di gestire la struttura dei team Wave Connect direttamente dal tuo IdP, senza alcuna configurazione manuale dei team in Wave Connect.
A ogni team Wave Connect può essere assegnato un modello diverso, così gli utenti in gruppi diversi ottengono automaticamente il layout del biglietto, il branding e i campi bloccati giusti per il loro reparto o ruolo. Consulta Modelli per i dettagli.
Deprovisioning
Quando l’assegnazione di un utente all’applicazione Wave Connect viene rimossa nel tuo IdP, l’IdP impostaactive su false. Wave Connect disattiva l’account:
- L’utente non può più accedere e le sue sessioni vengono revocate.
- Appare con il badge
SUSPENDEDin Utenti. - Il suo biglietto NFC resta collegato, e il suo profilo e i suoi contatti vengono preservati.
- Continua a contare come posto finché non viene eliminato.
active su true (ad esempio riassegnando l’utente) riattiva l’account.
Quando il tuo IdP invia una richiesta DELETE, Wave Connect elimina definitivamente l’utente: il suo profilo e i suoi contatti vengono rimossi e il suo biglietto NFC viene scollegato in modo che possa essere assegnato a qualcun altro.
Alcuni identity provider (come Microsoft Entra ID) sospendono gli account utente per un periodo di tolleranza di 30 giorni prima di eliminarli definitivamente. Per impostazione predefinita, Wave Connect segue questo comportamento e disattiva l’account durante quel periodo. Per saltare il periodo di tolleranza, apri Impostazioni → Sicurezza → Sync Directory → Configura e abilita Elimina l’utente immediatamente invece di sospenderlo. La disattivazione elimina quindi definitivamente l’utente da subito.