Ugrás a fő tartalomhoz
A SCIM-kiépítés szinkronban tartja a Base44 vállalati munkaterület tagságát a Microsoft Entra ID-val (korábban Azure AD). Létrehoz egy külön vállalati alkalmazást, csatlakoztatja a Base44-hez, leképezi a szerepköröket, és bekapcsolja az automatikus szinkronizálást, így a tagok hozzáadása, frissítése és eltávolítása Ön helyett történik. Ahhoz, hogy csapata bejelentkezhessen, külön állítsa be az SSO-t a Microsoft Entra ID-hoz.
A SCIM-kiépítéshez Enterprise csomag szükséges. A Business csomag nem tartalmazza. Ha nem látja ezt a lehetőséget, forduljon Base44-ügyfélcsapatához.

Mielőtt elkezdené

Győződjön meg róla, hogy rendelkezik a következőkkel:
  • Tulajdonosi vagy adminisztrátori hozzáférés a Base44 vállalati munkaterülethez.
  • Adminisztrátori hozzáférés a Microsoft Entra felügyeleti központhoz.
  • A SCIM Base URL, amelyet a Beállítások > Hitelesítés részben talál.
  • Egy munkaterületi API-kulcs, amelyet a Beállítások > Titkos kulcsok részben talál.
A SCIM Provisioning kártya az Authentication oldalon a Base URL-lel

A SCIM Base URL megkeresése


A SCIM-kiépítés beállítása

Hozzon létre egy dedikált Entra vállalati alkalmazást, csatlakoztassa a Base44-hez, képezze le a szerepköröket és az attribútumokat, majd kapcsolja be az automatikus szinkronizálást.

  1. lépés: A SCIM-alkalmazás létrehozása

Hozzon létre egy külön, nem katalógusbeli vállalati alkalmazást a kiépítéshez. A SCIM-alkalmazás létrehozása:
  1. A Microsoft Entra felügyeleti központban lépjen az Identity > Applications > Enterprise applications részre.
  2. Kattintson a New application, majd a Create your own application elemre.
  3. Adjon meg egy nevet (például Base44 SCIM Provisioning), és válassza az Integrate any other application you don’t find in the gallery lehetőséget.
  4. Kattintson a Létrehozás gombra.

  1. lépés: Csatlakozás a Base44-hez

Irányítsa az Entrát a Base44-munkaterületére a SCIM Base URL és egy munkaterületi API-kulcs segítségével. Ha még nincs API-kulcsa, előbb hozzon létre egyet. Munkaterületi API-kulcs létrehozása:
  1. A munkaterület Beállítások részében kattintson a Titkos kulcsok elemre.
  2. Kattintson az API-kulcs létrehozása gombra.
  3. Adjon meg egy nevet (például Entra SCIM), opcionálisan egy leírást, majd kattintson a Kulcs létrehozása gombra.
A Base44 Create API Key párbeszédablaka megadott névvel

Az új API-kulcs elnevezése a Settings > Secrets részben

A Base44 a teljes kulcsot csak egyszer mutatja meg. Másolja ki, mielőtt bezárja a párbeszédablakot, és tárolja biztonságos helyen, mert az alábbiakban ezt használja Secret Token értékként.
A Base44 API Key Created párbeszédablaka a létrehozott kulccsal

Másolja ki a kulcsot, amíg látható. A párbeszédablak bezárása után nem tekintheti meg újra.

A kiépítés konfigurálása:
  1. Nyissa meg az alkalmazást, lépjen a Kiépítés… részre, majd kattintson a Kezdés gombra.
  2. Állítsa a Provisioning Mode értékét Automatic lehetőségre.
  3. Az Admin Credentials alatt állítsa be a következőket:
    • Tenant URL: A SCIM Base URL, a végére írt ?aadOptscim062020 résszel. Az eredmény így néz ki: https://app.base44.com/scim/v2/organizations/{{WORKSPACE_ID}}?aadOptscim062020.
    • Secret Token: A munkaterületi API-kulcs.
  4. Kattintson a Test Connection gombra a sikeres kapcsolat megerősítéséhez.
  5. Kattintson a Mentés gombra.
Folytatás előtt futtassa a Test Connection ellenőrzést, és győződjön meg róla, hogy sikeres. A sikertelen teszt általában hibás Tenant URL-t vagy Secret Tokent jelez.
Az Entra Provisioning adminisztrátori hitelesítő adatai a Provisioning Mode, a Tenant URL és a Secret Token mezővel

A Tenant URL és a Secret Token beállítása az Entra Provisioning képernyőjén

Az Entra megköveteli a ?aadOptscim062020 utótagot a Tenant URL-ben. Enélkül a kapcsolati teszt vagy a kiépítés meghiúsulhat. Ez az utótag az Entrára jellemző, ezért más identitásszolgáltatóknál ne adja hozzá.

  1. lépés: Az externalId leképezése

