Snabbstart av API-driven etablering av inkommande trafik med Graph Explorer
I den här självstudien beskrivs hur du snabbt kan testa API-driven inkommande etablering med Microsoft Graph Explorer.
Förutsättningar
Kommentar
Det här etablerings-API:et är främst avsett för användning i ett program eller en tjänst. Klientadministratörer kan antingen konfigurera ett huvudnamn för tjänsten eller en hanterad identitet för att bevilja behörighet att utföra uppladdningen. Det finns ingen separat användartilldelningsbar Microsoft Entra-inbyggd katalogroll för det här API:et. Förutom program som har fått SynchronizationData-User.Upload behörighet med administratörsmedgivande kan endast administratörsanvändare med rollen Global administratör anropa API:et. Den här självstudien visar hur du kan testa API:et med en global administratörsroll i testkonfigurationen.
Ladda upp användardata till API:et för inkommande etablering
Öppna en ny webbläsarflik eller ett webbläsarfönster.
Starta URL:en https://aka.ms/ge för att komma åt Microsoft Graph Explorer.
Klicka på användarprofilikonen för att logga in.
Slutför inloggningsprocessen med ett användarkonto som har rollen Global administratör .
Vid lyckad inloggning visar klientinformationen ditt klientnamn.
Nu är du redo att anropa API:et.
I panelen FÖR API-begäran anger du HTTP-begärandetypen till POST.
Kopiera och klistra in den etablerings-API-slutpunkt som hämtats från översiktssidan för etableringsappen.
Under panelen Begärandehuvuden lägger du till ett nytt nyckelvärdepar med Content-Type = application/scim+json.
Under panelen Begärandetext kopierar du massbegäran med SCIM Enterprise-användarschemat
Klicka på knappen Kör fråga för att skicka begäran till etablerings-API-slutpunkten.
Om begäran har skickats får du ett
Accepted 202svar från API-slutpunkten.Ö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 massbegäran
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
Logga in på administrationscentret för Microsoft Entra med minst inloggningsuppgifter för programadministratör.
Bläddra till Microsoft Entra-ID –> Program –> Företagsprogram.
Under alla program använder du textrutan sökfilter för att hitta och öppna ditt API-drivna etableringsprogram.
Öppna bladet Etablering. Landningssidan visar status för den senaste körningen.
Klicka på Visa etableringsloggar för att öppna bladet etableringsloggar. Du kan också klicka på menyalternativet Övervaka –> Etableringsloggar.
Klicka på en post i etableringsloggarna för att visa ytterligare bearbetningsinformation.
Skärmen med information om etableringsloggen visar alla steg som körs 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 i omfångssteget visar information om omfångsfilterutvärdering. Som standard bearbetas alla användare. Om du har angett 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 api för etableringsloggar i Graph Explorer
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.
- 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ämtajobIdfrån översiktssidan för etableringsappen. - Använd metoden GET och klicka på Kör fråga för att hämta etableringsloggarna. Som standard innehåller svaret som returneras alla loggposter.
- 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:34ZDu kan också kontrollera statusen för användaren efter detexternalIdvä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'
Bilaga
Massbegäran med SCIM Enterprise-användarschema
Massbegäran som visas nedan använder SCIM-standardschemat Core User och Enterprise User.
Begärandetext
{
"schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
"Operations": [
{
"method": "POST",
"bulkId": "897401c2-2de4-4b87-a97f-c02de3bcfc61",
"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": "897401c2-2de4-4b87-a97f-c02de3bcfc61",
"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
}