Szybki start: rozpoczynanie pracy z aprowizowaniem przychodzącym opartym na interfejsie API przy użyciu biblioteki cURL

2025-04-30

Wprowadzenie

cURL to popularne, bezpłatne, open source, narzędzie wiersza polecenia używane przez deweloperów interfejsu API, które jest domyślnie dostępne w systemie Windows 10/11. W tym samouczku opisano, jak szybko przetestować aprowizację przychodzącą opartą na interfejsie API za pomocą biblioteki cURL.

Wymagania wstępne

Skonfigurowano aplikację do zarządzania dostępem przychodzącym opartą na interfejsie API .
Skonfigurowano jednostkę usługi i ma ona dostęp do interfejsu API aprowizacji dla ruchu przychodzącego. Zanotuj identyfikatory ClientId i ClientSecret aplikacji usługi głównej do użycia w tym samouczku.

Przekazywanie danych użytkownika do API udostępniania danych przychodzących

Pobierz client_id i client_secret głównej usługi, która ma dostęp do interfejsu API aprowizacji przychodzącej.

Użyj mechanizmu przyznawania OAuth client_credentials, aby uzyskać token dostępu. Zastąp zmienne [yourClientId], [yourClientSecret] i [yourTenantId] wartościami dotyczącymi konfiguracji i uruchom następujące polecenie cURL. Kopiowanie wygenerowanej wartości tokenu dostępu

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"

Skopiuj żądanie zbiorcze za pomocą schematu użytkownika przedsiębiorstwa SCIM i zapisz zawartość w pliku o nazwie scim-bulk-upload-users.json.
Zastąp zmienną [InboundProvisioningAPIEndpoint] punktem końcowym API aprowizacji skojarzonym z Twoją aplikacją aprowizacji. Użyj wartości [AccessToken] z poprzedniego kroku i uruchom następujące polecenie curl, aby przekazać żądanie zbiorcze do punktu końcowego interfejsu API aprowizacji.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
Po pomyślnym przesłaniu otrzymasz kod odpowiedzi HTTP 202, który oznacza zaakceptowanie.
Usługa aprowizacji rozpoczyna natychmiast przetwarzanie ładunku żądania zbiorczego, a szczegóły aprowizacji można wyświetlić, korzystając z dzienników aprowizacji aplikacji aprowizacji przychodzącej.

Weryfikowanie przetwarzania ładunku żądania zbiorczego

Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji.
Przejdź do aplikacji Entra ID>Dla przedsiębiorstw.
We wszystkich aplikacjach użyj pola tekstowego filtru wyszukiwania, aby znaleźć i otworzyć aplikację aprowizacji opartą na interfejsie API.
Otwórz panel aprowizacji. Na stronie docelowej jest wyświetlany stan ostatniego uruchomienia.
Wybierz Wyświetl dzienniki aprowizacji, aby otworzyć panel dzienników aprowizacji. Alternatywnie możesz wybrać opcję menu Monitor>dzienniki aprowizacji.
Wybierz dowolny rekord w dziennikach aprowizacji, aby wyświetlić więcej szczegółów przetwarzania.
Ekran szczegółów dziennika aprowizacji zawiera wszystkie kroki wykonywane dla określonego użytkownika.
- W kroku Importowanie z interfejsu API zobacz szczegóły danych użytkownika wyodrębnionych z żądania zbiorczego.
- Krok Dopasowywanie użytkownika zawiera szczegóły dopasowania dowolnego użytkownika na podstawie zgodnego identyfikatora. Jeśli wystąpi dopasowanie użytkownika, usługa aprowizacji wykonuje operację aktualizacji. Jeśli nie ma dopasowania użytkownika, usługa aprowizacji wykonuje operację tworzenia.
- Etap Określanie, czy użytkownik znajduje się w zakresie zawiera szczegóły oceny filtru określania zakresu. Domyślnie wszyscy użytkownicy są przetwarzani. Jeśli ustawisz filtr określania zakresu (na przykład przetwarzasz tylko użytkowników należących do działu sprzedaży), w tym kroku zostaną wyświetlone szczegóły oceny filtru określania zakresu.
- Krok Aprowizacja użytkownika wywołuje końcowy krok przetwarzania i zmiany zastosowane do konta użytkownika.
- Użyj karty Zmodyfikowane właściwości , aby wyświetlić aktualizacje atrybutów.

Aneks

Wyświetl tę sekcję, aby uzyskać informacje na temat zbiorczego żądania dotyczącego schematu użytkownika SCIM dla przedsiębiorstw.

Żądanie zbiorcze ze schematem SCIM dla użytkowników przedsiębiorstwa

Żądanie zbiorcze przedstawione poniżej używa standardu SCIM ze schematem użytkownika podstawowego i użytkownika przedsiębiorstwa.

Treść żądania

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

Udostępnij za pośrednictwem