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

Článek
02/28/2024

Tento kurz popisuje, jak pomocí Microsoft Graph Exploreru rychle otestovat příchozí zřizování řízené rozhraním API.

Požadavky

Nakonfigurovali jste příchozí zřizovací aplikaci řízenou rozhraním API.

Poznámka:

Toto rozhraní API pro zřizování je primárně určené pro použití v rámci aplikace nebo služby. Správci tenanta můžou buď nakonfigurovat instanční objekt, nebo spravovanou identitu, aby udělili oprávnění k provedení nahrávání. Pro toto rozhraní API neexistuje samostatná uživatelsky přiřaditelná role adresáře Microsoft Entra. Mimo aplikace, které získaly SynchronizationData-User.Upload oprávnění se souhlasem správce, můžou rozhraní API vyvolat jenom uživatelé s rolí globálního Správa istratoru. V tomto kurzu se dozvíte, jak můžete v nastavení testu otestovat rozhraní API s rolí globálního správce.

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

Otevřete novou kartu prohlížeče nebo okno prohlížeče.
Spusťte adresu URL https://aka.ms/ge pro přístup k Microsoft Graph Exploreru.
Přihlaste se kliknutím na ikonu profilu uživatele.
Dokončete proces přihlášení pomocí uživatelského účtu, který má roli Globální Správa istrator.
Po úspěšném přihlášení se v informacích o tenantovi zobrazí název vašeho tenanta.

Teď jste připraveni vyvolat rozhraní API.
Na panelu požadavků rozhraní API nastavte typ požadavku HTTP na POST.
Zkopírujte a vložte koncový bod zřizovacího rozhraní API načtený ze stránky přehledu zřizovací aplikace.
Na panelu Hlavičky požadavku přidejte novou dvojici hodnot klíče Content-Type = application/scim+json.
Na panelu Textu požadavku zkopírujte hromadný požadavek pomocí schématu uživatele SCIM Enterprise.
Kliknutím na tlačítko Spustit dotaz odešlete požadavek do koncového bodu rozhraní API zřizování.
Pokud se požadavek úspěšně odešle, obdržíte Accepted 202 odpověď z koncového bodu rozhraní API.
Otevřete panel Hlavičky odpovědi a zkopírujte hodnotu adresy URL atributu location. Tím se odkazuje na koncový bod rozhraní API pro zřizování protokolů, na který se můžete dotazovat a zkontrolovat stav zřizování uživatelů, kteří jsou v hromadné žádosti.

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

Zpracování můžete ověřit v Centru pro správu Microsoft Entra nebo pomocí Graph Exploreru.

Ověření zpracování z Centra pro správu Microsoft Entra

Přihlaste se do Centra pro správu Microsoft Entra s přihlašovacími údaji aspoň Správa istratoru.
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 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.

Ověření zpracování pomocí rozhraní API pro zřizování protokolů v Graph Exploreru

Zpracování můžete zkontrolovat pomocí adresy URL rozhraní API pro zřizování protokolů vrácenou jako součást hlavičky odpovědi na umístění ve volání rozhraní API zřizování.

V Graph Exploreru zkopírujte textovou adresu URL požadavku a vložte adresu URL umístění vrácenou koncovým bodem zřizovacího rozhraní API nebo ji můžete vytvořit pomocí formátu: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' kde můžete načíst ze stránky přehledu jobId zřizovací aplikace.
Použijte metodu GET a kliknutím na Spustit dotaz načtěte protokoly zřizování. Vrácená odpověď ve výchozím nastavení obsahuje všechny záznamy protokolu.
Další filtry můžete nastavit tak, aby se data načítala pouze po určitém časovém rámci nebo s konkrétní hodnotou stavu. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z Stav uživatele můžete také zkontrolovat hodnotou externalId použitou ve zdrojovém systému, která se používá jako vlastnost zdrojové ukotvení nebo spojení. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Dodatek

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

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

Text 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
}

Sdílet prostřednictvím