Oktatóanyag: Attribútumvisszaírás konfigurálása a Microsoft Entra-azonosítóról az SAP SuccessFactors szolgáltatásba

Ennek az oktatóanyagnak az a célja, hogy bemutassuk a Microsoft Entra-azonosítótól az SAP SuccessFactors Employee Centralig az attribútumok visszaírásának lépéseit.

Áttekintés

Az SAP SuccessFactors Writeback alkalmazás konfigurálható úgy, hogy meghatározott attribútumokat írjon a Microsoft Entra-azonosítóból az SAP SuccessFactors Employee Centralba. A SuccessFactors visszaíró kiépítési alkalmazás támogatja az értékek hozzárendelését a következő Employee Central attribútumokhoz:

• Munkahelyi e-mail:
• Felhasználónév
• Üzleti telefonszám (beleértve az országkódot, a körzetszámot, a számot és a bővítményt)
• Üzleti telefonszám elsődleges jelzője
• Mobiltelefonszám (országkód, körzetszám, szám)
• Mobiltelefon elsődleges jelzője
• User custom01-custom15 attribútumok
• loginMethod attribútum

Feljegyzés

Ez az alkalmazás nem függ a SuccessFactors bejövő felhasználókiépítési integrációs alkalmazásaitól. A SuccessFactorstól függetlenül konfigurálhatja helyszíni AD-kiépítési alkalmazásra vagy SuccessFactors-ra a Microsoft Entra ID kiépítési alkalmazáshoz.

A támogatott forgatókönyvekkel, ismert problémákkal és korlátozásokkal kapcsolatos további részletekért tekintse meg az SAP SuccessFactors integrációs referencia-útmutatójának Visszaírási forgatókönyvek szakaszát .

Kiknek ideális ez a felhasználói kiépítési megoldás?

Ez a SuccessFactors Writeback felhasználói kiépítési megoldás ideális a következőkhöz:

• Azok a Microsoft 365-öt használó szervezetek, amelyek vissza szeretnék írni az it által kezelt mérvadó attribútumokat (például e-mail-címet, telefonszámot, felhasználónevet) a SuccessFactors Employee Centralnak.

SuccessFactors konfigurálása az integrációhoz

Az összes SuccessFactors kiépítési összekötőhöz szükség van egy SuccessFactors-fiók hitelesítő adataira, és megfelelő engedélyekkel kell meghívni az Employee Central OData API-kat. Ez a szakasz a szolgáltatásfiók SuccessFactorsban való létrehozásának és a megfelelő engedélyek megadásának lépéseit ismerteti.

• API-felhasználói fiók létrehozása/azonosítása a SuccessFactorsben
• API-jogosultsági szerepkör létrehozása
• Engedélycsoport létrehozása az API-felhasználó számára
• Engedélyszerepkör megadása az engedélycsoportnak

API-felhasználói fiók létrehozása/azonosítása a SuccessFactorsben

A SuccessFactors felügyeleti csapatával vagy a megvalósítási partnerével együttműködve hozzon létre vagy azonosítsa a successFactors felhasználói fiókját az OData API-k meghívásához. A fiók felhasználóneve és jelszavas hitelesítő adatai szükségesek a kiépítési alkalmazások Microsoft Entra-azonosítóban való konfigurálásához.

API-jogosultsági szerepkör létrehozása

1. Jelentkezzen be az SAP SuccessFactors szolgáltatásba egy olyan felhasználói fiókkal, amely hozzáfér a Felügyeleti központhoz.

2. Keresse meg a Jogosultsági szerepkörök kezelése lehetőséget, majd válassza az Engedélyszerepkörök kezelése lehetőséget a keresési eredmények között.

   

3. A jogosultsági szerepkörök listájában kattintson az Új létrehozása gombra.

   

4. Adjon hozzá egy szerepkörnevet és leírást az új engedélyszerepkörhöz. A névnek és a leírásnak azt kell jeleznie, hogy a szerepkör API-használati engedélyekhez tartozik.

   

