Snabbstart av API-driven etablering av inkommande trafik med cURL

Artikel
02/28/2024

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 i Windows 10/11. I den här självstudien beskrivs hur du snabbt kan testa API-driven inkommande etablering med cURL.

Förutsättningar

Du har konfigurerat en API-driven etableringsapp för inkommande trafik.
Du har konfigurerat ett huvudnamn för tjänsten och det har åtkomst till API:et för inkommande etablering. Anteckna ClientId och ClientSecret för tjänstens huvudnamnsapp för användning i den här självstudien.

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

Hämta client_id och client_secret för tjänstens huvudnamn som har åtkomst till API:et för inkommande etablering.

Använd OAuth client_credentials bevilja flöde för att hämta en åtkomsttoken. Ersätt variablerna [yourClientId]och [yourClientSecret][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 den etablerings-API-slutpunkt som är associerad med din etableringsapp. [AccessToken] Använd värdet 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å administrationscentret för Microsoft Entra som minst 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 mer 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.

Bilaga

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-standardschemat core-användare och företagsanvändare.

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
}

Share via