> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SCIM-kiépítés beállítása a Microsoft Entra ID-hoz

> Állítson be SCIM-kiépítést a Microsoft Entra ID-val. Hozza létre a SCIM-alkalmazást, csatlakoztassa a Base44-hez, képezze le az externalId-t, a szerepköröket és a kreditkorlátokat, majd építse ki a tagokat.

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](https://docs.base44.com/hu/Enterprise/Microsoft-Entra-SSO.md).

> [!WARNING]
>
> A SCIM-kiépítéshez [Enterprise csomag](https://base44.com/pricing) 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](https://entra.microsoft.com).
* 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](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/SCIM-provisioning.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=09b2229f89a7b808a40ef0054d023514)

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.

### 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.

### 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](https://mintcdn.com/base44/4lOZlF-NX1U7CVNj/images/SCIM-API-Key.png?fit=max\&auto=format\&n=4lOZlF-NX1U7CVNj\&q=85\&s=f7dfa3a3939d08266b4268e77b4a6032)

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](https://mintcdn.com/base44/4lOZlF-NX1U7CVNj/images/SCIM-new-api-key.png?fit=max\&auto=format\&n=4lOZlF-NX1U7CVNj\&q=85\&s=01d75a5fedbbe507ff3aa0e71ec7a8ea)

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.

> [!TIP]
>
> 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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/Entra-provisioning.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=2bde8648cd62a7f3ddc66ccb62d779d7)

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

> [!WARNING]
>
> 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á.

### 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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/Entra-edit-attribute.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=c8406da7373aef1680268d0d5227703c)

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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/Configuring-the-SCIM-Connection.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=62cf0e7255b82d516c93cb0ae6506b2c)

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

### 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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/SCIM-edit-list.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=0f39296fe43cb64489a0163d2408dc03)

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

### 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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/create-app-role.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=de9d39f98226c84df4992bdc72fa5d16)

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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/SCIM-app-roles.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=e7c00dfa3ed50db30d624028876fbf66)

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

### 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](https://mintcdn.com/base44/TmPgTYCBwlWr1oF3/images/SCIM-mapping-role-field.png?fit=max\&auto=format\&n=TmPgTYCBwlWr1oF3\&q=85\&s=bea562304a4babea4a11992f1bf1cb85)

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.

### 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.

> [!NOTE]
>
> 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.

### 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.

| Szerepkör | Mit tehet |
| - | - |
| `admin` | Tagok és munkaterület-beállítások kezelése |
| `editor` | Alkalmazások építése, szerkesztése és futtatása; a munkaterület kreditkeretéből használ krediteket |
| `viewer` | Csak olvasási hozzáférés az alkalmazásokhoz; nem használ krediteket |

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](https://docs.base44.com/hu/Enterprise/managing-enterprise-members.md#per-member-credit-limits).

> [!NOTE]
>
> 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.

> [accordion] Külön Entra-alkalmazás kell az SSO-hoz és a SCIM-hez?
>
> 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](https://docs.base44.com/hu/Enterprise/Microsoft-Entra-SSO.md).

> [accordion] Miért sikertelen a SCIM-kapcsolati teszt?
>
> 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.

> [accordion] Miért nem szinkronizálódik a szerepkör, vagy miért hiúsul meg a kiépítés a szerepkörmezőnél?
>
> 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.

> [accordion] Miért nem szerepel a Base44 egyéni attribútuma a Target attribute legördülő menüben?
>
> 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.

> [accordion] Miért rossz rekord frissül az újrakiépítés után?
>
> 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.

> [!NOTE]
>
> 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](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.