Implementieren Sie identitätsbasierte Authentifizierung und Autorisierung in Minimal-APIs in ASP.NET Core

Minimale APIs in ASP.NET Core ermöglichen es uns, schlanke APIs mit minimalen Abhängigkeiten zu erstellen. Allerdings benötigen wir in unseren Minimal-APIs häufig noch Authentifizierung und Autorisierung.

Minimal APIs in ASP.NET Core offer a lightweight approach to building APIs with minimal dependencies. However, many scenarios still require authentication and authorization in these minimal APIs. ASP.NET Core provides several options for achieving this, including basic authentication, token-based authentication, and identity-based authentication.

Minimale APIs in ASP.NET Core bieten einen einfachen Ansatz zum Erstellen von APIs mit minimalen Abhängigkeiten. Allerdings erfordern viele Szenarien immer noch eine Authentifizierung und Autorisierung in diesen minimalen APIs. ASP.NET Core bietet hierfür mehrere Optionen, darunter Basisauthentifizierung, tokenbasierte Authentifizierung und identitätsbasierte Authentifizierung.

We've covered implementing basic authentication in minimal APIs and JWT token-based authentication in minimal APIs. Now, let's explore how to implement identity-based authentication for minimal APIs in ASP.NET Core.

Wir haben die Implementierung der Basisauthentifizierung in minimalen APIs und der JWT-Token-basierten Authentifizierung in minimalen APIs behandelt. Lassen Sie uns nun untersuchen, wie Sie die identitätsbasierte Authentifizierung für minimale APIs in ASP.NET Core implementieren.

To follow along with the code examples in this article, ensure you have Visual Studio 2022 installed on your system. If you don't have a copy, you can download Visual Studio 2022 here.

Um den Codebeispielen in diesem Artikel folgen zu können, stellen Sie sicher, dass Visual Studio 2022 auf Ihrem System installiert ist. Wenn Sie keine Kopie haben, können Sie Visual Studio 2022 hier herunterladen.

Creating an ASP.NET Core Web API Project in Visual Studio 2022

Erstellen eines ASP.NET Core-Web-API-Projekts in Visual Studio 2022

To create an ASP.NET Core Web API project in Visual Studio 2022, follow these steps:

Führen Sie die folgenden Schritte aus, um ein ASP.NET Core-Web-API-Projekt in Visual Studio 2022 zu erstellen:

We'll use this ASP.NET Core Web API project to work with the code examples given in the sections below.

Wir verwenden dieses ASP.NET Core-Web-API-Projekt, um mit den in den folgenden Abschnitten angegebenen Codebeispielen zu arbeiten.

Identity Management in ASP.NET Core

Identitätsmanagement in ASP.NET Core

ASP.NET Core includes a powerful feature called identity management, which has been enhanced in .NET 8. The built-in Identity framework in ASP.NET Core provides the necessary middleware to implement authentication, user management, and role-based authorization, making it easier to implement robust and secure authentication mechanisms in your application.

ASP.NET Core umfasst eine leistungsstarke Funktion namens Identitätsverwaltung, die in .NET 8 verbessert wurde. Das integrierte Identitätsframework in ASP.NET Core stellt die erforderliche Middleware bereit, um Authentifizierung, Benutzerverwaltung und rollenbasierte Autorisierung zu implementieren Es ist einfacher, robuste und sichere Authentifizierungsmechanismen in Ihrer Anwendung zu implementieren.

ASP.NET Core's Identity framework is extensible and customizable, supporting the following key features:

Das Identitätsframework von ASP.NET Core ist erweiterbar und anpassbar und unterstützt die folgenden Hauptfunktionen:

Creating a Minimal API in ASP.NET Core

Erstellen einer Minimal-API in ASP.NET Core

In the Web API project we created above, replace the generated code with the following code to create a basic minimal API.

Ersetzen Sie im oben erstellten Web-API-Projekt den generierten Code durch den folgenden Code, um eine grundlegende Minimal-API zu erstellen.

When you run the application, the text "Hello World!" will be displayed in your web browser. We'll use this endpoint later in this article.

Wenn Sie die Anwendung ausführen, wird der Text „Hello World!“ angezeigt. wird in Ihrem Webbrowser angezeigt. Wir werden diesen Endpunkt später in diesem Artikel verwenden.

Installing NuGet Packages

Installieren von NuGet-Paketen

To add support for the built-in Identity framework in ASP.NET Core, select the project in the Solution Explorer window, then right-click and select "Manage NuGet Packages." In the NuGet Package Manager window, search for the Microsoft.AspNetCore.Identity.EntityFrameworkCore, Microsoft.EntityFrameworkCore.SqlServer, and Microsoft.EntityFrameworkCore.Design packages and install them.

Um Unterstützung für das integrierte Identitätsframework in ASP.NET Core hinzuzufügen, wählen Sie das Projekt im Projektmappen-Explorer-Fenster aus, klicken Sie dann mit der rechten Maustaste und wählen Sie „NuGet-Pakete verwalten“. Suchen Sie im NuGet-Paket-Manager-Fenster nach den Paketen Microsoft.AspNetCore.Identity.EntityFrameworkCore, Microsoft.EntityFrameworkCore.SqlServer und Microsoft.EntityFrameworkCore.Design und installieren Sie sie.

