Quickstart: Starten met API-gestuurde binnenkomende voorziening met behulp van cURL
Introductie
cURL- is een populair, gratis, opensource- en opdrachtregelprogramma dat wordt gebruikt door API-ontwikkelaars. Het is standaard beschikbaar op Windows 10/11. In deze instructie wordt beschreven hoe u snel API-gestuurde binnenkomende voorziening kunt testen met cURL.
Voorwaarden
- U hebt de API-gestuurde inkomende provisioning-app geconfigureerd.
- U hebt een service-principal geconfigureerd en deze heeft toegang tot de inkomende provisioning-API. Noteer de
ClientId
enClientSecret
van uw service-principal-app voor gebruik in deze zelfstudie.
Gebruikersgegevens uploaden naar de inbound provisioning API
- Haal de client_id en client_secret van de service-principal op die toegang heeft tot de inkomende provisioning-API.
- Gebruik de OAuth client_credentials verleningsstroom om een toegangstoken op te halen. Vervang de variabelen
[yourClientId]
,[yourClientSecret]
en[yourTenantId]
door waarden die van toepassing zijn op uw installatie en voer de volgende cURL-opdracht uit. De gegenereerde toegangstokenwaarde kopiërencurl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=[yourClientId]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[yourClientSecret]&grant_type=client_credentials" "https://login.microsoftonline.com/[yourTenantId]/oauth2/v2.0/token"
- Kopieer de bulkaanvraag met SCIM Enterprise User Schema en sla de inhoud op in een bestand met de naam
scim-bulk-upload-users.json
. - Vervang de variabele
[InboundProvisioningAPIEndpoint]
door het inrichtings-API-eindpunt dat is gekoppeld aan uw inrichtings-app. Gebruik de[AccessToken]
waarde uit de vorige stap en voer de volgende curl-opdracht uit om de bulkaanvraag te uploaden naar het eindpunt van de inrichtings-API.curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
- Wanneer het uploaden is voltooid, ontvangt u http 202 Geaccepteerde antwoordcode.
- De inrichtingsservice begint de nettolading van de bulkaanvraag onmiddellijk te verwerken en u kunt de inrichtingsgegevens bekijken door toegang te krijgen tot de inrichtingslogboeken van de inkomende inrichtings-app.
De verwerking van de nettolading van de bulkaanvraag controleren
Meld u aan bij Microsoft Entra-beheercentrum als ten minste een Applicatiebeheerder.
Blader naar Microsoft Entra ID -> Toepassingen -> Enterprise toepassingen.
Gebruik onder alle toepassingen het zoekfiltertekstvak om uw API-gestuurde inrichtingstoepassing te zoeken en te openen.
Open het tabblad Inrichting. Op de landingspagina wordt de status van de laatste uitvoering weergegeven.
Klik op Inrichtingslogboeken weergeven om de inrichtingslogboeken-blade te openen. U kunt ook klikken op de menuoptie Monitor -> Inrichtingslogboeken.
Klik op een record in de inrichtingslogboeken om meer verwerkingsdetails weer te geven.
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 details van gebruikersgegevens die zijn geëxtraheerd uit de bulkaanvraag.
- De gebruiker stap geeft details weer van elke overeenkomende gebruiker op basis van de overeenkomende id. Als er een gebruikersmatch is, voert de voorzieningsservice een update-uitvoering uit. Als er geen overeenkomende gebruiker is, voert de voorzieningsdienst een aanmaakbewerking uit.
- De Bepalen of gebruiker binnen het bereik valt stap geeft details weer 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.
- In de stap Gebruiker Voorzien wordt de laatste verwerkingsstap en wijzigingen aan het gebruikersaccount opgeroepen.
- Gebruik het tabblad Gewijzigde eigenschappen om kenmerkupdates weer te geven.
Bijlage
Bekijk deze sectie voor informatie over de bulkaanvraag met het SCIM-gebruikersschema voor Enterprise.
Bulkaanvraag met SCIM Enterprise-gebruikersschema
De onderstaande bulkaanvraag maakt gebruik van het SCIM Standard Core User en Enterprise User Schema.
verzoekbody
{
"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
}