Zelfstudie: Een .NET MAUI Shell-app maken

Deze zelfstudie is deel 2 van een reeks die laat zien hoe u een shell-app voor .NET Multi-Platform App UI (.NET MAUI) maakt en deze voorbereidt op verificatie met behulp van het Microsoft Entra-beheercentrum. In deel 1 van deze reeks hebt u een toepassing geregistreerd en gebruikersstromen geconfigureerd in uw externe tenant. In deze zelfstudie voegt u een aangepaste MSAL-clienthulp (Microsoft Authentication Library) toe om de MSAL SDK te initialiseren, vereiste bibliotheken te installeren en een installatiekopieënresource op te nemen.

In deze zelfstudie gaat u;

• Maak een .NETSHELL-shell-app.
• Voeg MSAL SDK-ondersteuning toe met behulp van MSAL-helperklassen.
• Vereiste pakketten installeren.
• Afbeeldingsresource toevoegen.

Vereisten

• Zelfstudie: Registreren en configureren van de mobiele .NET EXTERNAL-app in een externe tenant
• .NET 7.0 SDK
• Visual Studio 2022 met de WORKLOAD VOOR DE WORKLOAD VAN HET BEDRIJF geïnstalleerd:
  • Instructies voor Windows
  • Instructies voor macOS

Een .NETSHELL-shell-app maken

1. Selecteer een nieuw project maken in het beginvenster van Visual Studio 2022.
2. Selecteer IN het venster Een nieuw project maken DE Vervolgkeuzelijst Alle projecttypen, selecteer de sjabloon .NET MAUI App en selecteer Volgende.
3. In het venster Uw nieuwe project configureren moet de projectnaam worden ingesteld op SignInMaui. Werk de naam van de oplossing bij om u aan te melden en selecteer Volgende.
4. Kies in het venster Aanvullende informatie .NET 7.0 en selecteer Maken.

Wacht totdat het project is gemaakt en de bijbehorende afhankelijkheden zijn hersteld.

MSAL SDK-ondersteuning toevoegen met behulp van MSAL-helperklassen

MET MSAL-client kunnen ontwikkelaars beveiligingstokens verkrijgen van een externe tenant om beveiligde web-API's te verifiëren en te openen. In deze sectie downloadt u bestanden waaruit MSALClient bestaat.

Download de volgende bestanden in een map op uw computer:

• AzureAdConfig.cs: dit bestand haalt de unieke id's van de Microsoft Entra-app op uit uw app-configuratiebestand.
• DownStreamApiConfig.cs : dit bestand haalt de bereiken voor de Microsoft Graph-aanroep op en stelt deze in.
• DownstreamApiHelper.cs: dit bestand verwerkt de uitzonderingen die optreden bij het aanroepen van de downstream-API.
• Exception.cs - Dit bestand biedt een paar extensiemethode met betrekking tot het genereren en verwerken van uitzonderingen.
• IdentityLogger.cs : in dit bestand wordt uitgelegd hoe u MSAL.NET logboekregistratie gebruikt.
• MSALClientHelper.cs: dit bestand bevat methoden voor het initialiseren van MSAL SDK.
• PlatformConfig.cs: dit bestand bevat methoden voor het afhandelen van een specifiek platform. Bijvoorbeeld Windows.
• PublicClientSingleton.cs: dit bestand bevat een singleton-implementatie om de MSALClient en de bijbehorende klassen te verpakken ter ondersteuning van het statische initialisatiemodel voor platforms.
• WindowsHelper.cs: dit bestand bevat methoden om de venstergreep op te halen.

Belangrijk

Sla het downloaden van de MSALClient-bestanden niet over. Ze zijn vereist om deze zelfstudie te voltooien.

De MSALClient-bestanden verplaatsen met Visual Studio

1. Klik in het deelvenster Solution Explorer met de rechtermuisknop op het SignInMaui-project en selecteer Nieuwe map toevoegen>. Geef de map MSALClient een naam.
2. Klik met de rechtermuisknop op de map MSALClient, selecteer Bestaand item toevoegen>....
3. Navigeer naar de map met de gedownloade MSALClient-bestanden die u eerder hebt gedownload.
4. Selecteer alle MSALClient-bestanden die u hebt gedownload en selecteer vervolgens Toevoegen

De vereiste pakketten installeren

U moet de volgende pakketten installeren:

• Microsoft.Identity.Client : dit pakket bevat de binaire bestanden van de Microsoft Authentication Library voor .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json : dit pakket bevat de implementatie van de JSON-configuratieprovider voor Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder : dit pakket bevat functionaliteit om een object te binden aan gegevens in configuratieproviders voor Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions : dit pakket bevat abstracties van configuratie op basis van sleutel-waardeparen.
• Microsoft.Identity.Client.Extensions.Msal : dit pakket bevat extensies voor Microsoft Authentication Library voor .NET (MSAL.NET).

NuGet Pakketbeheer

Als u het NuGet-Pakketbeheer wilt gebruiken om het Microsoft.Identity.Client-pakket in Visual Studio te installeren, voert u de volgende stappen uit:

1. Selecteer Hulpprogramma's>NuGet Package Manager>NuGet-pakketten voor oplossing....
2. Zoek op het tabblad Bladeren naar Microsoft.Identity.Client.
3. Selecteer Microsoft.Identity.Client in de lijst.
4. Selecteer SignInMaui in het deelvenster Projectlijst .
5. Selecteer Installeren.
6. Als u wordt gevraagd om de installatie te controleren, selecteert u OK.

Herhaal het proces om de resterende vereiste pakketten te installeren.

Afbeeldingsresource toevoegen

In deze sectie downloadt u een afbeelding die u in uw app gebruikt om de interactie tussen gebruikers te verbeteren.

Download de volgende afbeelding:

• Pictogram: Microsoft Entra ID - Deze afbeelding wordt gebruikt als pictogram op de hoofdpagina.

De afbeelding verplaatsen met Visual Studio

1. Vouw in het deelvenster Solution Explorer van Visual Studio de map Resources uit, waarin de map Afbeeldingen wordt weergegeven.
2. Klik met de rechtermuisknop op afbeeldingen en selecteer Bestaand item toevoegen>....
3. Navigeer naar de map met de gedownloade afbeeldingen.
4. Wijzig het filter in het bestandstypefilter in Afbeeldingsbestanden.
5. Selecteer de afbeelding die u hebt gedownload.
6. Selecteer Toevoegen.

Volgende stap

Deel 3: Zelfstudie: Gebruikers aanmelden in de .NET EXTERNAL Shell-app met behulp van een externe tenant