5. Az Engedélybeállítások területen kattintson az Engedély... elemre, majd görgessen le az engedélylistán, és kattintson az Integrációs eszközök kezelése parancsra. Jelölje be azt a jelölőnégyzetet, amely lehetővé teszi, hogy a rendszergazda az OData API-hoz egyszerű hitelesítéssel férhessen hozzá.

   

6. Görgessen le ugyanabban a mezőben, és válassza az Employee Central API lehetőséget. Adja hozzá az alábbi engedélyeket az ODATA API használatával való olvasáshoz és az ODATA API használatával végzett szerkesztéshez. Válassza a szerkesztési lehetőséget, ha ugyanazt a fiókot szeretné használni a SuccessFactors forgatókönyvbe való visszaíráshoz.

   

7. Kattintson a Kész gombra. Kattintson a Save Changes (Módosítások mentése) gombra.

Engedélycsoport létrehozása az API-felhasználó számára

1. A SuccessFactors Felügyeleti központban keresse meg az Engedélycsoportok kezelése lehetőséget, majd válassza az Engedélycsoportok kezelése lehetőséget a keresési eredmények között.

   

2. Az Engedélycsoportok kezelése ablakban kattintson az Új létrehozása gombra.

   

3. Adjon hozzá egy csoportnevet az új csoporthoz. A csoport nevének azt kell jeleznie, hogy a csoport API-felhasználók számára készült.

   

4. Tagok hozzáadása a csoporthoz. Kiválaszthatja például a Felhasználónév lehetőséget a Kapcsolatok készlet legördülő menüben, majd megadhatja az integrációhoz használni kívánt API-fiók felhasználónevét.

   

5. Kattintson a Kész gombra az engedélycsoport létrehozásának befejezéséhez.

Engedélyszerepkör megadása az engedélycsoportnak

1. A SuccessFactors Felügyeleti központban keresse meg az Engedélyszerepkörök kezelése lehetőséget, majd válassza az Engedélyszerepkörök kezelése lehetőséget a keresési eredmények között.

2. Az engedélyszerepkör-listából válassza ki az API-használati engedélyekhez létrehozott szerepkört.

3. A Szerepkör engedélyezése...csoportban kattintson a Hozzáadás... gombra. Gomb.

4. Válassza az Engedélycsoport lehetőséget... a legördülő menüben, majd a Kiválasztás gombra kattintva nyissa meg a Csoportok ablakot a kereséshez, és válassza ki a fent létrehozott csoportot.

   

5. Tekintse át az engedélycsoport engedélyszerepkör-engedélyének megadását.

   

6. Kattintson a Save Changes (Módosítások mentése) gombra.

Felkészülés a SuccessFactors visszaírására

A SuccessFactors Writeback kiépítési alkalmazás bizonyos kódértékeket használ az e-mailek és a telefonszámok beállításához az Employee Centralban. Ezek a kódértékek állandó értékekként vannak beállítva az attribútumleképezési táblában, és minden SuccessFactors-példány esetében eltérőek. Ez a szakasz a kódértékek rögzítésének lépéseit ismerteti.

Feljegyzés

Kérje meg a SuccessFactors rendszergazdáját, hogy végezze el az ebben a szakaszban leírt lépéseket.

E-mail- és telefonszámválasztó listák nevének azonosítása

Az SAP SuccessFactorsben a választólista konfigurálható lehetőségek készlete, amelyek közül a felhasználó kiválaszthat. A különböző típusú e-mailek és telefonszámok (például üzleti, személyes és egyéb) egy választólista használatával jelennek meg. Ebben a lépésben azonosítjuk a SuccessFactors-bérlőben az e-mail- és telefonszámértékek tárolására konfigurált választólistákat.

1. A SuccessFactors Felügyeleti központban keresse meg az Üzleti konfiguráció kezelése lehetőséget.

   

