Konfigurera Xledger för automatisk användaretablering med Microsoft Entra ID

Den här artikeln beskriver de steg du behöver utföra i både Xledger och Microsoft Entra ID för att konfigurera automatisk användaretablering. När Microsoft Entra ID är konfigurerad provisionerar och avprovisionerar den automatiskt användare och grupper till Xledger med hjälp av Microsoft Entra provisioningstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisk användaretablering och avetablering till SaaS-program med Microsoft Entra ID.

Funktioner som stöds

Förutsättningar

Scenariot som beskrivs i den här artikeln förutsätter att du redan har följande förutsättningar:

• Microsoft Entra klientorganisation
• En av följande roller: programadministratör, molnprogramadministratöreller programägare.
• Ett användarkonto i Xledger med administratörsbehörighet.

Steg 1: Planera din försörjningsdistribution

1. Lär dig hur försörjningstjänsten fungerar.
2. Fastställ vem som omfattas av försörjningen.
3. Bestäm vilka data som ska mappas mellan Microsoft Entra ID och Xledger.

Steg 2: Konfigurera Xledger för att stödja etablering med Microsoft Entra ID

1. Logga in på Xledger med rollen domänadministratör (eller liknande) och gå till Åtkomsttoken för api för administrationssystemåtkomst >>.

2. Generera en hemlig token och anteckna den

   

3. Anteckna hyresgäst-URL

   

Dessa värden används på fliken Etablering i xledger-programmet. (Steg 5)

Steg 3: Lägg till Xledger från Microsoft Entra-programgalleriet

Lägg till Xledger från Microsoft Entra-applikationsgalleriet för att börja hantera försörjning till Xledger. Om du tidigare har konfigurerat Xledger för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vilka som omfattas av provisioner

Med Microsoft Entra etableringstjänst kan du omfångsbegränsa vem som etableras baserat på tilldelning till programmet, eller baserat på attribut för användaren eller gruppen. Om du väljer att avgränsa vem som ska ha åtkomst till din app baserat på tilldelning, kan du följa stegen för att tilldela användare och grupper till applikationen. Om du väljer att avgränsa vem som provisioneras enbart utifrån attributen för användaren eller gruppen kan du använda ett avgränsningsfilter.

• Börja litet. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper kan du ange ett attributbaserat omfångsfilter.

• Om du behöver extra roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till Xledger

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i TestApp baserat på användar- och/eller grupptilldelningar i Microsoft Entra ID.

Konfigurera automatisk användaretablering för Xledger i Microsoft Entra ID

1. Logga in på Microsoft Entra administrationscenter som minst en Cloud-programadministratör.

2. Bläddra till Entra ID>Enterprise-appar

   

3. I programlistan väljer du Xledger.

   

4. Välj fliken Provisioning.

   

5. Välj + Ny konfiguration.

   

6. I fältet Klient-URL anger du din Xledger-klient-URL och hemliga token. Välj Testanslutning för att säkerställa att Microsoft Entra ID kan ansluta till Xledger. Om anslutningen misslyckas kontrollerar du att xledger-kontot har nödvändiga administratörsbehörigheter och försöker igen.

   

7. Välj Skapa för att skapa konfigurationen.

8. Välj Egenskaper på sidan Översikt .

9. Välj ikonen Redigera för att redigera egenskaperna. Aktivera e-postaviseringar och ange ett e-postmeddelande för att ta emot karantänmeddelanden. Aktivera förebyggande av oavsiktliga borttagningar. Välj Använd för att spara ändringarna.

   

10. Välj Attributmappning i den vänstra panelen och välj användare.

11. Granska de användarattribut som synkroniseras från Microsoft Entra ID till Xledger i avsnittet Attribute-Mapping. De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Xledger för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Xledger-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Egenskap	Typ	Stöds för filtrering	Krävs av Xledger
    användarnamn	Sträng	✓	✓
    aktiv	Boolesk
    visningsnamn	Sträng
    e-postmeddelanden[typ = "arbete"].värde	Sträng
    telefonnummer[typ är lika med "arbete"].värde	Sträng
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:åtkomstFrånDatum	Datum och tid
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:åtkomstTillDatum	Datum och tid

12. Välj Grupper.

13. Granska de gruppattribut som synkroniseras från Microsoft Entra ID till Xledger i avsnittet Attribute-Mapping. De attribut som valts som Matchande egenskaper används för att matcha grupperna i Xledger för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Egenskap	Typ	Stöds för filtrering	Krävs av Xledger
    visningsnamn	Sträng	✓	✓
    medlemmar	Hänvisning

14. Information om hur du konfigurerar omfångsfilter finns i anvisningarna i artikeln Omfångsfilter.

15. Använd etablering på begäran för att verifiera synkronisering med ett litet antal användare innan du distribuerar mer allmänt i din organisation.

16. När du är redo att konfigurera väljer du Starta konfiguration på sidan Översikt.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

1. Använd provisioneringsloggarna för att avgöra vilka användare som har provisionerats framgångsrikt eller inte.
2. Kontrollera förloppsindikatorn för att se statusen för försörjningscykeln och hur nära den är att slutföras.
3. Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantäntillstånd i artikeln karantänstatus för programvaruförsörjning.

Fler resurser

• Hantera användarkontoetablering för Enterprise-appar
• Vad är programåtkomst och enkel inloggning med Microsoft Entra ID?

Relaterat innehåll

• Lär dig att granska loggar och få rapporter om försörjningsaktivitet