Delen via

Quickstart api-gestuurde binnenkomende inrichting met Graph Explorer

  • Artikel

In deze zelfstudie wordt beschreven hoe u apigestuurde binnenkomende inrichting snel kunt testen met Microsoft Graph Explorer.

Vereisten

Notitie

Deze inrichtings-API is voornamelijk bedoeld voor gebruik binnen een toepassing of service. Tenantbeheerders kunnen een service-principal of beheerde identiteit configureren om toestemming te verlenen voor het uploaden. Er is geen afzonderlijke door de gebruiker toe te wijzen maprol van Microsoft Entra voor deze API. Buiten toepassingen die machtigingen hebben verkregen SynchronizationData-User.Upload met beheerderstoestemming, kunnen alleen beheerdersgebruikers met de rol Globale beheerder de API aanroepen. In deze zelfstudie ziet u hoe u de API kunt testen met de rol Globale beheerder in uw testinstallatie.

Gebruikersgegevens uploaden naar de inkomende inrichtings-API

  1. Open een nieuw browsertabblad of browservenster.

  2. Start de URL https://aka.ms/ge voor toegang tot Microsoft Graph Explorer.

  3. Klik op het pictogram van het gebruikersprofiel om u aan te melden.

    Afbeelding van het pictogram van het gebruikersprofiel.

  4. Voltooi het aanmeldingsproces met een gebruikersaccount met de rol Globale beheerder .

  5. Bij een geslaagde aanmelding worden in de tenantgegevens uw tenantnaam weergegeven.

    Schermopname van tenantnaam.

    U bent nu klaar om de API aan te roepen.

  6. Stel in het deelvenster API-aanvraag het HTTP-aanvraagtype in op POST.

  7. Kopieer en plak het inrichtings-API-eindpunt dat is opgehaald op de overzichtspagina van de inrichtings-app.

  8. Voeg in het deelvenster Aanvraagheaders een nieuw sleutelwaardepaar van Content-Type = application/scim+json toe. Schermopname van het deelvenster Aanvraagheader.

  9. Kopieer in het deelvenster Aanvraagbody de bulkaanvraag met scim Enterprise-gebruikersschema

  10. Klik op de knop Query uitvoeren om de aanvraag naar het eindpunt van de inrichtings-API te verzenden.

  11. Als de aanvraag is verzonden, krijgt u een Accepted 202 antwoord van het API-eindpunt.

  12. Open het deelvenster Antwoordheaders en kopieer de URL-waarde van het locatiekenmerk. Dit verwijst naar het API-eindpunt van de inrichtingslogboeken waarop u een query kunt uitvoeren om de inrichtingsstatus van gebruikers te controleren die aanwezig zijn in de bulkaanvraag.

De verwerking van de nettolading van bulkaanvragen controleren

Aanvraagbody

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701984",
            "userName": "bjensen@example.com",
            "name": {
                "formatted": "Ms. Barbara J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Barbara",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Babs Jensen",
            "nickName": "Babs",
            "emails": [
            {
              "value": "bjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Universal City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91608",
              "country": "USA",
              "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5555",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Guide",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701984",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "89607",
                     "displayName": "John Smith"
                 }
            }
        }
    },
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701985",
            "userName": "Kjensen@example.com",
            "name": {
                "formatted": "Ms. Kathy J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Kathy",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Kathy Jensen",
            "nickName": "Kathy",
            "emails": [
            {
              "value": "kjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Oracle City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91618",
              "country": "USA",
              "formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5545",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Lead",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701985",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "701984",
                     "displayName": "Barbara Jensen"
                 }
            }
        }
    }
],
    "failOnErrors": null
}
U kunt de verwerking controleren vanuit het Microsoft Entra-beheercentrum of met Graph Explorer.

Verwerking verifiëren vanuit het Microsoft Entra-beheercentrum

  1. Meld u aan bij het Microsoft Entra-beheercentrum met ten minste aanmeldingsreferenties van de toepassingsbeheerder .

  2. Blader naar Microsoft Entra ID -> Toepassingen -> Bedrijfstoepassingen.

  3. Gebruik onder alle toepassingen het zoekfiltertekstvak om uw API-gestuurde inrichtingstoepassing te zoeken en te openen.

  4. Open de blade Inrichten. Op de landingspagina wordt de status van de laatste uitvoering weergegeven.

  5. Klik op Inrichtingslogboeken weergeven om de blade inrichtingslogboeken te openen. U kunt ook klikken op de menuoptie Monitor -> Inrichtingslogboeken.

    Schermopname van het inrichten van logboeken in het menu.

  6. Klik op een record in de inrichtingslogboeken om aanvullende verwerkingsdetails weer te geven.

  7. In het scherm met details van het inrichtingslogboek worden alle stappen weergegeven die worden uitgevoerd voor een specifieke gebruiker.

    • Zie onder de stap Importeren uit API de details van gebruikersgegevens die zijn geëxtraheerd uit de bulkaanvraag.
    • In de stap Gebruiker vergelijken worden details weergegeven van elke overeenkomst van een gebruiker op basis van de overeenkomende id. Als een gebruiker overeenkomt, voert de inrichtingsservice een updatebewerking uit. Als er geen overeenkomende gebruiker is, voert de inrichtingsservice een bewerking uit.
    • De stap Bepalen of gebruiker zich in de bereikstap bevindt, toont details van de bereikfilterevaluatie. Standaard worden alle gebruikers verwerkt. Als u een bereikfilter hebt ingesteld (bijvoorbeeld alleen gebruikers verwerken die behoren tot de afdeling Verkoop), worden de evaluatiedetails van het bereikfilter weergegeven in deze stap.
    • De stap Gebruiker inrichten roept de laatste verwerkingsstap en wijzigingen aan die zijn toegepast op het gebruikersaccount.
    • Gebruik het tabblad Aangepaste eigenschappen om kenmerkupdates weer te geven.

Verwerking controleren met behulp van de API voor inrichtingslogboeken in Graph Explorer

U kunt de verwerking inspecteren met behulp van de API-URL van de inrichtingslogboeken die wordt geretourneerd als onderdeel van de antwoordheader van de locatie in de inrichtings-API-aanroep.

  1. In Graph Explorer kopieert u de locatie-URL die wordt geretourneerd door het eindpunt van de inrichtings-API of kunt u deze maken met behulp van de indeling: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' waar u de jobId url kunt ophalen van de overzichtspagina van de inrichtings-app.
  2. Gebruik de methode GET en klik op Query uitvoeren om de inrichtingslogboeken op te halen. Standaard bevat het geretourneerde antwoord alle logboekrecords.
  3. U kunt meer filters instellen om alleen gegevens op te halen na een bepaald tijdsbestek of met een specifieke statuswaarde. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z U kunt ook de status van de gebruiker controleren op basis van de externalId waarde die wordt gebruikt in uw bronsysteem dat wordt gebruikt als bronanker/samenvoegingseigenschap. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Bijlage

Bulkaanvraag met SCIM Enterprise-gebruikersschema

De onderstaande bulkaanvraag maakt gebruik van het schema sciM standard Core User en Enterprise User.

Aanvraagbody

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701984",
            "userName": "bjensen@example.com",
            "name": {
                "formatted": "Ms. Barbara J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Barbara",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Babs Jensen",
            "nickName": "Babs",
            "emails": [
            {
              "value": "bjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Universal City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91608",
              "country": "USA",
              "formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5555",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Guide",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701984",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "89607",
                     "displayName": "John Smith"
                 }
            }
        }
    },
    {
        "method": "POST",
        "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
            "externalId": "701985",
            "userName": "Kjensen@example.com",
            "name": {
                "formatted": "Ms. Kathy J Jensen, III",
                "familyName": "Jensen",
                "givenName": "Kathy",
                "middleName": "Jane",
                "honorificPrefix": "Ms.",
                "honorificSuffix": "III"
            },
            "displayName": "Kathy Jensen",
            "nickName": "Kathy",
            "emails": [
            {
              "value": "kjensen@example.com",
              "type": "work",
              "primary": true
            }
            ],
            "addresses": [
            {
              "type": "work",
              "streetAddress": "100 Oracle City Plaza",
              "locality": "Hollywood",
              "region": "CA",
              "postalCode": "91618",
              "country": "USA",
              "formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
              "primary": true
            }
            ],
            "phoneNumbers": [
            {
              "value": "555-555-5545",
              "type": "work"
            }
            ],
            "userType": "Employee",
            "title": "Tour Lead",
            "preferredLanguage": "en-US",
            "locale": "en-US",
            "timezone": "America/Los_Angeles",
            "active":true,
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                 "employeeNumber": "701985",
                 "costCenter": "4130",
                 "organization": "Universal Studios",
                 "division": "Theme Park",
                 "department": "Tour Operations",
                 "manager": {
                     "value": "701984",
                     "displayName": "Barbara Jensen"
                 }
            }
        }
    }
],
    "failOnErrors": null
}

Volgende stappen