Esercitazione: Integrazione dell'accesso Single Sign-On di Microsoft Entra con DocuSign

In questa esercitazione si apprenderà come integrare DocuSign con Microsoft Entra ID. Integrando DocuSign con Microsoft Entra ID, è possibile:

  • Usare Microsoft Entra ID per controllare chi può accedere a DocuSign.
  • Abilitare l'accesso automatico a DocuSign per gli utenti tramite gli account Microsoft Entra.
  • È possibile gestire gli account in un'unica posizione centrale: il portale di Azure.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Sottoscrizione di DocuSign abilitata per l'accesso Single Sign-On (SSO).
  • Controllare il DNS del dominio. Questa operazione è necessaria per richiedere il dominio in DocuSign.

Nota

Questa integrazione è disponibile anche per l'uso dall'ambiente Microsoft Entra US Government Cloud. È possibile trovare questa applicazione nella raccolta di applicazioni cloud Microsoft Entra US Government e configurarla nello stesso modo in cui si esegue dal cloud pubblico.

Descrizione dello scenario

In questa esercitazione si configurerà e si testerà Microsoft Entra SSO in un ambiente di test per verificare che:

Per configurare l'integrazione di DocuSign in Microsoft Entra ID, è necessario aggiungere DocuSign dalla raccolta all'elenco di app SaaS gestite:

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare DocuSign nella casella di ricerca.
  4. Selezionare DocuSign nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Office 365 sono disponibili qui.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per DocuSign

Configurare e testare l'accesso SSO di Microsoft Entra con DocuSign usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente corrispondente in DocuSign.

Per configurare e testare l'accesso SSO di Microsoft Entra con DocuSign, seguire questa procedura:

  1. Configurare l'accesso Single Sign-On di Microsoft Entra in modo che gli utenti possano usare questa funzionalità.
    1. Creare un utente di test di Microsoft Entra per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
    2. Assegnare l'utente di test di Microsoft Entra per abilitare B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di DocuSign: per configurare le impostazioni dell'accesso Single Sign-On sul lato applicazione.
    1. Creare un utente di test di DocuSign per generare una controparte di B.Simon in DocuSign collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso SSO per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Microsoft Entra

Per abilitare l'accesso Single Sign-On di Microsoft Entra nel portale di Azure, seguire questa procedura:

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.

  2. Passare alla pagina di integrazione dell'applicazione DocuSign delle applicazioni>Identity>Applications>Enterprise, individuare la sezione Gestione e quindi selezionare Single Sign-On.

  3. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

  4. Nella pagina Configura l'accesso Single Sign-On con SAML fare clic sull'icona della matita relativa a Configurazione SAML di base per modificare le impostazioni.

    Edit Basic SAML Configuration

  5. Nella sezione Configurazione SAML di base seguire questa procedura:

    a. Nella casella di testo Identificatore (ID entità) digitare un URL usando il criterio seguente:

    https://<subdomain>.docusign.com/organizations/<OrganizationID>/saml2

    b. Nella casella di testo URL di risposta digitare un URL corrispondente al modello seguente:

    URL di risposta
    Production:
    https://<subdomain>.docusign.com/organizations/<OrganizationID>/saml2/login/<IDPID>
    https://<subdomain>.docusign.net/SAML/
    Istanza qa :
    https://<SUBDOMAIN>.docusign.com/organizations/saml2

    c. Nella casella di testo URL di accesso digitare l'URL usando il modello seguente:

    https://<subdomain>.docusign.com/organizations/<OrganizationID>/saml2/login/sp/<IDPID>

    Nota

    Questi valori tra parentesi angolari sono segnaposto. Sostituirli con i valori nell'identificatore effettivo, nell'URL di risposta e nell'URL di accesso. Per informazioni dettagliate, vedere la sezione relativa a "View SAML 2.0 Endpoints" (Visualizza endpoint SAML 2.0) più avanti in questa esercitazione.

  6. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare Certificato (Base64). Selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    The Certificate download link

  7. Nella sezione Configura DocuSign copiare gli URL appropriati in base alle esigenze.

    Copy configuration URLs

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un utente Amministrazione istrator.
  2. Passare a Utenti>identità>Tutti gli utenti.
  3. Selezionare Nuovo utente Crea nuovo utente> nella parte superiore della schermata.
  4. Nelle proprietà Utente seguire questa procedura:
    1. Nel campo Nome visualizzato immettere B.Simon.
    2. Nel campo Nome entità utente immettere .username@companydomain.extension Ad esempio, B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
    4. Selezionare Rivedi e crea.
  5. Seleziona Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione si concederà a B.Simon l'accesso a DocuSign in modo che questo utente possa usare l'accesso Single Sign-On di Azure.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>DocuSign.
  3. Nella pagina di panoramica dell'app individuare la sezione Gestione e selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente e quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
  5. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon dall'elenco Utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  6. Se si prevede che agli utenti venga assegnato un ruolo, è possibile selezionarlo nell'elenco a discesa Selezionare un ruolo. Se per questa app non è stato configurato alcun ruolo, il ruolo selezionato è "Accesso predefinito".
  7. Nella finestra di dialogo Aggiungi assegnazione selezionare il pulsante Assegna.

