Microsoft.Identity.Web
3.3.1
Prefix Reserved
dotnet add package Microsoft.Identity.Web --version 3.3.1
NuGet\Install-Package Microsoft.Identity.Web -Version 3.3.1
<PackageReference Include="Microsoft.Identity.Web" Version="3.3.1" />
paket add Microsoft.Identity.Web --version 3.3.1
#r "nuget: Microsoft.Identity.Web, 3.3.1"
// Install Microsoft.Identity.Web as a Cake Addin #addin nuget:?package=Microsoft.Identity.Web&version=3.3.1 // Install Microsoft.Identity.Web as a Cake Tool #tool nuget:?package=Microsoft.Identity.Web&version=3.3.1
Microsoft Identity Web
Microsoft Identity Web is a library which contains a set of reusable classes used in conjunction with ASP.NET Core for integrating with the Microsoft identity platform (formerly Azure AD v2.0 endpoint) and AAD B2C.
This library is for specific usage with:
- Web applications, which sign in users and, optionally, call web APIs
- Protected web APIs, which optionally call protected downstream web APIs
Quick links:
Conceptual documentation | Getting Started | Reference documentation | Sample Code Web App | Sample Code Web API | Support |
---|
Nuget package
Build Status
Release notes, roadmap and SLA
Release notes and roadmap
The Microsoft Identity Web roadmap is available from Roadmap in the Wiki pages, along with release notes.
Support SLA
- Major versions are supported for twelve months after the release of the next major version.
- Minor versions older than N-1 are not supported.
Minor versions are bugfixes or features with non-breaking (additive) API changes. It is expected apps can upgrade. Therefore, we will not patch old minor versions of the library. You should also confirm, in issue repros, that you are using the latest minor version before the Microsoft Identity Web team spends time investigating an issue.
Using Microsoft Identity Web
- The conceptual documentation is currently available from the Wiki pages.
- Code samples are available for web app samples and web API samples
Where do I file issues
This is the correct repo to file issues.
Community Help and Support
If you find a bug or have a feature or documentation request, please raise the issue on GitHub Issues.
We use Stack Overflow with the community to provide support, using the tags web-app
, web-api
, asp.net-core
, microsoft-identity-web
. We highly recommend you ask your questions on Stack Overflow first and browse existing issues to see if someone has asked your question before.
To provide a recommendation, visit our User Voice page.
Contribute
We enthusiastically welcome contributions and feedback. You can clone the repo and start contributing now. Read our Contribution Guide for more information.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
Security Library
This library controls how users sign-in and access services. We recommend you always take the latest version of our library in your app when possible. We use semantic versioning so you can control the risk associated with updating your app. As an example, always downloading the latest minor version number (e.g. x.y.x) ensures you get the latest security and feature enhancements, but our API surface remains the same. You can always see the latest version and release notes under the Releases tab of GitHub.
Security Reporting
If you find a security issue with our libraries or services, please report it to [email protected] with as much detail as possible. Your submission may be eligible for a bounty through the Microsoft Bounty program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly upon receiving the information. We encourage you to get notifications of when security incidents occur by visiting this page and subscribing to Security Advisory Alerts.
Trademarks.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.
Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT License (the "License").
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 is compatible. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- Microsoft.AspNetCore.DataProtection (>= 5.0.8)
- Microsoft.Extensions.Caching.Memory (>= 5.0.0)
- Microsoft.Extensions.Hosting (>= 6.0.0)
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Security.Cryptography.Xml (>= 6.0.1)
- System.Text.Json (>= 8.0.5)
-
.NETFramework 4.7.2
- Microsoft.AspNetCore.DataProtection (>= 2.1.0)
- Microsoft.Extensions.Caching.Memory (>= 2.1.0)
- Microsoft.Extensions.Hosting (>= 2.1.1)
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Security.Cryptography.Xml (>= 4.7.1)
- System.Text.Json (>= 8.0.5)
-
.NETStandard 2.0
- Microsoft.AspNetCore.DataProtection (>= 2.1.0)
- Microsoft.Extensions.Caching.Memory (>= 2.1.0)
- Microsoft.Extensions.Hosting (>= 2.1.1)
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Security.Cryptography.Xml (>= 4.7.1)
- System.Text.Json (>= 8.0.5)
-
net6.0
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 6.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Text.Json (>= 8.0.5)
-
net7.0
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Text.Json (>= 8.0.5)
-
net8.0
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Text.Json (>= 8.0.5)
-
net9.0
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.3.1)
- Microsoft.Identity.Web.Certificateless (>= 3.3.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.3.1)
- Microsoft.Identity.Web.TokenCache (>= 3.3.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.2.0)
- Microsoft.IdentityModel.Validators (>= 8.2.0)
- System.Formats.Asn1 (>= 9.0.0-rc.2.24473.5)
- System.IdentityModel.Tokens.Jwt (>= 8.2.0)
- System.Text.Json (>= 9.0.0-rc.2.24473.5)
NuGet packages (140)
Showing the top 5 NuGet packages that depend on Microsoft.Identity.Web:
Package | Downloads |
---|---|
Microsoft.Identity.Web.UI
This package enables UI for ASP.NET Core Web apps that use Microsoft.Identity.Web. |
|
Rystem.Api.Client.Authentication.BlazorServer
Rystem.Api helps you to integrate Api Server and Automated Client for Aspect-Oriented programming. |
|
FenixAlliance.ACL.Dependencies
Application Component for the Alliance Business Suite. |
|
OrchardCore.Microsoft.Authentication
Orchard Core CMS is a Web Content Management System (CMS) built on top of the Orchard Core Framework. Provide features to Authenticates users using Microsoft Account, Microsoft Entra ID (Azure Active Directory) Account. |
|
Blauhaus.EVACS.Admin.Blazor
Package Description |
GitHub repositories (39)
Showing the top 5 popular GitHub repositories that depend on Microsoft.Identity.Web:
Repository | Stars |
---|---|
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
|
|
OrchardCMS/OrchardCore
Orchard Core is an open-source modular and multi-tenant application framework built with ASP.NET Core, and a content management system (CMS) built on top of that framework.
|
|
skoruba/IdentityServer4.Admin
The administration for the IdentityServer4 and Asp.Net Core Identity
|
|
dotnet/maui-samples
Samples for .NET Multi-Platform App UI (.NET MAUI)
|
|
microsoft/dotnet-podcasts
.NET reference application shown at .NET Conf featuring ASP.NET Core, Blazor, .NET MAUI, Microservices, Orleans, Playwright, and more!
|
Version | Downloads | Last updated |
---|---|---|
3.3.1 | 149,178 | 11/2/2024 |
3.3.0 | 100,112 | 10/28/2024 |
3.2.2 | 783,237 | 10/9/2024 |
3.2.1 | 100,599 | 10/5/2024 |
3.2.0 | 378,278 | 9/24/2024 |
3.1.0 | 1,198,337 | 8/22/2024 |
3.0.1 | 1,358,173 | 7/23/2024 |
3.0.0 | 509,726 | 7/18/2024 |
3.0.0-preview3 | 14,207 | 6/19/2024 |
3.0.0-preview2 | 16,256 | 6/11/2024 |
3.0.0-preview1 | 32,676 | 4/29/2024 |
2.21.1 | 229,228 | 7/20/2024 |
2.21.0 | 8,014 | 7/19/2024 |
2.20.0 | 1,030,994 | 6/28/2024 |
2.19.1 | 2,097,073 | 6/10/2024 |
2.19.0 | 671,413 | 5/29/2024 |
2.18.2 | 590,437 | 5/21/2024 |
2.18.1 | 1,364,114 | 4/25/2024 |
2.18.0 | 253,769 | 4/22/2024 |
2.17.5 | 628,139 | 4/16/2024 |
2.17.4 | 1,505,379 | 3/29/2024 |
2.17.3 | 137,522 | 3/27/2024 |
2.17.2 | 807,286 | 3/14/2024 |
2.17.1 | 1,322,404 | 2/27/2024 |
2.17.0 | 1,620,243 | 2/5/2024 |
2.16.1 | 2,255,991 | 1/9/2024 |
2.16.0 | 2,442,371 | 11/27/2023 |
2.15.5 | 1,741,109 | 11/20/2023 |
2.15.3 | 1,691,900 | 10/22/2023 |
2.15.2 | 524,658 | 10/18/2023 |
2.15.1 | 503,855 | 10/5/2023 |
2.14.0 | 597,275 | 9/26/2023 |
2.13.4 | 902,407 | 9/8/2023 |
2.13.3 | 1,045,247 | 8/17/2023 |
2.13.2 | 1,129,796 | 7/31/2023 |
2.13.1 | 327,743 | 7/25/2023 |
2.13.0 | 504,653 | 7/14/2023 |
2.12.4 | 1,528,600 | 6/18/2023 |
2.12.2 | 71,733 | 6/15/2023 |
2.11.1 | 593,114 | 6/6/2023 |
2.11.0 | 1,209,269 | 5/15/2023 |
2.10.0 | 518,374 | 5/5/2023 |
2.9.0 | 1,054,026 | 4/15/2023 |
2.8.0 | 20,895 | 4/14/2023 |
2.7.0 | 691,684 | 3/30/2023 |
2.6.1 | 417,804 | 3/23/2023 |
2.5.0 | 2,659,863 | 2/27/2023 |
2.0.8-preview | 77,101 | 12/16/2022 |
2.0.7-preview | 23,902 | 12/2/2022 |
2.0.6-preview | 26,431 | 11/20/2022 |
2.0.5-preview | 13,652 | 11/7/2022 |
2.0.4-preview | 1,288 | 10/27/2022 |
2.0.3-preview | 21,292 | 10/19/2022 |
2.0.2-preview | 4,815 | 10/9/2022 |
2.0.0-preview | 19,152 | 9/20/2022 |
1.26.0 | 2,474,978 | 2/5/2023 |
1.25.10 | 3,796,950 | 12/1/2022 |
1.25.9 | 400,689 | 11/28/2022 |
1.25.8 | 626,373 | 11/20/2022 |
1.25.7 | 38,697 | 11/18/2022 |
1.25.6 | 485,988 | 11/16/2022 |
1.25.5 | 1,001,963 | 11/1/2022 |
1.25.4 | 220,155 | 10/27/2022 |
1.25.3 | 2,741,517 | 9/16/2022 |
1.25.2 | 1,445,762 | 8/25/2022 |
1.25.1 | 4,265,261 | 6/23/2022 |
1.25.0 | 1,219,980 | 6/3/2022 |
1.24.1 | 2,713,448 | 4/26/2022 |
1.24.0 | 374,144 | 4/20/2022 |
1.23.1 | 2,337,471 | 3/11/2022 |
1.23.0 | 1,424,867 | 2/15/2022 |
1.22.3 | 634,643 | 2/2/2022 |
1.22.2 | 212,824 | 1/28/2022 |
1.22.1 | 1,072,275 | 1/8/2022 |
1.22.0 | 16,714 | 1/8/2022 |
1.21.1 | 1,474,286 | 12/4/2021 |
1.21.0 | 674,471 | 11/20/2021 |
1.20.1 | 6,670 | 12/3/2021 |
1.20.0 | 942,576 | 11/5/2021 |
1.19.0 | 260,182 | 11/2/2021 |
1.19.0-preview | 14,024 | 10/7/2021 |
1.18.0 | 1,421,681 | 10/6/2021 |
1.17.0 | 629,453 | 9/20/2021 |
1.16.1 | 727,731 | 9/6/2021 |
1.16.0 | 2,336,602 | 8/19/2021 |
1.15.2 | 679,795 | 7/30/2021 |
1.15.1 | 146,619 | 7/27/2021 |
1.15.0 | 156,882 | 7/23/2021 |
1.14.1 | 356,931 | 7/15/2021 |
1.14.0 | 1,040,394 | 6/23/2021 |
1.13.1 | 244,941 | 6/15/2021 |
1.13.0 | 163,104 | 6/11/2021 |
1.12.0 | 457,773 | 6/2/2021 |
1.11.0 | 288,989 | 5/24/2021 |
1.10.0 | 364,184 | 5/17/2021 |
1.9.2 | 412,924 | 5/4/2021 |
1.9.1 | 802,351 | 4/14/2021 |
1.9.0 | 110,880 | 4/12/2021 |
1.8.2 | 729,434 | 3/23/2021 |
1.8.1 | 186,480 | 3/16/2021 |
1.8.0 | 358,865 | 3/10/2021 |
1.7.0 | 382,823 | 2/27/2021 |
1.6.0 | 427,952 | 2/12/2021 |
1.5.1 | 859,658 | 1/21/2021 |
1.5.0 | 35,701 | 1/20/2021 |
1.4.1 | 770,486 | 12/15/2020 |
1.4.0 | 269,589 | 12/9/2020 |
1.3.0 | 575,204 | 11/11/2020 |
1.2.0 | 315,304 | 10/23/2020 |
1.1.0 | 1,553,035 | 10/6/2020 |
1.0.0 | 208,770 | 9/30/2020 |
0.4.0-preview | 122,706 | 9/11/2020 |
0.3.1-preview | 87,634 | 8/27/2020 |
0.3.0-preview | 1,108,552 | 8/25/2020 |
0.2.3-preview | 86,473 | 8/10/2020 |
0.2.2-preview | 8,116 | 8/7/2020 |
0.2.1-preview | 61,043 | 7/25/2020 |
0.2.0-preview | 90,995 | 7/13/2020 |
0.1.5-preview | 150,235 | 6/16/2020 |
0.1.4-preview | 137,499 | 6/1/2020 |
0.1.3-preview | 119,866 | 5/15/2020 |
0.1.2-preview | 41,019 | 5/7/2020 |
0.1.1-preview | 48,754 | 4/22/2020 |
0.1.0-preview | 40,832 | 4/13/2020 |
The release notes are available at https://github.com/AzureAD/microsoft-identity-web/releases and the roadmap at https://github.com/AzureAD/microsoft-identity-web/wiki#roadmap