2. A HRIS-elemek területen válassza az e-mailInfo lehetőséget, és kattintson az e-mail típusú mező Részletei elemére.

   

3. Az e-mail típusú részletek lapon jegyezze fel a mezőhöz társított választólista nevét. Alapértelmezés szerint ecEmailType. A bérlőben azonban eltérő lehet.

   

4. A HRIS-elemek területen válassza a phoneInfo lehetőséget, és kattintson a Telefontípus mező Részletei elemére.

   

5. A telefontípus részletei lapon jegyezze fel a mezőhöz társított lista nevét. Alapértelmezés szerint ecPhoneType. A bérlőben azonban eltérő lehet.

   

Az e-mailType állandó értékének lekérése

1. A SuccessFactors Felügyeleti központban keresse meg és nyissa meg a Picklist Centert.

2. Az e-mail-választólista megkereséséhez használja az előző szakaszban rögzített e-mail-választólista nevét (például ecEmailType).

   

3. Nyissa meg az aktív e-mail-választólistát.

   

4. Az e-mail-típusválasztó lapon válassza az Üzleti e-mail típust.

   

5. Jegyezze fel a Vállalati e-mailhez társított beállításazonosítót. Ezt a kódot fogjuk használni az e-mailType használatával az attribútumleképezési táblában.

   

   Feljegyzés

   Húzza a vessző karaktert az érték fölé másoláskor. Ha például a Option ID értéke 8448, akkor a Microsoft Entra ID-ban az e-mailType értéket állítsa a 8448-es állandószámra (vessző karakter nélkül).

A phoneType állandó értékének lekérése

1. A SuccessFactors Felügyeleti központban keresse meg és nyissa meg a Picklist Centert.

2. Használja az előző szakaszban rögzített telefonválasztólista nevét a telefonválasztó listájának megkereséséhez.

   

3. Nyissa meg az aktív telefonválasztólistát.

   

4. A telefontípusválasztó lapon tekintse át a Picklist Értékek területen felsorolt különböző telefontípusokat.

   

5. Jegyezze fel a vállalati telefonhoz társított beállításazonosítót. Ezt a kódot fogjuk használni a businessPhoneType használatával az attribútumleképezési táblában.

   

6. Jegyezze fel a mobiltelefonhoz társított beállításazonosítót. Ezt a kódot fogjuk használni a cellPhoneType használatával az attribútumleképezési táblában.

   

   Feljegyzés

   Húzza a vessző karaktert az érték fölé másoláskor. Ha például az Option ID értéke 10 606, akkor a Microsoft Entra ID cellPhoneType elemét állítsa az 10606-os állandószámra (vessző karakter nélkül).

SuccessFactors Writeback alkalmazás konfigurálása

Ez a szakasz a következőhöz nyújt lépéseket:

• A kiépítési összekötő alkalmazás hozzáadása és a SuccessFactors-kapcsolat konfigurálása
• Attribútumleképezések konfigurálása
• Felhasználói kiépítés engedélyezése és elindítása

1. rész: A kiépítési összekötő alkalmazás hozzáadása és a SuccessFactors-kapcsolatok konfigurálása

A SuccessFactors Visszaírás konfigurálása:

1. Jelentkezzen be a Microsoft Entra felügyeleti központba legalább felhőalkalmazás-rendszergazdaként.

2. Keresse meg az Identity>Applications>Enterprise-alkalmazásokat>Új alkalmazás.

3. Keresse meg a SuccessFactors Writebacket, és adja hozzá az alkalmazást a katalógusból.

4. Az alkalmazás hozzáadása és az alkalmazás részletei képernyő megjelenítése után válassza a Kiépítés lehetőséget

5. A kiépítési mód módosítása automatikusra

