Felhasználók bejelentkezése egy minta .NET MAUI asztali alkalmazásban

A következőkre vonatkozik:Munkaerő-bérlők Külső bérlők (további információ)

Ez az útmutató egy minta .NET többplatformos alkalmazás felhasználói felületével (.NET MAUI) mutatja be, hogyan adhat hozzá hitelesítést egy asztali alkalmazáshoz külső bérlő használatával. A mintaalkalmazás lehetővé teszi, hogy a felhasználók bejelentkezhessenek és kijelentkezhessenek. Az asztali .NET MAUI mintaalkalmazás a .NET-hez készült Microsoft Authentication Library (MSAL) használatával kezeli a hitelesítést.

Ebben a cikkben a következő feladatokat hajtja végre:

• Regisztráljon egy .NET MAUI asztali alkalmazást a külső bérlőben.
• Hozzon létre egy bejelentkezési és bejelentkezési felhasználói folyamatot a külső bérlőben.
• A .NET MAUI asztali alkalmazás társítása a felhasználói folyamattal.
• Frissítsen egy minta .NET MAUI asztali alkalmazást a saját külső bérlői adatainak használatához.
• Futtassa és tesztelje a minta .NET MAUI asztali alkalmazást.

Előfeltételek

• .NET 7.0 SDK
• Visual Studio 2022 a MAUI számítási feladattal telepítve:
  • Útmutatás Windowshoz
  • Utasítások a macOS-hez
• Külső bérlő. Ha még nincs ilyenje, regisztráljon egy ingyenes próbaverzióra.

.NET MAUI asztali alkalmazás regisztrálása

Ahhoz, hogy az alkalmazás bejelentkezhessen a Microsoft Entra szolgáltatással, Microsoft Entra Külső ID tisztában kell lennie a létrehozott alkalmazással. Az alkalmazásregisztráció megbízhatósági kapcsolatot létesít az alkalmazás és a Microsoft Entra között. Amikor regisztrál egy alkalmazást, a külső azonosító létrehoz egy egyedi azonosítót, más néven egy alkalmazás (ügyfél) azonosítót, amely az alkalmazás azonosítására szolgál a hitelesítési kérelmek létrehozásakor.

Az alábbi lépések bemutatják, hogyan regisztrálhatja az alkalmazást a Microsoft Entra Felügyeleti központban:

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

2. Ha több bérlőhöz is rendelkezik hozzáféréssel, a felső menü Gépház ikonjával válthat a külső bérlőre a Címtárak + előfizetések menüből.

3. Keresse meg az identitásalkalmazásokat>> Alkalmazásregisztrációk.

4. Válassza az + Új regisztráció lehetőséget.

5. A Megjelenő alkalmazás regisztrálása lapon;

   1. Adjon meg egy értelmes alkalmazásnevet, amely az alkalmazás felhasználói számára jelenik meg, például ciam-client-app.
   2. A Támogatott fióktípusok csoportban válassza a Csak ebben a szervezeti címtárban lévő Fiókok lehetőséget.

6. Válassza ki a pénztárgépet.

7. Az alkalmazás Áttekintés panelje a sikeres regisztrációkor jelenik meg. Jegyezze fel az alkalmazás forráskódjában használandó alkalmazás-(ügyfél-) azonosítót .

Ha meg szeretné adni az alkalmazás típusát az alkalmazásregisztrációhoz, kövesse az alábbi lépéseket:

1. A Kezelés területen válassza a Hitelesítés lehetőséget.
2. A Platformkonfigurációk lapon válassza a Platform hozzáadása, majd a Mobil és asztali alkalmazások lehetőséget.
3. Az átirányítási URI-k megadásakor msalEnter_the_Application_Id_Here://authcserélje le Enter_the_Application_Id_Here a korábban másolt alkalmazás (ügyfél) azonosítóját, majd válassza a Konfigurálás lehetőséget.
4. A módosítások mentéséhez válassza a Mentés lehetőséget.

Rendszergazdai jóváhagyás megadása

1. A Alkalmazásregisztrációk lapon válassza ki a létrehozott alkalmazást (például a ciam-client-appot) az Áttekintés lap megnyitásához.

2. A Kezelés területen válassza ki az API-engedélyeket. A Konfigurált engedélyek listájában az alkalmazáshoz a User.Read engedély lett hozzárendelve. Mivel azonban a bérlő egy külső bérlő, a felhasználói felhasználók maguk nem járulhatnak hozzá ehhez az engedélyhez. Önnek, mint rendszergazdának hozzá kell adnia ezt az engedélyt a bérlő összes felhasználója nevében:

   1. Válassza a rendszergazdai hozzájárulás megadása a bérlő nevének> megadását<, majd válassza az Igen lehetőséget.
   2. Válassza a Frissítés lehetőséget, majd ellenőrizze, hogy a bérlő nevének> megadása <mindkét hatókör állapotábanjelenik-e meg.

Felhasználói folyamat létrehozása

Kövesse az alábbi lépéseket egy olyan felhasználói folyamat létrehozásához, amellyel az ügyfél bejelentkezhet vagy regisztrálhat egy alkalmazásra.

1. Jelentkezzen be a Microsoft Entra felügyeleti központba legalább külső azonosítójú felhasználói folyamatként Rendszergazda istratorként.

2. Ha több bérlőhöz is rendelkezik hozzáféréssel, a felső menü Gépház ikonjával válthat a külső bérlőre a Címtárak + előfizetések menüből.

3. Tallózással keresse meg az Identitás>külső identitásai>felhasználói folyamatokat.

4. Válassza az + Új felhasználói folyamat lehetőséget.

5. A Létrehozás lapon:

   1. Adja meg a felhasználói folyamat nevét, például a SignInSignUpSample nevet.

   2. Az Identitásszolgáltatók listában válassza az E-mail-fiókok lehetőséget. Ez az identitásszolgáltató lehetővé teszi, hogy a felhasználók az e-mail-címükkel jelentkezzenek be vagy jelentkezzenek be.

      Feljegyzés

      A további identitásszolgáltatók csak az összevonás beállítása után lesznek itt felsorolva. Ha például összevonást állít be a Google vagy a Facebook használatával, itt kiválaszthatja ezeket a további identitásszolgáltatókat.

   3. Az E-mail fiókok csoportban a két lehetőség közül választhat. Ebben az oktatóanyagban válassza a Jelszóval ellátott e-mail lehetőséget.

      • Jelszóval ellátott e-mail: Lehetővé teszi az új felhasználók számára, hogy bejelentkezési névként e-mail-címmel és jelszóval jelentkezzenek be az első tényező hitelesítő adataiként.
      • Egyszeri pin-kód küldése: Lehetővé teszi az új felhasználók számára, hogy bejelentkezési névként egy e-mail-címmel regisztráljanak és jelentkezzenek be, és az egyszeri pin-kód elküldése az első tényező hitelesítő adataiként. Ahhoz, hogy ez a beállítás elérhető legyen a felhasználói folyamat szintjén, engedélyezni kell az egyszeri pin-kód megadását a bérlői szinten (minden identitásszolgáltatónak>egyszeri pin-kód küldése).

   4. A Felhasználói attribútumok csoportban válassza ki azokat az attribútumokat, amelyeket a felhasználótól a regisztrációkor szeretne gyűjteni. A Továbbiak megjelenítése lehetőséget választva kiválaszthatja az ország/régió, a megjelenítendő név és az irányítószám attribútumait és jogcímeit. Kattintson az OK gombra. (A rendszer csak akkor kéri az attribútumok megadását, ha első alkalommal regisztrál.)

6. Válassza a Létrehozás lehetőséget. Az új felhasználói folyamat megjelenik a Felhasználói folyamatok listában. Szükség esetén frissítse a lapot.

Az önkiszolgáló jelszó-visszaállítás engedélyezéséhez kövesse az Önkiszolgáló jelszó-visszaállítás engedélyezése című cikk lépéseit.

Az asztali .NET MAUI-alkalmazás társítása a felhasználói folyamattal

Bár számos alkalmazás társítható a felhasználói folyamathoz, egyetlen alkalmazás csak egy felhasználói folyamathoz társítható. A felhasználói folyamat lehetővé teszi a felhasználói élmény konfigurálását adott alkalmazásokhoz. Konfigurálhat például egy olyan felhasználói folyamatot, amely megköveteli, hogy a felhasználók jelentkezzenek be vagy regisztráljanak e-mail-címmel.

1. Az oldalsáv menüjében válassza az Identitás lehetőséget.

2. Válassza a Külső identitások, majd a Felhasználói folyamatok lehetőséget.

3. A Felhasználói folyamatok lapon válassza ki a korábban létrehozott felhasználói folyamat nevét, például SignInSignUpSample.

4. A Használat területen válassza az Alkalmazások lehetőséget.

5. Válassza az Alkalmazás hozzáadása lehetőséget.

6. Válassza ki az alkalmazást a listából( például ciam-client-app ), vagy használja a keresőmezőt az alkalmazás megkereséséhez, majd jelölje ki.

7. Válassza a Kiválasztás lehetőséget

.NET MAUI asztali mintaalkalmazás klónozása vagy letöltése

A .NET MAUI asztali alkalmazás mintakódjának lekéréséhez töltse le a .zip fájlt, vagy klónozza a .NET MAUI asztali mintaalkalmazást a GitHubról az alábbi parancs futtatásával:

git clone https://github.com/Azure-Samples/ms-identity-ciam-dotnet-tutorial.git

A minta .NET MAUI asztali alkalmazás konfigurálása

1. A Visual Studióban nyissa meg az ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/appsettings.json fájlt.
2. Keresse meg a helyőrzőt:
   1. Enter_the_Tenant_Subdomain_Here és cserélje le a Címtár (bérlő) altartományra. Ha például a bérlő elsődleges tartománya, contoso.onmicrosoft.comhasználja a következőt contoso: Ha nem rendelkezik a bérlő nevével, olvassa el a bérlő adatait.
   2. Enter_the_Application_Id_Here és cserélje le a korábban regisztrált alkalmazás (ügyfél) azonosítójára.

Minta .NET MAUI asztali alkalmazás futtatása és tesztelése

A .NET MAUI-alkalmazások több operációs rendszeren és eszközön való futtatásra lettek tervezve. Ki kell választania, hogy melyik célhoz szeretné tesztelni és hibakereséssel használni az alkalmazást.

Állítsa a Hibakeresési célértéket a Visual Studio eszköztárán arra az eszközre, amellyel hibakeresést és tesztelést szeretne végezni. Az alábbi lépések bemutatják a hibakeresési cél Windowsra való beállítását:

1. Válassza a Cél hibakeresése legördülő menüt.
2. Keretrendszer kiválasztása
3. Válassza ki a net7.0-windows...

Futtassa az alkalmazást az F5 billentyű lenyomásával, vagy válassza a Lejátszás gombot a Visual Studio tetején.

1. Most már tesztelheti a minta .NET MAUI asztali alkalmazást. Az alkalmazás futtatása után az asztali alkalmazás ablaka automatikusan megjelenik:

   

2. A megjelenő asztali ablakban válassza a Bejelentkezés gombot. Megnyílik egy böngészőablak, és a rendszer kérni fogja a bejelentkezést.

   

   A bejelentkezési folyamat során a rendszer különböző engedélyek megadását kéri (hogy az alkalmazás hozzáférhessen az adataihoz). Sikeres bejelentkezés és hozzájárulás esetén az alkalmazás képernyőjén megjelenik a főoldal.

   

Következő lépések

• Az alapértelmezett védjegyezés testreszabása.
• Bejelentkezés konfigurálása a Google-nal.