Utöka API-driven etablering för att synkronisera anpassade attribut
Som standard stöder API-drivna etableringsappar bearbetningsattribut som ingår i standardschemat för SCIM Core-användare och företagsanvändare. Ditt postsystem kan ha anpassade attribut som du kanske vill inkludera som en del av API-driven etablering. Den här avancerade självstudien beskriver hur du utökar din API-drivna etableringsapp för att bearbeta ytterligare anpassade attribut.
Kommentar
Innan du provar det här avancerade scenariot rekommenderar vi att du kontrollerar att din färdiga konfiguration av etableringsappen fungerar som förväntat med någon av följande API-klienter Graph Explorer, cURL eller Postman.
Exempelscenario
Du har konfigurerat en API-driven etableringsapp. Du etablerar appen använder de attribut som ingår i SCIM Core-standardschemat för användare och företagsanvändare och etablerar användare i Microsoft Entra-ID. Nu vill du skicka två anpassade attribut HireDate och JobCode från HR-systemet till API-slutpunkten för inkommande etablering. Du vill mappa dessa två anpassade attribut till Microsoft Entra-attribut employeeHireDate och jobTitle.
Steg 1 – Utöka schemat för etableringsappen
I det här steget lägger vi till de två attributen "HireDate" och "JobCode" som inte ingår i SCIM-standardschemat i etableringsappen och använder dem i etableringsdataflödet.
- Logga in på administrationscentret för Microsoft Entra som minst programadministratör.
- Bläddra till Identity>Applications Enterprise-program.>
- Öppna din API-drivna etableringsapp.
- Öppna bladet Etablering.
- Klicka på knappen Redigera etablering .
- Expandera avsnittet Mappningar och klicka på länken för attributmappning.
- Rulla nedåt på sidan Attributmappningar . Välj Visa avancerade alternativ och klicka på länken Redigera attribut för API .
- Rulla ned till slutet av sidan Redigera attributlista .
- Lägg till följande två attribut i listan som SCIM-schematillägg. Du kan använda ditt eget SCIM-schemanamnområde.
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:HireDate
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode
- Spara ändringarna
Kommentar
Om du bara vill lägga till några ytterligare attribut i etableringsappen använder du administrationscentret för Microsoft Entra för att utöka schemat. Om du vill lägga till fler anpassade attribut (låt oss säga 20+ attribut) rekommenderar vi att du använder UpdateSchema läget för CSV2SCIM PowerShell-skript som automatiserar ovanstående manuella process.
Steg 2 – Mappa anpassade attribut
Nu ska vi lägga till dessa tillägg i attributmappningen för etableringsappen.
Klicka på länken Lägg till ny mappning på sidan Attributmappning .
Mappa attributet
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:HireDatetillemployeeHireDate. Klicka på OK.
Välj sedan den befintliga mappningen för och klicka på den för
titleatt redigera mappningen.Redigera attributmappningen till ett uttryck som ska inkludera
urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCodesom en del avjobTitleMicrosoft Entra-attributet.Join("", [title], "(", [urn:ietf:params:scim:schemas:extension:contoso:1.0:User:JobCode], ")")
Med den här uttrycksmappningen, om
titleär "Tour Lead" ochJobCodeär "TL-1001", ställs Microsoft Entra-attributetjobTitlein på "Tour Lead (TL-1001)".Spara attributmappningarna.
Steg 3 – Ladda upp massbegäran med anpassade attribut
- Öppna API-klienten (Graph Explorer/Postman/cURL).
- Kopiera och klistra in massbegäran med anpassade attribut.
- Skicka massbegäran till din API-slutpunkts-URL för etablering.
- Efter en tid kan du kontrollera etableringsloggarna för att verifiera attributändringen.
- Du kan också verifiera ändringen i Microsoft Entra-användarprofilen. Värdet för
Employee hire dateåterspeglar din klientorganisations tidszon.
Bilaga
Massbegäran med anpassade attribut
Massbegäran innehåller de anpassade attribut som konfigurerats i stegen ovan.
Begärandetext
{
"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
}