Xledger configureren voor automatische provisioning van gebruikers met Microsoft Entra ID

In dit artikel beschrijven we de stappen die u moet uitvoeren in zowel Xledger als Microsoft Entra ID om automatische gebruikersverzorging te configureren. Wanneer deze is geconfigureerd, richt Microsoft Entra ID automatisch gebruikers en groepen in en heft deze weer op voor Xledger met behulp van de Microsoft Entra inrichtingsservice. Raadpleeg Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID voor belangrijke informatie over wat deze service doet, hoe deze werkt, en veelgestelde vragen.

Ondersteunde mogelijkheden

Vereiste voorwaarden

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

• Een Microsoft Entra tenant
• Een van de volgende rollen: Toepassingsbeheerder, Cloudtoepassingsbeheerder of Toepassingseigenaar.
• Een gebruikersaccount in Xledger met beheerdersmachtigingen.

Stap 1: Het plannen van uw provisioning-implementatie

1. Meer informatie over hoe de leveringsservice werkt.
2. Bepaal wie binnen de reikwijdte van de voorziening valt.
3. Bepaal welke gegevens moeten worden gekoppeld tussen Microsoft Entra ID en Xledger.

Stap 2: Xledger configureren ter ondersteuning van inrichting met Microsoft Entra ID

1. Meld u aan bij Xledger met de rol domeinbeheerder (of vergelijkbaar) en navigeer naar toegangstokens voor > toegang tot het beheersysteem>.

2. Genereer een geheime token en noteer deze

   

3. Maak een aantekening van de tenant-URL

   

Deze waarden worden gebruikt op het tabblad Inrichten van uw Xledger-toepassing. (Stap 5)

Stap 3: Xledger toevoegen vanuit de Microsoft Entra toepassingsgalerie

Voeg Xledger toe vanuit de Microsoft Entra applicatiegalerij om te beginnen met het beheren van voorzieningen naar Xledger. Als u Xledger eerder hebt ingesteld voor eenmalige aanmelding, kunt u dezelfde toepassing gebruiken. Het is echter raadzaam een afzonderlijke app te maken wanneer u de integratie voor het eerst test. Meer informatie over het toevoegen van een toepassing vanuit 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 bereikfilter gebruiken.

• Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. 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 bereikfilter op basis van kenmerken opgeven.

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

Stap 5: Automatische gebruikersinrichting configureren voor Xledger

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

Automatische gebruikersinrichting configureren voor Xledger in Microsoft Entra ID

1. Meld u aan bij de Microsoft Entra-beheercentrum als ten minste een Cloud-toepassingsbeheerder.

2. Blader naar Entra ID>Enterprise apps

   

3. Selecteer Xledger in de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Selecteer + Nieuwe configuratie.

   

6. Voer in het veld Tenant-URL uw Xledger tenant-URL en geheime token in. Selecteer Test Connection om ervoor te zorgen dat Microsoft Entra ID verbinding kan maken met Xledger. Als de verbinding mislukt, controleert u of uw Xledger-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

   

7. Selecteer Maken om uw configuratie te maken.

8. Selecteer Eigenschappen op de pagina Overzicht .

9. Selecteer het pictogram Bewerken om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantainemeldingen te ontvangen. Schakel preventie van onbedoelde verwijderingen in. Selecteer Toepassen om de wijzigingen op te slaan.

   

10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

11. Controleer in de sectie Attribute-Mapping de gebruikerskenmerken die vanuit Microsoft Entra ID naar Xledger worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Xledger te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Xledger-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Eigenschap	Typologie	Ondersteund voor filteren	Vereist door Xledger
    gebruikersnaam	Snaar / Touwtje	✓	✓
    actief	Booleaan
    weergaveNaam	Snaar / Touwtje
    emails[type gelijk aan "work"].waarde	Snaar / Touwtje
    telefoonNummers[type gelijk aan "werk"].waarde	Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessFromDate	Datum/tijd
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:toegangsdatum	Datum/tijd

12. Selecteer Groepen.

13. Controleer de groepskenmerken die vanuit Microsoft Entra ID met Xledger worden gesynchroniseerd in de sectie Attribute-Mapping. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in Xledger te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Eigenschap	Typologie	Ondersteund voor filteren	Vereist door Xledger
    weergaveNaam	Snaar / Touwtje	✓	✓
    leden	Referentie

14. Als u bereikfilters wilt configureren, raadpleegt u de instructies in het artikel Bereikfilter.

15. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

16. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Stap 6: Uw implementatie bewaken

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

1. Gebruik de provisioning logs om te bepalen welke gebruikers wel of niet succesvol zijn geprovisioneerd.
2. Controleer de voortgangsbalk om de status van de implementatiecyclus te bekijken en te zien hoe dicht deze bij voltooiing is.
3. Als de toepassingsconfiguratie in een ongezonde toestand lijkt te verkeren, wordt de applicatie in quarantaine geplaatst. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Meer middelen

• Het inrichten van gebruikersaccounts voor Enterprise Apps beheren
• Wat is toepassingstoegang en eenmalige aanmelding met Microsoft Entra ID?

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over de inrichtingsactiviteit