Microsoft.Identity.Web 3.9.1

Prefix Reserved

.NET 6.0 .NET Standard 2.0 .NET Framework 4.6.2

dotnet add package Microsoft.Identity.Web --version 3.9.1

NuGet\Install-Package Microsoft.Identity.Web -Version 3.9.1

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.Identity.Web" Version="3.9.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Microsoft.Identity.Web" Version="3.9.1" />
                    

                            Directory.Packages.props

<PackageReference Include="Microsoft.Identity.Web" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Microsoft.Identity.Web --version 3.9.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Microsoft.Identity.Web, 3.9.1"

#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.

#addin nuget:?package=Microsoft.Identity.Web&version=3.9.1
                    

                            Install Microsoft.Identity.Web as a Cake Addin

#tool nuget:?package=Microsoft.Identity.Web&version=3.9.1
                    

                            Install Microsoft.Identity.Web as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

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

Version Lifecycle and Support Matrix

See Long Term Support policy for details.

The following table lists IdentityWeb versions currently supported and receiving security fixes.

Major Version	Last Release	Patch release date	Support phase	End of support
3.x		Monthly	Active	Not planned.<br/>✅Supported versions: from 3.0.0 to <br/>⚠️Unsupported versions `< 3.0.0`.

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 opencode@microsoft.com 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 secure@microsoft.com 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.

Product	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. 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. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.
.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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 4.6.2
- Microsoft.AspNetCore.DataProtection (>= 6.0.0)
- Microsoft.Extensions.Caching.Memory (>= 6.0.2)
- Microsoft.Extensions.Hosting (>= 6.0.0)
- Microsoft.Extensions.Http (>= 3.1.3)
- Microsoft.Identity.Web.Certificate (>= 3.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.10.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.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.10.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.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.10.0)
- System.Security.Cryptography.Xml (>= 4.7.1)
- System.Text.Json (>= 8.0.5)
net6.0
- Microsoft.Identity.Web.Certificate (>= 3.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 6.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.10.0)
net7.0
- Microsoft.Identity.Web.Certificate (>= 3.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.10.0)
net8.0
- Microsoft.Identity.Web.Certificate (>= 3.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 8.0.1)
- System.IdentityModel.Tokens.Jwt (>= 8.10.0)
net9.0
- Microsoft.Identity.Web.Certificate (>= 3.9.1)
- Microsoft.Identity.Web.Certificateless (>= 3.9.1)
- Microsoft.Identity.Web.TokenAcquisition (>= 3.9.1)
- Microsoft.Identity.Web.TokenCache (>= 3.9.1)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.10.0)
- Microsoft.IdentityModel.Validators (>= 8.10.0)
- System.Formats.Asn1 (>= 9.0.0)
- System.IdentityModel.Tokens.Jwt (>= 8.10.0)

NuGet packages (159)

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.	27.3M
Rystem.Api.Client.Authentication.BlazorServer Rystem.Api helps you to integrate Api Server and Automated Client for Aspect-Oriented programming.	4.6M
FenixAlliance.ACL.Dependencies Application Component for the Alliance Business Suite.	933.5K
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.	495.1K
OrchardCore.Application.Cms.Core.Targets Orchard Core CMS is a Web Content Management System (CMS) built on top of the Orchard Core Framework. Converts the application into a modular OrchardCore CMS application with TheAdmin theme but without any front-end Themes.	475.7K

GitHub repositories (44)

Showing the top 20 popular GitHub repositories that depend on Microsoft.Identity.Web:

Repository	Stars
dotnet/AspNetCore.Docs Documentation for ASP.NET Core	12.9K
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.	7.7K
skoruba/IdentityServer4.Admin The administration for the IdentityServer4 and Asp.Net Core Identity	3.6K
dotnet/maui-samples Samples for .NET Multi-Platform App UI (.NET MAUI)	3.4K
microsoft/dotnet-podcasts .NET reference application shown at .NET Conf featuring ASP.NET Core, Blazor, .NET MAUI, Microservices, Orleans, Playwright, and more!	2.8K
MicrosoftLearning/AZ-204-DevelopingSolutionsforMicrosoftAzure AZ-204: Developing solutions for Microsoft Azure	2.4K
microsoft/WhatTheHack A collection of challenge based hack-a-thons including student guide, coach guide, lecture presentations, sample/instructional code and templates. Please visit the What The Hack website at: https://aka.ms/wth	1.8K
NuGet/NuGetGallery NuGet Gallery is a package repository that powers https://www.nuget.org. Use this repo for reporting NuGet.org issues.	1.6K
fullstackproltd/AspNetCoreSpa Asp.Net 7.0 & Angular 15 SPA Fullstack application with plenty of examples. Live demo:	1.5K
AlphaYu/adnc .NET微服务/分布式开发框架，同时也适用于单体架构系统的开发。	1.4K
abpframework/abp-samples Sample solutions built with the ABP Framework	1.2K
OfficeDev/Microsoft-Teams-Samples Welcome to the Microsoft Teams samples repository. Here you will find task-focused samples in C#, JavaScript and TypeScript to help you get started with the Microsoft Teams App!	1.2K
OfficeDev/TrainingContent Training Content used for developer.microsoft.com/office	891
JonPSmith/AuthPermissions.AspNetCore This library provides extra authorization and multi-tenant features to an ASP.NET Core application.	846
dotnet/dotnet-monitor This repository contains the source code for .NET Monitor - a tool that allows you to gather diagnostic data from running applications using HTTP endpoints	673
skoruba/Duende.IdentityServer.Admin The administration for the Duende IdentityServer and Asp.Net Core Identity ⚡	638
Azure/Industrial-IoT Azure Industrial IoT Platform	559
EdiWang/Moonglade Blog system of https://edi.wang, runs on Microsoft Azure	533
microsoft/hack-together Hack Together: Microsoft Graph and .NET is a hackathon for .NET developers to learn Microsoft Graph and Microsoft 365.	522
JasperFx/alba Easy integration testing for ASP.NET Core applications	456

