Esercitazione: Configurare DocuSign per il provisioning utenti automatico
Questa esercitazione descrive i passaggi da eseguire in DocuSign e Microsoft Entra ID per effettuare automaticamente il provisioning e il deprovisioning degli account utente da Microsoft Entra ID a DocuSign.
Prerequisiti
Per lo scenario descritto in questa esercitazione si presuppone che l'utente disponga di quanto segue:
- Un tenant di Microsoft Entra.
- Una sottoscrizione di DocuSign abilitata per l'accesso Single Sign-On.
- Un account utente in DocuSign con autorizzazioni di amministratore di team.
Assegnazione di utenti a DocuSign
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 account utente, vengono sincronizzati solo gli utenti e i gruppi che sono stati "assegnati" a un'applicazione in Microsoft Entra ID.
Prima di configurare e abilitare il servizio di provisioning, è necessario decidere quali utenti e/o gruppi in Microsoft Entra ID rappresentano gli utenti che devono accedere all'app DocuSign. Dopo aver stabilito questo, è possibile assegnare tali utenti all'app DocuSign seguendo le istruzioni riportate nell'articolo seguente:
Assegnare un utente o gruppo a un'app aziendale
Suggerimenti importanti per l'assegnazione di utenti a DocuSign
È consigliabile assegnare a DocuSign un singolo utente di Microsoft Entra per testare la configurazione del provisioning. È possibile assegnare utenti aggiuntivi in un secondo momento.
Quando si assegna un utente a DocuSign, è necessario selezionare un ruolo utente valido. Il ruolo "Default Access" (Accesso predefinito) non è applicabile per il provisioning.
Nota
Microsoft Entra ID non supporta il provisioning dei gruppi con l'applicazione Docusign, ma è possibile effettuare il provisioning solo degli utenti.
Abilitare il provisioning utenti
Questa sezione illustra come connettere l'ID Microsoft Entra all'API di provisioning dell'account utente di DocuSign e configurare il servizio di provisioning per creare, aggiornare e disabilitare gli account utente assegnati in DocuSign in base all'assegnazione di utenti e gruppi in Microsoft Entra ID.
Suggerimento
È anche possibile scegliere di abilitare l'accesso Single Sign-On basato su SAML per DocuSign, seguendo le istruzioni fornite nella portale di Azure. L'accesso Single Sign-On può essere configurato indipendentemente dal provisioning automatico, nonostante queste due funzionalità siano complementari.
Per configurare il provisioning degli account utente:
Questa sezione descrive come abilitare il provisioning degli account utente di Active Directory in DocuSign.
Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
Passare a Identità>Applicazioni>Applicazioni aziendali.
Se si è già configurato DocuSign per l'accesso Single Sign-On, cercare l'istanza di DocuSign usando il campo di ricerca. In caso contrario, selezionare Aggiungi e cercare DocuSign nella raccolta di applicazioni. Selezionare DocuSign nei risultati della ricerca e aggiungerlo all'elenco delle applicazioni.
Selezionare l'istanza di DocuSign e quindi la scheda Provisioning.
Impostare Modalità di provisioning su Automatico.
Nella sezione Credenziali di amministratore specificare le impostazioni di configurazione seguenti:
Nella casella di testo Nome utente amministratore digitare un nome di account DocuSign che abbia il profilo Amministratore di sistema assegnato in DocuSign.com.
Nella casella di testo Password amministratore digitare la password per questo account.
Nota
Se sia l'accesso Single Sign-On che il provisioning utenti sono impostati, le credenziali di autorizzazione usate per il provisioning devono essere configurate per l'uso sia con SSO che con nome utente/password.
Selezionare Test connessione per assicurarsi che Microsoft Entra ID possa connettersi all'app DocuSign.
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.
Fare clic su Salva.
Nella sezione Mapping selezionare Synchronize Microsoft Entra users to DocuSign (Sincronizza utenti di Microsoft Entra con DocuSign).
Nella sezione Mapping attributi esaminare gli attributi utente sincronizzati da Microsoft Entra ID a DocuSign. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in DocuSign per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.
Per abilitare il servizio di provisioning Di Microsoft Entra per DocuSign, impostare Stato del provisioning su Sì nella sezione Impostazioni
Fare clic su Salva.
Viene avviata la sincronizzazione iniziale di tutti gli utenti assegnati a DocuSign nella sezione Utenti e gruppi. La sincronizzazione iniziale richiede più tempo delle sincronizzazioni successive, che saranno eseguite circa ogni 40 minuti per tutto il tempo che il servizio è in esecuzione. È possibile usare la sezione Dettagli sincronizzazione per monitorare lo stato di avanzamento e selezionare i collegamenti ai log delle attività di provisioning, che descrivono tutte le azioni eseguite dal servizio di provisioning sull'app DocuSign.
Per altre informazioni sulla lettura dei log di provisioning di Microsoft Entra, vedere Creazione di report sul provisioning automatico degli account utente.
Suggerimenti per la risoluzione dei problemi
- Per eseguire il provisioning del profilo di un ruolo o di autorizzazione per un utente in DocuSign, è possibile usare un'espressione nei mapping degli attributi usando le funzioni switch e singleAppRoleAssignment. Ad esempio, l'espressione seguente eseguirà il provisioning dell'ID "8032066" quando un utente ha il ruolo "Amministratore DS" assegnato in Microsoft Entra ID. Non eseguirà il provisioning di alcun profilo di autorizzazione se all'utente non è assegnato un ruolo sul lato MICROSOFT Entra ID. È possibile recuperare l'ID dal portale DocuSign.
Switch(SingleAppRoleAssignment([appRoleAssignments])," ", "DS Admin", "8032066")