Alapértelmezés szerint az Entra egy változó értékkel azonosítja a felhasználókat. Ha az externalId attribútumot az objectId attribútumra, egy stabil egyedi azonosítóra képezi le, a Base44 megbízhatóan azonosíthatja az egyes felhasználókat a frissítésekhez és az inaktiváláshoz. A leképezés frissítése:
  1. A Mappings alatt kattintson a Provision Microsoft Entra ID Users elemre.
  2. A leképezési táblában keresse meg azt a sort, ahol a Target attribute pontosan externalId.
  3. Kattintson erre a sorra, és módosítsa a Source attribute értékét objectId értékre.
  4. Kattintson az Ok, majd a Mentés gombra.
Az Entra Edit Attribute panelje objectId értékre állított forrásattribútummal

Az objectId kiválasztása az externalId forrásattribútumaként

A mentés után a frissített leképezés megjelenik az attribútumtáblában, ahol az externalId az objectId attribútumra van leképezve.
Az Entra attribútumleképezési táblája az objectId-re leképezett externalId-vel

Az objectId-re leképezett externalId a Provision Microsoft Entra ID Users képernyőn

  1. lépés: Egyéni attribútumok hozzáadása

A Base44 szerepkör- és kreditkorlát-mezői nem szerepelnek az Entra alapértelmezett céllistájában, ezért a leképezésük előtt hozzá kell adnia őket. Az attribútumok hozzáadása:
  1. A Provision Microsoft Entra ID Users leképezési képernyőn görgessen le, és jelölje be a Show advanced options lehetőséget.
  2. Kattintson az alkalmazásához tartozó Edit attribute list for elemre.
  3. A lista alján adja hozzá a következőket:
    • Szerepkör: urn:base44:params:scim:schemas:extension:user:2.0:role, a Típus értéke String.
    • Kreditkorlát (nem kötelező): urn:base44:params:scim:schemas:extension:user:2.0:creditLimit, a Típus értéke Integer.
  4. Kattintson a Mentés gombra, és erősítse meg a módosítást.
Az Entra Edit attribute list String típusként hozzáadott Base44 szerepkör-URN-nel

A Base44 szerepkör-attribútumának hozzáadása az Edit attribute list részben

  1. lépés: Alkalmazásszerepkörök létrehozása

A szerepköröket az App registrations részben hozza létre, nem az Enterprise applications részben. Az Enterprise applications részben csak hozzárendeli őket. Alkalmazásszerepkörök létrehozása:
  1. A Microsoft Entra felügyeleti központban lépjen az App registrations részre, és nyissa meg az All applications lapot.
  2. Válassza ki a SCIM-alkalmazást.
  3. Kattintson az App roles, majd a Create app role elemre.
  4. Hozzon létre külön szerepkört minden Base44 jogosultsági szinthez: admin, editor és viewer.
  5. Az Érték mezőbe pontosan a Base44 által várt kisbetűs karakterláncot írja (admin, editor vagy viewer).
  6. Kattintson az Alkalmaz gombra.
Az Entra Create app role panelje, ahol a megjelenítendő név, az érték és a leírás admin, az engedélyezett tagtípus Users/Groups, és a bekapcsoló jelölőnégyzet be van jelölve

Alkalmazásszerepkör létrehozása egy Base44 jogosultsági szinthez

Minden jogosultsági szinthez hozzon létre egy szerepkört. A létrehozás után mind a 3 megjelenik az alkalmazás App roles listájában.
Az Entra App roles listája az admin, editor és viewer szerepkörökkel

Az admin, editor és viewer alkalmazásszerepkörök az Entrában

  1. lépés: A szerepkör és a kreditkorlát leképezése

Az Entra tömbként tárolja a szerepköröket, a Base44 viszont egyetlen szöveges értéket vár, ezért a szerepkört közvetlen leképezés helyett kifejezéssel kell leképezni. A szerepkör leképezése:
  1. Lépjen az Enterprise applications > a SCIM-alkalmazás > Kiépítés… > Edit attribute mapping > Provision Microsoft Entra ID Users részre.
  2. Kattintson az Add New Mapping gombra, vagy szerkessze a meglévő szerepkörsort.
  3. Állítsa a Mapping type értékét Expression lehetőségre.
  4. Az Expression mezőbe írja be: SingleAppRoleAssignment([appRoleAssignments])
  5. Állítsa a Target attribute értékét urn:base44:params:scim:schemas:extension:user:2.0:role értékre.
  6. Állítsa a Match objects using this attribute értékét Nem, az Apply this mapping értékét Mindig lehetőségre.
  7. Kattintson az Ok gombra.
Az Entra kifejezésalapú leképezése a szerepkörmezőhöz a SingleAppRoleAssignment használatával

A szerepkör leképezése a SingleAppRoleAssignment kifejezéssel

