Microsoft.AspNetCore.Authentication.JwtBearer 9.0.2

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer --version 9.0.2                
NuGet\Install-Package Microsoft.AspNetCore.Authentication.JwtBearer -Version 9.0.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="9.0.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Microsoft.AspNetCore.Authentication.JwtBearer --version 9.0.2                
#r "nuget: Microsoft.AspNetCore.Authentication.JwtBearer, 9.0.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Microsoft.AspNetCore.Authentication.JwtBearer as a Cake Addin
#addin nuget:?package=Microsoft.AspNetCore.Authentication.JwtBearer&version=9.0.2

// Install Microsoft.AspNetCore.Authentication.JwtBearer as a Cake Tool
#tool nuget:?package=Microsoft.AspNetCore.Authentication.JwtBearer&version=9.0.2                

About

Microsoft.AspNetCore.Authentication.JwtBearer is a middleware component designed for ASP.NET Core applications. It facilitates JSON Web Token (JWT) authentication, enabling secure authentication for APIs and web services. This package allows you to validate JWT tokens issued by an authentication server, ensuring secure access to your application's resources.

Key Features

  • Seamless integration with ASP.NET Core applications.
  • Supports JSON Web Token (JWT) authentication.
  • Enables secure authentication for APIs and web services.
  • Flexible configuration options for token validation parameters.
  • Works with .NET Core 3.0 and newer, as well as .NET Standard 2.1.

How to Use

using Microsoft.AspNetCore.Authentication.JwtBearer;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.IdentityModel.Tokens;
using System.Text;

public void ConfigureServices(IServiceCollection services)
{
    services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
        .AddJwtBearer(options =>
        {
            options.TokenValidationParameters = new TokenValidationParameters
            {
                ValidateIssuer = true,
                ValidateAudience = true,
                ValidateLifetime = true,
                ValidateIssuerSigningKey = true,
                ValidIssuer = "your_issuer",
                ValidAudience = "your_audience",
                IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("your_secret_key"))
            };
        });

    // Other configurations...
}

For more detailed configuration options and advanced scenarios, please refer to the blog JWT Validation and Authorization in ASP.NET Core.

Main Types

The main types provided by this library are:

  • JwtBearerDefaults: Contains default values for JWT Bearer authentication.
  • JwtBearerEvents: Events used to handle JWT Bearer authentication events.
  • JwtBearerHandler: Handles JWT Bearer authentication requests.
  • wtBearerOptions: Options for configuring JWT Bearer authentication.

Additional Documentation

Feedback & Contributing

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

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2.8K)

Showing the top 5 NuGet packages that depend on Microsoft.AspNetCore.Authentication.JwtBearer:

Package Downloads
Microsoft.Identity.Web.TokenAcquisition

Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).

Microsoft.AspNetCore.App

Provides a default set of APIs for building an ASP.NET Core application. 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.

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.

Microsoft.AspNetCore.Authentication.AzureAD.UI

ASP.NET Core Azure Active Directory Integration provides components for easily integrating Azure Active Directory authentication within your ASP.NET Core application. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/ab1f1c636afa3a6607f2d67bc387b586596d1d38

Okta.AspNetCore

Official Okta middleware for ASP.NET Core 3.1+. Easily add authentication and authorization to ASP.NET Core applications.

GitHub repositories (443)

Showing the top 5 popular GitHub repositories that depend on Microsoft.AspNetCore.Authentication.JwtBearer:

Repository Stars
bitwarden/server
Bitwarden infrastructure/backend (API, database, Docker, etc).
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
duplicati/duplicati
Store securely encrypted backups in the cloud!
dotnet-architecture/eShopOnWeb
Sample ASP.NET Core 8.0 reference application, now community supported: https://github.com/NimblePros/eShopOnWeb
Version Downloads Last updated
10.0.0-preview.1.25120.3 1,335 2/25/2025
9.0.2 508,063 2/11/2025
9.0.1 1,156,955 1/14/2025
9.0.0 3,834,336 11/12/2024
9.0.0-rc.2.24474.3 155,720 10/8/2024
9.0.0-rc.1.24452.1 74,597 9/10/2024
9.0.0-preview.7.24406.2 9,080 8/13/2024
9.0.0-preview.6.24328.4 45,671 7/9/2024
9.0.0-preview.5.24306.11 5,897 6/11/2024
9.0.0-preview.4.24267.6 11,696 5/21/2024
9.0.0-preview.3.24172.13 79,957 4/11/2024
9.0.0-preview.2.24128.4 26,025 3/12/2024
9.0.0-preview.1.24081.5 27,537 2/13/2024
8.0.13 479,186 2/11/2025
8.0.12 1,448,372 1/14/2025
8.0.11 5,558,815 11/12/2024
8.0.10 8,764,487 10/8/2024
8.0.8 11,217,269 8/13/2024
8.0.7 8,108,146 7/9/2024
8.0.6 9,643,224 5/28/2024
8.0.5 3,378,858 5/14/2024
8.0.4 8,606,871 4/9/2024
8.0.3 5,995,126 3/12/2024
8.0.2 6,951,828 2/13/2024
8.0.1 8,265,719 1/9/2024
8.0.0 28,437,271 11/14/2023
8.0.0-rc.2.23480.2 480,905 10/10/2023
8.0.0-rc.1.23421.29 101,759 9/12/2023
8.0.0-preview.7.23375.9 236,867 8/8/2023
8.0.0-preview.6.23329.11 81,243 7/11/2023
8.0.0-preview.5.23302.2 11,831 6/13/2023
8.0.0-preview.4.23260.4 11,509 5/16/2023
8.0.0-preview.3.23177.8 18,869 4/11/2023
8.0.0-preview.2.23153.2 8,733 3/14/2023
8.0.0-preview.1.23112.2 60,273 2/21/2023
7.0.20 1,178,365 5/28/2024
7.0.19 130,139 5/14/2024
7.0.18 402,534 4/9/2024
7.0.17 419,303 3/12/2024
7.0.16 651,326 2/13/2024
7.0.15 1,147,771 1/9/2024
7.0.14 2,255,708 11/14/2023
7.0.13 2,554,727 10/24/2023
7.0.12 1,979,912 10/10/2023
7.0.11 2,823,108 9/12/2023
7.0.10 3,894,870 8/8/2023
7.0.9 2,824,653 7/11/2023
7.0.8 2,338,291 6/22/2023
7.0.7 1,246,526 6/13/2023
7.0.5 7,301,917 4/11/2023
7.0.4 3,574,330 3/14/2023
7.0.3 3,461,148 2/14/2023
7.0.2 4,402,552 1/10/2023
7.0.1 9,245,664 12/13/2022
7.0.0 5,380,880 11/7/2022
7.0.0-rc.2.22476.2 85,831 10/11/2022
7.0.0-rc.1.22427.2 24,496 9/14/2022
7.0.0-preview.7.22376.6 24,478 8/9/2022
7.0.0-preview.6.22330.3 263,927 7/12/2022
7.0.0-preview.5.22303.8 6,261 6/14/2022
7.0.0-preview.4.22251.1 10,451 5/10/2022
7.0.0-preview.3.22178.4 4,449 4/13/2022
7.0.0-preview.2.22153.2 3,957 3/14/2022
7.0.0-preview.1.22109.13 3,413 2/17/2022
6.0.36 501,803 11/12/2024
6.0.35 410,847 10/8/2024
6.0.33 1,165,009 8/13/2024
6.0.32 982,751 7/9/2024
6.0.31 936,378 5/28/2024
6.0.30 454,990 5/14/2024
6.0.29 1,464,433 4/9/2024
6.0.28 1,191,277 3/12/2024
6.0.27 1,517,382 2/13/2024
6.0.26 2,832,387 1/9/2024
6.0.25 3,585,248 11/14/2023
6.0.24 2,136,722 10/24/2023
6.0.23 1,072,347 10/10/2023
6.0.22 2,017,423 9/12/2023
6.0.21 2,822,279 8/8/2023
6.0.20 2,676,270 7/11/2023
6.0.19 1,739,577 6/22/2023
6.0.18 873,891 6/13/2023
6.0.16 7,254,276 4/11/2023
6.0.15 4,488,814 3/14/2023
6.0.14 4,682,252 2/14/2023
6.0.13 7,509,997 1/10/2023
6.0.12 11,262,082 12/13/2022
6.0.11 7,931,477 11/7/2022
6.0.10 12,034,221 10/11/2022
6.0.9 9,126,930 9/13/2022
6.0.8 11,380,301 8/9/2022
6.0.7 9,226,359 7/12/2022
6.0.6 7,418,140 6/14/2022
6.0.5 10,523,257 5/10/2022
6.0.4 8,325,105 4/11/2022
6.0.3 9,686,957 3/8/2022
6.0.2 7,552,565 2/8/2022
6.0.1 13,044,005 12/14/2021
6.0.0 13,271,771 11/8/2021
6.0.0-rc.2.21480.10 75,950 10/12/2021
6.0.0-rc.1.21452.15 60,283 9/14/2021
6.0.0-preview.7.21378.6 66,643 8/10/2021
6.0.0-preview.6.21355.2 19,439 7/14/2021
6.0.0-preview.5.21301.17 11,735 6/15/2021
6.0.0-preview.4.21253.5 9,933 5/24/2021
6.0.0-preview.3.21201.13 13,753 4/8/2021
6.0.0-preview.2.21154.6 3,988 3/11/2021 6.0.0-preview.2.21154.6 is deprecated because it is no longer maintained.
6.0.0-preview.1.21103.6 6,485 2/12/2021 6.0.0-preview.1.21103.6 is deprecated because it is no longer maintained.
5.0.17 2,797,078 5/10/2022 5.0.17 is deprecated because it is no longer maintained.
5.0.16 656,372 4/11/2022 5.0.16 is deprecated because it is no longer maintained.
5.0.15 1,062,445 3/8/2022 5.0.15 is deprecated because it is no longer maintained.
5.0.14 966,550 2/8/2022 5.0.14 is deprecated because it is no longer maintained.
5.0.13 2,561,420 12/14/2021 5.0.13 is deprecated because it is no longer maintained.
5.0.12 21,019,061 11/7/2021 5.0.12 is deprecated because it is no longer maintained.
5.0.11 3,918,916 10/12/2021 5.0.11 is deprecated because it is no longer maintained.
5.0.10 3,956,345 9/14/2021 5.0.10 is deprecated because it is no longer maintained.
5.0.9 7,505,780 8/10/2021 5.0.9 is deprecated because it is no longer maintained.
5.0.8 2,905,537 7/13/2021 5.0.8 is deprecated because it is no longer maintained; 5.0.8 has at least one vulnerability with moderate severity.
5.0.7 4,176,289 6/8/2021 5.0.7 is deprecated because it is no longer maintained; 5.0.7 has at least one vulnerability with moderate severity.
5.0.6 2,984,551 5/11/2021 5.0.6 is deprecated because it is no longer maintained; 5.0.6 has at least one vulnerability with moderate severity.
5.0.5 4,209,742 4/6/2021 5.0.5 is deprecated because it is no longer maintained; 5.0.5 has at least one vulnerability with moderate severity.
5.0.4 2,987,869 3/9/2021 5.0.4 is deprecated because it is no longer maintained; 5.0.4 has at least one vulnerability with moderate severity.
5.0.3 3,158,694 2/9/2021 5.0.3 is deprecated because it is no longer maintained; 5.0.3 has at least one vulnerability with moderate severity.
5.0.2 2,878,512 1/12/2021 5.0.2 is deprecated because it is no longer maintained; 5.0.2 has at least one vulnerability with moderate severity.
5.0.1 3,202,117 12/8/2020 5.0.1 is deprecated because it is no longer maintained; 5.0.1 has at least one vulnerability with moderate severity.
5.0.0 11,255,422 11/9/2020 5.0.0 is deprecated because it is no longer maintained; 5.0.0 has at least one vulnerability with moderate severity.
5.0.0-rc.2.20475.17 108,248 10/13/2020 5.0.0-rc.2.20475.17 is deprecated because it is no longer maintained.
5.0.0-rc.1.20451.17 302,784 9/14/2020 5.0.0-rc.1.20451.17 is deprecated because it is no longer maintained.
5.0.0-preview.8.20414.8 3,284,697 8/25/2020 5.0.0-preview.8.20414.8 is deprecated because it is no longer maintained.
5.0.0-preview.7.20365.19 16,734 7/21/2020 5.0.0-preview.7.20365.19 is deprecated because it is no longer maintained.
5.0.0-preview.6.20312.15 20,940 6/25/2020 5.0.0-preview.6.20312.15 is deprecated because it is no longer maintained.
5.0.0-preview.5.20279.2 3,527 6/10/2020 5.0.0-preview.5.20279.2 is deprecated because it is no longer maintained.
5.0.0-preview.4.20257.10 4,378 5/18/2020 5.0.0-preview.4.20257.10 is deprecated because it is no longer maintained.
5.0.0-preview.3.20215.14 4,486 4/23/2020 5.0.0-preview.3.20215.14 is deprecated because it is no longer maintained.
5.0.0-preview.2.20167.3 3,554 4/2/2020 5.0.0-preview.2.20167.3 is deprecated because it is no longer maintained.
5.0.0-preview.1.20124.5 5,579 3/16/2020 5.0.0-preview.1.20124.5 is deprecated because it is no longer maintained.
3.1.32 2,378,333 12/13/2022
3.1.31 276,275 11/8/2022
3.1.30 213,674 10/11/2022
3.1.29 261,682 9/13/2022
3.1.28 2,199,716 8/9/2022
3.1.27 367,757 7/12/2022
3.1.26 352,781 6/14/2022
3.1.25 654,113 5/10/2022
3.1.24 472,424 4/11/2022
3.1.23 2,060,487 3/8/2022
3.1.22 3,165,660 12/14/2021
3.1.21 2,236,580 11/7/2021
3.1.20 1,003,680 10/11/2021
3.1.19 1,239,787 9/14/2021
3.1.18 8,117,253 8/10/2021
3.1.17 1,106,436 7/13/2021 3.1.17 has at least one vulnerability with moderate severity.
3.1.16 2,185,547 6/8/2021 3.1.16 has at least one vulnerability with moderate severity.
3.1.15 1,609,774 5/11/2021 3.1.15 has at least one vulnerability with moderate severity.
3.1.14 2,064,020 4/6/2021 3.1.14 has at least one vulnerability with moderate severity.
3.1.13 2,365,738 3/9/2021 3.1.13 has at least one vulnerability with moderate severity.
3.1.12 2,143,032 2/9/2021 3.1.12 has at least one vulnerability with moderate severity.
3.1.11 3,488,348 1/12/2021 3.1.11 has at least one vulnerability with moderate severity.
3.1.10 5,658,126 11/9/2020 3.1.10 has at least one vulnerability with moderate severity.
3.1.9 6,236,438 10/13/2020 3.1.9 has at least one vulnerability with moderate severity.
3.1.8 10,622,453 9/8/2020 3.1.8 has at least one vulnerability with moderate severity.
3.1.7 4,734,480 8/11/2020 3.1.7 has at least one vulnerability with moderate severity.
3.1.6 5,607,696 7/14/2020 3.1.6 has at least one vulnerability with moderate severity.
3.1.5 7,935,408 6/9/2020 3.1.5 has at least one vulnerability with moderate severity.
3.1.4 7,235,213 5/12/2020 3.1.4 has at least one vulnerability with moderate severity.
3.1.3 9,635,079 3/24/2020 3.1.3 has at least one vulnerability with moderate severity.
3.1.2 7,166,491 2/18/2020 3.1.2 has at least one vulnerability with moderate severity.
3.1.1 9,567,911 1/14/2020 3.1.1 has at least one vulnerability with moderate severity.
3.1.0 7,321,915 12/3/2019 3.1.0 has at least one vulnerability with moderate severity.
3.1.0-preview3.19555.2 13,763 11/13/2019 3.1.0-preview3.19555.2 is deprecated because it is no longer maintained; 3.1.0-preview3.19555.2 has at least one vulnerability with moderate severity.
3.1.0-preview2.19528.8 3,455 11/1/2019 3.1.0-preview2.19528.8 is deprecated because it is no longer maintained; 3.1.0-preview2.19528.8 has at least one vulnerability with moderate severity.
3.1.0-preview1.19508.20 7,449 10/15/2019 3.1.0-preview1.19508.20 is deprecated because it is no longer maintained; 3.1.0-preview1.19508.20 has at least one vulnerability with moderate severity.
3.0.3 681,321 2/18/2020 3.0.3 is deprecated because it is no longer maintained; 3.0.3 has at least one vulnerability with moderate severity.
3.0.2 289,744 1/14/2020 3.0.2 is deprecated because it is no longer maintained; 3.0.2 has at least one vulnerability with moderate severity.
3.0.0 40,681,332 9/23/2019 3.0.0 is deprecated because it is no longer maintained; 3.0.0 has at least one vulnerability with moderate severity.
3.0.0-rc1.19457.4 25,130 9/16/2019 3.0.0-rc1.19457.4 is deprecated because it is no longer maintained.
3.0.0-preview9.19424.4 152,457 9/4/2019 3.0.0-preview9.19424.4 is deprecated because it is no longer maintained.
3.0.0-preview8.19405.7 27,953 8/13/2019 3.0.0-preview8.19405.7 is deprecated because it is no longer maintained.
3.0.0-preview7.19365.7 40,240 7/23/2019 3.0.0-preview7.19365.7 is deprecated because it is no longer maintained.
3.0.0-preview6.19307.2 36,796 6/12/2019 3.0.0-preview6.19307.2 is deprecated because it is no longer maintained.
3.0.0-preview5-19227-01 24,221 5/6/2019 3.0.0-preview5-19227-01 is deprecated because it is no longer maintained.
3.0.0-preview4-19216-03 7,082 4/18/2019 3.0.0-preview4-19216-03 is deprecated because it is no longer maintained.
3.0.0-preview3-19153-02 7,813 3/6/2019 3.0.0-preview3-19153-02 is deprecated because it is no longer maintained.
3.0.0-preview-19075-0444 12,429 1/29/2019 3.0.0-preview-19075-0444 is deprecated because it is no longer maintained.
2.3.0 4,076 1/14/2025
2.2.0 29,201,298 12/3/2018 2.2.0 is deprecated because it is no longer maintained.
2.2.0-preview3-35497 71,672 10/17/2018 2.2.0-preview3-35497 is deprecated because it is no longer maintained.
2.2.0-preview2-35157 37,589 9/12/2018 2.2.0-preview2-35157 is deprecated because it is no longer maintained.
2.2.0-preview1-35029 9,037 8/22/2018 2.2.0-preview1-35029 is deprecated because it is no longer maintained.
2.1.30 1,117,566 8/19/2021
2.1.2 17,568,128 8/21/2018 2.1.2 has at least one vulnerability with moderate severity.
2.1.1 12,260,353 6/18/2018 2.1.1 has at least one vulnerability with moderate severity.
2.1.0 15,194,623 5/29/2018 2.1.0 has at least one vulnerability with moderate severity.
2.1.0-rc1-final 41,134 5/6/2018 2.1.0-rc1-final is deprecated because it is no longer maintained.
2.1.0-preview2-final 38,981 4/10/2018 2.1.0-preview2-final is deprecated because it is no longer maintained.
2.1.0-preview1-final 54,011 2/26/2018 2.1.0-preview1-final is deprecated because it is no longer maintained.
2.0.4 4,617,240 5/7/2018 2.0.4 is deprecated because it is no longer maintained.
2.0.3 4,211,546 3/13/2018 2.0.3 is deprecated because it is no longer maintained.
2.0.1 7,552,249 11/14/2017 2.0.1 is deprecated because it is no longer maintained.
2.0.0 12,230,568 8/11/2017 2.0.0 is deprecated because it is no longer maintained.
2.0.0-preview2-final 56,258 6/27/2017 2.0.0-preview2-final is deprecated because it is no longer maintained.
2.0.0-preview1-final 18,094 5/10/2017 2.0.0-preview1-final is deprecated because it is no longer maintained.
1.1.3 482,413 9/20/2017 1.1.3 is deprecated because it is no longer maintained.
1.1.2 1,261,276 5/9/2017 1.1.2 is deprecated because it is no longer maintained.
1.1.1 477,667 3/6/2017 1.1.1 is deprecated because it is no longer maintained.
1.1.0 398,968 11/16/2016 1.1.0 is deprecated because it is no longer maintained.
1.1.0-preview1-final 6,684 10/24/2016 1.1.0-preview1-final is deprecated because it is no longer maintained.
1.0.5 12,772 11/14/2017 1.0.5 is deprecated because it is no longer maintained.
1.0.4 6,774 9/20/2017 1.0.4 is deprecated because it is no longer maintained.
1.0.3 18,754 5/9/2017 1.0.3 is deprecated because it is no longer maintained.
1.0.2 116,705 3/6/2017 1.0.2 is deprecated because it is no longer maintained.
1.0.1 21,949 12/12/2016 1.0.1 is deprecated because it is no longer maintained.
1.0.0 764,720 6/27/2016 1.0.0 is deprecated because it is no longer maintained.
1.0.0-rc2-final 19,677 5/16/2016 1.0.0-rc2-final is deprecated because it is no longer maintained.