Zelfstudie: Integratie van eenmalige aanmelding van Microsoft Entra met DocuSign

  • Artikel

In deze zelfstudie leert u hoe u DocuSign integreert met Microsoft Entra ID. Wanneer u DocuSign integreert met Microsoft Entra ID, kunt u het volgende doen:

  • Gebruik Microsoft Entra ID om te bepalen wie toegang heeft tot DocuSign.
  • Schakel automatische aanmelding in bij DocuSign voor uw gebruikers via hun Microsoft Entra-account.
  • Uw accounts op één centrale locatie beheren: de Azure-portal.

Vereisten

U hebt het volgende nodig om aan de slag te gaan:

  • Een Microsoft Entra-abonnement. Als u geen abonnement hebt, kunt u een gratis account krijgen.
  • Een DocuSign-abonnement waarvoor eenmalige aanmelding (SSO) is ingeschakeld.
  • Het beheer over uw domein-DNS. Dat is nodig om het domein op DocuSign te claimen.

Notitie

Deze integratie is ook beschikbaar voor gebruik vanuit de Microsoft Entra US Government Cloud-omgeving. U vindt deze toepassing in de Microsoft Entra US Government Cloud Application Gallery en configureert deze op dezelfde manier als vanuit de openbare cloud.

Beschrijving van scenario

In deze zelfstudie configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving om te controleren of:

  • DocuSign ondersteunt eenmalige aanmelding die door de serviceprovider SP is gestart.

  • DocuSign biedt ondersteuning voor het just-in-time inrichten van gebruikers.

  • DocuSign biedt ondersteuning voor het automatisch inrichten van gebruikers.

Als u de integratie van DocuSign in Microsoft Entra ID wilt configureren, moet u DocuSign vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
  3. Typ DocuSign in het zoekvak in de sectie Toevoegen uit de galerie.
  4. Selecteer DocuSign in het resultatenvenster en voeg de app toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.

U kunt ook de wizard Enterprise App Configuration gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en ook de configuratie van eenmalige aanmelding doorlopen. Hier vindt u meer informatie over O365-wizards.

Eenmalige aanmelding van Microsoft Entra voor DocuSign configureren en testen

Configureer en test eenmalige aanmelding van Microsoft Entra met DocuSign met behulp van een testgebruiker met de naam B.Simon. Eenmalige aanmelding werkt alleen als u een koppelingsrelatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in DocuSign.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra met DocuSign te configureren en te testen:

  1. Configureer eenmalige aanmelding van Microsoft Entra zodat uw gebruikers deze functie kunnen gebruiken.
    1. Maak een Microsoft Entra-testgebruiker om eenmalige aanmelding van Microsoft Entra te testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen gebruik te maken van eenmalige aanmelding van Microsoft Entra.
  2. Configureer eenmalige aanmelding bij DocuSign om de instellingen voor eenmalige aanmelding aan de toepassingszijde te configureren.
    1. Maak een DocuSign-testgebruiker om een tegenhanger van B.Simon te genereren in DocuSign die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
  3. Eenmalige aanmelding testen om te controleren of de configuratie werkt.

Eenmalige aanmelding voor Microsoft Entra configureren

