Snabbstart: Kom igång med API-driven inkommande provisionering med cURL

Artikel
01/30/2025

Introduktion

cURL är ett populärt, kostnadsfritt kommandoradsverktyg med öppen källkod som används av API-utvecklare, och det är tillgängligt som standard på Windows 10/11. I den här handledningen beskrivs hur du snabbt kan testa API-driven inkommande provisionering med cURL.

Förutsättningar

Du har konfigurerat API-driven inkommande provisioneringsapp.
Du har konfigurerat en tjänstprincip och har åtkomst till API:et för inkommande provisionering. Anteckna ClientId och ClientSecret för din tjänsthuvudprincipapp för användning i den här handledningen.

Ladda upp användardata till API:et för inkommande försörjning

Hämta client_id och client_secret för tjänstens klienthuvudnamn som har behörighet till API:et för etablering av inkommande tjänster.
Använd OAuth client_credentials tilldelningsflöde för att hämta en åtkomsttoken. Ersätt variablerna [yourClientId], [yourClientSecret] och [yourTenantId] med värden som gäller för konfigurationen och kör följande cURL-kommando. Kopiera det värde för åtkomsttoken som genererats
```
curl -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"
```
Kopiera massbegäran med SCIM Enterprise-användarschemat och spara innehållet i en fil med namnet scim-bulk-upload-users.json.
Ersätt variabeln [InboundProvisioningAPIEndpoint] med etablerings-API-slutpunkten som är associerad med din etableringsapp. Använd värdet [AccessToken] från föregående steg och kör följande curl-kommando för att ladda upp massbegäran till etablerings-API-slutpunkten.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
När uppladdningen har slutförts får du HTTP 202 Godkänd svarskod.
Etableringstjänsten börjar bearbeta nyttolasten för massbegäran omedelbart och du kan se etableringsinformationen genom att komma åt etableringsloggarna för den inkommande etableringsappen.

Verifiera bearbetningen av nyttolasten för massbegäran

Logga in på Microsoft Entra Administrationscenter som minst en Programadministratör.
Bläddra till Microsoft Entra ID -> Applikationer -> Företagsapplikationer.
Under alla applikationer använder du textrutan för sökfilter för att hitta och öppna din API-drivna provisioneringsapplikation.
Öppna Provisioning-bladet. Landningssidan visar status för den senaste körningen.
Klicka på Visa provisioneringsloggar för att öppna panelen provisioneringsloggar. Du kan också klicka på menyalternativet Övervaka –> Provisioneringsloggar.
Klicka på en post i etableringsloggarna för att visa mer bearbetningsinformation.
Etableringsloggskärmen visar alla steg som har körts för en specifik användare.
- Under steget Importera från API kan du läsa mer om användardata som extraherats från massbegäran.
- Steget Matcha användare visar information om alla användarmatchningar utifrån den matchande identifieraren. 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 Avgöra om användaren är i omfånget visar information om utvärderingen av omfångsfilter. 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.

Tillägg

Se det här avsnittet för information om massbegäran med SCIM Enterprise-användarschema.

Massbegäran med SCIM Enterprise-användarschema

Massbegäran som visas nedan använder SCIM standard Core User och Företagsanvändare Schema.

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
}

Dela via