Sdílet prostřednictvím

Rychlý start: Začínáme s příchozím zřizováním řízeným rozhraním API pomocí cURL

  • Článek

Ú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í dostupný ve Windows 10/11. Tento kurz popisuje, jak pomocí cURL rychle otestovat příchozí zřizování řízené rozhraním API.

Požadavky

Nahrajte uživatelská data do vstupního rozhraní API pro zřizování

  1. 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í.
  2. K získání přístupového tokenu použijte OAuth typ udělení client_credentials. 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"
  3. Zkopírujte hromadný požadavek s uživatelským schématem SCIM Enterprise a uložte obsah do souboru nazvaného scim-bulk-upload-users.json.
  4. Nahraďte proměnnou [InboundProvisioningAPIEndpoint] koncovým bodem rozhraní API zřizování přidruženým k vaší zřizovací aplikaci. Použijte hodnotu [AccessToken] 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"
  5. Po úspěšném nahrání obdržíte kód odpovědi HTTP 202 Accepted.
  6. Služba zřizování začne okamžitě zpracovávat obsah hromadné žádosti a podrobnosti o zřizování můžete zobrazit přístupem k protokolům příchozí aplikace pro zřizování.

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

  1. Přihlaste se k Centru pro správu Microsoft Entra s oprávněním alespoň Správce aplikací.

  2. Přejděte na Microsoft Entra ID -> Aplikace -> Podnikové Aplikace.

  3. 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.

  4. Otevřete panel Zřizování. Na vstupní stránce se zobrazí stav posledního spuštění.

  5. Kliknutím na Zobrazit protokoly zřizování zobrazíte panel zřizovacích protokolů. Případně můžete kliknout na možnost nabídky Monitorování –> protokoly zřizování.

    snímek obrazovky protokolů o zřizování v nabídce

  6. Kliknutím na libovolný záznam v protokolech zřizování zobrazíte další podrobnosti o zpracování.

  7. 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 si prohlédněte podrobnosti o uživatelských datech extrahovaných z hromadné žádosti.
    • Krok Match user zobrazuje podrobnosti o 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í.
    • Určení, zda je uživatel v rámci, krok zobrazuje podrobnosti o vyhodnocení filtru rozsahu. 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řízení uživatele označuje poslední krok zpracování a změny použité u uživatelského účtu.
    • Pomocí karty Změněné vlastnosti zobrazte aktualizace atributů.

Příloha

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

Hromadný požadavek s uživatelským schématem 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.

textu požadavku

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

Další kroky