Snabbstart av API-driven etablering av inkommande trafik med Graph Explorer
I den här handledningen beskrivs hur du snabbt kan testa API-driven inkommande tilldelning med Microsoft Graph Explorer.
Förutsättningar
- Du har konfigurerat API-drivna inkommande etableringsapplikation.
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 administratörsanvändare med rollen användaradministratör anropa API:et. Den här självstudien visar hur du kan testa API:et med en användaradministratörsroll i testkonfigurationen.
Ladda upp användardata till det inkommande provisionerings-API:et
Ö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.
Välj användarprofilikonen för att logga in.
Slutför inloggningsprocessen med ett användarkonto som har användaradministratör rollåtkomst.
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
Välj knappen Kör sökfråga för att skicka begäran till provisionerings-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 bulkförfrågan
Begärandetext
{
"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
}
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 applikationer använder du textrutan sökfilter för att hitta och öppna din API-drivna tilldelningsapplikation.
Öppna tilldelningsbladet. Landningssidan visar status för den senaste körningen.
Välj Visa etableringsloggar för att öppna panelen etableringsloggar. Du kan också välja menyalternativet Övervakning –> Provisioneringsloggar.
Välj en post i tilldelningsloggarna för att se ytterligare bearbetningsinformation.
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 Bestäm om användaren är inom scopet visar detaljer 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.
- 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 välj 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 följer 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": "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
}