Microsoft.AspNetCore.Authentication.OpenIdConnect 11.0.0

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();
    

    This ensures that the authentication middleware is added to the request pipeline.

Main Types

The main types provided by Microsoft.AspNetCore.Authentication.OpenIdConnect are:

  • OpenIdConnectOptions: Represents the options for configuring the OpenID Connect authentication middleware
  • OpenIdConnectEvents: Provides event handlers for various stages of the OpenID Connect authentication workflow

For more information on these types and their usage, refer to the official documentation.

Additional Documentation

For additional documentation on using OpenID Connect authentication in ASP.NET Core, you can refer to the following resources:

Feedback & Contributing

Microsoft.AspNetCore.Authentication.OpenIdConnect is released as open-source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Showing the top 20 packages that depend on Microsoft.AspNetCore.Authentication.OpenIdConnect.

Packages Downloads
CheddarAuthService
Package to access SIERA+ related authentication services and models
581
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
189
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
154
CheddarAuthService
Package to access SIERA+ related authentication services and models
91
CheddarAuthService
Package to access SIERA related authentication services and models
90
CheddarAuthService
Package to access SIERA related authentication services and models
48
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
39
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
30
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
29
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
29
Microsoft.AspNetCore.All
Provides a default set of APIs for building an ASP.NET Core application, and also includes API for third-party integrations with ASP.NET Core. This package requires the ASP.NET Core runtime. This runtime is installed by the .NET Core SDK, or can be acquired separately using installers available at https://aka.ms/dotnet-download.
28
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
28
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
27
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
27
Microsoft.Identity.Web
This package enables ASP.NET Core web apps and web APIs to use the Microsoft identity platform (formerly Azure AD v2.0). This package is specifically used for web applications, which sign-in users, and protected web APIs, which optionally call downstream web APIs.
26
CheddarAuthService
Package to access SIERA related authentication services and models
26
CheddarAuthService
Initial package creation
25
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
25
Microsoft.AspNetCore.All
Provides a default set of APIs for building an ASP.NET Core application, and also includes API for third-party integrations with ASP.NET Core. This package requires the ASP.NET Core runtime. This runtime is installed by the .NET Core SDK, or can be acquired separately using installers available at https://aka.ms/dotnet-download.
25

Version Downloads Last updated
11.0.0 4 11/13/2026
11.0.0-rc.3.26522.148 4 11/16/2026
11.0.0-rc.2.26504.105 7 10/14/2026
11.0.0-rc.1.26425.128 7 09/14/2026
11.0.0-preview.7.26381.103 7 08/27/2026
11.0.0-preview.6.26359.118 10 07/20/2026
11.0.0-preview.5.26302.115 11 06/27/2026
11.0.0-preview.4.26230.115 9 05/12/2026
11.0.0-preview.3.26207.106 10 04/28/2026
11.0.0-preview.2.26159.112 17 03/21/2026
11.0.0-preview.1.26104.118 9 03/05/2026
10.0.15 4 11/19/2026
10.0.14 4 11/03/2026
10.0.13 7 10/14/2026
10.0.12 7 09/15/2026
10.0.11 9 08/23/2026
10.0.10 9 07/18/2026
10.0.9 9 07/18/2026
10.0.8 12 05/12/2026
10.0.7 12 04/29/2026
10.0.6 10 04/28/2026
10.0.5 15 03/21/2026
10.0.4 11 03/21/2026
10.0.3 11 03/05/2026
10.0.2 12 01/31/2026
10.0.1 11 12/21/2025
10.0.0 13 12/04/2025
10.0.0-rc.2.25502.107 14 10/20/2025
10.0.0-rc.1.25451.107 11 09/11/2025
10.0.0-preview.7.25380.108 11 08/24/2025
10.0.0-preview.6.25358.103 10 07/20/2025
10.0.0-preview.5.25277.114 14 08/06/2025
10.0.0-preview.4.25258.110 11 07/01/2026
10.0.0-preview.3.25172.1 11 05/04/2025
10.0.0-preview.2.25164.1 12 07/02/2026
10.0.0-preview.1.25120.3 10 03/14/2025
9.0.23 4 11/18/2026
9.0.22 6 11/09/2026
9.0.21 1 10/14/2026
9.0.20 5 09/15/2026
9.0.19 9 09/24/2026
9.0.18 4 07/18/2026
9.0.17 12 06/26/2026
9.0.16 8 07/18/2026
9.0.15 9 06/28/2026
9.0.14 11 06/26/2026
9.0.13 7 06/26/2026
9.0.12 8 07/01/2026
9.0.11 13 06/28/2026
9.0.10 6 06/27/2026
9.0.9 10 06/24/2026
9.0.8 13 06/24/2026
9.0.7 8 06/24/2026
9.0.6 6 06/24/2026
9.0.5 10 06/24/2026
9.0.4 17 05/04/2025
9.0.3 17 03/14/2025
9.0.2 11 05/07/2025
9.0.1 14 01/27/2025
9.0.0 15 11/15/2024
9.0.0-rc.2.24474.3 12 07/02/2026
9.0.0-rc.1.24452.1 15 09/15/2024
9.0.0-preview.7.24406.2 15 08/20/2024
9.0.0-preview.6.24328.4 11 07/11/2024
9.0.0-preview.5.24306.11 9 06/20/2024
9.0.0-preview.4.24267.6 10 06/08/2024
9.0.0-preview.3.24172.13 7 07/06/2026
9.0.0-preview.2.24128.4 8 07/09/2026
9.0.0-preview.1.24081.5 9 07/19/2026
8.0.34 1 11/12/2026
8.0.33 3 11/20/2026
8.0.32 5 10/14/2026
8.0.31 8 09/15/2026
8.0.30 8 08/17/2026
8.0.29 9 07/18/2026
8.0.28 7 06/26/2026
8.0.27 8 06/29/2026
8.0.26 7 07/18/2026
8.0.25 10 06/28/2026
8.0.24 9 06/26/2026
8.0.23 10 06/27/2026
8.0.22 12 06/27/2026
8.0.21 11 06/26/2026
8.0.20 9 07/02/2026
8.0.19 11 07/02/2026
8.0.18 7 06/28/2026
8.0.17 12 06/30/2026
8.0.16 11 06/26/2026
8.0.15 9 07/04/2026
8.0.14 8 03/19/2025
8.0.13 6 06/26/2026
8.0.12 8 07/18/2026
8.0.11 8 07/18/2026
8.0.10 8 07/05/2026
8.0.8 13 06/24/2026
8.0.7 10 06/24/2026
8.0.6 12 09/25/2024
8.0.5 14 06/02/2024
8.0.4 12 06/29/2024
8.0.3 13 07/25/2024
8.0.2 12 08/09/2024
8.0.1 15 02/07/2024
8.0.0 34 03/24/2024
8.0.0-rc.2.23480.2 13 10/05/2024
8.0.0-rc.1.23421.29 17 03/26/2024
8.0.0-preview.7.23375.9 10 03/18/2024
8.0.0-preview.6.23329.11 18 10/08/2025
8.0.0-preview.5.23302.2 14 02/04/2024
8.0.0-preview.4.23260.4 12 01/06/2024
8.0.0-preview.3.23177.8 7 07/09/2024
8.0.0-preview.2.23153.2 15 12/25/2024
8.0.0-preview.1.23112.2 10 10/14/2025
7.0.20 11 06/27/2026
7.0.19 10 06/26/2026
7.0.18 12 06/28/2026
7.0.17 8 06/26/2026
7.0.16 8 06/29/2026
7.0.15 12 06/29/2026
7.0.14 11 01/06/2024
7.0.13 9 04/17/2024
7.0.12 11 01/22/2024
7.0.11 14 08/10/2024
7.0.10 11 04/25/2024
7.0.9 12 04/27/2024
7.0.8 12 12/03/2024
7.0.7 20 12/26/2024
7.0.5 10 01/11/2024
7.0.4 11 01/17/2024
7.0.3 12 05/25/2024
7.0.2 12 06/14/2024
7.0.1 13 01/09/2024
7.0.0 14 01/10/2025
7.0.0-rc.2.22476.2 12 10/20/2024
7.0.0-rc.1.22427.2 9 12/27/2023
7.0.0-preview.7.22376.6 17 01/18/2025
7.0.0-preview.6.22330.3 13 08/01/2024
7.0.0-preview.5.22303.8 10 03/30/2024
7.0.0-preview.4.22251.1 10 09/02/2024
7.0.0-preview.3.22178.4 14 10/07/2024
7.0.0-preview.2.22153.2 16 01/12/2024
7.0.0-preview.1.22109.13 14 02/26/2025
6.0.36 10 06/28/2026
6.0.35 7 06/27/2026
6.0.33 12 06/26/2026
6.0.32 5 06/26/2026
6.0.31 9 06/30/2026
6.0.30 8 06/26/2026
6.0.29 8 06/27/2026
6.0.28 9 07/18/2026
6.0.27 7 07/06/2026
6.0.26 13 06/26/2026
6.0.25 12 06/26/2026
6.0.24 14 09/23/2024
6.0.23 11 06/26/2026
6.0.22 15 07/12/2024
6.0.21 10 03/15/2024
6.0.20 16 03/07/2024
6.0.19 10 07/09/2024
6.0.18 9 10/12/2025
6.0.16 15 06/12/2024
6.0.15 14 05/22/2024
6.0.14 19 03/11/2023
6.0.13 8 06/27/2026
6.0.12 13 09/09/2024
6.0.11 14 07/25/2024
6.0.10 8 11/04/2025
6.0.9 15 06/24/2026
6.0.8 13 08/15/2022
6.0.7 10 06/08/2024
6.0.6 14 06/16/2022
6.0.5 10 01/26/2024
6.0.4 10 12/18/2023
6.0.3 17 03/30/2022
6.0.2 15 01/03/2024
6.0.1 14 12/23/2023
6.0.0 19 03/31/2022
6.0.0-rc.2.21480.10 15 05/12/2025
6.0.0-rc.1.21452.15 18 06/20/2024
6.0.0-preview.7.21378.6 11 10/06/2024
6.0.0-preview.6.21355.2 7 02/06/2025
6.0.0-preview.5.21301.17 10 09/21/2024
6.0.0-preview.4.21253.5 11 06/05/2024
6.0.0-preview.3.21201.13 12 02/09/2024
6.0.0-preview.2.21154.6 8 05/06/2024
6.0.0-preview.1.21103.6 14 12/31/2023
5.0.17 9 06/28/2022
5.0.16 14 02/19/2024
5.0.15 16 07/08/2024
5.0.14 14 09/16/2024
5.0.13 15 01/09/2024
5.0.12 17 01/02/2024
5.0.11 11 06/28/2026
5.0.10 12 09/30/2021
5.0.9 14 08/16/2021
5.0.8 19 01/09/2024
5.0.7 11 08/30/2024
5.0.6 16 01/28/2024
5.0.5 18 01/03/2025
5.0.4 12 01/21/2024
5.0.3 14 02/12/2024
5.0.2 668 01/14/2021
5.0.1 26 02/16/2021
5.0.0 21 01/18/2024
5.0.0-rc.2.20475.17 15 10/06/2024
5.0.0-rc.1.20451.17 13 12/31/2023
5.0.0-preview.8.20414.8 8 09/08/2024
5.0.0-preview.7.20365.19 12 12/29/2023
5.0.0-preview.6.20312.15 10 07/02/2026
5.0.0-preview.5.20279.2 13 05/31/2024
5.0.0-preview.4.20257.10 10 10/09/2024
5.0.0-preview.3.20215.14 11 10/09/2024
5.0.0-preview.2.20167.3 13 06/03/2025
5.0.0-preview.1.20124.5 11 01/05/2024
3.1.32 8 03/13/2025
3.1.31 10 06/29/2026
3.1.30 14 05/29/2024
3.1.29 8 07/08/2026
3.1.28 11 12/18/2024
3.1.27 11 12/01/2024
3.1.26 9 12/25/2023
3.1.25 11 05/01/2024
3.1.24 10 12/21/2023
3.1.23 12 02/16/2024
3.1.22 16 01/12/2024
3.1.21 12 07/05/2024
3.1.20 10 10/06/2024
3.1.19 18 01/06/2024
3.1.18 11 12/15/2023
3.1.17 10 06/15/2025
3.1.16 9 06/26/2026
3.1.15 16 02/26/2024
3.1.14 11 09/07/2025
3.1.13 13 12/15/2023
3.1.12 11 04/30/2024
3.1.11 14 01/20/2025
3.1.10 6 11/08/2024
3.1.9 13 12/14/2023
3.1.8 12 01/10/2024
3.1.7 13 09/05/2024
3.1.6 16 12/27/2023
3.1.5 16 04/25/2024
3.1.4 18 12/24/2023
3.1.3 15 12/20/2023
3.1.2 13 01/06/2024
3.1.1 11 02/05/2024
3.1.0 87 09/14/2021
3.1.0-preview3.19555.2 9 08/30/2025
3.1.0-preview2.19528.8 13 10/06/2024
3.1.0-preview1.19508.20 14 09/08/2024
3.0.3 18 02/24/2024
3.0.2 13 03/07/2025
3.0.0 17 02/04/2024
3.0.0-rc1.19457.4 17 10/06/2024
3.0.0-preview9.19424.4 11 01/03/2024
3.0.0-preview8.19405.7 15 10/03/2024
3.0.0-preview7.19365.7 11 03/16/2024
3.0.0-preview6.19307.2 11 05/20/2024
3.0.0-preview5-19227-01 13 06/28/2024
3.0.0-preview4-19216-03 15 12/16/2023
3.0.0-preview3-19153-02 11 12/12/2024
3.0.0-preview-19075-0444 17 07/08/2024
2.3.14 5 11/14/2026
2.3.13 8 09/15/2026
2.3.12 8 08/17/2026
2.3.11 6 06/29/2026
2.3.10 10 06/26/2026
2.3.9 9 06/24/2026
2.3.8 8 06/24/2026
2.3.0 11 06/24/2026
2.2.0 19 01/21/2024
2.2.0-preview3-35497 7 04/05/2025
2.2.0-preview2-35157 15 01/23/2025
2.2.0-preview1-35029 8 04/13/2024
2.1.2 12 02/04/2024
2.1.1 12 09/03/2021
2.1.0 17 11/18/2021
2.1.0-rc1-final 12 05/24/2024
2.1.0-preview2-final 11 05/22/2024
2.1.0-preview1-final 9 05/28/2025
2.0.4 14 04/21/2024
2.0.3 12 02/05/2025
2.0.1 10 04/08/2025
2.0.0 13 12/16/2023
2.0.0-preview2-final 10 06/27/2026
2.0.0-preview1-final 16 01/03/2024
1.1.3 9 11/20/2024
1.1.2 12 08/15/2024
1.1.1 14 10/06/2024
1.1.0 14 01/03/2024
1.1.0-preview1-final 11 01/22/2024
1.0.5 13 10/06/2024
1.0.4 11 01/21/2026
1.0.3 9 06/24/2026
1.0.2 12 08/11/2024
1.0.1 9 03/16/2025
1.0.0 13 12/26/2023
1.0.0-rc2-final 15 12/01/2024