A kreditkorlát beállítása nem kötelező. Enélkül a tag egyéni korlát nélkül használja a munkaterület közös kreditkeretét. Csak akkor adjon meg kreditkorlátot, ha korlátozni szeretné, hány kreditet használhat egy adott tag havonta. Kreditkorlát leképezése (nem kötelező):
  1. Adja meg a kreditkorlát értékét a felhasználó Entra-profiljában egy beépített bővítménymezőben, például az extensionAttribute1 mezőben.
  2. Kattintson az Add New Mapping gombra, és állítsa a Mapping type értékét Egyenes lehetőségre.
  3. Állítsa a Source attribute értékét extensionAttribute1 értékre.
  4. Állítsa a Target attribute értékét urn:base44:params:scim:schemas:extension:user:2.0:creditLimit értékre.
  5. Kattintson az Ok, majd a Mentés gombra.

  1. lépés: Hozzárendelés és kiépítés

Válassza ki, kiket épít ki, adjon nekik szerepkört, és indítsa el a szinkronizálást. Felhasználók hozzárendelése:
  1. Lépjen az Enterprise applications > a SCIM-alkalmazás > Users and groups részre.
  2. Kattintson az Add user/group gombra, és válassza ki a kiépítendő felhasználókat vagy csoportokat.
  3. A Select a role alatt válassza ki a létrehozott szerepkört (admin, editor vagy viewer), majd kattintson az Assign gombra.
A kiépítés bekapcsolása:
  1. Lépjen a Kiépítés… részre.
  2. Állítsa a Provisioning Status értékét Be lehetőségre.
Az Entra elkezdi szinkronizálni a hozzárendelt felhasználókat a Base44-munkaterületre.
Ha egy felhasználónál a Szerkesztés gomb szürke, jelölje be a felhasználó melletti jelölőnégyzetet, kattintson az Eltávolítás gombra, majd adja hozzá újra a megfelelő szerepkörrel.

  1. lépés: A meglévő felhasználók frissítése

Ha az externalId leképezését azután módosította, hogy néhány felhasználó már ki lett építve, frissítse a rekordjaikat, hogy megkapják a helyes objectId értéket. A meglévő felhasználók frissítése:
  1. Lépjen a Kiépítés… > Provision on demand részre.
  2. Keresse meg a felhasználót, és futtassa a kiépítést a rekordja frissítéséhez.
  3. Ha mindenkire alkalmazni szeretné, térjen vissza a fő Kiépítés… oldalra, és kattintson a Restart provisioning gombra.

Szerepkörök és kreditkorlátok

A Base44 SCIM-en keresztül csak a következő szerepköröket fogadja el. Az Entra alkalmazásszerepköreit pontosan ezekre az értékekre képezze le. A kreditkorlátok csak az admin és az editor szerepkörre vonatkoznak, mert a megtekintők nem használnak krediteket. A 0 kreditkorlát korlát nélkülinek számít. A kreditkorlátokat SCIM nélkül, közvetlenül a munkaterületen is beállíthatja. Lásd: Vállalati munkaterület tagjainak kezelése.
A munkaterület tulajdonosai SCIM-en keresztül nem frissíthetők és nem inaktiválhatók. A tulajdonosok előléptetését vagy visszaminősítését inkább a munkaterület-beállításokban végezze.

GYIK

Válasszon az alábbi kérdések közül, hogy többet megtudjon az Entra SCIM-kiépítéséről.
Igen. A SCIM-kiépítés egy dedikált Enterprise application alkalmazást használ, a bejelentkezés pedig egy külön App registration regisztrációt. A kiépítést az Enterprise application alkalmazáson konfigurálja, a bejelentkezést pedig külön állítsa be. Lásd: SSO a Microsoft Entra ID-hoz.
Ellenőrizze, hogy a Tenant URL ?aadOptscim062020 végződésű-e, és hogy a Secret Token a Beállítások > Titkos kulcsok részből származó munkaterületi API-kulcs-e. Győződjön meg róla, hogy a SCIM Base URL-t a Beállítások > Hitelesítés részből másolta, és nem módosította.
Az Entra tömbként tárolja a szerepköröket, ezért az Egyenes leképezés meghiúsul. Állítsa a szerepkör leképezési típusát Expression értékre, és használja a SingleAppRoleAssignment([appRoleAssignments]) kifejezést. Győződjön meg róla, hogy minden alkalmazásszerepkör Érték értéke pontosan admin, editor vagy viewer, kisbetűvel.
Előbb adja hozzá. A leképezési képernyőn jelölje be a Show advanced options lehetőséget, kattintson az Edit attribute list elemre, adja hozzá a teljes URN-t (például urn:base44:params:scim:schemas:extension:user:2.0:role), majd mentse. Ezután a mező megjelenik a legördülő menüben.
Győződjön meg róla, hogy az externalId az objectId attribútumra van leképezve. Ha a felhasználókat a leképezés módosítása előtt építette ki, a Provision on demand lehetőséggel frissítse egyenként a felhasználókat, vagy a Restart provisioning lehetőséggel mindenkit.
Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.