Esercitazione: Configurare Templafy SAML2 per il provisioning utenti automatico

Questa esercitazione descrive la procedura da eseguire in Templafy SAML2 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 SAML2.

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

Assegnazione di utenti a Templafy SAML2

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 devono poter accedere a Templafy SAML2. Dopo aver definito questo aspetto, è possibile assegnare gli utenti e/o i gruppi a Templafy SAML2 seguendo le istruzioni riportate di seguito:

• Assegnare un utente o gruppo a un'app aziendale

Suggerimenti importanti per l'assegnazione di utenti a Templafy SAML2

• È consigliabile assegnare un singolo utente di Microsoft Entra a Templafy SAML2 per testare la configurazione del provisioning utenti automatico. In un secondo momento si potranno assegnare altri utenti e/o gruppi.

• Quando si assegna un utente a Templafy SAML2, è 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 SAML2 per supportare il provisioning con Microsoft Entra ID

Prima di configurare Templafy SAML2 per il provisioning utenti automatico con Microsoft Entra ID, è necessario abilitare il provisioning SCIM in Templafy SAML2.

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

   

Passaggio 3: aggiungere Templafy SAML2 dalla raccolta

Per configurare Templafy SAML2 per il provisioning utenti automatico con Microsoft Entra ID, è necessario aggiungere Templafy SAML2 dalla raccolta di applicazioni di Microsoft Entra all'elenco di applicazioni SaaS gestite.

Per aggiungere Templafy SAML2 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 SAML2 e selezionarlo nella casella di ricerca.
4. Selezionare Templafy SAML2 dal pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

Passaggio 4: configurare il provisioning automatico degli utenti per Templafy SAML2

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 SAML2 in base alle assegnazioni di utenti e/o gruppi in Microsoft Entra ID.

Per configurare il provisioning utenti automatico per Templafy SAML2 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 delle applicazioni selezionare Templafy SAML2.

   

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 Sincronizzare gli utenti di Microsoft Entra con Templafy SAML2.

10. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Templafy SAML2 nella sezione Mapping attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Templafy SAML2 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 tra Microsoft Entra ID e Templafy SAML2 nella sezione Mapping attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Templafy SAML2 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 SAML2, 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 SAML2 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 SAML2.

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