6. Töltse ki a Rendszergazdai hitelesítő adatok szakaszt az alábbiak szerint:

   • Rendszergazdai felhasználónév – Adja meg a SuccessFactors API felhasználói fiók felhasználónevét, hozzáfűzve a cégazonosítót. Formátuma: username@companyID

   • Rendszergazdai jelszó – Adja meg a SuccessFactors API felhasználói fiók jelszavát.

   • Bérlő URL-címe – Adja meg a SuccessFactors OData API-szolgáltatások végpontjának nevét. Csak a kiszolgáló gazdanevét adja meg http vagy https nélkül. Ennek az értéknek a következőképpen kell kinéznie: api4.successfactors.com.

   • Értesítési e-mail – Adja meg az e-mail-címét, és jelölje be az "E-mail küldése sikertelenség esetén" jelölőnégyzetet.

   Feljegyzés

   A Microsoft Entra kiépítési szolgáltatás e-mailben értesítést küld, ha a kiépítési feladat karanténba kerül.

   • Kattintson a Kapcsolat tesztelése gombra. Ha a kapcsolati teszt sikeres, kattintson a felül található Mentés gombra. Ha nem sikerül, ellenőrizze, hogy a SuccessFactors hitelesítő adatai és URL-címe érvényes-e.

   

   • A hitelesítő adatok sikeres mentése után a Leképezések szakasz megjeleníti az alapértelmezett leképezést. Frissítse a lapot, ha az attribútumleképezések nem láthatók.

2. rész: Attribútumleképezések konfigurálása

Ebben a szakaszban azt konfigurálja, hogy a felhasználói adatok hogyan áramlanak a SuccessFactorsből az Active Directoryba.

1. A Leképezések alatti Kiépítés lapon kattintson a Microsoft Entra-felhasználók kiosztása elemre.

2. A Forrásobjektum hatóköre mezőben megadhatja, hogy a Microsoft Entra ID-ban mely felhasználókat érdemes figyelembe venni a visszaíráshoz, ha attribútumalapú szűrőket határoz meg. Az alapértelmezett hatókör a Microsoft Entra-azonosító összes felhasználója.

   Tipp.

   Amikor első alkalommal konfigurálja a kiépítési alkalmazást, tesztelnie és ellenőriznie kell az attribútumleképezéseket és -kifejezéseket, hogy biztosan a kívánt eredményt adja. A Microsoft azt javasolja, hogy a Forrásobjektum hatóköre alatt található hatókör hatókörében található hatókörszűrőkkel tesztelje a leképezéseket a Microsoft Entra ID néhány tesztfelhasználójával. Miután ellenőrizte, hogy a leképezések működnek-e, eltávolíthatja a szűrőt, vagy fokozatosan kibonthatja, hogy több felhasználót is bevonjon.

3. A Célobjektum-műveletek mező csak a Frissítés műveletet támogatja.

