Configurare Humbol per il provisioning automatico degli utenti con Microsoft Entra ID

Questo articolo descrive i passaggi da eseguire sia in Humbol che in Microsoft Entra ID, per configurare il provisioning automatico degli utenti. Se configurato, Microsoft Entra ID gestisce automaticamente il provisioning e il deprovisioning degli utenti su Humbol utilizzando il servizio di provisioning di Microsoft Entra. Per informazioni importanti sul funzionamento di questo servizio e sulle domande frequenti, vedere Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Funzionalità supportate

Creare utenti in Humbol.
Rimuovere gli utenti in Humbol quando non richiedono più l'accesso.
Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Humbol.
Autenticazione unica a Humbol (scelta consigliata).

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

Tenant di Microsoft Entra.
Uno dei ruoli seguenti: Amministratore applicazione, Amministratore applicazione cloud o Proprietario applicazione.
Contratto attivo con Humbol, incluso l'utilizzo dell'API SCIM con Humbol Inc.
Un account utente in Humbol con autorizzazioni di amministratore.

Passaggio 1: Pianificare la distribuzione dell'approvvigionamento

Informazioni sul funzionamento del servizio di provisioning.
Determinare chi è nell'ambito per il provisioning.
Stabilire quali dati associare tra Microsoft Entra ID e Humbol.

Passaggio 2: Configurare Humbol per supportare il provisioning con Microsoft Entra ID

Contattare il supporto tecnico di Humbol per configurare Humbol per supportare il provisioning con Microsoft Entra ID.

Accedi alla tua organizzazione Humbol come amministratore di Humbol.
Passare alla pagina delle impostazioni API dell'organizzazione.
1. In questa pagina è possibile trovare l'URL dell'API SCIM dell'organizzazione. Copialo
2. Creare il token dell'API SCIM e copiare il valore.
Annotazioni

Il valore del token non viene salvato in nessun punto del servizio Humbol, quindi se lo si perde, è necessario crearne uno nuovo e rimuoverlo precedente.

Passaggio 3: Aggiungere Humbol dalla raccolta di applicazioni Microsoft Entra

Aggiungere Humbol dalla galleria delle applicazioni di Microsoft Entra per iniziare a gestire il provisioning in Humbol. Se Humbol è stato configurato in precedenza per l'accesso SSO, è possibile usare la stessa applicazione. Tuttavia, è consigliabile creare un'app separata durante il test iniziale dell'integrazione. Altre informazioni sull'aggiunta di un'applicazione dalla raccolta sono disponibili qui.

Passaggio 4: Definire chi è incluso nel processo di provisioning

Il servizio di provisioning di Microsoft Entra consente di delimitare chi viene fornito in base all'assegnazione all'applicazione o in base agli attributi degli utenti o dei gruppi. Se si sceglie di definire l'ambito di provisioning per la tua app in base all'assegnazione, è possibile usare la procedura per assegnare utenti e gruppi all'app. Se si sceglie di delimitare l'ambito che viene fornito basandosi esclusivamente sugli attributi dell'utente o del gruppo, è possibile usare un filtro di ambito.

Iniziare con pochi elementi. Eseguire il test con un piccolo insieme di utenti e gruppi prima di distribuirlo a tutti. Quando l'ambito per il provisioning è impostato su utenti e gruppi assegnati, è possibile controllarlo assegnando uno o due utenti o gruppi all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributi.
Se sono necessari ruoli aggiuntivi, è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Passaggio 5: Configurare il provisioning automatico degli utenti in Humbol

Questa sezione mostra i passaggi da eseguire per configurare il servizio di provisioning di Microsoft Entra per creare, aggiornare e disabilitare utenti in TestApp in base alle assegnazioni utente in Microsoft Entra ID.

Per configurare il provisioning automatico degli utenti per Humbol in Microsoft Entra ID:

Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un amministratore di applicazioni cloud.
Passare alle app Entra ID>Enterprise
Nell'elenco delle applicazioni selezionare Humbol.
Selezionare la scheda Provisioning .
Selezionare + Nuova configurazione.
Nel campo URL Tenant, inserisci il tuo URL del Tenant Humbol e il Token Segreto. Selezionare Test connessione per assicurarsi che Microsoft Entra ID possa connettersi a Humbol. Se la connessione non riesce, verificare che l'account Humbol disponga delle autorizzazioni di amministratore necessarie e riprovare.
Selezionare Crea per creare la configurazione.
Selezionare Proprietà nella pagina Panoramica .
Selezionare l'icona Modifica per modificare le proprietà. Abilitare i messaggi di posta elettronica di notifica e fornire un messaggio di posta elettronica per ricevere notifiche di quarantena. Abilitare la prevenzione delle eliminazioni accidentali. Seleziona Applica per salvare le modifiche.
Nel campo Email di Notifica, immettere l'indirizzo di posta elettronica di una persona che dovrebbe ricevere le notifiche di errori di provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica quando si verifica un errore.
Selezionare Mapping attributi nel pannello sinistro e selezionare utenti.

Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Humbol nella sezione Mappatura attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per corrispondere con gli account utente in Humbol per le operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente, è necessario assicurarsi che l'API Humbol supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

Attributo	TIPO	Supporto per il filtraggio	Richiesto da Humbol
nome utente	Stringa	✓	✓
attivo	Booleano		✓
titolo	Stringa
email[type eq "work"].valore	Stringa		✓
lingua preferita	Stringa
nome.nomeDato	Stringa		✓
nome.cognome	Stringa		✓
indirizzi[tipo eq "lavoro"].località	Stringa
indirizzi[ tipo eq "lavoro" ].regione	Stringa
indirizzi[tipo eq "lavoro"].paese	Stringa
roles[principale eq "Vero"].valore	Stringa
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:dipartimento	Stringa
urn:ietf:params:scim:schemas:extension:enterprise:2.0:Utente:manager	Stringa

Annotazioni

Se si include roles[primary eq "True"].value ogni utente deve avere esattamente un ruolo.
Un'altra opzione consiste nel rimuovere il mapping degli attributi del ruolo e gestire i ruoli utente Humbol all'interno dell'applicazione Humbol.

Per configurare i filtri di ambito, vedere le istruzioni fornite nell'articolo Filtro di ambito.
Usare il provisioning su richiesta per convalidare la sincronizzazione con un numero ridotto di utenti prima di distribuire in modo più ampio nell'organizzazione.
Quando si è pronti per procedere al provisioning, selezionare Avvia il provisioning nella pagina Panoramica.

Passaggio 6: Monitorare la distribuzione

Dopo aver configurato il provisioning, usare le risorse seguenti per monitorare la distribuzione:

Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning correttamente o in modo non riuscito
Controllare la barra di progresso per visualizzare lo stato del ciclo di provisioning e come si avvicina al completamento.
Se la configurazione del provisioning sembra essere in cattivo stato, l'applicazione entra in quarantena. Ulteriori informazioni sugli stati di quarantena sono disponibili nell'articolo sullo stato di quarantena del provisioning delle applicazioni.