Alternatively, you can install the packages via the NuGet Package Manager console by entering the commands listed below.

Alternativ können Sie die Pakete über die NuGet Package Manager-Konsole installieren, indem Sie die unten aufgeführten Befehle eingeben.

Creating a New DbContext in EF Core

Erstellen eines neuen DbContext in EF Core

We'll be using Entity Framework Core in this example. The DbContext is an integral component of EF Core that represents a connection session with the database. Next, create a custom DbContext class by extending the IdentityDbContext class as shown in the code snippet given below.

In diesem Beispiel verwenden wir Entity Framework Core. Der DbContext ist eine integrale Komponente von EF Core, die eine Verbindungssitzung mit der Datenbank darstellt. Erstellen Sie als Nächstes eine benutzerdefinierte DbContext-Klasse, indem Sie die IdentityDbContext-Klasse erweitern, wie im unten angegebenen Codeausschnitt gezeigt.

You should register the custom DbContext class by including the following line of code in the Program.cs file.

Sie sollten die benutzerdefinierte DbContext-Klasse registrieren, indem Sie die folgende Codezeile in die Datei Program.cs einfügen.

Enabling Authentication and Authorization in ASP.NET Core

Aktivieren der Authentifizierung und Autorisierung in ASP.NET Core

Authentication is the process of determining who the user is and validating the user's identity. You can enable authentication in a minimal API in ASP.NET Core by using the AddAuthentication() method as shown in the code snippet given below.

Bei der Authentifizierung wird festgestellt, wer der Benutzer ist, und die Identität des Benutzers überprüft. Sie können die Authentifizierung in einer minimalen API in ASP.NET Core aktivieren, indem Sie die AddAuthentication()-Methode verwenden, wie im unten angegebenen Codeausschnitt gezeigt.

We use authorization to restrict access to certain resources in an application. You can enable authorization in your minimal API by using the following code.

Wir nutzen die Autorisierung, um den Zugriff auf bestimmte Ressourcen in einer Anwendung einzuschränken. Sie können die Autorisierung in Ihrer minimalen API aktivieren, indem Sie den folgenden Code verwenden.

The AddAuthorization method is used to register authorization services with the services container so that you can define rules for enabling or disabling access to resources of the application if needed.

Die AddAuthorization-Methode wird verwendet, um Autorisierungsdienste beim Dienstecontainer zu registrieren, sodass Sie bei Bedarf Regeln zum Aktivieren oder Deaktivieren des Zugriffs auf Ressourcen der Anwendung definieren können.

Configuring Services and API Endpoints in ASP.NET Core

Konfigurieren von Diensten und API-Endpunkten in ASP.NET Core

The next thing we need to do is configure the identity and EF Core services and the API endpoints. To do this, include the code listing given below in the Program.cs file.

Als nächstes müssen wir die Identitäts- und EF Core-Dienste sowie die API-Endpunkte konfigurieren. Fügen Sie dazu die unten angegebene Codeliste in die Datei Program.cs ein.

The AddIdentityApiEndpoints() method in the preceding code snippet adds the necessary controllers and services for authentication and authorization (login, logout, registration, etc.). Note that this is a new method (introduced in .NET 8) used to configure Identity integration in an application. The AddIdentityApiEndpoints() method accepts an instance of type IdentityUser as a parameter, which is used to specify the type of user.

Die AddIdentityApiEndpoints()-Methode im vorherigen Codeausschnitt fügt die erforderlichen Controller und Dienste für die Authentifizierung und Autorisierung (Anmeldung, Abmeldung, Registrierung usw.) hinzu. Beachten Sie, dass es sich hierbei um eine neue Methode (eingeführt in .NET 8) handelt, die zum Konfigurieren der Identitätsintegration in einer Anwendung verwendet wird. Die AddIdentityApiEndpoints()-Methode akzeptiert eine Instanz vom Typ IdentityUser als Parameter, der zur Angabe des Benutzertyps verwendet wird.

You can use the following piece of code to add authorization for the /helloworld endpoint.

Sie können den folgenden Codeabschnitt verwenden, um eine Autorisierung für den /helloworld-Endpunkt hinzuzufügen.

Complete Program.cs File Source

Vollständige Program.cs-Dateiquelle

The complete source code of the Program.cs file is given below for your reference.

Der vollständige Quellcode der Datei „Program.cs“ ist unten als Referenz aufgeführt.

The integrated identity management feature in ASP.NET Core is both powerful and easy to use. The improvements in .NET 8 have made Identity even more robust and flexible with an improved Identity API, which enables you to implement identity-based authentication and authorization more easily and efficiently with less code.

Die integrierte Identitätsverwaltungsfunktion in ASP.NET Core ist sowohl leistungsstark als auch einfach zu verwenden. Die Verbesserungen in .NET 8 haben Identity mit einer verbesserten Identity API noch robuster und flexibler gemacht, wodurch Sie identitätsbasierte Authentifizierung und Autorisierung einfacher und effizienter mit weniger Code implementieren können.

Next read this:

Lesen Sie als nächstes Folgendes: