Entra-azonosító alkalmazás beállítása

Ahhoz, hogy a számítási feladat a Fabricben működjön, regisztrálnia kell egy alkalmazást a Microsoft identitásplatformon, más néven a Microsoft Entra ID-ban. Ez az alkalmazás a számítási feladat Azure-beli hitelesítésére szolgál.

Előfeltételek

1. lépés: Entra-azonosító alkalmazás regisztrálása

Új Entra ID-alkalmazás létrehozásához kövesse az alábbi lépéseket:

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Lépjen a következőre: Identitás > Alkalmazások > Alkalmazásregisztrációk, és válassza az Új regisztrációlehetőséget.

  3. Adja meg az alkalmazás megjelenítendő nevét.

  4. A Támogatott fióktípusok szakaszban válassza Bármely szervezeti címtárban (Bármely Microsoft Entra ID-bérlő – Több-bérlős).

  5. Válassza a Regisztrálásgombot.

2. lépés: Az átirányítási URI konfigurálása

Az átirányítási URI-t olyan URI-ra kell konfigurálnia, amely azonnal bezárja a lapot, amikor navigál hozzá. További információ: Átirányítási URI (válasz URL-cím) vázlata és korlátozásai.

Az Entra ID-alkalmazás konfigurálásához kövesse az alábbi lépéseket:

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Válassza az Adj hozzá egy átirányítási URI-tlehetőséget.

  4. A platformkonfigurációkban* válassza a Platform hozzáadásalehetőséget.

  5. A Platformok konfigurálása panelen válassza egyoldalas alkalmazáslehetőséget.

  6. Az Egyoldalas alkalmazás konfigurálásarészben adjon hozzá egy átirányítási URI-t az Átirányítási URI-kterülethez. A minta példában a http://localhost:60006/close-t használják átirányítási URI-ként.

  7. Válassza a konfigurálása lehetőséget.

3. lépés: Ellenőrizze, hogy rendelkezik-e több-bérlős alkalmazással

Ha ellenőrizni szeretné, hogy az alkalmazás több-bérlős alkalmazás-e, kövesse az alábbi lépéseket.

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Az alkalmazásban a Kezelés szakaszban válassza a Hitelesítésilehetőséget.

  4. A Támogatott fióktípusokterületen ellenőrizze, hogy a bármely szervezeti címtárban (Bármely Microsoft Entra ID-bérlő – Több-bérlős) van-e kiválasztva. Ha nem, jelölje ki, majd válassza a Mentéslehetőséget.

4. lépés: Adja meg az alkalmazásazonosító URI-ját

Hozzon létre egy alkalmazásazonosító URI-t a következő formátummal: api://localdevinstance/<tenant ID>/<workload name>/<(optional)subpath>. Az azonosító URI nem végződhet perjellel.

  • számítási feladat neve – A fejleszteni kívánt számítási feladat neve. A számítási feladat nevének pontosan meg kell egyeznie a háttérjegyzékben megadott WorkloadName névvel, és a(z) Org.karakterrel kell kezdődnie.
  • bérlőazonosító – A bérlőazonosító. Ha nem tudja, mi a bérlőazonosítója, tekintse meg A Microsoft Entra-bérlőazonosító megkeresésecímű témakört.
  • Subpath – (Nem kötelező) Angol kis- és nagybetűket, számokat és kötőjeleket tartalmazó sztring. A segédúti karakterlánc legfeljebb 36 karakter hosszú lehet.

Íme néhány példa érvényes és érvénytelen URI-kra, ha a bérlőazonosító bbbbcccc-1111-dddd-2222-eeee3333ffff, és a számítási feladat neve Fabric.WorkloadSample ekkor:

  • Érvényes URI-k

    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample
    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample/abc

  • Érvénytelen URL-címek:

    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample/af/
    • api://localdevinstance/bbbbcccc-1111-dddd-2222-eeee3333ffff/Org.WorkloadSample/af/a

Ha alkalmazásazonosító URI-t szeretne hozzáadni az alkalmazáshoz, kövesse az alábbi lépéseket.

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Az alkalmazásban a Kezelés szakaszban válassza az API exponálását.

  4. Az alkalmazásazonosító URImellett válassza a Hozzáadáslehetőséget.

  5. Az Alkalmazásazonosító URI-jának szerkesztése panelen adja hozzá az alkalmazásazonosító URI-ját.

5. lépés: Hatókörök hozzáadása

Meg kell határoznia hatóköröket (más néven engedélyeket) az alkalmazáshoz. A hatókörök lehetővé teszik mások számára az alkalmazás funkcióinak használatát. A számítási feladat mintája például négy példát ad az API-engedélyekre, amelyeket mások is használhatnak. Ezeket az ál-engedélyeket a következő scopes.csláthatja:

  • Item1.Read.All – Számítási feladatok elemeinek olvasásához

  • Item1.ReadWrite.All – Munkaterhelési elemek olvasásához és írásához

  • FabricLakehouse.Read.All – Lakehouse-fájlok olvasásához

  • FabricLakehouse.ReadWrite.All – Lakehouse-fájlok olvasásához és írásához

Ha hatóköröket szeretne hozzáadni az alkalmazáshoz, kövesse az alábbi lépéseket.

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Az alkalmazásban a Kezelés szakaszban válassza az API exponálását.

  4. Az API-által definiálthatókörökben válassza a Hatókör hozzáadásalehetőséget.

  5. Válassza Hatókör hozzáadása lehetőséget, és kövesse a Hatókör hozzáadásacímű témakör utasításait.

6. lépés: Ügyfélalkalmazások hozzáadása

Engedélyezze a Fabricnek, hogy felhasználói hozzájárulás nélkül tokent kérjen az alkalmazáshoz.

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Az alkalmazásban a Kezelés szakaszban válassza az API exponálását.

  4. Az API-által definiálthatókörökben válassza a Hatókör hozzáadásalehetőséget.

  5. Válassza az Ügyfélalkalmazás hozzáadásalehetőséget.

  6. Adja hozzá az alább felsorolt ügyfélalkalmazásokat. Ezeknek az alkalmazásoknak az alkalmazásazonosítóit gyakran használt Microsoft-alkalmazásokalkalmazásazonosítóiban találja. Minden ügyfélalkalmazást önállóan kell hozzáadnia.

    • d2450708-699c-41e3-8077-b0c8341509aa – A Fabric-ügyfél háttérműveletekhez.
    • 871c010f-5e61-4fb1-83ac-98610a7e9110 – A Fabric-ügyfél előtérbeli műveletekhez.

7. lépés: API-engedélyek hozzáadása

Az API-engedélyek lehetővé teszik, hogy az alkalmazás külső szolgáltatásfüggőségeket használjon. HA API-engedélyeket szeretne hozzáadni az alkalmazáshoz, kövesse az Engedélyek hozzáadása alkalmazáshozcímű témakörben leírt lépéseket.

8. lépés: Titkos kód létrehozása az alkalmazáshoz

A háttérrendszerkonfigurálásához konfigurálnia kell egy titkos kulcsot az alkalmazáshoz.

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Az alkalmazásban a Kezelés szakaszban válassza Tanúsítványok & titkos kulcsoklehetőséget.

  4. Válassza ki a Ügyfél titkos kódokat, majd válassza Új titkos ügyfélkódlehetőséget.

  5. A Ügyféltitok hozzáadása panelen írja be a következőket:

    • Leírás – A titkos kódként használni kívánt név.
    • Lejárat – Válassza ki a titok lejárati dátumát.

  6. Válassza , majd adja hozzá.

9. lépés: Idtyp opcionális jogcím hozzáadása

A idtypejogcím azt jelzi, hogy a számítási feladat Fabricből lekérett jogkivonata csak egy alkalmazás jogkivonata.

  1. Lépjen be a Microsoft Entra adminisztrációs központba.

  2. Navigáljon Alkalmazások > Alkalmazásregisztráció, és válassza ki az alkalmazását.

  3. Az alkalmazásban a Kezelés szakaszban válaszd a Token konfiguráció-t.

  4. Válassza Választható jogcím hozzáadásalehetőséget.

  5. A Opcionális jogcím hozzáadása panelen a Jogkivonat típusaterületen válassza az Hozzáféréslehetőséget.

  6. A Jogcímalatt válassza ki a idtyplehetőséget.

  7. Válassza , majd adja hozzá.

Kapcsolódó tartalom

  • Last updated on