API-alapú kiépítés kiterjesztése egyéni attribútumok szinkronizálására

Cikk
02/28/2024

Az API-alapú kiépítési alkalmazások alapértelmezés szerint támogatják a szabványos SCIM Core felhasználói és vállalati felhasználói séma részét képező feldolgozási attribútumokat. Előfordulhat, hogy a rekordrendszer olyan egyéni attribútumokkal rendelkezik, amelyeket az API-alapú kiépítés részeként fel szeretne venni. Ez a speciális oktatóanyag bemutatja, hogyan terjesztheti ki az API-alapú kiépítési alkalmazást további egyéni attribútumok feldolgozására.

Feljegyzés

A speciális forgatókönyv kipróbálása előtt javasoljuk, hogy ellenőrizze, hogy a beépített kiépítési alkalmazás konfigurációja a várt módon működik-e az alábbi API-ügyfelek Graph Explorer, cURL vagy Postman használatával.

Példaforgatókönyv

Konfigurálta az API-alapú kiépítési alkalmazást. Az alkalmazás kiépítésével sikeresen használja a szabványos SCIM Core felhasználói és vállalati felhasználói séma részét képező attribútumokat, és felhasználókat épít ki a Microsoft Entra ID-ban. Most két egyéni attribútumot HireDateJobCode szeretne elküldeni a HR-rendszerből a bejövő kiépítési API-végpontra. Ezt a két egyéni attribútumot a Microsoft Entra attribútumokra employeeHireDate és jobTitlea .

1. lépés – A kiépítési alkalmazásséma kiterjesztése

Ebben a lépésben hozzáadjuk a "HireDate" és a "JobCode" attribútumot, amelyek nem részei a szabványos SCIM-sémának, és használják őket a kiépítési adatfolyamban.

Jelentkezzen be a Microsoft Entra felügyeleti központba legalább egy Alkalmazás Rendszergazda istratorként.
Keresse meg az Identity>Applications>Enterprise-alkalmazásokat.
Nyissa meg az API-alapú kiépítési alkalmazást.
Nyissa meg a Kiépítés panelt .
Kattintson a Kiépítés szerkesztése gombra.
Bontsa ki a Leképezések szakaszt , és kattintson az attribútumleképezési hivatkozásra.
Görgessen le az Attribútumleképezések lapon. Válassza a Speciális beállítások megjelenítése lehetőséget , és kattintson az API-hivatkozás attribútumlistájának szerkesztésére.
Görgessen le az Attribútumlista szerkesztése lap végéig.
Adja hozzá a következő két attribútumot a listához SCIM-sémabővítményként. Használhatja a saját SCIM-sémanévterét.
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:HireDate
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode
A módosítások mentése

Feljegyzés

Ha csak néhány további attribútumot szeretne hozzáadni a kiépítési alkalmazáshoz, a Microsoft Entra Felügyeleti központ segítségével bővítheti a sémát. Ha további egyéni attribútumokat (például 20+ attribútumot) szeretne hozzáadni, javasoljuk, hogy használja a UpdateSchema CSV2SCIM PowerShell-szkript módot, amely automatizálja a fenti manuális folyamatot.

2. lépés – Az egyéni attribútumok leképezése

Most vegyük fel ezeket a bővítményeket a kiépítési alkalmazásattribútum-leképezéshez.

Kattintson az Attribútumleképezés lapon az Új leképezés hozzáadása hivatkozásra.
Az attribútum leképezése a urn:ietf:params:scim:schemas:extension:contoso:1.0:User:HireDate következőre employeeHireDate: . Kattintson az OK gombra.
Ezután válassza ki a meglévő leképezést title , és kattintson rá a leképezés szerkesztéséhez.
Szerkessze az attribútumleképezést olyan kifejezésre, amely tartalmazza a urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCodejobTitle Microsoft Entra attribútum részét.
```
  Join("", [title], "(", [urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode], ")")
```
Ezzel a kifejezésleképezéssel, ha a title "Tour Lead" és JobCodea "TL-1001", akkor a Microsoft Entra attribútum jobTitle a "Tour Lead (TL-1001)" értékre lesz állítva.
Mentse az attribútumleképezéseket.

3. lépés – Tömeges kérelem feltöltése egyéni attribútumokkal

Nyissa meg az API-ügyfelet (Graph Explorer / Postman / cURL).
Másolja be a tömeges kérelmet egyéni attribútumokkal.
Küldje el a tömeges kérelmet a kiépítési API-végpont URL-címére.
Egy idő után ellenőrizheti a kiépítési naplókat az attribútumváltozás ellenőrzéséhez.
A Microsoft Entra felhasználói profiljában is ellenőrizheti a módosítást. A bérlői időzónát Employee hire date tükröző érték.

Függelék

Tömeges kérelem egyéni attribútumokkal

A tömeges kérelem tartalmazza a fenti lépésekben konfigurált egyéni attribútumokat.

Kérelem törzse

{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
    "Operations": [
    {
        "method": "POST",
        "bulkId": "701984",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
            "urn:ietf:params:scim:schemas:extension:contoso:1.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": "234300 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"
                 }
            },
            "urn:ietf:params:scim:schemas:extension:contoso:1.0:User": {
                "HireDate": "2021-05-01T00:00:00-05:00",
                "JobCode": "TG-1001"
            }            
        }
    },
    {
        "method": "POST",
        "bulkId": "701985",
        "path": "/Users",
        "data": {
            "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
            "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
            "urn:ietf:params:scim:schemas:extension:contoso:1.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": "701984",
              "costCenter": "4130",
              "organization": "Universal Studios",
              "division": "Theme Park",
              "department": "Tour Operations",
              "manager": {
                "value": "701984",
                "displayName": "Barbara Jensen"
             }
            },
            "urn:ietf:params:scim:schemas:extension:contoso:1.0:User": {
                "HireDate": "2022-07-15T00:00:00-05:00",
                "JobCode": "TL-1003"
            }            
        }
    }
],
    "failOnErrors": null
}

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