API-driven inkommande tillhandahållande med Graph Explorer

I den här handledningen beskrivs hur du snabbt kan testa API-driven inkommande provisioning med Microsoft Graph Explorer.

Prerequisite

• Du har konfigurerat en API-driven applikation för tillhandahållande för inkommande.

Ladda upp användardata till det inkommande provisionerings-API:et

1. Öppna en ny webbläsarflik eller ett webbläsarfönster.

2. Starta URL:en https://aka.ms/ge för att komma åt Microsoft Graph Explorer.

3. Välj användarprofilikonen för att logga in.

   

4. Slutför inloggningsprocessen med ett användarkonto som har användaradministratörsrollåtkomst .

5. Vid lyckad inloggning visar klientinformationen ditt klientnamn.

   

   Nu är du redo att anropa API:et.

6. I panelen FÖR API-begäran anger du HTTP-begärandetypen till POST.

7. Kopiera och klistra in den etablerings-API-slutpunkt som hämtats från översiktssidan för etableringsappen.

8. Under panelen Begärandehuvuden lägger du till ett nytt nyckelvärdepar med Content-Type = application/scim+json.

9. Under panelen Begärandetext kopierar du massbegäran med SCIM Enterprise-användarschemat

10. Välj på knappen Kör fråga för att skicka begäran till etablerings-API-slutpunkten.

11. Om begäran har skickats får du ett Accepted 202 svar från API-slutpunkten.

12. Öppna panelen Svarshuvuden och kopiera URL-värdet för platsattributet. Detta pekar på den API-slutpunkt för etableringsloggar som du kan köra frågor mot för att kontrollera etableringsstatusen för användare som finns i massbegäran.

Verifiera bearbetning av nyttolast för bulkförfrågan

Du kan verifiera bearbetningen antingen från administrationscentret för Microsoft Entra eller med hjälp av Graph Explorer.

Verifiera bearbetning från administrationscentret för Microsoft Entra

1. Logga in på administrationscentret för Microsoft Entra med minst inloggningsuppgifter för programadministratör .

2. Bläddra till Entra ID>Företagsapplikationer.

3. Under alla applikationer använder du textrutan sökfilter för att hitta och öppna din API-drivna tilldelningsapplikation.

4. Öppna tilldelningsbladet. Landningssidan visar status för den senaste körningen.

5. Välj Visa etableringsloggar för att öppna sidan etableringsloggar. Du kan också välja menyalternativet Övervaka>konfigurationsloggar.

   

6. Välj en post i tilldelningsloggarna för att se ytterligare bearbetningsinformation.

7. Skärmen med information om etableringsloggen visar alla steg som kördes för en specifik användare.

   • Under steget Importera från API kan du se information om användardata som extraherats från massbegäran.
   • Steget Matcha användare visar information om alla användarmatchning baserat på matchande identifierare. Om en användarmatchning inträffar utför etableringstjänsten en uppdateringsåtgärd. Om det inte finns någon användarmatchning utför etableringstjänsten en skapandeåtgärd.
   • Steget Kontrollera om användaren är inom omfång visar information om utvärdering av omfångsfilter. Som standard bearbetas alla användare. Om du anger ett omfångsfilter (till exempel endast bearbeta användare som tillhör försäljningsavdelningen) visas utvärderingsinformationen för omfångsfiltret i det här steget.
   • Steget Etablera användare belyser det sista bearbetningssteget och de ändringar som tillämpas på användarkontot.
   • Använd fliken Ändrade egenskaper för att visa attributuppdateringar.

Verifiera bearbetning med konfigureringsloggar i Graph Explorer API

Du kan granska bearbetningen med hjälp av API-URL:en för etableringsloggar som returneras som en del av platssvarshuvudet i API-anropet för etablering.

1. I textrutan Begär URL i Graph Explorer kopierar du plats-URL:en som returneras av etablerings-API-slutpunkten eller så kan du konstruera den med formatet: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' där du kan hämta jobId från översiktssidan för etableringsappen.
2. Använd metoden GET och välj Kör fråga för att hämta etableringsloggarna. Som standard innehåller svaret som returneras alla loggposter.
3. Du kan ange fler filter för att endast hämta data efter en viss tidsram eller med ett specifikt statusvärde. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z Du kan också kontrollera statusen för användaren efter det externalId värde som används i källsystemet som används som källankare/anslutningsegenskap. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Appendix

Massbegäran med SCIM Enterprise-användarschema

Massbegäran som följer använder SCIM-standardschemat Core User och Enterprise User.

Request body

{
    "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
}

Next steps

• Felsöka problem med API:et för inkommande provisionering
• Vanligaste frågorna om API-driven inkommande provisionering
• Snabbstart med PowerShell
• Snabbstart med Azure Logic Apps