4. Az Attribútumleképezések szakasz leképezési táblázatában a következő Microsoft Entra-attribútumokat képezheti le SuccessFactors-ra. Az alábbi táblázat útmutatást nyújt a visszaírási attribútumok leképezéséhez.

   #	Microsoft Entra attribútum	SuccessFactors attribútum	Megjegyzések
   0	employeeId	personIdExternal	Alapértelmezés szerint ez az attribútum az egyező azonosító. Az employeeId helyett bármely más Microsoft Entra-attribútumot használhat, amely a personIdExternal értékkel megegyező értéket tárolhatja a SuccessFactorsban.
   2	levélküldés	e-mail	E-mail attribútum forrásának leképezése. Tesztelési célokra a userPrincipalName-t e-mailre képezheti le.
   3	8448	emailType	Ez az állandó érték az üzleti e-mailekhez társított SuccessFactors-azonosító értéke. Frissítse ezt az értéket úgy, hogy megfeleljen a SuccessFactors-környezetnek. Az érték beállításának lépéseit az e-mailType állandó értékének lekérése című szakaszában találja.
   4	true	emailIsPrimary	Ezzel az attribútummal beállíthatja az üzleti e-maileket elsődlegesként a SuccessFactorsban. Ha az üzleti e-mail nem elsődleges, állítsa ezt a jelölőt hamisra.
   5	userPrincipalName	[custom01 – custom15]	Az Új leképezés hozzáadása funkcióval igény szerint userPrincipalName vagy bármely Microsoft Entra attribútumot írhat a SuccessFactors Felhasználói objektumban elérhető egyéni attribútumba.
   6	On Prem SamAccountName	username	Az Új leképezés hozzáadása funkcióval igény szerint leképezheti a helyszíni samAccountName nevet a SuccessFactors felhasználónév attribútumára. A Microsoft Entra Connect Sync: Címtárbővítmények használatával szinkronizálhatja a samAccountName-t a Microsoft Entra-azonosítóval. Ez a forrás legördülő menüben extension_yourTenantGUID_samAccountName
   7	SSO	loginMethod	Ha a SuccessFactors bérlő a részleges egyszeri bejelentkezéshez van beállítva, akkor az Add New Mapping (Új megfeleltetés hozzáadása) beállítással a loginMethod értéket igény szerint "SSO" vagy "PWD" állandó értékre állíthatja be.
   8	telephoneNumber	businessPhoneNumber	Ezzel a leképezéssel a PhoneNumber a Microsoft Entra-azonosítótól a SuccessFactors üzleti vagy munkahelyi telefonszámig áramolhat.
   9	10605	businessPhoneType	Ez az állandó érték az üzleti telefonhoz társított SuccessFactors azonosító értéke. Frissítse ezt az értéket úgy, hogy megfeleljen a SuccessFactors-környezetnek. Az érték beállításának lépéseit a PhoneType állandó értékének lekérése című szakaszában találja.
   10	true	businessPhoneIsPrimary	Ezzel az attribútummal állíthatja be az üzleti telefonszám elsődleges jelölőját. Az érvényes értékek igazak vagy hamisak.
   11	mobil	cellPhoneNumber	Ezzel a leképezéssel a PhoneNumber a Microsoft Entra-azonosítótól a SuccessFactors üzleti vagy munkahelyi telefonszámig áramolhat.
   12	10606	cellPhoneType	Ez az állandó érték a mobiltelefonhoz társított SuccessFactors azonosító értéke. Frissítse ezt az értéket úgy, hogy megfeleljen a SuccessFactors-környezetnek. Az érték beállításának lépéseit a PhoneType állandó értékének lekérése című szakaszában találja.
   13	false	cellPhoneIsPrimary	Ez az attribútum a mobiltelefonszám elsődleges jelzőjének beállításához használható. Az érvényes értékek igazak vagy hamisak.
   14	[extensionAttribute1-15]	Felhasználói azonosító	Ezzel a leképezéssel biztosíthatja, hogy a SuccessFactors aktív rekordja frissüljön, ha ugyanazon felhasználóhoz több foglalkoztatási rekord is tartozik. További részletekért lásd: Visszaírás engedélyezése a UserID használatával

5. Ellenőrizze és tekintse át az attribútumleképezéseket.

   

6. A leképezések mentéséhez kattintson a Mentés gombra. Ezután frissítjük a JSON Path API-kifejezéseket a SuccessFactors-példány phoneType-kódjainak használatára.

7. Válassza a Speciális beállítások megjelenítése lehetőséget.

   

8. Kattintson a SuccessFactors attribútumlistájának szerkesztésére.

   Feljegyzés

   Ha a SuccessFactors attribútumlistája nem jelenik meg az Entra Felügyeleti központban, használja az URL-címet https://portal.azure.com/?Microsoft_AAD_IAM_forceSchemaEditorEnabled=true a lap eléréséhez.

9. Ebben a nézetben az API-kifejezés oszlop az összekötő által használt JSON-elérési utakat jeleníti meg.

10. Frissítse az üzleti telefon és mobiltelefon JSON-útvonalkifejezéseit a környezetnek megfelelő azonosító érték (businessPhoneType és cellPhoneType) használatára.

    

