Instructies: Inrichtingsconfiguratie exporteren en terugdraaien naar een bekende goede status

In dit artikel leert u het volgende:

  • Uw inrichtingsconfiguratie exporteren en importeren vanuit de Azure Portal
  • Uw inrichtingsconfiguratie exporteren en importeren met behulp van de Microsoft-Graph API

Uw inrichtingsconfiguratie exporteren en importeren vanuit de Azure Portal

Uw inrichtingsconfiguratie exporteren

Uw configuratie exporteren:

  1. Selecteer Azure Active Directory in Azure Portal in het navigatiepaneel aan de linkerkant.
  2. Selecteer bedrijfstoepassingen in het deelvenster Azure Active Directory en kies uw toepassing.
  3. Selecteer inrichting in het linkernavigatiedeelvenster. Klik op de pagina inrichtingsconfiguratie op kenmerktoewijzingen, geef vervolgens geavanceerde opties weer en controleer ten slotte uw schema. Hiermee gaat u naar de schema-editor.
  4. Klik op downloaden in de opdrachtbalk boven aan de pagina om uw schema te downloaden.

Herstel na noodgevallen : terugdraaien naar een bekende goede status

Door uw configuratie te exporteren en op te slaan, kunt u terugdraaien naar een eerdere versie van uw configuratie. U wordt aangeraden de inrichtingsconfiguratie te exporteren en deze op te slaan voor later gebruik wanneer u een wijziging aanbrengt in uw kenmerktoewijzingen of bereikfilters. U hoeft alleen maar het JSON-bestand te openen dat u in de bovenstaande stappen hebt gedownload, de volledige inhoud van het JSON-bestand te kopiëren, de volledige inhoud van de JSON-nettolading in de schema-editor te vervangen en vervolgens op te slaan. Als er een actieve inrichtingscyclus is, wordt deze voltooid en gebruikt de volgende cyclus het bijgewerkte schema. De volgende cyclus is ook een eerste cyclus, die elke gebruiker en groep opnieuw evalueert op basis van de nieuwe configuratie. Houd rekening met het volgende wanneer u teruggaat naar een eerdere configuratie:

  • Gebruikers worden opnieuw geëvalueerd om te bepalen of ze binnen het bereik moeten vallen. Als de bereikfilters zijn gewijzigd, is een gebruiker niet meer binnen het bereik, worden ze uitgeschakeld. Hoewel dit in de meeste gevallen het gewenste gedrag is, is het mogelijk dat u dit wilt voorkomen en de functionaliteit voor het overslaan van verwijderingen van bereiken kunt gebruiken.
  • Als u de inrichtingsconfiguratie wijzigt, wordt de service opnieuw opgestart en wordt een eerste cyclus geactiveerd.

Uw inrichtingsconfiguratie exporteren en importeren met behulp van de Microsoft-Graph API

U kunt de Microsoft Graph API en Microsoft Graph Explorer gebruiken om uw kenmerktoewijzingen en schema voor gebruikersinrichting te exporteren naar een JSON-bestand en het terug te importeren in Azure AD. U kunt ook de stappen gebruiken die hier worden vastgelegd om een back-up van uw inrichtingsconfiguratie te maken.

Stap 1: De Service-principal-id (object-id) van uw inrichtings-app ophalen

  1. Start Azure Portal en ga naar de sectie Eigenschappen van uw inrichtingstoepassing. Als u bijvoorbeeld de toewijzing van uw Workday-toepassing naar AD-gebruikersinrichting wilt exporteren, gaat u naar de sectie Eigenschappen van die app.

  2. Kopieer in de sectie Eigenschappen van uw inrichtings-app de GUID-waarde die is gekoppeld aan het veld Object-id. Deze waarde wordt ook wel de ServicePrincipalId van uw app genoemd en wordt gebruikt in Microsoft Graph Explorer-bewerkingen.

    Workday App Service Principal ID

Stap 2: Aanmelden bij Microsoft Graph Explorer

  1. Start Microsoft Graph Explorer

  2. Klik op de knop 'Aanmelden met Microsoft' en meld u aan met Azure AD Globale beheerder of App-beheerdersreferenties.

    Aanmelden bij Microsoft Graph

  3. Wanneer u zich hebt aangemeld, ziet u de details van het gebruikersaccount in het linkerdeelvenster.

Stap 3: de inrichtingstaak-id van de inrichtings-app ophalen

Voer in Microsoft Graph Explorer de volgende GET-query uit om [servicePrincipalId] te vervangen door de ServicePrincipalId die is geëxtraheerd uit Stap 1.

   GET https://graph.microsoft.com/beta/servicePrincipals/[servicePrincipalId]/synchronization/jobs

U krijgt een antwoord zoals hieronder wordt weergegeven. Kopieer het id-kenmerk dat aanwezig is in het antwoord. Deze waarde is de ProvisioningJobId en wordt gebruikt om de metagegevens van het onderliggende schema op te halen.

Inrichtingstaak-id

Stap 4: Het inrichtingsschema downloaden

Voer in Microsoft Graph Explorer de volgende GET-query uit, waarbij u [servicePrincipalId] en [ProvisioningJobId] vervangt door de ServicePrincipalId en de ProvisioningJobId die in de vorige stappen zijn opgehaald.

   GET https://graph.microsoft.com/beta/servicePrincipals/[servicePrincipalId]/synchronization/jobs/[ProvisioningJobId]/schema

Kopieer het JSON-object uit het antwoord en sla het op in een bestand om een back-up van het schema te maken.

Stap 5: het inrichtingsschema importeren

Waarschuwing

Voer deze stap alleen uit als u het schema voor configuratie moet wijzigen dat niet kan worden gewijzigd met behulp van de Azure Portal of als u de configuratie wilt herstellen van een eerder back-upbestand met een geldig en werkend schema.

Configureer in Microsoft Graph Explorer de volgende PUT-query, waarbij u [servicePrincipalId] en [ProvisioningJobId] vervangt door de ServicePrincipalId en de ProvisioningJobId die in de vorige stappen zijn opgehaald.

    PUT https://graph.microsoft.com/beta/servicePrincipals/[servicePrincipalId]/synchronization/jobs/[ProvisioningJobId]/schema

Kopieer op het tabblad Aanvraagtekst de inhoud van het JSON-schemabestand.

Aanvraagbody

Voeg op het tabblad Aanvraagheaders het kenmerk Inhoudstype-header toe met de waarde 'application/json'

Aanvraagheaders

Selecteer Query uitvoeren om het nieuwe schema te importeren.