Quickstart api-gestuurde binnenkomende inrichting met cURL

Artikel
02/28/2024

Inleiding

cURL is een populair, gratis, opensource- en opdrachtregelprogramma dat wordt gebruikt door API-ontwikkelaars en is standaard beschikbaar in Windows 10/11. In deze zelfstudie wordt beschreven hoe u met cURL snel API-gestuurde binnenkomende inrichting kunt testen.

Vereisten

U hebt api-gestuurde inkomende inrichtings-app geconfigureerd.
U hebt een service-principal geconfigureerd en deze heeft toegang tot de binnenkomende inrichtings-API. Noteer de ClientId service-principal-app ClientSecret voor gebruik in deze zelfstudie.

Gebruikersgegevens uploaden naar de inkomende inrichtings-API

Haal de client_id en client_secret van de service-principal op die toegang heeft tot de inkomende inrichtings-API.
Gebruik OAuth client_credentials stroom verlenen 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ëren
```
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"
```
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 het Microsoft Entra-beheercentrum als ten minste een toepassings-Beheer istrator.
Blader naar Microsoft Entra ID -> Toepassingen -> Bedrijfstoepassingen.
Gebruik onder alle toepassingen het zoekfiltertekstvak om uw API-gestuurde inrichtingstoepassing te zoeken en te openen.
Open de blade Inrichten. Op de landingspagina wordt de status van de laatste uitvoering weergegeven.
Klik op Inrichtingslogboeken weergeven om de blade inrichtingslogboeken 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 de details van gebruikersgegevens die zijn geëxtraheerd uit de bulkaanvraag.
- In de stap Gebruiker vergelijken worden details weergegeven van elke overeenkomst van een gebruiker op basis van de overeenkomende id. Als een gebruiker overeenkomt, voert de inrichtingsservice een updatebewerking uit. Als er geen overeenkomende gebruiker is, voert de inrichtingsservice een bewerking uit.
- De stap Bepalen of gebruiker zich in de bereikstap bevindt, toont details 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.
- De stap Gebruiker inrichten roept de laatste verwerkingsstap en wijzigingen aan die zijn toegepast op het gebruikersaccount.
- Gebruik het tabblad Aangepaste eigenschappen om kenmerkupdates weer te geven.

Bijlage

Bekijk deze sectie voor informatie over de bulkaanvraag met scim Enterprise-gebruikersschema.

Bulkaanvraag met SCIM Enterprise-gebruikersschema

De onderstaande bulkaanvraag maakt gebruik van het SCIM Standard Core User en Enterprise User Schema.

Aanvraagbody

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

Delen via