Volg deze stappen om eenmalige aanmelding van Microsoft Entra in te schakelen in Azure Portal:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar de integratiepagina van de DocuSign-toepassing voor Identity>Applications>Enterprise-toepassingen>, zoek de sectie Beheren en selecteer vervolgens eenmalige aanmelding.

  3. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

  4. Selecteer op de pagina Eenmalige aanmelding instellen met SAML het potloodpictogram voor Standaard-SAML-configuratie om de instellingen te bewerken.

    Standaard SAML-configuratie bewerken

  5. In de sectie Standaard SAML-configuratie voert u de volgende stappen uit:

    a. In het tekstvak Id (Entiteits-id) typt u een URL met het volgende patroon:

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

    b. In het tekstvak Antwoord-URL typt u een URL in een van de volgende notaties:

    Antwoord-URL
    Productie:
    https://<subdomain>.docusign.com/organizations/<OrganizationID>/saml2/login/<IDPID>
    https://<subdomain>.docusign.net/SAML/
    QA-exemplaar:
    https://<SUBDOMAIN>.docusign.com/organizations/saml2

    c. In het tekstvak Aanmeldings-URL typt u een URL met het volgende patroon:

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

    Notitie

    Deze waarden tussen punthaken zijn tijdelijke aanduidingen. Vervang ze door de waarden in de werkelijke id, Antwoord-URL en aanmeldings-URL. Deze details worden uitgelegd in de sectie 'SAML 2.0-eindpunten bekijken' verderop in deze zelfstudie.

  6. Ga naar de pagina Eenmalige aanmelding met SAML instellen en zoek in de sectie SAML-handtekeningcertificaat de optie Certificaat (Base64). Selecteer Downloaden om het certificaat te downloaden en op uw computer op te slaan.

    De link om het certificaat te downloaden

  7. In de sectie Set up DocuSign kopieert u de juiste URL('s) op basis van uw behoeften.

    Configuratie-URL's kopiëren

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruiker Beheer istrator.
  2. Blader naar Identiteit>Gebruikers>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker Nieuwe gebruiker> maken bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld Weergavenaam de tekst in B.Simon.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. Bijvoorbeeld: B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Controleren + maken.
  5. Selecteer Maken.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie verleent u B. Simon toegang tot DocuSign, zodat deze gebruiker de eenmalige aanmelding van Azure kan gebruiken.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Identity>Applications Enterprise-toepassingen>>DocuSign.
  3. Zoek op de overzichtspagina van de app de sectie Beheren en selecteer Gebruikers en groepen.
  4. Selecteer Gebruiker toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
  5. Selecteer in het dialoogvenster Gebruikers en groepen de naam B.Simon in de lijst Gebruikers en klik op de knop Selecteren onderaan het scherm.
  6. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
  7. Selecteer in het dialoogvenster Toewijzing toevoegen de knop Toewijzen.

DocuSign SSO configureren

  1. Meld u in een ander browservenster als beheerder aan bij uw DocuSign-bedrijfssite

  2. Selecteer in de linkerbovenhoek van de pagina het startprogramma voor apps (9 puntjes) en selecteer vervolgens Beheer.

    Schermopname van Go to Admin onder profiel.

  3. Selecteer Domains (Domeinen) op de pagina met domeinoplossingen.

    Schermopname van Select_Domains.

  4. Selecteer in de sectie Domains (Domeinen) CLAIM DOMAIN (Domein claimen).

    Schermopname van Claim_domain.

  5. Typ in het dialoogvenster Claim a Domain (Een domein claimen) in het vak Domain Name (Domeinnaam) de domeinnaam van uw bedrijf en selecteer CLAIM. Zorg ervoor dat u verifieert of het domein bestaat en of de status actief is.

    Schermopname van dialoogvenster Een domein claimen/Domeinnaam.

  6. Selecteer in de sectie Domeinende optie Validatietoken ophalen van nieuw domein dat is toegevoegd in de claimlijst.

    Schermopname van pending_Identity_provider.

  7. Kopieer het TXT-token

    Schermopname van TXT_token.

  8. Configureer uw DNS-provider met het TXT-token door de stappen hieronder uit te voeren:

    a. Navigeer naar pagina DNS-recordbeheer van uw domein.

    b. Voeg een nieuw TXT-record toe.

    c. Naam: @ of *.

    d. Tekst: plak hier de TXT-tokenwaarde die u uit de vorige stap hebt gekopieerd.

    e. TTL: Standaard of 1 uur / 3.600 seconden.

  9. Klik in het linkernavigatievenster op Id-providers in ACCESS MANAGEMENT.

    Schermopname van de optie Id-providers.

  10. Selecteer in de sectie Identity ProvidersADD IDENTITY PROVIDER (Id-provider toevoegen).

    Schermopname van de optie Id-provider toevoegen.

  11. Voer de volgende stappen uit op de pagina Identity Provider Settings (id-providerinstellingen):

    a. Typ in het tekstvak Aangepaste naam een unieke naam voor de configuratie. Gebruik geen spaties.

    Schermopname van name_Identity_provider.

    b. Plak in het vak Issuer van id-provider de waarde van de Microsoft Entra-id die u hebt gekopieerd.

    Schermopname van urls_Identity_provider.

    c. Plak in het vak Identity Provider Login URL (Aanmeldings-URL id-provider) de waarde van de Aanmeldings-URL die u hebt gekopieerd uit de Azure-portal.

    d. Plak in het vak Aanmeldings-URL id-provider de waarde van de URL voor afmelden die u hebt gekopieerd uit de Azure-portal.

    Schermopname van settings_Identity_provider.

    e. Selecteer POST bij Send AuthN request by (Verificatieaanvraag verzenden per).

    f. Selecteer GET bij Send AuthN request by (Afmeldingsaanvraag verzenden per).

    g. Selecteer ADD NEW MAPPING (Nieuwe toewijzing toevoegen) in de sectie Custom Attribute Mapping (Aangepaste attribuuttoewijzing).

    Schermopname van UI voor aangepaste attribuuttoewijzing.

    h. Kies het veld dat u wilt toewijzen aan de Microsoft Entra-claim. In dit voorbeeld wordt de claim emailaddress toegewezen aan de waarde http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress. Dit is de standaardclaimnaam van Microsoft Entra ID voor de e-mailclaim. Selecteer SAVE (Opslaan).

    Schermopname van velden voor aangepaste attribuuttoewijzing.

    Notitie

    Gebruik de juiste gebruikers-id om de gebruiker van Microsoft Entra ID toe te wijzen aan docuSign-gebruikerstoewijzing. Selecteer het juiste veld en voer de juiste waarde in op basis van de instellingen van uw organisatie. De instelling Aangepaste attribuuttoewijzing is niet verplicht.

    i. Selecteer IN de sectie Identity Provider Certificates de optie ADD CERTIFICATE, upload het certificaat dat u hebt gedownload uit de Azure-portal en selecteer SAVE.

    Schermopname van Id-providercertificaten/Certificaat toevoegen.

    j. Selecteer in de sectie Identity Providers (Id-providers) ACTIONS (Acties) en vervolgens Endpoints (Eindpunten).

    Schermopname van de optie Id-providers/Eindpunten.

    k. Voer in de sectie SAML 2.0-eindpunten bekijken van de beheerportal van DocuSign de volgende stappen uit:

    Schermopname van SAML 2.0-eindpunten bekijken.

    1. Kopieer de URL van de serviceproviderverlener en plak deze in het vak Id in de sectie Standaard SAML-configuratie.

    2. Kopieer de URL van de Service Provider Assertion Consumer Service en plak deze in het vak Antwoord-URL in de sectie Standaard SAML-configuratie.

    3. Kopieer de aanmeldings-URL van de serviceprovider en plak deze in het vak Aanmeldings-URL in de sectie Standaard SAML-configuratie. Aan het einde van de Service Provider Login URL krijgt u de IDPID-waarde.

    4. Selecteer Sluiten.

DocuSign-testgebruiker maken

In deze sectie wordt een gebruiker met de naam B.Simon gemaakt in DocuSign. DocuSign biedt ondersteuning voor just-In-Time-inrichting van gebruikers, die standaard is ingeschakeld. Er is geen actie-item voor u in deze sectie. Als er nog geen gebruiker in DocuSign bestaat, wordt er een nieuwe gemaakt na authenticatie.

Notitie

Neem contact op met het ondersteuningsteam van DocuSign als u handmatig een gebruiker moet maken.

Eenmalige aanmelding testen

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

  • Klik op Deze toepassing testen. U wordt omgeleid naar de aanmeldings-URL van DocuSign, waar u de aanmeldingsstroom kunt initiëren.

  • Ga rechtstreeks naar de aanmeldings-URL van DocuSign en initieer de aanmeldingsstroom daar.

  • U kunt Microsoft Mijn apps gebruiken. Wanneer u in Mijn apps op de tegel DocuSign klikt, wordt u automatisch aangemeld bij de instantie van DocuSign waarvoor u eenmalige aanmelding hebt ingesteld. Zie Introduction to My Apps (Inleiding tot Mijn apps) voor meer informatie over Mijn apps.

Volgende stappen

Zodra u DocuSign hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.