11. A leképezések mentéséhez kattintson a Mentés gombra.

Felhasználói kiépítés engedélyezése és elindítása

A SuccessFactors alkalmazáskonfigurációinak befejezése után bekapcsolhatja a kiépítési szolgáltatást.

Tipp.

A kiépítési szolgáltatás bekapcsolásakor alapértelmezés szerint az üzembe helyezési műveleteket kezdeményezi a hatókörben lévő összes felhasználó számára. Ha a leképezésben vagy az adatokkal kapcsolatos hibák lépnek fel, a kiépítési feladat meghiúsulhat, és karanténba kerülhet. Ennek elkerülése érdekében ajánlott eljárásként javasoljuk, hogy konfigurálja a Forrásobjektum-hatókör szűrőt, és tesztelje az attribútumleképezéseket néhány tesztfelhasználóval, mielőtt elindítja a teljes szinkronizálást az összes felhasználó számára. Miután ellenőrizte, hogy a leképezések működnek-e, és megadja-e a kívánt eredményt, eltávolíthatja a szűrőt, vagy fokozatosan kibonthatja, hogy több felhasználót is bevonjon.

1. A Kiépítés lapon állítsa be a kiépítés állapotát Be értékre.

2. Válassza ki a hatókört. Az alábbi lehetőségek közül választhat:

   • Az összes felhasználó és csoport szinkronizálása: Válassza ezt a lehetőséget, ha a Microsoft Entra-azonosítóból a SuccessFactors-ba szeretné visszaírni az összes felhasználó leképezett attribútumait, a Leképezések –>Forrásobjektum hatóköre területen meghatározott hatókörkezelési szabályokra is figyelemmel.
   • Csak a hozzárendelt felhasználók és csoportok szinkronizálása: Válassza ezt a lehetőséget, ha csak az alkalmazáshoz hozzárendelt felhasználók leképezett attribútumait szeretné visszaírni az Alkalmazás –>Felhasználók> és csoportok menüben. Ezekre a felhasználókra a Leképezések –>Forrásobjektum hatóköre területen meghatározott hatókörkezelési szabályok is vonatkoznak.

   

   Feljegyzés

   A 2022. október 12. után létrehozott SuccessFactors Writeback kiépítési alkalmazások támogatják a "csoport-hozzárendelés" funkciót. Ha 2022. október 12. előtt hozta létre az alkalmazást, az csak "felhasználói hozzárendelés" támogatással rendelkezik. A "csoport-hozzárendelés" funkció használatához hozzon létre egy új példányt a SuccessFactors Writeback alkalmazásból, és helyezze át a meglévő leképezési konfigurációkat ebbe az alkalmazásba.

3. Kattintson a Mentés gombra.

4. Ez a művelet elindítja a kezdeti szinkronizálást, amely változó számú órát vehet igénybe attól függően, hogy hány felhasználó van a Microsoft Entra-bérlőben és a művelethez definiált hatókörben. A szinkronizálási ciklus előrehaladásának nyomon követéséhez ellenőrizze a folyamatjelző sávot.

5. A kiépítési szolgáltatás által végrehajtott műveletek megtekintéséhez bármikor ellenőrizze az Entra Felügyeleti központ Kiépítési naplók lapját. A kiépítési naplók felsorolják a kiépítési szolgáltatás által végrehajtott összes egyéni szinkronizálási eseményt.

6. Miután a kezdeti szinkronizálás befejeződött, egy naplózási összefoglaló jelentést ír a Kiépítés lapra, ahogy az alább látható.

   

Következő lépések

• A Microsoft Entra ID és az SAP SuccessFactors integrációs referenciajának részletes bemutatása
• Ismerje meg, hogyan konfigurálhatja az egyszeri bejelentkezést a SuccessFactors és a Microsoft Entra ID között
• Megtudhatja, hogyan integrálhat más SaaS-alkalmazásokat a Microsoft Entra-azonosítóval