Poradnik: Tworzenie aplikacji typu shell w .NET MAUI.

Dotyczy: Dzierżawcy usługi Workforce Zewnętrzni dzierżawcy (dowiedzieć się więcej)

Ten samouczek jest częścią 1 serii, która pokazuje, jak utworzyć aplikację powłoki interfejsu użytkownika aplikacji wieloplatformowej .NET (.NET MAUI) i przygotować ją do uwierzytelniania za pomocą centrum administracyjnego Microsoft Entra. W tym samouczku dodasz niestandardowe narzędzie pomocnicze klienta biblioteki Microsoft Authentication Library (MSAL), aby zainicjować MSAL SDK, zainstalować wymagane biblioteki i dołączyć zasób graficzny.

W tym samouczku nauczysz się następujących rzeczy:

• Utwórz aplikację shell .NET MAUI.
• Dodaj obsługę SDK MSAL przy użyciu klas pomocniczych MSAL.
• Zainstaluj wymagane pakiety.
• Dodaj zasób obrazu.

Warunki wstępne

• Zarejestruj nową aplikację internetową klienta w centrum administracyjnym firmy Microsoft Entra, skonfigurowaną dla kont w dowolnym katalogu organizacyjnym i osobistych kontach Microsoft. Aby uzyskać więcej informacji, zobacz Rejestrowanie aplikacji . Zapisz następujące wartości na stronie Przegląd aplikacji do późniejszego użycia:
  • Identyfikator aplikacji (klienta)
  • Identyfikator katalogu (klienta)
• Dodaj następujące identyfikatory URI przekierowania przy użyciu konfiguracji platformy aplikacji mobilnych i stacjonarnych. Więcej informacji znajdziesz w Jak dodać adres URI przekierowania w aplikacji.
  • Identyfikator URI przekierowania: msal{client_id}://auth gdzie {client_id} to identyfikator aplikacji (klienta).
• zestawu SDK platformy .NET
• programu Visual Studio 2022 z zainstalowanym pakietem roboczym MAUI:
  • instrukcje dotyczące instalacji programu Visual Studio

Tworzenie aplikacji .NET MAUI Shell

1. W oknie startowym programu Visual Studio 2022 wybierz pozycję Utwórz nowy projekt.
2. W oknie Utwórz nowy projekt wybierz pozycję MAUI na liście rozwijanej Wszystkie typy projektów, wybierz szablon .NET MAUI App, a następnie wybierz pozycję Dalej.
3. W oknie Konfigurowanie nowego projektunazwa projektu musi być ustawiona na SignInMaui. Zaktualizuj nazwę rozwiązania na sign-in-maui i wybierz pozycję Dalej.
4. W oknie Dodatkowe informacje wybierz najnowszą wersję .NET SDK i wybierz opcję Create.

Poczekaj na utworzenie projektu oraz przywrócenie jego zależności.

Dodaj obsługę zestawu SDK MSAL, korzystając z klas pomocniczych MSAL

Klient MSAL pozwala deweloperom na uzyskiwanie tokenów dostępu z zewnętrznego dzierżawcy, aby uwierzytelniać się i uzyskiwać dostęp do zabezpieczonych interfejsów API. W tej sekcji pobierasz pliki tworzące bibliotekę MSALClient.

Pobierz następujące pliki do folderu na komputerze:

• AzureAdConfig.cs — ten plik pobiera i ustawia unikatowe identyfikatory aplikacji Microsoft Entra z pliku konfiguracji aplikacji.
• DownStreamApiConfig.cs — ten plik pobiera i ustawia zakresy wywołania programu Microsoft Graph.
• DownstreamApiHelper.cs — ten plik obsługuje wyjątki występujące podczas wywoływania podrzędnego interfejsu API.
• Exception.cs — ten plik oferuje kilka metod rozszerzenia związanych z zgłaszaniem i obsługą wyjątków.
• IdentityLogger.cs — ten plik pokazuje, jak używać rejestrowania MSAL.NET.
• MSALClientHelper.cs — ten plik zawiera metody inicjowania zestawu SDK biblioteki MSAL.
• PlatformConfig.cs — ten plik zawiera metody obsługi określonej platformy. Na przykład system Windows.
• PublicClientSingleton.cs — ten plik zawiera pojedynczą implementację służącą do zawijania klasy MSALClient i skojarzonych klas w celu obsługi statycznego modelu inicjowania dla platform.
• WindowsHelper.cs — Ten plik zawiera metody pobierania uchwytu okna.

Ważny

Nie pomijaj pobierania plików MSALClient. Są one wymagane do ukończenia tego samouczka.

Przenoszenie plików MSALClient za pomocą programu Visual Studio

1. W okienku Eksploratora rozwiązań kliknij prawym przyciskiem myszy projekt SignInMaui i wybierz pozycję Dodaj>Nowy folder. Nadaj folderowi nazwę MSALClient.
2. Kliknij prawym przyciskiem myszy folder MSALClient, wybierz pozycję Dodaj>Istniejący element....
3. Przejdź do folderu zawierającego pobrane wcześniej pliki MSALClient.
4. Wybierz wszystkie pobrane pliki MSALClient, a następnie wybierz pozycję Dodaj

Instalowanie wymaganych pakietów

Należy zainstalować następujące pakiety:

• Microsoft.Identity.Client — ten pakiet zawiera pliki binarne biblioteki Microsoft Authentication Library for .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json — ten pakiet zawiera implementację dostawcy konfiguracji JSON dla microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder — Ten pakiet zawiera funkcjonalność powiązywania obiektu z danymi w dostawcach konfiguracji dla Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions — ten pakiet zawiera abstrakcje konfiguracji opartej na parach klucz-wartość.
• Microsoft.Identity.Client.Extensions.Msal — ten pakiet zawiera rozszerzenia biblioteki Microsoft Authentication Library for .NET (MSAL.NET).

Menedżer pakietów NuGet

Aby użyć menedżera pakietów NuGet, aby zainstalować pakiet Microsoft.Identity.Client w programie Visual Studio, wykonaj następujące kroki:

1. Wybierz Narzędzia>Menedżer pakietów NuGet>Zarządzaj pakietami NuGet dla rozwiązania....
2. Na karcie Przeglądaj znajdź Microsoft.Identity.Client.
3. Wybierz Microsoft.Identity.Client na liście.
4. Wybierz pozycję SignInMaui w okienku listy Project.
5. Wybierz pozycję Zainstaluj.
6. Jeśli zostanie wyświetlony monit o zweryfikowanie instalacji, wybierz pozycję OK.

Powtórz ten proces, aby zainstalować pozostałe wymagane pakiety.

Dodawanie zasobu obrazu

W tej sekcji pobierzesz obraz używany w aplikacji, aby ulepszyć sposób interakcji użytkowników z nią.

Pobierz następujący obraz:

• Icon: Microsoft Entra ID — ten obraz jest używany jako ikona na stronie głównej.

Przenoszenie obrazu za pomocą programu Visual Studio

1. W okienku eksploratora rozwiązań programu Visual Studio rozwiń folder Resources, co odsłania folder Obrazy.
2. Kliknij prawym przyciskiem myszy pozycję Obrazy i wybierz pozycję Dodaj>istniejący element....
3. Przejdź do folderu zawierającego pobrane obrazy.
4. Zmień filtr na filtr typu pliku: Pliki obrazów.
5. Wybierz pobrany obraz.
6. Wybierz pozycję Dodaj.

Następny krok

Część 3: Samouczek: logowanie użytkowników w aplikacji powłoki .NET MAUI przy użyciu zewnętrznego dzierżawcy