Zelfstudie: Een ASP.NET Core-project maken en configureren voor verificatie

In deze zelfstudie leert u hoe u een ASP.NET Core-project maakt met behulp van een IDE en configureert voor verificatie en autorisatie. Deze zelfstudie is het tweede deel van een reeks die laat zien hoe u een web-API beveiligt met behulp van het Microsoft Identity Platform. In het vorige artikel hebt u een toepassing geregistreerd in uw Microsoft Entra ID-tenant. In dit artikel, u;

• Een ASP.NET Core Empty-project maken in uw IDE
• De instellingen voor de toepassing configureren
• De vereiste NuGet-pakketten identificeren en installeren

Vereisten

• Voltooiing van de vereisten en stappen in zelfstudie: Web-API registreren bij het Microsoft Identity Platform.
• U kunt de IDE's downloaden die in deze zelfstudie worden gebruikt op de pagina Downloads .
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 voor Mac

• Een minimale vereiste van .NET 6.0 SDK.

Een ASP.NET Core-project maken in Azure

Gebruik de volgende tabbladen om een ASP.NET Core-project in een IDE te maken.

Visual Studio

1. Open Visual Studio en selecteer vervolgens Een nieuw project maken.
2. Zoek en kies de sjabloon ASP.NET Core Empty en selecteer Vervolgens.
3. Voer een naam in voor het project, zoals NewWebAPILocal.
4. Kies een locatie voor het project of accepteer de standaardoptie en selecteer vervolgens Volgende.
5. Accepteer de standaardwaarde voor het framework en configureer voor HTTPS.
6. Selecteer Maken.

Visual Studio Code

1. Open Visual Studio Code, selecteer Map > openen.... Navigeer naar en selecteer de locatie waar u uw project wilt maken.

2. Open een nieuwe terminal door Terminal te selecteren in de bovenste balk en vervolgens Nieuwe terminal.

3. Maak een nieuwe map met behulp van het pictogram Nieuwe map... in het deelvenster Explorer . Geef een naam op die vergelijkbaar is met de naam die eerder is geregistreerd, bijvoorbeeld NewWebAPILocal.

4. Open een nieuwe terminal door Terminal > New Terminal te selecteren.

5. Als u een ASP.NET Core Empty-sjabloon wilt maken, voert u de volgende opdrachten uit in de terminal om naar de map te gaan en het project te maken:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio voor Mac

1. Open Visual Studio en selecteer Vervolgens Nieuw.
2. Selecteer App onder Web en Console in de linkernavigatiebalk.
3. Selecteer onder ASP.NET Core DE API en zorg ervoor dat C# is geselecteerd in de vervolgkeuzelijst en selecteer vervolgens Doorgaan.
4. Accepteer de standaardwaarde voor het doelframework en Geavanceerd en selecteer Vervolgens Doorgaan.
5. Voer een naam in voor de projectnaam. Dit wordt weergegeven in de naam van de oplossing. Geef een soortgelijke naam op als de naam die is geregistreerd in het Microsoft Entra-beheercentrum, zoals NewAPI1.
6. Accepteer de standaardlocatie voor het project of kies een andere locatie en selecteer Vervolgens Maken.

Notitie

Visual Studio voor Mac is gepland voor buitengebruikstelling op 31 augustus 2024 overeenkomstig microsoft Modern levenscyclusbeleid. Visual Studio voor Mac 17.6 blijft tot 31 augustus 2024 ondersteund, met onderhoudsupdates voor beveiligingsproblemen en bijgewerkte platforms van Apple. Raadpleeg wat er gebeurt met Visual Studio voor Mac voor meer informatie.

Het ASP.NET Core-project configureren

De waarden die eerder zijn vastgelegd, worden gebruikt in appsettings.json om de toepassing voor verificatie te configureren. appsettings.json is een configuratiebestand dat wordt gebruikt voor het opslaan van toepassingsinstellingen die tijdens de runtime worden gebruikt.

1. Open appsettings.json en vervang de bestandsinhoud door het volgende codefragment:

   {
     "AzureAd": {
       "Instance": "https://login.microsoftonline.com/",
       "ClientId": "Enter the client ID here",
       "TenantId": "Enter the tenant ID here",
       "Scopes": "Forecast.Read"
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*"
   } 
   

   • Instance - Het eindpunt van de cloudprovider. Neem contact op met de verschillende beschikbare eindpunten in nationale clouds.
   • TenantId - De id van de tenant waar de toepassing is geregistreerd. Vervang de tekst tussen aanhalingstekens door de map-id-waarde (tenant) die eerder is vastgelegd op de overzichtspagina van de geregistreerde toepassing.
   • ClientId - De id van de toepassing, ook wel de client genoemd. Vervang de tekst tussen aanhalingstekens door de toepassings-id-waarde (client) die eerder is vastgelegd op de overzichtspagina van de geregistreerde toepassing.
   • Scopes - Het bereik dat wordt gebruikt om toegang tot de toepassing aan te vragen. Voor deze zelfstudie is Forecast.Readhet bereik .

2. Sla de wijzigingen in het bestand op.

Identiteitspakketten installeren

NuGet-pakketten met betrekking tot identiteiten moeten worden geïnstalleerd in het project om te kunnen verifiëren dat gebruikers worden ingeschakeld.

Visual Studio

1. Selecteer Tools>NuGet Pakketbeheer> Manage NuGet Packages for Solution in het bovenste menu.
2. Als het tabblad Bladeren is geselecteerd, zoekt u naar Microsoft.Identity.Web, selecteert u het Microsoft.Identity.Web pakket, schakelt u het selectievakje Project in en selecteert u Installeren.
3. Selecteer OK of Ik ga akkoord voor andere vensters die kunnen worden weergegeven.

Visual Studio Code

1. Voer in de terminal die in de vorige sectie is geopend de volgende opdracht in:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio voor Mac

1. Selecteer Tools>Manage NuGet Packages in het bovenste menu.
2. Zoek naar Microsoft.Identity.Web, selecteer het Microsoft.Identity.Web pakket, selecteer Project en selecteer vervolgens Pakket toevoegen.
3. Controleer in het pop-upvenster of het juiste project is geselecteerd en selecteer vervolgens OK.
4. Selecteer Accepteren als er andere vensters voor acceptatie van licenties worden weergegeven.

Volgende stappen

Zelfstudie: Een beveiligd eindpunt implementeren in uw API