Esercitazione: Configurazione di DocuSign per il provisioning utentiTutorial: Configuring DocuSign for User Provisioning

Questa esercitazione descrive le procedure da eseguire in DocuSign e Azure AD per effettuare automaticamente il provisioning e il deprovisioning degli account utente da Azure AD a DocuSign.The objective of this tutorial is to show you the steps you need to perform in DocuSign and Azure AD to automatically provision and de-provision user accounts from Azure AD to DocuSign.

PrerequisitiPrerequisites

Per lo scenario descritto in questa esercitazione si presuppone che l'utente disponga di quanto segue:The scenario outlined in this tutorial assumes that you already have the following items:

  • Un tenant di Azure Active Directory.An Azure Active directory tenant.
  • Una sottoscrizione di DocuSign abilitata per l'accesso Single Sign-On.A DocuSign single sign-on enabled subscription.
  • Un account utente in DocuSign con autorizzazioni di amministratore di team.A user account in DocuSign with Team Admin permissions.

Assegnazione di utenti a DocuSignAssigning users to DocuSign

Per determinare gli utenti che dovranno ricevere l'accesso alle app selezionate, Azure Active Directory usa il concetto delle "assegnazioni".Azure Active Directory uses a concept called "assignments" to determine which users should receive access to selected apps. Nel contesto del provisioning automatico degli account utente, vengono sincronizzati solo gli utenti e i gruppi che sono stati "assegnati" a un'applicazione in Azure AD.In the context of automatic user account provisioning, only the users and groups that have been "assigned" to an application in Azure AD are synchronized.

Prima di configurare e abilitare il servizio di provisioning, è necessario stabilire quali utenti e/o gruppi in Azure AD rappresentano gli utenti che devono accedere all'app DocuSign.Before configuring and enabling the provisioning service, you need to decide what users and/or groups in Azure AD represent the users who need access to your DocuSign app. Dopo aver stabilito questo, è possibile assegnare tali utenti all'app DocuSign seguendo le istruzioni riportate nell'articolo seguente:Once decided, you can assign these users to your DocuSign app by following the instructions here:

Assegnare un utente o gruppo a un'app aziendaleAssign a user or group to an enterprise app

Suggerimenti importanti per l'assegnazione di utenti a DocuSignImportant tips for assigning users to DocuSign

  • È consigliabile assegnare un singolo utente di Azure AD a DocuSign per testare la configurazione del provisioning.It is recommended that a single Azure AD user is assigned to DocuSign to test the provisioning configuration. È possibile assegnare utenti aggiuntivi in un secondo momento.Additional users may be assigned later.

  • Quando si assegna un utente a DocuSign, è necessario selezionare un ruolo utente valido.When assigning a user to DocuSign, you must select a valid user role. Il ruolo "Default Access" (Accesso predefinito) non è applicabile per il provisioning.The "Default Access" role does not work for provisioning.

Nota

Azure Active Directory non supporta il provisioning di gruppi con l'applicazione Docusign. È possibile eseguire il provisioning solo degli utenti.Azure AD does not support group provisioning with the Docusign application, only users can be provisioned.

Abilitare il provisioning utentiEnable User Provisioning

Questa sezione illustra la connessione di Azure AD all'API per il provisioning degli account utente di DocuSign e la configurazione del servizio di provisioning per la creazione, l'aggiornamento e la disabilitazione degli account utente assegnati in DocuSign in base all'assegnazione di utenti e gruppi in Azure AD.This section guides you through connecting your Azure AD to DocuSign's user account provisioning API, and configuring the provisioning service to create, update, and disable assigned user accounts in DocuSign based on user and group assignment in Azure AD.

Suggerimento

Si può anche scegliere di abilitare l'accesso Single Sign-On basato su SAML per DocuSign, seguendo le istruzioni disponibili nel portale di Azure.You may also choose to enabled SAML-based Single Sign-On for DocuSign, following the instructions provided in Azure portal. L'accesso Single Sign-On può essere configurato indipendentemente dal provisioning automatico, nonostante queste due funzionalità siano complementari.Single sign-on can be configured independently of automatic provisioning, though these two features compliment each other.

Per configurare il provisioning degli account utente:To configure user account provisioning:

Questa sezione descrive come abilitare il provisioning degli account utente di Active Directory in DocuSign.The objective of this section is to outline how to enable user provisioning of Active Directory user accounts to DocuSign.

  1. Nel portale di Azure passare alla sezione Azure Active Directory > App aziendali > Tutte le applicazioni.In the Azure portal, browse to the Azure Active Directory > Enterprise Apps > All applications section.

  2. Se si è già configurato DocuSign per l'accesso Single Sign-On, cercare l'istanza di DocuSign usando il campo di ricerca.If you have already configured DocuSign for single sign-on, search for your instance of DocuSign using the search field. In caso contrario, selezionare Aggiungi e cercare DocuSign nella raccolta di applicazioni.Otherwise, select Add and search for DocuSign in the application gallery. Selezionare DocuSign nei risultati della ricerca e aggiungerlo all'elenco delle applicazioni.Select DocuSign from the search results, and add it to your list of applications.

  3. Selezionare l'istanza di DocuSign e quindi la scheda Provisioning.Select your instance of DocuSign, then select the Provisioning tab.

  4. Impostare Modalità di provisioning su Automatico.Set the Provisioning Mode to Automatic.

    provisioning

  5. Nella sezione Credenziali di amministratore specificare le impostazioni di configurazione seguenti:Under the Admin Credentials section, provide the following configuration settings:

    a.a. Nella casella di testo Nome utente amministratore digitare un nome di account DocuSign che abbia il profilo Amministratore di sistema assegnato in DocuSign.com.In the Admin User Name textbox, type a DocuSign account name that has the System Administrator profile in DocuSign.com assigned.

    b.b. Nella casella di testo Password amministratore digitare la password per questo account.In the Admin Password textbox, type the password for this account.

  6. Nel portale di Azure fare clic su Test connessione per verificare che Azure AD possa connettersi all'app DocuSign.In the Azure portal, click Test Connection to ensure Azure AD can connect to your DocuSign app.

  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.In the Notification Email field, enter the email address of a person or group who should receive provisioning error notifications, and check the checkbox.

  8. Fare clic su Salva.Click Save.

  9. Nella sezione Mapping selezionare Synchronize Azure Active Directory Users to DocuSign (Sincronizza utenti di Azure Active Directory in DocuSign).Under the Mappings section, select Synchronize Azure Active Directory Users to DocuSign.

  10. Nella sezione Mapping degli attributi esaminare gli attributi utente che vengono sincronizzati da Azure AD a DocuSign.In the Attribute Mappings section, review the user attributes that are synchronized from Azure AD to DocuSign. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in DocuSign per le operazioni di aggiornamento.The attributes selected as Matching properties are used to match the user accounts in DocuSign for update operations. Selezionare il pulsante Salva per eseguire il commit delle modifiche.Select the Save button to commit any changes.

  11. Per abilitare il servizio di provisioning di Azure AD per DocuSign, impostare Stato del provisioning su nella sezione Impostazioni.To enable the Azure AD provisioning service for DocuSign, change the Provisioning Status to On in the Settings section

  12. Fare clic su Salva.Click Save.

Viene avviata la sincronizzazione iniziale di tutti gli utenti assegnati a DocuSign nella sezione Utenti e gruppi.It starts the initial synchronization of any users assigned to DocuSign in the Users and Groups section. La sincronizzazione iniziale richiede più tempo delle sincronizzazioni successive, che saranno eseguite circa ogni 20 minuti per tutto il tempo che il servizio è in esecuzione.The initial sync takes longer to perform than subsequent syncs, which occur approximately every 20 minutes as long as the service is running. È possibile usare la sezione Dettagli sincronizzazione per monitorare lo stato di avanzamento e selezionare i collegamenti ai report delle attività di provisioning, che descrivono tutte le azioni eseguite dal servizio di provisioning sull'app DocuSign.You can use the Synchronization Details section to monitor progress and follow links to provisioning activity reports, which describe all actions performed by the provisioning service on your DocuSign app.

È ora possibile creare un account di test.You can now create a test account. Attendere 20 minuti per verificare che l'account sia stato sincronizzato con DocuSign.Wait for up to 20 minutes to verify that the account has been synchronized to DocuSign.

Risorse aggiuntiveAdditional resources