Configurare Templafy OpenID Connect per il provisioning utenti automatico

Questa esercitazione descrive la procedura da eseguire in Templafy OpenID Connect e Microsoft Entra ID per configurare Microsoft Entra ID in modo da effettuare automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in Templafy OpenID Connect.

Nota

L'esercitazione descrive un connettore basato sul servizio di provisioning utenti 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

Per lo scenario descritto in questa esercitazione si presuppone che l'utente disponga dei prerequisiti seguenti:

• Un tenant di Microsoft Entra.
• Un tenant di Templafy.
• Un account utente in Templafy con autorizzazioni di amministratore.

Passaggio 1: pianificare la distribuzione del provisioning

1. Vedere le informazioni su come funziona il servizio di provisioning.
2. Determinare gli utenti che verranno inclusi nell'ambito per il provisioning.
3. 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:

• Assegnare un utente o gruppo a un'app aziendale

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 il provisioning utenti automatico con Microsoft Entra ID, è necessario abilitare il provisioning SCIM in OpenID Connect.

1. Accedere alla console di amministrazione di Templafy. Cliccare su Amministrazione.

   

2. Cliccare su Metodo di autenticazione.

   

3. 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:

1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
2. Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
3. Nella sezione Aggiungi dalla raccolta digitare Templafy OpenID Connect, selezionare Templafy OpenID Connect nella casella di ricerca.
4. Selezionare Templafy OpenID Connect nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

Passaggio 4: configurare il provisioning utenti automatico in 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 OpenID connect-based basato per Templafy, seguendo le istruzioni fornite nell'esercitazione sull'accesso Single Sign-On per Templafy. L'accesso Single Sign-On può essere configurato indipendentemente dal provisioning utenti automatico, anche se queste due funzionalità sono complementari.

Per configurare il provisioning utenti automatico per Templafy OpenID Connect in Microsoft Entra ID:

1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

2. Passare a Identità>Applicazioni>Applicazioni enterprise

   

3. Nell'elenco di applicazioni selezionare Templafy OpenID Connect.

   

4. Selezionare la scheda Provisioning.

   

5. Impostare Modalità di provisioning su Automatico.

   

6. Nella sezione Credenziali amministratore immettere https://scim.templafy.com/scim in 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.

   

7. 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.

   

8. Cliccare su Salva.

9. Nella sezione Mapping, selezionare Sincronizza utenti Microsoft Entra con Templafy OpenID Connect.

10. Esaminare gli attributi utente 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 gli account utente in Templafy OpenID Connect per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Attributo	Type	Supportato per il filtro
    userName	String	✓
    active	Booleano
    displayName	String
    title	String
    preferredLanguage	String
    name.givenName	String
    name.familyName	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    phoneNumbers[type eq "fax"].value	String
    externalId	Stringa
    addresses[type eq "work"].locality	String
    addresses[type eq "work"].postalCode	Stringa
    addresses[type eq "work"].region	String
    addresses[type eq "work"].streetAddress	Stringa
    addresses[type eq "work"].country	Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String

    Nota

    Funzionalità Individuazione dello schema abilitata per questa app.

11. Nella sezione Mapping selezionare Sincronizza gruppi di Microsoft Entra in Templafy.

12. Esaminare gli attributi gruppo 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	Type	Supportato per il filtro
    displayName	String	✓
    membri	Riferimento
    externalId	Stringa

    Nota

    Funzionalità Individuazione dello schema abilitata per questa app.

13. Per configurare i filtri di ambito, fare riferimento alle istruzioni fornite nell'esercitazione sui filtri per la definizione dell'ambito.

14. Per abilitare il servizio di provisioning di Microsoft Entra per Templafy OpenID Connect, impostare Stato del provisioning su Sì nella sezione Impostazioni.

    

15. 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.

    

16. Quando si è pronti per effettuare il provisioning, 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 con esito positivo o negativo.
• Controllare l'indicatore di stato 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 altre informazioni sugli stati di quarantena, fare clic qui.

Registro modifiche

• 04/05/2023 - Supporto aggiuntivo 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?

Passaggi successivi

• Informazioni su come esaminare i log e ottenere report sulle attività di provisioning