Microsoft.IdentityModel.Tokens 8.12.0
IdentityModel Extensions for .NET
The IdentityModel Extensions for .NET library provides robust tools to enhance authentication and authorization workflows in your .NET applications. Backed by the Entra team, this library simplifies working with OpenID Connect (OIDC), OAuth2.0, and JSON Web Tokens (JWT) in .NET.
Whether you're building secure APIs, implementing token validation, or managing claims, this library is designed to handle the heavy lifting for you.
Why IdentityModel?
- Widely Adopted: Trusted by thousands of developers to integrate OIDC and OAuth2.0 standards.
- Secure by Design: Built with security as a priority to reduce common vulnerabilities.
- Extensible: Easily extend or customize for advanced use cases.
- Battle hardened: Validates 5+ trillion requests daily, and growing.
Versions
You can find the release notes for each version here. Older versions can be found here.
Version Lifecycle and Support Matrix
See Long Term Support policy for details.
| Major Version | Currently Supported Version | Status |
|---|---|---|
| 8.x | from 8.0.1 to  |
Active (Current) - Tied to .NET 9 (STS) & 10 (LTS) ~ Nov, 2028 |
| 7.x | 7.7.1 | Supported (LTS) through .NET 8 LTS lifetime Nov 10, 2026. ⚠️Versions < 7.7.1 not supported. |
| 5.x | 5.7.0 | Supported (LTS), tied to the Microsoft.Owin.Security.JWT 4.2.2 lifetime. ⚠️Versions < 5.7.0 not supported. |
IdentityModel 8.x
Version 8.x introduces significant updates and improvements:
- Enhanced Performance: Optimized token validation to handle high-throughput scenarios.
- .NET Compatibility: Fully compatible with .NET 9.
🧭LTS: Supported through .NET 9 LTS lifetime: May 12, 2026 + .NET 10 LTS (~3 years).
IdentityModel 7.x
IdentityModel 7x introduced several improvements related to serialization and consistency in the API, which provide a better user experience for developers, as well as full AOT compatibility on .NET, and considerable performance improvements compared to IdentityModel 6x.
🧭LTS: Supported through .NET 8 LTS lifetime: Nov 10, 2026.
⚡Recommendation: Move to 8.x.
IdentityModel 6.x
🧭Deprecated: Support ended with .NET 7 LTS lifetime: May 2024.
⚡Action: Move to 8.x.
IdentityModel 5.x
Not a recommended version
🧭LTS: Supported for Microsoft.Owin.Security.JWT
⚡Action: Move to 8.x.
Samples and Documentation
The scenarios supported by IdentityModel extensions for .NET are described in Scenarios. The libraries are in particular used part of ASP.NET security to validate tokens in ASP.NET Web Apps and Web APIs. To learn more about token validation, and find samples, see:
- Microsoft Entra ID with ASP.NET Core
- Developing ASP.NET Apps with Microsoft Entra ID
- Validating tokens
- more generally, the library's Wiki
- the reference documentation
Community Help and Support
Report a bug or request a feature directly in the GitHub repo.
Have a design proposal? Please submit a design proposal before starting work on a PR to ensure it means the goals/objectives of this library and it's priorities.
We leverage Stack Overflow to work with the community on supporting Microsoft Entra and its SDKs, including this one! We highly recommend you ask your questions on Stack Overflow (we're all on there!) Also browse existing issues to see if someone has had your question before.
We recommend you use the "identityModel" tag so we can see it! Here is the latest Q&A on Stack Overflow for IdentityModel: https://stackoverflow.com/questions/tagged/identityModel
Security Reporting
See SECURITY.md
Contributing
All code is licensed under the MIT license and we triage actively on GitHub. We enthusiastically welcome contributions and feedback. See Contributing.md for guidelines, branch information, build instructions, and legalese.
License
Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT License (the "License");
We Value and Adhere to the Microsoft Open Source Code of Conduct
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Showing the top 20 packages that depend on Microsoft.IdentityModel.Tokens.
| Packages | Downloads |
|---|---|
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
67 |
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
88 |
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
188 |
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
200 |
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
226 |
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
378 |
|
Microsoft.IdentityModel.JsonWebTokens
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
512 |
|
Microsoft.IdentityModel.Protocols
Provides base protocol support for OpenIdConnect and WsFederation.
|
165 |
|
Microsoft.IdentityModel.Protocols
Provides base protocol support for OpenIdConnect and WsFederation.
|
187 |
|
Microsoft.IdentityModel.Protocols
Provides base protocol support for OpenIdConnect and WsFederation.
|
237 |
|
Microsoft.IdentityModel.Protocols
Provides base protocol support for OpenIdConnect and WsFederation.
|
377 |
|
Microsoft.IdentityModel.Protocols
Provides base protocol support for OpenIdConnect and WsFederation.
|
508 |
|
Microsoft.IdentityModel.Tokens.Saml
Includes types that provide support for SamlTokens version 1 and 2.
|
111 |
|
Microsoft.IdentityModel.Xml
Includes types that provide support for Reading / Writing XML with Enveloped Signatures.
|
112 |
|
System.IdentityModel.Tokens.Jwt
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
78 |
|
System.IdentityModel.Tokens.Jwt
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
173 |
|
System.IdentityModel.Tokens.Jwt
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
180 |
|
System.IdentityModel.Tokens.Jwt
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
246 |
|
System.IdentityModel.Tokens.Jwt
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
413 |
|
System.IdentityModel.Tokens.Jwt
Includes types that provide support for creating, serializing and validating JSON Web Tokens.
|
513 |
.NET Framework 4.6.2
- Microsoft.IdentityModel.Logging (>= 8.12.0)
- Microsoft.Bcl.TimeProvider (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.0)
- System.Memory (>= 4.5.5)
- System.Text.Json (>= 8.0.5)
- System.Diagnostics.DiagnosticSource (>= 6.0.2)
.NET Standard 2.0
- System.Text.Json (>= 8.0.5)
- System.Security.Cryptography.Cng (>= 4.5.0)
- System.Diagnostics.DiagnosticSource (>= 6.0.2)
- Microsoft.Extensions.Logging.Abstractions (>= 2.1.0)
- Microsoft.CSharp (>= 4.5.0)
- Microsoft.Bcl.TimeProvider (>= 8.0.1)
- Microsoft.IdentityModel.Logging (>= 8.12.0)
.NET 9.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- Microsoft.IdentityModel.Logging (>= 8.12.0)
.NET 8.0
- Microsoft.IdentityModel.Logging (>= 8.12.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
.NET 6.0
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.0)
- Microsoft.Bcl.TimeProvider (>= 8.0.1)
- Microsoft.IdentityModel.Logging (>= 8.12.0)
.NET Framework 4.7.2
- System.Text.Json (>= 8.0.5)
- Microsoft.Bcl.TimeProvider (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 2.1.0)
- System.Diagnostics.DiagnosticSource (>= 6.0.2)
- System.Memory (>= 4.5.5)
- Microsoft.IdentityModel.Logging (>= 8.12.0)
| Version | Downloads | Last updated |
|---|---|---|
| 8.12.1 | 4 | 06/23/2025 |
| 8.12.0 | 4 | 06/05/2025 |
| 8.11.0 | 7 | 05/24/2025 |
| 8.10.0 | 8 | 05/17/2025 |
| 8.9.0 | 9 | 04/25/2025 |
| 8.8.0 | 10 | 04/16/2025 |
| 8.7.0 | 14 | 03/29/2025 |
| 8.6.1 | 11 | 03/07/2025 |
| 8.6.0 | 13 | 02/25/2025 |
| 8.5.0 | 13 | 03/01/2025 |
| 8.4.0 | 15 | 02/09/2025 |
| 8.3.1 | 12 | 01/24/2025 |
| 8.3.0 | 13 | 12/10/2024 |
| 8.2.1 | 16 | 11/16/2024 |
| 8.2.0 | 16 | 11/10/2024 |
| 8.1.2 | 15 | 10/08/2024 |
| 8.1.1 | 16 | 10/07/2024 |
| 8.1.0 | 19 | 09/24/2024 |
| 8.0.2 | 15 | 09/07/2024 |
| 8.0.1 | 17 | 07/23/2024 |
| 8.0.0 | 17 | 07/16/2024 |
| 8.0.0-preview1 | 17 | 06/20/2024 |
| 7.7.1 | 17 | 07/22/2024 |
| 7.7.0 | 17 | 07/19/2024 |
| 7.6.3 | 17 | 07/14/2024 |
| 7.6.2 | 29 | 06/22/2024 |
| 7.6.1 | 20 | 06/20/2024 |
| 7.6.0 | 31 | 05/31/2024 |
| 7.5.2 | 30 | 05/14/2024 |
| 7.5.1 | 17 | 04/10/2024 |
| 7.5.0 | 17 | 04/10/2024 |
| 7.4.1 | 18 | 04/10/2024 |
| 7.4.0 | 25 | 03/08/2024 |
| 7.4.0-preview1 | 18 | 03/08/2024 |
| 7.3.1 | 20 | 02/06/2024 |
| 7.3.0 | 22 | 02/06/2024 |
| 7.2.0 | 23 | 02/06/2024 |
| 7.1.2 | 22 | 02/06/2024 |
| 7.0.3 | 27 | 01/06/2024 |
| 7.0.2 | 20 | 02/06/2024 |
| 7.0.1 | 23 | 02/06/2024 |
| 7.0.0 | 26 | 02/06/2024 |
| 7.0.0-preview5 | 21 | 02/06/2024 |
| 7.0.0-preview4 | 19 | 02/06/2024 |
| 7.0.0-preview3 | 21 | 02/06/2024 |
| 7.0.0-preview2 | 19 | 02/06/2024 |
| 7.0.0-preview | 28 | 02/06/2024 |
| 6.36.0 | 16 | 07/19/2024 |
| 6.35.1 | 16 | 07/14/2024 |
| 6.35.0 | 36 | 01/30/2024 |
| 6.34.0 | 21 | 02/06/2024 |
| 6.33.0 | 23 | 02/06/2024 |
| 6.32.3 | 30 | 02/06/2024 |
| 6.32.2 | 27 | 02/06/2024 |
| 6.32.1 | 21 | 02/06/2024 |
| 6.32.0 | 18 | 02/06/2024 |
| 6.31.0 | 20 | 02/06/2024 |
| 6.30.1 | 19 | 02/06/2024 |
| 6.30.0 | 21 | 02/06/2024 |
| 6.29.0 | 20 | 08/03/2023 |
| 6.28.1 | 22 | 02/06/2024 |
| 6.27.0 | 19 | 04/21/2023 |
| 6.26.1 | 22 | 02/06/2024 |
| 6.26.0 | 24 | 02/06/2024 |
| 6.25.1 | 23 | 02/06/2024 |
| 6.25.0 | 20 | 11/16/2022 |
| 6.24.0 | 24 | 02/06/2024 |
| 6.23.1 | 32 | 09/20/2022 |
| 6.23.0 | 19 | 02/06/2024 |
| 6.22.1 | 20 | 02/06/2024 |
| 6.22.0 | 22 | 09/13/2022 |
| 6.21.0 | 29 | 11/23/2022 |
| 6.20.0 | 41 | 08/18/2022 |
| 6.19.0 | 29 | 02/06/2024 |
| 6.18.0 | 23 | 02/06/2024 |
| 6.17.0 | 25 | 04/22/2022 |
| 6.16.0 | 27 | 03/01/2022 |
| 6.15.1 | 22 | 04/14/2022 |
| 6.15.0 | 48 | 12/15/2021 |
| 6.14.1 | 18 | 02/06/2024 |
| 6.14.0 | 17 | 02/06/2024 |
| 6.13.1 | 21 | 02/06/2024 |
| 6.12.2 | 63 | 11/07/2022 |
| 6.12.1 | 22 | 02/06/2024 |
| 6.12.0 | 21 | 02/06/2024 |
| 6.11.1 | 24 | 12/15/2021 |
| 6.11.0 | 21 | 02/06/2024 |
| 6.10.2 | 24 | 02/06/2024 |
| 6.10.1 | 30 | 04/16/2021 |
| 6.10.0 | 212 | 04/13/2021 |
| 6.9.0 | 21 | 02/06/2024 |
| 6.8.0 | 319 | 01/21/2021 |
| 6.7.2-preview-10803222715 | 23 | 02/06/2024 |
| 6.7.1 | 220 | 11/12/2020 |
| 6.6.1-preview-10617201806 | 20 | 02/06/2024 |
| 6.6.0 | 20 | 02/06/2024 |
| 6.5.1 | 18 | 02/06/2024 |
| 6.5.0 | 25 | 02/06/2024 |
| 5.7.0 | 19 | 02/06/2024 |
| 5.6.0 | 400 | 11/10/2020 |
| 5.5.0 | 505 | 02/11/2020 |
| 5.4.0 | 33 | 02/06/2024 |
| 5.3.0 | 80 | 11/11/2020 |
| 5.2.4 | 19 | 02/06/2024 |
| 5.2.2 | 21 | 02/06/2024 |
| 5.2.1 | 23 | 04/21/2022 |
| 5.1.5 | 32 | 02/06/2024 |
| 5.1.4 | 24 | 08/24/2022 |
| 5.1.3 | 21 | 02/06/2024 |
| 5.1.2 | 35 | 02/19/2020 |
| 5.0.0 | 19 | 02/10/2020 |