Rozšíření zřizování řízeného rozhraním API pro synchronizaci vlastních atributů

Článek
07/29/2024

Aplikace zřizování řízené rozhraním API ve výchozím nastavení podporují atributy zpracování, které jsou součástí standardního schématu uživatele SCIM Core a podnikového uživatele. Váš systém záznamu může mít vlastní atributy, které můžete chtít zahrnout jako součást zřizování řízeného rozhraním API. Tento pokročilý kurz popisuje, jak rozšířit aplikaci zřizování řízenou rozhraním API, aby zpracovávala další vlastní atributy.

Poznámka:

Než se pokusíte tento pokročilý scénář vyzkoušet, doporučujeme ověřit, že vaše předem zařazovací konfigurace aplikace funguje podle očekávání, a to pomocí některého z následujících klientů rozhraní API Graph Explorer, cURL.

Ukázkový scénář

Nakonfigurovali jste aplikaci zřizování řízenou rozhraním API. Zřizovací aplikace úspěšně využívá atributy, které jsou součástí standardního schématu uživatele SCIM Core a podnikového uživatelského schématu a zřizování uživatelů v Microsoft Entra ID. Teď chcete do koncového bodu rozhraní API pro příchozí zřizování odeslat dva vlastní atributy HireDate a JobCode z vašeho systému lidských zdrojů. Tyto dva vlastní atributy byste chtěli namapovat na atributy employeeHireDate Microsoft Entra a jobTitle.

Krok 1 – rozšíření schématu zřizovací aplikace

V tomto kroku přidáme do zřizovací aplikace dva atributy HireDate a JobCode, které nejsou součástí standardního schématu SCIM, a použijeme je ve zřizovacím toku dat.

Přihlaste se do Centra pro správu Microsoft Entra jako alespoň správce aplikací.
Přejděte k podnikovým aplikacím> identit.>
Otevřete aplikaci zřizování řízenou rozhraním API.
Otevřete okno Zřizování.
Klikněte na tlačítko Upravit zřizování .
Rozbalte oddíl Mapování a klikněte na odkaz mapování atributů.
Posuňte se dolů na stránku Mapování atributů . Vyberte Zobrazit upřesňující možnosti a klikněte na seznam Upravit seznam atributů pro odkaz rozhraní API .
Posuňte se dolů na konec stránky Upravit seznam atributů.
Přidejte do seznamu následující dva atributy jako rozšíření schématu SCIM. Můžete použít vlastní obor názvů schématu SCIM.
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:HireDate
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode
Uložení změn

Poznámka:

Pokud chcete do zřizovací aplikace přidat jenom několik dalších atributů, rozšiřte schéma pomocí Centra pro správu Microsoft Entra. Pokud chcete přidat další vlastní atributy (řekněme 20 a více atributů), doporučujeme použít UpdateSchema režim CSV2SCIM skriptu PowerShellu, který automatizuje výše uvedený ruční proces.

Krok 2 – mapování vlastních atributů

Teď přidáme tato rozšíření do mapování atributů zřizovací aplikace.

Na stránce mapování atributů klikněte na odkaz Přidat nové mapování.
Namapujte urn:ietf:params:scim:schemas:extension:contoso:1.0:User:HireDate atribut na employeeHireDate. Klikněte na OK.
Dále vyberte existující mapování title a kliknutím na něj mapování upravte.
Upravte mapování atributů na výraz, který bude obsahovat urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode jako součást atributu jobTitle Microsoft Entra.
```
  Join("", [title], "(", [urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode], ")")
```
Při mapování tohoto výrazu title , pokud je "Tour Lead" a JobCodeje TL-1001, pak atribut jobTitle Microsoft Entra bude nastaven na "Tour Lead (TL-1001)".
Uložte mapování atributů.

Krok 3 : Nahrání hromadného požadavku s vlastními atributy

Otevřete klienta rozhraní API (Graph Explorer / cURL).
Zkopírujte hromadný požadavek s vlastními atributy.
Odešlete hromadnou žádost na adresu URL koncového bodu zřizovacího rozhraní API.
Po nějaké době můžete zkontrolovat protokoly zřizování a ověřit změnu atributu.
Změnu můžete ověřit také v profilu uživatele Microsoft Entra. Hodnota pro Employee hire date odráží časové pásmo vašeho tenanta.

Dodatek

Hromadný požadavek s vlastními atributy

Hromadný požadavek zahrnuje vlastní atributy nakonfigurované v předchozích krocích.

Text požadavku

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

Sdílet prostřednictvím