Configurare Templafy OpenID Connect per il provisioning automatico di utenti
L'obiettivo di questo articolo è illustrare i passaggi da eseguire in Templafy OpenID Connect e Microsoft Entra ID per configurare Microsoft Entra ID per effettuare automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in Templafy OpenID Connect.
Nota
Questo articolo descrive un connettore basato sul servizio di provisioning utente di Microsoft Entra. Per informazioni dettagliate sulle caratteristiche e sul funzionamento di questo servizio e per le domande frequenti, vedere Automatizzare il provisioning e il deprovisioning utenti in applicazioni SaaS con Microsoft Entra ID.
Prerequisiti
Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:
- Un account utente di Microsoft Entra con una sottoscrizione attiva. Se non è già disponibile, è possibile Creare un account gratuitamente. - Uno dei ruoli seguenti: - Amministratore applicazioni - Amministratore applicazioni cloud - proprietario dell'applicazione..
- Un tenant di Templafy.
- Un account utente in Templafy con autorizzazioni di amministratore.
Passaggio 1: pianificare la distribuzione del provisioning
- Scoprire come funziona il servizio di provisioning.
- Determinare gli utenti che verranno inclusi nell'ambito per il provisioning.
- Determinare per quali dati eseguire il mapping tra Microsoft Entra ID e Templafy OpenID Connect.
Assegnazione di utenti a Templafy OpenID Connect
Per determinare quali utenti avranno l'accesso alle app selezionate, Microsoft Entra ID usa il concetto delle cosiddette assegnazioni. Nel contesto del provisioning automatico degli utenti vengono sincronizzati solo gli utenti e/o i gruppi che sono stati assegnati a un'applicazione in Microsoft Entra ID.
Prima di configurare e abilitare il provisioning utenti automatico, è necessario stabilire quali utenti e/o gruppi in Microsoft Entra ID dovrebbero poter accedere a Templafy OpenID Connect. Dopo aver definito questo aspetto, è possibile assegnare gli utenti e/o i gruppi a Templafy OpenID Connect seguendo le istruzioni riportate di seguito:
Suggerimenti importanti per l'assegnazione di utenti a Templafy OpenID Connect
È consigliabile assegnare un singolo utente di Microsoft Entra a Templafy OpenID Connect per testare la configurazione del provisioning automatico degli utenti. In un secondo momento si potranno assegnare altri utenti e/o gruppi.
Quando si assegna un utente a Templafy OpenID Connect, è necessario selezionare qualsiasi ruolo specifico dell'applicazione valido, se disponibile, nella finestra di dialogo di assegnazione. Gli utenti con il ruolo Accesso predefinito vengono esclusi dal provisioning.
Passaggio 2: configurare Templafy OpenID Connect affinché supporti il provisioning con Microsoft Entra ID
Prima di configurare Templafy OpenID Connect per la fornitura automatica di utenti con Microsoft Entra ID, è necessario abilitare il provisioning SCIM su Templafy OpenID Connect.
Accedere alla console di amministrazione di Templafy. Cliccare su Amministrazione.
Cliccare su Metodo di autenticazione.
Copiare il valore Chiave API SCIM. Questo valore verrà immesso nel campo Token segreto nella scheda Provisioning dell'applicazione Templafy OpenID Connect.
Passaggio 3: Aggiungere Templafy OpenID Connect dalla raccolta
Per configurare Templafy OpenID Connect per il provisioning utenti automatico con Microsoft Entra ID, è necessario aggiungere Templafy OpenID Connect dalla raccolta di applicazioni di Microsoft Entra all'elenco di applicazioni SaaS gestite.
Per aggiungere Templafy OpenID Connect dalla raccolta di applicazioni di Microsoft Entra, seguire questa procedura:
- Accedi al centro di amministrazione di Microsoft Entra come almeno un Amministratore delle applicazioni cloud.
- Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
- Nella sezione Aggiungi dalla raccolta digitare Templafy OpenID Connect, selezionare Templafy OpenID Connect nella casella di ricerca.
- Selezionare Templafy OpenID Connect nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi mentre l'app viene aggiunta al tenant.
Passaggio 4: Configurare il provisioning automatico degli utenti su Templafy OpenID Connect
Questa sezione descrive la procedura per configurare il servizio di provisioning di Microsoft Entra in modo da creare, aggiornare e disabilitare utenti e/o gruppi in Templafy OpenID Connect in base alle assegnazioni di utenti e/o gruppi in Microsoft Entra ID.
Suggerimento
È anche possibile scegliere di abilitare l'accesso Single Sign-On basato su OpenID connect per Templafy, seguendo le istruzioni fornite nell'articolo Templafy Single Sign-On. L'accesso Single Sign-On può essere configurato indipendentemente dall'approvvigionamento utenti automatico, anche se queste due funzionalità sono complementari.
Per configurare il provisioning utenti automatico per Templafy OpenID Connect in Microsoft Entra ID:
Accedi al Centro di amministrazione di Microsoft Entra come almeno un Amministratore applicazioni cloud.
Passare a Identità>Applicazioni>Applicazioni aziendali
Nell'elenco di applicazioni selezionare Templafy OpenID Connect.
Selezionare la scheda Provisioning.
Impostare la Modalità di distribuzione su Automatico.
Nella sezione Credenziali amministratore immettere
https://scim.templafy.com/scimin URL tenant. Immettere il valore Chiave API SCIM recuperato in precedenza in Token segreto. Cliccare su Connessione di test per verificare che Microsoft Entra ID possa connettersi a Templafy. Se la connessione non riesce, verificare che l'account Templafy abbia autorizzazioni di amministratore e riprovare.
Nel campo Messaggio di posta elettronica di notifica immettere l'indirizzo di posta elettronica di una persona o un gruppo che riceverà le notifiche di errore relative al provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica in caso di errore.
Cliccare su Salva.
Nella sezione Mapping, selezionare Sincronizza utenti Microsoft Entra con Templafy OpenID Connect.
Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Templafy OpenID Connect nella sezione Mappatura attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Templafy OpenID Connect per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.
Attributo Tipo Supportato per il filtraggio userName Stringa ✓ attivo Booleano Nome visualizzato Stringa titolo Stringa linguaPreferita Stringa name.givenName Stringa nome.cognome String phoneNumbers[type eq "lavoro"].value Stringa phoneNumbers[type uguale a "cellulare"].value String phoneNumbers[tipo eq "fax"].valore Stringa externalId String addresses[type eq "work"].locality Stringa indirizzi[tipo eq "lavoro"].codicePostale Stringa addresses[type eq "lavoro"].region Stringa addresses[type eq "work"].streetAddress Stringa indirizzi[type eq "lavoro"].country Stringa urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:dipartimento Stringa urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization Stringa Nota
Funzione di Individuazione dello schema abilitata per questa applicazione.
Nella sezione Mapping selezionare Sincronizza gruppi di Microsoft Entra in Templafy.
Esamina gli attributi del gruppo che sono sincronizzati da Microsoft Entra ID a Templafy OpenID Connect nella sezione Mapping attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Templafy OpenID Connect per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.
Attributo Tipo Supportato per il filtraggio nome visualizzato Stringa ✓ membri Riferimento externalId Stringa Nota
La funzionalità di individuazione dello schema è abilitata per questa applicazione.
Per configurare i filtri di ambito, vedere le istruzioni seguenti fornite nell'articolo Filtro di ambito.
Per abilitare il servizio di provisioning di Microsoft Entra per Templafy OpenID Connect, impostare Stato del provisioning su Sì nella sezione Impostazioni.
Definire gli utenti e/o i gruppi di cui si vuole eseguire il provisioning in Templafy OpenID Connect selezionando i valori desiderati in Ambito nella sezione Impostazioni.
Quando si è pronti per la configurazione, fare clic su Salva.
L'operazione avvia la sincronizzazione iniziale di tutti gli utenti e/o i gruppi definiti in Ambito nella sezione Impostazioni. La sincronizzazione iniziale richiede più tempo delle sincronizzazioni successive, che saranno eseguite circa ogni 40 minuti quando il servizio di provisioning di Microsoft Entra è in esecuzione. È possibile usare la sezione Dettagli sincronizzazione per monitorare lo stato di avanzamento e selezionare i collegamenti al report delle attività di provisioning, che descrive tutte le azioni eseguite dal servizio di provisioning di Microsoft Entra in Templafy OpenID Connect.
Passaggio 5: 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
- Controlla la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
- Se la configurazione del provisioning sembra essere in uno stato non integro, l'applicazione entra in quarantena. Per saperne di più sugli stati di quarantena, consulta l'articolo relativo al provisioning delle applicazioni con stato di quarantena.
Registro modifiche
- 05/04/2023 - Aggiunto supporto per l'Individuazione dello schema.
Altre risorse
- Gestione del provisioning degli account utente per app aziendali
- Che cos'è l'accesso alle applicazioni e Single Sign-On con Microsoft Entra ID?