Rychlé zprovoznění příchozího zřizování řízeného rozhraním API pomocí cURL

Článek
02/28/2024

Úvod

CURL je oblíbený bezplatný opensourcový nástroj příkazového řádku, který používají vývojáři rozhraní API a je ve výchozím nastavení k dispozici ve Windows 10/11. Tento kurz popisuje, jak pomocí cURL rychle otestovat příchozí zřizování řízené rozhraním API.

Požadavky

Nakonfigurovali jste příchozí zřizovací aplikaci řízenou rozhraním API.
Nakonfigurovali jste instanční objekt a má přístup k rozhraní API pro příchozí zřizování. Poznamenejte si aplikaci instančního objektu ClientId pro ClientSecret použití v tomto kurzu.

Nahrání uživatelských dat do rozhraní API pro příchozí zřizování

Načtěte client_id a client_secret instančního objektu, který má přístup k rozhraní API pro příchozí zřizování.
K získání přístupového tokenu použijte OAuth client_credentials udělení toku. Nahraďte proměnné [yourClientId][yourClientSecret] a [yourTenantId] hodnotami platnými pro nastavení a spusťte následující příkaz cURL. Zkopírování vygenerované hodnoty přístupového tokenu
```
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"
```
Zkopírujte hromadný požadavek pomocí schématu uživatele SCIM Enterprise a uložte obsah do souboru s názvem scim-bulk-upload-users.json.
Nahraďte proměnnou [InboundProvisioningAPIEndpoint] koncovým bodem rozhraní API pro zřizování přidruženou k vaší zřizovací aplikaci. [AccessToken] Použijte hodnotu z předchozího kroku a spuštěním následujícího příkazu curl nahrajte hromadný požadavek do koncového bodu zřizovacího rozhraní API.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
Po úspěšném nahrání obdržíte kód odpovědi HTTP 202 Accepted.
Služba zřizování začne okamžitě zpracovávat datovou část hromadné žádosti a podrobnosti o zřizování zobrazíte tak, že se dostanete k protokolům zřizování příchozí aplikace pro zřizování.

Ověření zpracování datové části hromadné žádosti

Přihlaste se k Centru pro správu Microsoft Entra jako alespoň aplikační Správa istrator.
Přejděte na Microsoft Entra ID –> Aplikace –> Podnikové aplikace.
Ve všech aplikacích pomocí textového pole filtru vyhledávání najděte a otevřete aplikaci zřizování řízenou rozhraním API.
Otevřete okno Zřizování. Na cílové stránce se zobrazí stav posledního spuštění.
Kliknutím na Zobrazit protokoly zřizování otevřete okno zřizovací protokoly. Případně můžete kliknout na možnost Sledování nabídky –> Protokoly zřizování.
Kliknutím na libovolný záznam v protokolech zřizování zobrazíte další podrobnosti o zpracování.
Na obrazovce s podrobnostmi protokolu zřizování se zobrazí všechny kroky provedené pro konkrétního uživatele.
- V kroku Import z rozhraní API najdete podrobnosti o uživatelských datech extrahovaných z hromadné žádosti.
- Krok Match user (Shoda) zobrazuje podrobnosti o jakékoli shodě uživatele na základě odpovídajícího identifikátoru. Pokud dojde ke shodě uživatele, služba zřizování provede operaci aktualizace. Pokud se žádný uživatel neshoduje, služba zřizování provede operaci vytvoření.
- V kroku Určení, jestli je uživatel v kroku oboru, se zobrazují podrobnosti o vyhodnocení filtru oborů . Ve výchozím nastavení se zpracovávají všichni uživatelé. Pokud jste nastavili filtr oborů (například zpracování pouze uživatelů patřících do prodejního oddělení), zobrazí se v tomto kroku podrobnosti vyhodnocení filtru oborů.
- Krok Zřizování uživatele označuje poslední krok zpracování a změny použité na uživatelský účet.
- K zobrazení aktualizací atributů použijte kartu Změněné vlastnosti.

Dodatek

V této části najdete informace o hromadné žádosti pomocí schématu uživatele SCIM Enterprise.

Hromadný požadavek se schématem uživatele SCIM Enterprise

Následující hromadná žádost používá standardní uživatelské schéma základního uživatele a podnikového uživatelského schématu SCIM.

Text požadavku

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

Sdílet prostřednictvím