Gyorsútmutató API-alapú bejövő kiépítés a Graph Explorerrel

Cikk
02/28/2024

Ez az oktatóanyag azt ismerteti, hogyan tesztelheti gyorsan az API-alapú bejövő kiépítést a Microsoft Graph Explorerrel.

Előfeltételek

Konfigurálta az API-alapú bejövő kiépítési alkalmazást.

Feljegyzés

Ez a kiépítési API elsősorban egy alkalmazáson vagy szolgáltatáson belüli használatra szolgál. A bérlői rendszergazdák konfigurálhatnak egy szolgáltatásnevet vagy egy felügyelt identitást, hogy engedélyt adjanak a feltöltés végrehajtására. Ehhez az API-hoz nincs külön felhasználó által hozzárendelhető Microsoft Entra beépített címtárszerepkör. Azon alkalmazásokon kívül, amelyek rendszergazdai hozzájárulással szereztek SynchronizationData-User.Upload be engedélyt, csak a globális Rendszergazda istrator szerepkörrel rendelkező rendszergazdai felhasználók hívhatják meg az API-t. Ez az oktatóanyag bemutatja, hogyan tesztelheti az API-t globális rendszergazdai szerepkörrel a tesztbeállításban.

Felhasználói adatok feltöltése a bejövő kiépítési API-ba

Nyisson meg egy új böngészőlapot vagy böngészőablakot.
Indítsa el az URL-címet https://aka.ms/ge a Microsoft Graph Explorer eléréséhez.
A bejelentkezéshez kattintson a felhasználói profil ikonra.
Fejezze be a bejelentkezési folyamatot egy globális Rendszergazda istrator szerepkörrel rendelkező felhasználói fiókkal.
Sikeres bejelentkezés esetén a bérlő adatai megjelenítik a bérlő nevét.

Most már készen áll az API meghívására.
Az API-kérelem panelen állítsa a HTTP-kérés típusát POST értékre.
Másolja és illessze be a kiépítési alkalmazás áttekintési oldaláról lekért kiépítési API-végpontot.
A Kérelem fejlécek panelen adjon hozzá egy új, Content-Type = application/scim+json kulcsértékpárt.
A Kérelem törzspanel alatt másolja be a tömeges kérelmet az SCIM Vállalati felhasználói sémával
A Lekérdezés futtatása gombra kattintva küldje el a kérést a kiépítési API-végpontnak.
Ha a kérés elküldése sikeresen megtörtént, választ kap Accepted 202 az API-végponttól.
Nyissa meg a Válasz fejlécek panelt, és másolja ki a helyattribútum URL-címét. Ez a kiépítési naplók API-végpontjára mutat, amelyet lekérdezhet a tömeges kérelemben szereplő felhasználók kiépítési állapotának ellenőrzéséhez.

A tömeges kérelem hasznos adatainak feldolgozásának ellenőrzése

A feldolgozást a Microsoft Entra felügyeleti központban vagy a Graph Explorer használatával ellenőrizheti.

Feldolgozás ellenőrzése a Microsoft Entra Felügyeleti központból

Jelentkezzen be a Microsoft Entra felügyeleti központba legalább application Rendszergazda istrator bejelentkezési hitelesítő adatokkal.
Keresse meg a Microsoft Entra ID - Applications - Enterprise applications (Alkalmazások –>> Nagyvállalati alkalmazások) lehetőséget.
Az összes alkalmazásnál használja a keresési szűrő szövegmezőt az API-alapú kiépítési alkalmazás megkereséséhez és megnyitásához.
Nyissa meg a Kiépítés panelt. A kezdőlap az utolsó futtatás állapotát jeleníti meg.
Kattintson a Kiépítési naplók megtekintése elemre a kiépítési naplók panel megnyitásához. Másik lehetőségként kattintson a Monitor –> Kiépítési naplók menüpontra.
A további feldolgozási részletek megtekintéséhez kattintson a kiépítési naplók bármelyik rekordjára.
A kiépítési napló részleteinek képernyője megjeleníti az adott felhasználóhoz végrehajtott összes lépést.
- Az API-ból való importálás lépésnél tekintse meg a tömeges kérelemből kinyert felhasználói adatok részleteit.
- Az Egyezés felhasználói lépés az egyező azonosító alapján jeleníti meg a felhasználói egyezés részleteit. Ha egy felhasználó egyezik, a kiépítési szolgáltatás frissítési műveletet hajt végre. Ha nincs felhasználói egyezés, akkor a kiépítési szolgáltatás létrehoz egy műveletet.
- A Hatókörön belüli felhasználó meghatározása lépés a hatókör-szűrés kiértékelésének részleteit jeleníti meg. Alapértelmezés szerint a rendszer minden felhasználót feldolgoz. Ha beállított egy hatókörszűrőt (például csak az értékesítési részleghez tartozó felhasználók feldolgozását), a hatókörszűrő kiértékelési adatai ebben a lépésben jelennek meg.
- A Felhasználó kiépítése lépés meghívja a felhasználói fiókra alkalmazott utolsó feldolgozási lépést és módosításokat.
- A Módosított tulajdonságok lapon megtekintheti az attribútumfrissítéseket.

Feldolgozás ellenőrzése kiépítési naplók API-val a Graph Explorerben

A feldolgozást a kiépítési API-hívás hely válaszfejlécének részeként visszaadott kiépítési naplók API-URL-címével vizsgálhatja meg.

A Graph Explorerben másolja be a kiépítési API-végpont által visszaadott hely URL-címét a Graph Explorer URL-címére , vagy állítsa össze a formátumot: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' ahol lekérheti a jobId kiépítési alkalmazás áttekintési oldaláról.
Használja a GET metódust, és kattintson a Lekérdezés futtatása gombra a kiépítési naplók lekéréséhez. Alapértelmezés szerint a visszaadott válasz az összes naplórekordot tartalmazza.
Több szűrőt is beállíthat úgy, hogy csak egy adott időkeret után vagy egy adott állapotértékkel kérje le az adatokat. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z A felhasználó állapotát a forrásrendszerben használt érték alapján externalId is ellenőrizheti, amelyet a forráshorgony/illesztési tulajdonságként használnak. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Függelék

Tömeges kérelem SCIM vállalati felhasználói sémával

Az alább látható tömeges kérelem az SCIM standard alapszintű felhasználói és vállalati felhasználói sémáját használja.

Kérelem törzse

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

Megosztás a következőn keresztül: