Questo articolo fornisce istruzioni passo dopo passo per configurare la connessione SCIM tra Microsoft Entra ID e deskbird, consentendo la sincronizzazione automatica dei dati di utenti e gruppi.
💡 Nota: Dopo aver configurato SCIM, la prima sincronizzazione potrebbe richiedere 1–2 ore. Attendi e controlla nuovamente più tardi.
⚠️ Gli oggetti da fornire devono includere solo gli utenti e/o i gruppi che necessitano dell'accesso a deskbird. Qualsiasi oggetto incluso nella sincronizzazione verrà fornito automaticamente.
- Crea il token SCIM in deskbird
- Configurazione dell'applicazione SCIM
- Passaggi per fornire gli oggetti selezionati
1. Crea il token SCIM in deskbird
- Vai su Admin > Azienda: Chiavi API.
- Clicca su Generate key, inserisci un Nome e seleziona SCIM.
3. Scegli il tuo provider SCIM e genera il tuo token (c'è un solo token per azienda)
Â
4. Copia il tuo token SCIM e incollalo in un luogo sicuro (il token non sarĂ visibile nell'interfaccia)
5. Puoi sempre revocare una chiave esistente e generarne una nuova
Â
Ora hai tutto il necessario per procedere con la configurazione della tua applicazione SCIM
Â
2. Configurazione dell'applicazione SCIM
- Vai su https://entra.microsoft.com/ e clicca su Enterprise applications
- Clicca su New application
- Clicca su Create your own application
- Dagli un nome e assicurati che Integrate any other application you don't find in the gallery (Non-gallery) sia selezionato:
- Clicca su Create
- Ora dovresti essere reindirizzato alla nuova applicazione creata
- Vai su Provisioning
- Clicca su Get started
- Seleziona Automatic dal menu a tendina
- Nel campo Tenant URL, inserisci il seguente URL: https://api.deskbird.app/v2/scim
- Nel campo Secret Token, inserisci il token SCIM dell'azienda che hai generato nel primo passaggio
- Clicca su Test Connection
Se tutto funziona correttamente, vedrai un pop-up di conferma.
- Clicca su Save
- Clicca su Provision Microsoft Entra ID Users sotto Mappings
- Scorri fino in fondo alla pagina ed elimina l'attributo mailNickname
- In fondo alla pagina, clicca su Add New Mapping
- Vai su Source attribute e seleziona objectId dal menu a tendina
- Vai su Target attribute e seleziona externalId dal menu a tendina
- Clicca su Save
- Ora dovresti vedere la mappatura aggiunta nell'elenco:
- Clicca su Provision Microsoft Entra ID Users sotto Mappings
đź’ˇ Controllo consigliato per il provisioning basato sui gruppi:
Se utilizzi il provisioning SCIM basato sui gruppi, ti consigliamo vivamente di verificare le mappature degli attributi dei gruppi per assicurarti che gli utenti vengano correttamente disattivati in deskbird quando vengono rimossi da un gruppo Entra ID.
- Nella sezione Mappings, seleziona Provision Microsoft Entra ID Groups dal menu a tendina.
- Scorri fino in fondo e clicca su Show advanced options.
- Individua l'attributo con target attribute members.
Assicurati che la configurazione sia la seguente:
- ❌ urn:ietf:params:scim:schemas:core:2.0:Group non è selezionato
- âś… urn:ietf:params:scim:schemas:extension:enterprise:2.0:User rimane selezionato
Salva le modifiche e attendi qualche minuto affinché Microsoft Entra ID le applichi. Con questa configurazione, gli utenti rimossi dai gruppi Entra ID verranno correttamente impostati come Inattivi in deskbird durante il prossimo ciclo di provisioning.
- Vai su Enterprise Applications e seleziona Users and Groups
- Clicca su Add user/group
- Clicca su None selected
- Cerca e scegli i gruppi/gli utenti che vuoi fornire. Clicca su Select
- Clicca su Assign
Ora tutto dovrebbe essere configurato!
3. Passaggi per fornire gli oggetti selezionati
- Vai alla tua applicazione SCIM e clicca su Provisioning
- Vai su Start provisioning
- Il processo verrà avviato in background. Una volta completato, dovrebbe apparire così:
💡 Nota: Dopo aver configurato SCIM, la prima sincronizzazione potrebbe richiedere 1–2 ore. Attendi e controlla nuovamente più tardi. Dopo la configurazione iniziale, una sincronizzazione avverrà ogni 40 minuti.