Szybki start: rozpoczynanie pracy z aprowizowaniem przychodzącym opartym na interfejsie API przy użyciu biblioteki cURL
Wprowadzenie
cURL jest popularnym, bezpłatnym narzędziem typu open source, narzędziem wiersza polecenia, używanym przez deweloperów interfejsu API i 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ę provisioning inbound sterowaną przez API.
-
skonfigurowano jednostkę usługi i ma dostęp do przychodzącego interfejsu API aprowizacji. Zanotuj identyfikatory
ClientIdiClientSecretaplikacji 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 obiektu usługi, która ma dostęp do interfejsu API aprowizacji przychodzącej.
- Użyj przepływu klienta 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ępucurl -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 SCIM Enterprise 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 przekazaniu otrzymasz kod odpowiedzi HTTP 202: Zaakceptowane.
- 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 Microsoft Entra jako co najmniej Administrator aplikacji.
Przejdź do 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 panel aprowizacji. 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 Monitor —> 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 Importowania z interfejsu API sprawdź szczegóły danych użytkownika wyodrębnionych z żądania grupowego.
- 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 konfiguracji wykonuje operację tworzenia.
- Określanie, czy użytkownik znajduje się w zakresie kroku zawiera szczegółowe informacje dotyczące oceny filtru określania zakresu. Domyślnie wszyscy użytkownicy są przetwarzani. 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 Udostępnienie użytkownika oznacza ostatni etap przetwarzania i wprowadzone zmiany do konta użytkownika.
- Użyj karty zmodyfikowanych 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
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
}