Freigeben über

Tutorial: Erstellen und Konfigurieren eines ASP.NET Core-Projekts für die Authentifizierung

  • Artikel

In diesem Tutorial lernen Sie, wie Sie mithilfe einer IDE ein ASP.NET Core-Projekt erstellen und es für die Authentifizierung und Autorisierung konfigurieren. Dieses Tutorial ist der zweite Teil einer Reihe, in der veranschaulicht wird, wie eine Web-API mithilfe von Microsoft Identity Platform geschützt wird. Im vorherigen Artikel haben Sie eine Anwendung in Ihrem Microsoft Entra ID-Mandanten registriert. In diesem Artikel führen Sie folgende Schritte aus:

  • Erstellen eines leeren ASP.NET Core-Projekts in Ihrer IDE
  • Konfigurieren der Einstellungen für die Anwendung
  • Identifizieren und Installieren der erforderlichen NuGet-Pakete

Voraussetzungen

Erstellen eines ASP.NET Core-Projekts

Verwenden Sie die folgenden Registerkarten, um ein ASP.NET Core-Projekt innerhalb einer IDE zu erstellen.

  1. Öffnen Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus.
  2. Suchen Sie nach der Vorlage Leere ASP.NET Core, wählen Sie diese aus, und wählen Sie dann Weiter aus.
  3. Geben Sie einen Namen für das Projekt ein, z. B. NewWebAPILocal.
  4. Wählen Sie einen Speicherort für das Projekt aus, oder übernehmen Sie die Standardoption, und wählen Sie dann Weiter aus.
  5. Übernehmen Sie die Standardeinstellung für das Framework und für Konfigurieren für HTTPS.
  6. Klicken Sie auf Erstellen.

Konfigurieren des ASP.NET Core-Projekts

Die zuvor aufgezeichneten Werte werden in der Datei appsettings.json verwendet, um die Anwendung für die Authentifizierung zu konfigurieren. Bei appsettings.json handelt es sich um eine Konfigurationsdatei, die zum Speichern von während der Laufzeit verwendeten Anwendungseinstellungen benutzt wird.

  1. Öffnen Sie die Datei appsettings.json, und ersetzen Sie den Dateiinhalt durch den folgenden Codeschnipsel:

    {
  "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 – Der Endpunkt des Cloudanbieters. Überprüfen Sie die verschiedenen verfügbaren Endpunkte unter Nationale Clouds.
    • TenantId – Der Bezeichner des Mandanten, in dem die Anwendung registriert ist. Ersetzen Sie den Text in Anführungszeichen durch den Wert der Verzeichnis-ID (Mandanten-ID), die zuvor auf der Übersichtsseite der registrierten Anwendung aufgezeichnet wurde.
    • ClientId – Der Bezeichner der Anwendung, auch als Client bezeichnet. Ersetzen Sie den Text in Anführungszeichen durch den Wert Anwendungs-ID (Client-ID), die zuvor auf der Übersichtsseite der registrierten Anwendung aufgezeichnet wurde.
    • Scopes – Der Bereich, der zum Anfordern des Zugriffs auf die Anwendung verwendet wird. In diesem Tutorial lautet der Bereich Forecast.Read.

  2. Speichern Sie die Änderungen in der Datei.

Identitätspakete installieren

Identitätsbezogene NuGet-Pakete müssen im Projekt installiert sein, damit die Authentifizierung von Benutzern aktiviert werden kann.

  1. Wählen Sie im oberen Menü Tools>NuGet-Paket-Manager>NuGet-Pakete für Lösung verwalten aus.
  2. Suchen Sie bei ausgewählter Registerkarte Durchsuchen nach Microsoft.Identity.Web, wählen Sie das Microsoft.Identity.Web-Paket aus, aktivieren Sie das Kontrollkästchen Projekt, und wählen Sie dann Installieren aus.
  3. Wählen Sie OK oder Ich stimme zu für andere Fenster, die möglicherweise erscheinen.

Nächste Schritte

Tutorial: Implementieren eines geschützten Endpunkts zu Ihrer API