Rövid útmutató API-vezérelt bejövő kiépítés a cURL használatával

Cikk
02/28/2024

Bevezetés

A cURL egy népszerű, ingyenes, nyílt forráskódú parancssori eszköz, amelyet az API-fejlesztők használnak, és alapértelmezés szerint elérhető a Windows 10/11-ben. Ez az oktatóanyag bemutatja, hogyan tesztelheti gyorsan az API-alapú bejövő kiépítést a cURL használatával.

Előfeltételek

Konfigurálta az API-alapú bejövő kiépítési alkalmazást.
Konfigurált egy szolgáltatásnevet, és hozzáféréssel rendelkezik a bejövő kiépítési API-hoz. Jegyezze fel az ClientId oktatóanyagban használt egyszerű szolgáltatásalkalmazást és ClientSecret annak használatát.

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

Kérje le a bejövő kiépítési API-hoz hozzáféréssel rendelkező szolgáltatásnév client_id és client_secret .
Az OAuth client_credentials hozzáférési jogkivonat lekéréséhez adja meg a folyamatot. Cserélje le a változókat [yourClientId]és [yourTenantId][yourClientSecret] a beállításokra vonatkozó értékeket, és futtassa a következő cURL parancsot. A létrehozott hozzáférési jogkivonat értékének másolása
```
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"
```
Másolja ki a tömeges kérelmet az SCIM Vállalati felhasználói sémával , és mentse a tartalmat egy nevű scim-bulk-upload-users.jsonfájlba.
Cserélje le a változót [InboundProvisioningAPIEndpoint] a kiépítési alkalmazáshoz társított kiépítési API-végpontra. Használja az [AccessToken] előző lépés értékét, és futtassa a következő curl parancsot a tömeges kérés feltöltéséhez a kiépítési API-végpontra.
```
curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
```
Sikeres feltöltés után HTTP 202 Elfogadva válaszkódot kap.
A kiépítési szolgáltatás azonnal megkezdi a tömeges kérelem hasznos adatainak feldolgozását, és a kiépítési adatokat a bejövő kiépítési alkalmazás kiépítési naplóihoz való hozzáféréssel tekintheti meg.

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

Jelentkezzen be a Microsoft Entra Felügyeleti központba legalább egy alkalmazás Rendszergazda istratorként.
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.

Függelék

Ebben a szakaszban az SCIM Enterprise felhasználói sémával rendelkező tömeges kéréssel kapcsolatos információkat tekintheti meg.

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: