aspnet/Microsoft.AspNetCore.Authentication.OpenIdConnectv10.0.2

About

Microsoft.AspNetCore.Authentication.OpenIdConnect provides middleware that enables an application to support the OpenID Connect authentication workflow.

Key Features

• Single sign-on and single sign-out support
• Integration with external identity providers
• Token validation and management
• Configuration and mapping of user claims

How to Use

To use Microsoft.AspNetCore.Authentication.OpenIdConnect, follow these steps:

Installation

dotnet add package Microsoft.AspNetCore.Authentication.OpenIdConnect

Configuration

To configure Microsoft.AspNetCore.Authentication.OpenIdConnect, you need to add the necessary services and middleware to your application.

1. In the Program.cs of your ASP.NET Core app, add the following code to register the OpenID Connect authentication services:

   builder.Services
       .AddAuthentication(options =>
       {
           options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
           options.DefaultChallengeScheme = OpenIdConnectDefaults.AuthenticationScheme;
       })
       .AddCookie()
       .AddOpenIdConnect(options =>
       {
           // Configure the authentication options
           options.SignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;
           options.Authority = "your-identity-provider";
           options.ClientId = "your-client-id";
           options.ClientSecret = "your-client-secret-from-user-secrets-or-keyvault";
           options.ResponseType = "code";
           options.Scope.Add("profile");
           options.SaveTokens = true;
       });
   

   Make sure to replace your-identity-provider, your-client-id, and your-client-secret-from-user-secrets-or-keyvault, with the appropriate values for your application and identity provider.

2. Add the following code to enable the OpenID Connect authentication middleware:

   var app = builder.Build();
   
   app.UseAuthentication();