Configurare Templafy OpenID Connect per il provisioning automatico degli utenti con Microsoft Entra ID

L'obiettivo di questo articolo è illustrare i passaggi da eseguire in Templafy OpenID Connect e Microsoft Entra ID 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 utenti Microsoft Entra. Per informazioni importanti su cosa fa questo servizio, come funziona e sulle domande frequenti, consultare Automazione del provisioning e deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Prerequisiti

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

Passaggio 1: Pianifica la distribuzione del provisioning

  1. Scoprire come funziona il servizio di provisioning.
  2. Determinare chi rientra nell'ambito per la fornitura.
  3. Determinare quali dati mappare tra Microsoft Entra ID e Templafy OpenID Connect.

Passaggio 1: Assegnare utenti a Templafy OpenID Connect

Microsoft Entra ID usa un concetto denominato assignments per determinare quali utenti devono ricevere l'accesso alle app selezionate. Nel contesto del provisioning utenti automatico, vengono sincronizzati solo gli utenti e/o i gruppi assegnati a un'applicazione in Microsoft Entra ID.

Prima di configurare e abilitare il provisioning utenti automatico, è necessario decidere quali utenti e/o gruppi in Microsoft Entra ID necessitano di accesso a Templafy OpenID Connect. Dopo aver deciso, è possibile assegnare questi utenti e/o gruppi a Templafy OpenID Connect seguendo le istruzioni Assegnare un utente o un gruppo a un'app aziendale.

Suggerimenti importanti per l'assegnazione di utenti a Templafy OpenID Connect

  • È consigliato assegnare un singolo utente Microsoft Entra a Templafy OpenID Connect per testare la configurazione dell'approvvigionamento 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 per supportare il provisioning con Microsoft Entra ID

Prima di configurare Templafy OpenID Connect per il provisioning automatico degli utenti con Microsoft Entra ID, è necessario abilitare il provisioning SCIM su Templafy OpenID Connect.

  1. Accedere alla console di amministrazione di Templafy. Selezionare Amministrazione.

    Screenshot della console di amministrazione di Templafy.

  2. Selezionare Metodo di autenticazione.

    Screenshot della sezione di amministrazione di Templafy con l'opzione Metodo di autenticazione evidenziata.

  3. Copiare il valore Chiave API SCIM. Questo valore verrà immesso nel campo Token segreto nella scheda Provisioning dell'applicazione Templafy OpenID Connect.

    Screenshot della chiave API SCIM.

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

Per aggiungere Templafy OpenID Connect dalla raccolta di applicazioni Microsoft Entra, seguire questa procedura:

  1. Accedi al centro amministrativo di Microsoft Entra come almeno un amministratore delle applicazioni cloud.

  2. Passare a Entra ID>App 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 mentre l'app viene aggiunta al tenant.

    Screenshot di Templafy OpenID Connect nell'elenco dei risultati.

Passaggio 4: Configurare il provisioning automatico degli utenti su Templafy OpenID Connect

Questa sezione illustra la procedura per configurare il servizio di provisioning Microsoft Entra per 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.

Configurare il provisioning automatico degli utenti per Templafy OpenID Connect in Microsoft Entra ID

  1. Accedi al centro amministrativo di Microsoft Entra come almeno un amministratore delle applicazioni cloud.

  2. Passare a Entra ID>App aziendali

    Screenshot del pannello di applicazioni aziendali.

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

    Immagine del collegamento Templafy OpenID Connect nell'elenco delle applicazioni.

  4. Selezionare la scheda Provisioning.

    Screenshot della schermata di gestione con evidenziata l'opzione Provisioning.

  5. Selezionare + Nuova configurazione.

    Screenshot della nuova configurazione.

  6. Nella sezione Credenziali amministratore, inserisci https://scim.templafy.com/scim in URL tenant. Immettere il valore della chiave API SCIM recuperato in precedenza in Token segreto. Selezionare Test Connection per assicurarsi che Microsoft Entra ID possa connettersi a Templafy. Se la connessione non riesce, verificare che l'account Templafy abbia autorizzazioni di amministratore e riprovare.

    Screenshot della connessione di test del provisioning.

  7. Selezionare Crea per creare la configurazione.

  8. Selezionare Proprietà nella pagina Panoramica .

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

    Screenshot delle proprietà di provisioning.

  10. Selezionare Mapping attributi nel pannello sinistro e selezionare utenti.

  11. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Templafy OpenID Connect nella sezione di Attribute Mapping. Gli attributi selezionati come proprietà Matching vengono usati per abbinare 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
    nome utente Stringa
    attivo Booleano
    Nome visualizzato Stringa
    titolo Stringa
    linguaPreferita Stringa
    nome.nomeDato Stringa
    nome.cognome Stringa
    phoneNumbers[type eq "lavoro"].value Stringa
    phoneNumbers[type uguale a "cellulare"].value Stringa
    phoneNumbers[tipo eq "fax"].valore Stringa
    Id esterno Stringa
    indirizzi[tipo eq "lavoro"].località Stringa
    indirizzi[tipo eq "lavoro"].codicePostale Stringa
    addresses[type eq "lavoro"].region Stringa
    indirizzi[type eq "lavoro"].indirizzoStrada 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.

  12. Seleziona Gruppi.

  13. Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID a Templafy OpenID Connect nella sezione Attribute Mapping. 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
    Id esterno Stringa

    Nota

    Funzione di Individuazione dello schema abilitata per questa applicazione.

  14. Per configurare i filtri di ambito, vedere le istruzioni fornite nell'articolo Filtro di ambito.

  15. Usare il provisioning su richiesta per convalidare la sincronizzazione con un numero ridotto di utenti prima di distribuire in modo più ampio nell'organizzazione.

  16. Quando si è pronti per procedere al provisioning, selezionare Avvia il provisioning nella pagina Panoramica.

Passaggio 5: monitorare la distribuzione

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

  1. Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning correttamente o in modo non riuscito
  2. Controlla la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
  3. Se la configurazione del provisioning sembra essere in uno stato malsano, 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