Documo configureren voor automatische voorziening van gebruikers met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Documo als Microsoft Entra ID om automatische toewijzing van gebruikers te configureren. Wanneer geconfigureerd, richt Microsoft Entra ID automatisch gebruikers en groepen in en verwijdert ze in Documo- met behulp van de Microsoft Entra-inrichtingsservice. Voor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, zie Automatiseren van het beheren en ontzeggen van toegang tot SaaS-applicaties met Microsoft Entra ID.

Ondersteunde mogelijkheden

Voorwaarden

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

• Een Microsoft Entra-gebruikersaccount met een actief abonnement. Als u dat nog niet hebt, kunt u gratis een account maken.
• Een van de volgende rollen:
  • Toepassingsbeheerder
  • cloudtoepassingsbeheerder
  • applicatie-eigenaar.

• Een Documo-account met API-toegang.
• Een gebruikersaccount in Documo met beheerdersmachtigingen.

Stap 1: Uw inrichtingsimplementatie plannen

1. Leer meer over hoe de inrichtingsservice werkt.
2. Bepaal wie binnen het toepassingsgebied van valt voor de voorziening van.
3. Bepaal welke gegevens u wilt koppelen tussen Microsoft Entra ID en Documo.

Stap 2: Documo configureren ter ondersteuning van inrichting met Microsoft Entra-id

1. Genereer een API-sleutel voor het inrichten van Microsoft Entra.
2. Zoek en onthoud uw API-URL. De standaard-API-URL is https://api.documo.com. Als u een aangepast Documo-API-domein hebt, kunt u ernaar verwijzen op het domeintabblad van de pagina Met de huisstijlinstellingen van Documo.

Stap 3: Documo toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Voeg Documo toe vanuit de Microsoft Entra toepassingsgalerij om te beginnen met het beheer van de provisioning naar Documo. Als u Documo eerder hebt ingesteld voor Single Sign-On (SSO), kunt u dezelfde applicatie gebruiken. We raden u echter aan om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie. Meer informatie over het toevoegen van een applicatie uit de galerie vindt u hier.

Stap 4: Bepaal wie binnen de scope van voorzieningen valt.

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie is ingericht op basis van toewijzing aan de toepassing of op basis van kenmerken van de gebruiker of groep. Als u ervoor kiest om te bepalen wie voor uw app is ingericht op basis van toewijzing, kunt u de stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen is ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfiltergebruiken.

• Begin klein. Test met een kleine set gebruikers en groepen voordat ze voor iedereen worden uitgerold. Wanneer het bereik voor inrichting is ingesteld op toegewezen gebruikers en groepen, kunt u dit beheren door een of twee gebruikers of groepen toe te wijzen aan de app. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een attribuut-gebaseerd bereikfilter opgeven.

• Als u extra rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Stap 5: Automatische gebruikersinrichting configureren voor Documo

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en/of groepen in Documo te maken, bij te werken en uit te schakelen op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.

De automatische gebruikersvoorziening configureren voor Documo in Microsoft Entra ID:

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een Cloudtoepassingsbeheerder.

2. Navigeer naar Entra ID>Enterprise apps

   

3. Selecteer Documoin de lijst met toepassingen.

   

4. Selecteer het tabblad Provisioning.

   

5. Stel de inrichtingsmodus in op Automatisch.

   

6. Voer in de sectie Beheerdersreferenties uw Documo Tenant-URL en geheime tokenin.

   • Uw tenant-URL is de API-URL die u in stap 2 hebt voorbereid, waarbij /scim/v2 aan het einde is toegevoegd. De waarde voor degenen zonder aangepaste domeinen moet worden https://api.documo.com/scim/v2.

   • Kopieer en plak in het veld Geheim Token de API-sleutel die je in stap 2 hebt voorbereid. Selecteer Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met Documo. Als de verbinding mislukt, controleert u of uw Documo-account beheerdersmachtigingen heeft en probeer het opnieuw.

   

7. Voer in het veld Meldings-e-mail het e-mailadres in van een persoon of groep die de meldingen voor inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt selectievakje.

   

8. Selecteer opslaan.

9. Selecteer in de sectie Toewijzingen de optie Synchroniseer Microsoft Entra-gebruikers met Documo.

10. Controleer in de sectie Kenmerktoewijzingen de gebruikerskenmerken die vanuit Microsoft Entra-id met Documo worden gesynchroniseerd. De attributen die zijn geselecteerd als overeenkomende eigenschappen, worden gebruikt om de gebruikersaccounts in Documo te koppelen tijdens updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Documo-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om wijzigingen door te voeren.

    Attribuut	Typologie	Ondersteund voor filteren
    gebruikersnaam	Snaar	✓
    actief	Booleaans
    naam.voornaam	Snaar
    naam.achternaam	Snaar
    roles[primary eq "Waar"].value	Snaar

11. Raadpleeg artikel over bereikfiltersvoor de volgende instructies om bereikfilters te configureren.

12. Als u de Microsoft Entra-inrichtingsservice voor Documo wilt inschakelen, wijzigt u de Inrichtingsstatus in Op in de sectie Instellingen.

    

13. Definieer de gebruikers en/of groepen die u aan Documo wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen.

    

14. Als u klaar bent om te configureren, selecteert u Opslaan.

    

Met deze bewerking wordt de eerste synchronisatiecyclus gestart van alle gebruikers en groepen die zijn gedefinieerd in Bereik in de sectie Instellingen. De eerste cyclus duurt langer dan volgende cycli, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd.

Stap 6: Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

1. Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
2. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
3. Als de implementatieconfiguratie in een ongezonde staat lijkt te verkeren, wordt de toepassing in quarantaine geplaatst. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Meer middelen

• Het inrichten van gebruikersaccounts voor enterprise-apps beheren
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over inrichtingsactiviteiten