Version	Downloads	Last updated
3.9.1	5,906	5/18/2025
3.9.0	14,670	5/15/2025
3.8.4	474,261	4/24/2025
3.8.3	1,257,131	4/8/2025
3.8.2	314,496	3/31/2025
3.8.1	340,223	3/21/2025
3.8.0	504,225	3/7/2025
3.7.1	984,194	2/15/2025
3.7.0	360,830	2/7/2025
3.6.2	727,854	1/23/2025
3.6.1	84,710	1/21/2025
3.6.0	176,889	1/17/2025
3.5.0	2,459,137	12/4/2024
3.4.0	1,663,670	11/15/2024
3.3.1	1,420,115	11/2/2024
3.3.0	425,204	10/28/2024
3.2.2	2,046,000	10/9/2024
3.2.1	268,161	10/5/2024
3.2.0	781,831	9/24/2024
3.1.0	2,267,925	8/22/2024
3.0.1	2,602,405	7/23/2024
3.0.0	660,284	7/18/2024
3.0.0-preview3	20,048	6/19/2024
3.0.0-preview2	18,755	6/11/2024
3.0.0-preview1	39,420	4/29/2024
2.21.1	724,479	7/20/2024
2.21.0	18,530	7/19/2024
2.20.0	1,578,339	6/28/2024
2.19.1	2,744,749	6/10/2024
2.19.0	970,428	5/29/2024
2.18.2	794,539	5/21/2024
2.18.1	1,975,446	4/25/2024
2.18.0	407,560	4/22/2024
2.17.5	814,817	4/16/2024
2.17.4	1,837,832	3/29/2024
2.17.3	192,546	3/27/2024
2.17.2	1,097,250	3/14/2024
2.17.1	1,580,869	2/27/2024
2.17.0	2,126,588	2/5/2024
2.16.1	2,845,216	1/9/2024
2.16.0	3,046,148	11/27/2023
2.15.5	1,826,616	11/20/2023
2.15.3	1,910,885	10/22/2023
2.15.2	698,883	10/18/2023
2.15.1	559,165	10/5/2023
2.14.0	727,734	9/26/2023
2.13.4	1,028,423	9/8/2023
2.13.3	1,181,091	8/17/2023
2.13.2	1,222,166	7/31/2023
2.13.1	371,995	7/25/2023
2.13.0	547,088	7/14/2023
2.12.4	1,715,415	6/18/2023
2.12.2	81,610	6/15/2023
2.11.1	675,499	6/6/2023
2.11.0	1,359,210	5/15/2023
2.10.0	576,404	5/5/2023
2.9.0	1,184,981	4/15/2023
2.8.0	25,371	4/14/2023
2.7.0	747,502	3/30/2023
2.6.1	470,502	3/23/2023
2.5.0	2,809,629	2/27/2023
2.0.8-preview	80,622	12/16/2022
2.0.7-preview	30,066	12/2/2022
2.0.6-preview	27,924	11/20/2022
2.0.5-preview	14,842	11/7/2022
2.0.4-preview	1,523	10/27/2022
2.0.3-preview	23,166	10/19/2022
2.0.2-preview	5,182	10/9/2022
2.0.0-preview	19,631	9/20/2022
1.26.0	2,787,914	2/5/2023
1.25.10	4,059,623	12/1/2022
1.25.9	498,277	11/28/2022
1.25.8	657,666	11/20/2022
1.25.7	43,591	11/18/2022
1.25.6	495,980	11/16/2022
1.25.5	1,048,436	11/1/2022
1.25.4	243,616	10/27/2022
1.25.3	2,921,615	9/16/2022
1.25.2	1,513,309	8/25/2022
1.25.1	4,617,918	6/23/2022
1.25.0	1,298,869	6/3/2022
1.24.1	2,902,986	4/26/2022
1.24.0	391,332	4/20/2022
1.23.1	2,503,045	3/11/2022
1.23.0	1,496,504	2/15/2022
1.22.3	673,159	2/2/2022
1.22.2	222,593	1/28/2022
1.22.1	1,132,251	1/8/2022
1.22.0	18,224	1/8/2022
1.21.1	1,556,063	12/4/2021
1.21.0	707,582	11/20/2021
1.20.1	8,089	12/3/2021
1.20.0	1,017,652	11/5/2021
1.19.0	290,220	11/2/2021
1.19.0-preview	15,062	10/7/2021
1.18.0	1,571,717	10/6/2021
1.17.0	652,023	9/20/2021
1.16.1	982,668	9/6/2021
1.16.0	2,513,931	8/19/2021
1.15.2	713,737	7/30/2021
1.15.1	152,376	7/27/2021
1.15.0	162,332	7/23/2021
1.14.1	364,842	7/15/2021
1.14.0	1,086,661	6/23/2021
1.13.1	253,927	6/15/2021
1.13.0	168,956	6/11/2021
1.12.0	469,863	6/2/2021
1.11.0	303,469	5/24/2021
1.10.0	384,686	5/17/2021
1.9.2	428,595	5/4/2021
1.9.1	850,728	4/14/2021
1.9.0	114,208	4/12/2021
1.8.2	782,126	3/23/2021
1.8.1	193,150	3/16/2021
1.8.0	386,801	3/10/2021
1.7.0	399,220	2/27/2021
1.6.0	438,891	2/12/2021
1.5.1	890,967	1/21/2021
1.5.0	37,037	1/20/2021
1.4.1	788,184	12/15/2020
1.4.0	290,941	12/9/2020
1.3.0	590,483	11/11/2020
1.2.0	325,556	10/23/2020
1.1.0	1,661,485	10/6/2020
1.0.0	246,838	9/30/2020
0.4.0-preview	125,394	9/11/2020
0.3.1-preview	89,825	8/27/2020
0.3.0-preview	4,619,527	8/25/2020
0.2.3-preview	87,428	8/10/2020
0.2.2-preview	8,387	8/7/2020
0.2.1-preview	62,844	7/25/2020
0.2.0-preview	92,980	7/13/2020
0.1.5-preview	159,162	6/16/2020
0.1.4-preview	141,795	6/1/2020
0.1.3-preview	122,809	5/15/2020
0.1.2-preview	42,172	5/7/2020
0.1.1-preview	50,920	4/22/2020
0.1.0-preview	41,893	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