Inicjowanie obsługi administracyjnej ruchu przychodzącego opartego na interfejsie API z biblioteką cURL

Artykuł
02/28/2024

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ę inbound provisioning opartą na interfejsie API.
Skonfigurowano jednostkę usługi i ma ona dostęp do interfejsu API aprowizacji dla ruchu przychodzącego. Zanotuj i ClientIdClientSecret aplikację jednostki usługi do użycia w tym samouczku.

Przekazywanie danych użytkownika do interfejsu API aprowizacji dla ruchu przychodzącego

Pobierz client_id i client_secret jednostki usługi, która ma dostęp do interfejsu API aprowizacji dla ruchu przychodzącego.
Użyj protokołu OAuth client_credentials przyznaj przepływ, 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 interfejsu API aprowizacji skojarzonym z aplikacją aprowizacji. [AccessToken] Użyj wartości 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 przekazaniu otrzymasz kod odpowiedzi HTTP 202 Zaakceptowane.
Usługa aprowizacji rozpoczyna przetwarzanie ładunku żądania zbiorczego natychmiast i można wyświetlić szczegóły aprowizacji, korzystając z dzienników aprowizacji aplikacji inbound provisioning.

Weryfikowanie przetwarzania ładunku żądania zbiorczego

Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako co najmniej Administracja istrator aplikacji.
Przejdź do witryny Microsoft Entra ID —> Aplikacje —> aplikacje dla przedsiębiorstw.
We wszystkich aplikacjach użyj pola tekstowego filtru wyszukiwania, aby znaleźć i otworzyć aplikację aprowizacji opartą na interfejsie API.
Otwórz blok Aprowizowanie. Na stronie docelowej jest wyświetlany stan ostatniego uruchomienia.
Kliknij pozycję Wyświetl dzienniki aprowizacji, aby otworzyć blok dzienników aprowizacji. Alternatywnie możesz kliknąć opcję menu Monitorowanie —> dzienniki aprowizacji.
Kliknij 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.
- Krok Określanie, czy użytkownik znajduje się w zakresie, zawiera szczegóły oceny filtru określania zakresu . Domyślnie wszyscy użytkownicy są przetwarzane. Jeśli ustawiono filtr określania zakresu (na przykład przetwarzaj 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.

Dodatek

Wyświetl tę sekcję, aby uzyskać informacje na temat żądania zbiorczego ze schematem użytkownika przedsiębiorstwa SCIM.

Żądanie zbiorcze ze schematem użytkownika przedsiębiorstwa SCIM

Poniższe żądanie zbiorcze używa standardowego użytkownika podstawowego SCIM i schematu 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