Configurare l'accesso Single Sign-On di DocuSign

  1. In un'altra finestra del Web browser accedere al sito aziendale di DocuSign come amministratore

  2. Nell'angolo superiore sinistro della pagina selezionare l'icona di avvio dell'app (9 puntini) e quindi selezionare Amministrazione.

    Screenshot of Go to Admin under Profile.

  3. Nella pagina delle soluzioni di dominio selezionare Domains (Domini).

    Screenshot of Select_Domains.

  4. Nella sezione Domains (Domini) selezionare CLAIM DOMAIN (RICHIEDI DOMINIO).

    Screenshot of Claim_domain.

  5. Nella finestra di dialogo Claim a Domain (Richiedi un dominio) digitare il dominio aziendale nella casella Domain Name (Nome dominio) e quindi selezionare CLAIM (RICHIEDI). Verificare il dominio e assicurarsi che lo stato sia attivo.

    Screenshot of Claim a Domain/Domain Name dialog.

  6. Nella sezione Domini selezionare Ottieni token di convalida del nuovo dominio aggiunto nell'elenco di attestazioni.

    Screenshot of pending_Identity_provider.

  7. Copiare il token TXT

    Screenshot of TXT_token.

  8. Configurare il provider DNS con il token TXT seguendo questa procedura:

    a. Passare alla pagina di gestione dei record DNS del dominio. b. Aggiungere un nuovo record TXT. c. Nome: @ o * d. Testo: incollare il valore del token TXT copiato dal passaggio precedente. e. TTL: valore predefinito o 1 ora / 3600 secondi

  9. Nella pagina delle soluzioni di dominio selezionare Identity Providers (Provider di identità).

    Screenshot of Identity Providers option.

  10. Nella sezione Identity Providers (Provider di identità) selezionare ADD IDENTITY PROVIDER (AGGIUNGI PROVIDER DI IDENTITÀ).

    Screenshot of Add Identity Provider option.

  11. Nella pagina Identity Provider Settings (Impostazioni provider di identità) seguire questa procedura:

    a. Nella casella Nome personalizzato digitare un nome univoco per la configurazione. Non usare spazi.

    Screenshot of name_Identity_provider.

    b. Nella casella Identity Provider Issuer (Autorità di certificazione provider di identità) incollare il valore dell'identificatore Microsoft Entra copiato.

    Screenshot of urls_Identity_provider.

    c. Nella casella Identity Provider Login URL (URL di accesso del provider di identità) incollare il valore di URL di accesso copiato dal portale di Azure.

    d. Nella casella Identity Provider Logout URL (URL di disconnessione provider di identità) incollare il valore di URL disconnessione copiato dal portale di Azure.

    Screenshot of settings_Identity_provider.

    e. Per Send AuthN request by (Invia richiesta di autenticazione da) selezionare POST.

    f. Per Send logout request by (Invia richiesta di disconnessione da) selezionare GET.

    g. Nella sezione Custom Attribute Mapping (Mapping attributi personalizzati) selezionare ADD NEW MAPPING (AGGIUNGI NUOVO MAPPING).

    Screenshot of Custom Attribute Mapping UI.

    h. Scegliere il campo da mappare all'attestazione Microsoft Entra. In questo esempio viene eseguito il mapping dell'attestazione emailaddress al valore di http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress. Si tratta del nome dell'attestazione predefinito dell'ID Microsoft Entra per l'attestazione di posta elettronica. Selezionare SAVE (SALVA).

    Screenshot of Custom Attribute Mapping fields.

    Nota

    Usare l'identificatore utente appropriato per eseguire il mapping dell'utente da Microsoft Entra ID al mapping utente DocuSign. Selezionare il campo corretto e immettere il valore appropriato in base alle impostazioni dell'organizzazione. L'impostazione Mapping attributi personalizzati non è obbligatoria.

    i. Nella sezione Identity Provider Certificates (Certificati provider di identità) selezionare ADD CERTIFICATE (AGGIUNGI CERTIFICATO), caricare il certificato scaricato da portale di Azure e selezionare SALVA.

    Screenshot of Identity Provider Certificates/Add Certificate.

    j. Nella sezione Identity Providers (Provider di identità) fare clic su ACTIONS (AZIONI) e quindi su Endpoints (Endpoint).

    Screenshot of Identity Providers/Endpoints.

    k. Nella sezione View SAML 2.0 Endpoints (Visualizza endpoint SAML 2.0) del portale di amministrazione di DocuSign seguire questa procedura:

    Screenshot of View SAML 2.0 Endpoints.

    1. Copiare l'URL dell'autorità di certificazione del provider di servizi e incollarlo nella casella Identificatore nella sezione Configurazione SAML di base.

    2. Copiare l'URL del servizio consumer di asserzione del provider di servizi e incollarlo nella casella URL di risposta nella sezione Configurazione SAML di base.

    3. Copiare l'URL di accesso del provider di servizi e incollarlo nella casella URL di accesso nella sezione Configurazione SAML di base. Alla fine dellURL di accesso del provider di servizi si otterrà il valore di IDPID.

    4. Selezionare Chiudi.

Creare l'utente di test di DocuSign

In questa sezione viene creato un utente di nome B.Simon in DocuSign. DocuSign supporta il provisioning utenti JIT, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in DocuSign, ne viene creato uno nuovo dopo l'autenticazione.

Nota

Per creare un utente manualmente, contattare il team di supporto di DocuSign.

Testare l'accesso SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

  • Fare clic su Test this application (Testa questa applicazione), verrà eseguito il reindirizzamento all'URL di accesso di DocuSign in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di DocuSign e avviare il flusso di accesso da questa posizione.

  • È possibile usare App personali Microsoft. Quando si fa clic sul riquadro di DocuSign nel App personali, si dovrebbe accedere automaticamente all'applicazione DocuSign per cui si è configurato l'accesso SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato DocuSign, è possibile applicare il controllo sessione che consente di proteggere in tempo reale l'esfiltrazione e l'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo sessione con app Microsoft Defender per il cloud.