SSO e Gruppi Utente · 7 min di lettura
Provisioning degli utenti (SCIM)
Come SCIM permette al tuo identity provider di creare, aggiornare, disattivare e rimuovere gli account Intric, come configurarlo in Microsoft Entra ID e cosa non copre.
SCIM (System for Cross-domain Identity Management) è uno standard per trasferire gli account utente da un sistema a un altro. Con SCIM attivo, è il tuo identity provider (IdP) a decidere chi ha un account Intric e se è attivo: un utente che aggiungi viene creato in Intric prima del suo primo accesso, e un utente che rimuovi perde l’accesso senza che nessuno debba intervenire in Intric.
Questa pagina è rivolta a chi amministra il tuo IdP. La procedura guidata riguarda Microsoft Entra ID. Se usi un altro IdP che supporta SCIM 2.0, contatta il supporto di Intric.
SCIM e SSO
Sezione intitolata “SCIM e SSO”SCIM e SSO sono distinti, e servono entrambi.
- SSO gestisce come l’utente accede.
- SCIM gestisce se l’utente ha un account e in quale stato.
Con il solo SSO, un account viene creato e aggiornato soltanto quando l’utente accede. Un utente che rimuovi dal tuo IdP non può più accedere, ma il suo account Intric resta attivo finché qualcuno non lo disattiva a mano, e un nuovo utente non esiste in Intric fino al primo accesso, quindi un amministratore non può preparare nulla per lui in anticipo.
Con il solo SCIM, un utente ottiene un account ma non può accedere. SCIM non rilascia alcuna password, quindi l’accesso passa comunque da SSO.
Aggiungere SCIM non cambia nulla nella tua configurazione SSO esistente. Configura prima SSO: vedi SSO e gruppi di utenti.
Cosa viene sincronizzato
Sezione intitolata “Cosa viene sincronizzato”| Modifica nel tuo IdP | Effetto in Intric |
|---|---|
| Un utente viene assegnato all’applicazione di provisioning | Intric crea un account prima del primo accesso dell’utente, con il ruolo User e nel tuo gruppo di fatturazione predefinito. Nell’elenco utenti compare come Invited finché l’utente non accede per la prima volta. |
| Un utente viene rimosso dall’assegnazione, oppure il suo account viene disabilitato | L’account viene disattivato e compare come Inactive. L’utente non può accedere e Intric rifiuta le sue sessioni e le sue chiavi API. Non viene eliminato nulla e la modifica è reversibile. |
| Un utente viene riabilitato o assegnato di nuovo | L’account viene ripristinato con tutto il suo contenuto. |
| Un utente viene eliminato | L’account viene disattivato subito. Quando Entra ID elimina definitivamente l’utente, circa 30 giorni dopo, Intric rimuove l’account: scompare da tutti gli elenchi e il suo indirizzo email può essere riutilizzato. Intric conserva i contenuti creati dall’utente e la cronologia di audit. |
| Cambia il nome di un utente | Intric aggiorna il nome, a meno che l’utente non abbia cambiato il proprio nome in Intric. Un nome scelto dall’utente in Intric viene mantenuto. |
| Cambia l’indirizzo email di un utente | Intric aggiorna l’indirizzo email, una volta verificato e purché nessun altro account Intric lo usi. |
Alcune regole stabiliscono i casi che la tabella non copre:
- Un utente che ha già un account Intric con lo stesso indirizzo email mantiene quell’account. Non viene creato un secondo account. Lo stesso vale per un utente con un invito in sospeso: entra tramite l’invito.
- Un account che un amministratore di Intric ha disattivato a mano resta disattivato. Riabilitare l’utente nel tuo IdP ripristina soltanto gli account che il tuo IdP ha disattivato.
- Ogni modifica apportata da SCIM viene registrata nell’audit log di Intric.
Cosa non fa SCIM
Sezione intitolata “Cosa non fa SCIM”- È unidirezionale. Le modifiche vanno dal tuo IdP a Intric, mai in senso inverso. Cambiare un ruolo, disattivare un utente o spostare un utente in un altro gruppo di fatturazione in Intric non cambia nulla nel tuo IdP.
- Non sincronizza i gruppi. L’appartenenza ai gruppi continua ad aggiornarsi a ogni accesso dell’utente, come descritto in Gruppi di utenti.
- Non assegna i ruoli. Gli utenti di cui è stato fatto il provisioning ricevono il ruolo User. Un amministratore di Intric cambia i ruoli in Intric.
- Non è istantaneo. Entra ID invia le modifiche in un ciclo che si ripete ogni 40 minuti. Intric applica ogni modifica entro pochi secondi dalla ricezione. Per interrompere subito l’accesso di un utente, disattivalo anche nell’amministrazione utenti di Intric.
Cosa ti serve
Sezione intitolata “Cosa ti serve”- SSO con Entra ID già funzionante per la tua organizzazione.
- Il ruolo Application Administrator o Cloud Application Administrator in Entra ID.
- Entra ID P1 o P2 se assegni gruppi anziché singoli utenti.
- Due valori forniti da Intric, inviati tramite un canale sicuro: un Tenant URL e un Secret Token. Chiedi al supporto di Intric di attivare il provisioning per la tua organizzazione e ti invieremo entrambi.
Il servizio di provisioning di Entra ID svolge il lavoro. Si collega al servizio di accesso di Intric, login.intric.ai, con il Secret Token e gestisce solo gli utenti della tua organizzazione.
Configura il provisioning in Entra ID
Sezione intitolata “Configura il provisioning in Entra ID”Il provisioning funziona da un’applicazione aziendale a sé stante, separata dalla registrazione dell’app che usi per l’accesso.
Crea l'applicazione di provisioning
- Nell’Entra admin center, vai a Entra IDEnterprise apps e clicca su New application.
- Clicca su Create your own application.
- Dai all’applicazione un nome che i tuoi amministratori riconoscano, per esempio
Intric provisioning, scegli Integrate any other application you don’t find in the gallery (Non-gallery) e clicca su Create.
Collegala a Intric
- Nella nuova applicazione, apri Provisioning e imposta la modalità di provisioning su Automatic.
- In Admin Credentials, incolla il Tenant URL e il Secret Token che hai ricevuto da Intric.
- Clicca su Test Connection. Deve riuscire prima che tu continui. Se non riesce, controlla di aver incollato entrambi i valori per intero, poi contatta il supporto di Intric.
- Salva.
Imposta le mappature degli attributi
- In Mappings, apri Provision Microsoft Entra ID Users e mantieni solo le mappature della tabella qui sotto. Elimina le altre, come reparto e qualifica: il servizio di accesso di Intric non le memorizza.
- In Mappings, apri Provision Microsoft Entra ID Groups e imposta Enabled su No.
- In Settings, imposta Scope su Sync only assigned users and groups.
| Attributo Entra ID | Attributo SCIM |
|---|---|
userPrincipalName |
userName |
Switch([IsSoftDeleted], , "False", "True", "True", "False") |
active |
mail |
emails[type eq "work"].value |
givenName |
name.givenName |
surname |
name.familyName |
displayName |
displayName |
objectId |
externalId |
Prova con un utente, poi avvia
- In Users and groups, assegna un utente di prova.
- Apri Provision on demand, seleziona l’utente di prova e clicca su Provision. Il risultato elenca ogni passaggio e la risposta del servizio di accesso.
- Verifica con il supporto di Intric che l’account sia comparso in Intric.
- Assegna gli stessi utenti e gruppi assegnati alla tua applicazione di accesso.
- Clicca su Start provisioning.
Da questo momento, aggiungere un utente a un gruppo assegnato gli dà un account Intric, e rimuoverlo glielo toglie.
Intric sui tuoi server
Sezione intitolata “Intric sui tuoi server”I passaggi in Entra ID sono gli stessi. Cambiano due cose.
La credenziale la crei tu. La tua installazione esegue un proprio servizio di accesso: invece di ricevere un Tenant URL e un Secret Token da Intric, crei un utente di servizio e il suo token nel tuo servizio di accesso. Intric ti guida nella procedura. La tua installazione richiede Intric backend 2.7.0 o successivo e Zitadel 4.13 o successivo.
Entra ID deve anche raggiungere il tuo servizio di accesso. Il suo servizio di provisioning gira nel cloud di Microsoft, mentre il tuo servizio di accesso si trova all’interno della tua rete. Il tuo team di rete deve consentire questo traffico. Ci sono due modi:
- Pubblicare solo il percorso
/scim/v2/del tuo host di accesso verso il servizio di provisioning di Microsoft. - Installare all’interno della tua rete l’agente di provisioning on-premises di Microsoft, che raggiunge il servizio di accesso senza che nulla venga aperto verso l’interno.
Quale scegliere lo decidi tu. Comunica a Intric quale hai scelto e, se nessuno dei due è adatto, definiremo insieme a te una configurazione.
Manutenzione
Sezione intitolata “Manutenzione”- Il Secret Token ha una data di scadenza. Quando scade, il provisioning si interrompe senza alcun errore in Intric: il ciclo successivo di Entra ID fallisce e gli utenti non vengono più creati né disattivati. Chiedi a Intric un nuovo token prima della scadenza e incollalo in Admin Credentials.
- Controlla i log di provisioning quando una modifica non arriva. Nell’applicazione di provisioning, Provisioning logs mostra ogni utente che Entra ID ha provato a inviare e la risposta ricevuta. Se Entra ID segnala un successo e Intric mostra ancora il vecchio stato dopo qualche minuto, contatta il supporto di Intric indicando l’indirizzo email dell’utente e l’orario.