Condividi tramite


Configurare Templafy SAML2 per il provisionamento automatico degli utenti

L'obiettivo di questo articolo è illustrare i passaggi da eseguire in Templafy SAML2 e Microsoft Entra ID per configurare Microsoft Entra ID per effettuare automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in Templafy SAML2.

Nota

Questo articolo descrive un connettore basato sul servizio di provisioning utente di Microsoft Entra. Per informazioni importanti su cosa fa questo servizio, come funziona e per le risposte alle domande frequenti, vedere Automatizzare il provisioning e il 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:

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

Passaggio 1: Pianifica la distribuzione del provisioning

  1. Scopri 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:

Suggerimenti importanti per l'assegnazione di utenti a Templafy SAML2

  • È consigliato assegnare un singolo utente di Microsoft Entra a Templafy SAML2 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 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 su Templafy SAML2.

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

    Console di amministrazione di Templafy

  2. Cliccare su 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 SAML2.

    Screenshot della chiave API SCIM.

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. Accedi al Centro di amministrazione di Microsoft Entra come almeno un 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. Pazientare alcuni secondi mentre l'app viene aggiunta al tenant. Templafy SAML2 nell'elenco dei risultati

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.

Suggerimento

È anche possibile scegliere di abilitare l'accesso Single Sign-On basato su SAML per Templafy, seguendo le istruzioni fornite nell'articolo Templafy Single Sign-On. Il Single Sign-On può essere configurato indipendentemente dal provisioning automatico degli utenti, anche se queste due funzionalità sono complementari.

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

  1. Accedi al Centro di amministrazione di Microsoft Entra come almeno un Amministratore delle applicazioni cloud.

  2. Passare a Identità>Applicazioni>Applicazioni aziendali

    Pannello delle applicazioni aziendali

  3. Nell'elenco delle applicazioni selezionare Templafy SAML2.

    Collegamento di Templafy SAML2 nell'elenco delle applicazioni

  4. Selezionare la scheda Provisioning.

    Screenshot delle opzioni di gestione con l'opzione Provisioning evidenziata.

  5. Impostare Modalità di provisioning su Automatico.

    Screenshot dell'elenco a discesa Modalità di Provisioning con l'opzione Automatico selezionata.

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

    URL del tenant + Token

  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.

    Messaggio e-mail di notifica

  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 Mappatura degli 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 Tipo Supportato per il filtraggio
    userName Stringa
    attivo Booleano
    nome visualizzato Stringa
    titolo Stringa
    lingua preferita Stringa
    name.givenName String
    nome.cognome String
    phoneNumbers[type eq "work"].value Stringa
    phoneNumbers[type eq "mobile"].value Stringa
    phoneNumbers[type eq "fax"].value Stringa
    externalId Stringa
    addresses[type eq "lavoro"].località Stringa
    addresses[type eq "work"].codicePostale String
    indirizzi[tipo eq "lavoro"].regione Stringa
    addresses[type eq "work"].streetAddress String
    addresses[type eq "work"].country Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization Stringa

    Nota

    La funzionalità di individuazione dello schema è abilitata per questa app.

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

  12. Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID a Templafy SAML2 nella sezione Mappature 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 Tipo Supportato per il filtraggio
    nome visualizzato Stringa
    membri Riferimento
    externalId Stringa

    Nota

    La funzionalità di Rilevamento dello schema è abilitata per questa applicazione.

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

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

    Stato del provisioning modificato a attivo

  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.

    Ambito di provisioning

  16. Quando si è pronti per effettuare il provisioning, fare clic su Salva.

    Salvataggio della configurazione del provisioning

    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:

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