Microsoft.Identity.Client
4.72.0
Prefix Reserved
See the version list below for details.
dotnet add package Microsoft.Identity.Client --version 4.72.0
NuGet\Install-Package Microsoft.Identity.Client -Version 4.72.0
<PackageReference Include="Microsoft.Identity.Client" Version="4.72.0" />
<PackageVersion Include="Microsoft.Identity.Client" Version="4.72.0" />
<PackageReference Include="Microsoft.Identity.Client" />
paket add Microsoft.Identity.Client --version 4.72.0
#r "nuget: Microsoft.Identity.Client, 4.72.0"
#addin nuget:?package=Microsoft.Identity.Client&version=4.72.0
#tool nuget:?package=Microsoft.Identity.Client&version=4.72.0
Microsoft Authentication Library (MSAL) for .NET
The MSAL library for .NET is part of the Microsoft identity platform for developers (formerly named Azure AD) v2.0. It enables you to acquire security tokens to call protected APIs. It uses industry standard OAuth2 and OpenID Connect. The library also supports Azure AD B2C.
Quick links:
| Conceptual documentation | Getting Started | Sample Code | API Reference | Support | Feedback |
|---|
Performance perspectives
Our documentation describes the approach to performance testing.
View some of the historical performance benchmark results in our dashboard.
Support SLA
MSAL.NET became Generally Available with MSAL.NET 3.0.8. Since MSAL.NET moved to version 4:
- Major versions are supported for twelve months after the release of the next major version.
- Minor versions older than N-1 are not supported.
Note Minor versions include bug fixes or features with non-breaking (additive) API changes. It is expected that applications using the library can upgrade through the IDE or CLI with no friction. We will not patch old minor versions of the library. When opening new issues, please confirm that you are using the latest minor version.
Using MSAL.NET
- Guides, tutorials, and detailed walkthroughs are available on Microsoft Learn.
- API documentation is available on Microsoft Learn
- Code samples are available from our Samples page.
Where do I file issues
You can file new issues in this repository.
Community help and support
We use Stack Overflow with the community to provide support. We highly recommend you ask your questions on Stack Overflow first and browse existing issues to see if someone has asked your question before.
If you find a bug or have a feature request, please raise the issue on GitHub Issues.
Contribute
We welcome contributions and feedback. You can fork and 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.z) 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 in as much detail as possible. Your submission may be eligible for a bounty through the Microsoft Bug Bounty program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly after receiving the information. We encourage you to get notifications of when security incidents occur by visiting the Microsoft Technical Security Notifications page and subscribing to Security Advisory Alerts.
Data collection
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
See the our telemetry documentation for an example of the telemetry collected by MSAL.NET.
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 © 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 was computed. 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 was computed. 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-android34.0 is compatible. net8.0-browser was computed. net8.0-ios was computed. net8.0-ios18.0 is compatible. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. 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. |
-
.NETFramework 4.6.2
- Microsoft.IdentityModel.Abstractions (>= 6.35.0)
- System.Diagnostics.DiagnosticSource (>= 6.0.1)
-
.NETFramework 4.7.2
- Microsoft.IdentityModel.Abstractions (>= 6.35.0)
- System.Diagnostics.DiagnosticSource (>= 6.0.1)
-
.NETStandard 2.0
- Microsoft.IdentityModel.Abstractions (>= 6.35.0)
- System.Diagnostics.DiagnosticSource (>= 6.0.1)
-
net8.0
- Microsoft.IdentityModel.Abstractions (>= 6.35.0)
- System.Diagnostics.DiagnosticSource (>= 6.0.1)
-
net8.0-android34.0
- Microsoft.IdentityModel.Abstractions (>= 6.35.0)
-
net8.0-ios18.0
- Microsoft.IdentityModel.Abstractions (>= 6.35.0)
NuGet packages (497)
Showing the top 5 NuGet packages that depend on Microsoft.Identity.Client:
| Package | Downloads |
|---|---|
|
Azure.Identity
Provides APIs for authenticating to Microsoft Entra ID |
|
|
Microsoft.Identity.Client.Extensions.Msal
This package contains the public client (desktop) caching to Microsoft Authentication Library for .NET (MSAL.NET) |
|
|
Microsoft.Identity.Web.TokenCache
This package bring token cache serializers for MSAL.NET confidential client applications. |
|
|
Microsoft.Identity.Web.Certificateless
This package brings certificateless authentication. |
|
|
Microsoft.Graph.Auth
Microsoft Graph Authentication Library implements authentication functionality used by Microsoft Graph Client Library. It provides a set of OAuth scenario-centric providers that implement Microsoft.Graph.IAuthenticationProvider and uses Microsoft Authentication Library (MSAL) to handle access token acquisition and storage. |
GitHub repositories (120)
Showing the top 20 popular GitHub repositories that depend on Microsoft.Identity.Client:
| Repository | Stars |
|---|---|
|
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
|
|
|
dotnet/roslyn
The Roslyn .NET compiler provides C# and Visual Basic languages with rich code analysis APIs.
|
|
|
nopSolutions/nopCommerce
ASP.NET Core eCommerce software. nopCommerce is a free and open-source shopping cart.
|
|
|
unoplatform/uno
Open-source platform for building cross-platform native Mobile, Web, Desktop and Embedded apps quickly. Create rich, C#/XAML, single-codebase apps from any IDE. Hot Reload included! 90m+ NuGet Downloads!!
|
|
|
git-ecosystem/git-credential-manager
Secure, cross-platform Git credential storage with authentication to GitHub, Azure Repos, and other popular Git hosting services.
|
|
|
elsa-workflows/elsa-core
A .NET workflows library
|
|
|
Azure/azure-sdk-for-net
This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
|
|
|
Azure/azure-powershell
Microsoft Azure PowerShell
|
|
|
microsoft/perfview
PerfView is a CPU and memory performance-analysis tool
|
|
|
xamarin/xamarin-forms-samples
Sample apps built using the Xamarin.Forms framework
|
|
|
dotnet/maui-samples
Samples for .NET Multi-Platform App UI (.NET MAUI)
|
|
|
microsoft/Power-Fx
Power Fx low-code programming language
|
|
|
lukencode/FluentEmail
All in one email sender for .NET. Supports popular senders (SendGrid, MailGun, etc) and Razor templates.
|
|
|
dotnet/interactive
.NET Interactive combines the power of .NET with many other languages to create notebooks, REPLs, and embedded coding experiences. Share code, explore data, write, and learn across your apps in ways you couldn't before.
|
|
|
microsoft/onefuzz
A self-hosted Fuzzing-As-A-Service platform
|
|
|
HotCakeX/Harden-Windows-Security
Harden Windows Safely, Securely using Official Supported Microsoft methods and proper explanation | Always up-to-date and works with the latest build of Windows | Provides tools and Guides for Personal, Enterprise, Government and Military security levels | Read The Rationale https://github.com/HotCakeX/Harden-Windows-Security/blob/main/Rationale.md
|
|
|
pnp/PnP
SharePoint / Office 365 Developer Patterns and Practices - Archived older solutions. Please see https://aka.ms/m365pnp for updated guidance
|
|
|
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
|
|
|
microsoft/CDM
The Common Data Model (CDM) is a standard and extensible collection of schemas (entities, attributes, relationships) that represents business concepts and activities with well-defined semantics, to facilitate data interoperability. Examples of entities include: Account, Contact, Lead, Opportunity, Product, etc.
|
|
|
scottksmith95/LINQKit
LINQKit is a free set of extensions for LINQ to SQL and Entity Framework power users.
|
| Version | Downloads | Last updated | |
|---|---|---|---|
| 4.73.0-preview | 651 | 5/14/2025 | |
| 4.72.1-preview | 524 | 5/13/2025 | |
| 4.72.0 | 124,060 | 5/9/2025 | |
| 4.71.2-preview | 2,669 | 4/22/2025 | |
| 4.71.1 | 596,079 | 4/24/2025 | |
| 4.71.1-preview | 2,388 | 4/22/2025 | |
| 4.71.0 | 629,868 | 4/18/2025 | |
| 4.70.2 | 565,664 | 4/9/2025 | |
| 4.70.1 | 1,442,236 | 4/4/2025 | |
| 4.70.1-preview | 2,816 | 3/26/2025 | |
| 4.70.0 | 961,455 | 3/18/2025 | |
| 4.69.1 | 1,603,301 | 3/4/2025 | |
| 4.68.0 | 1,266,702 | 2/7/2025 | |
| 4.67.2 | 16,737,058 | 1/14/2025 | |
| 4.67.1 | 548,650 | 1/9/2025 | |
| 4.67.0 | 105,761 | 1/8/2025 | |
| 4.66.4-preview | 390 | 1/14/2025 | |
| 4.66.3-preview | 384 | 1/8/2025 | |
| 4.66.2 | 4,727,983 | 11/11/2024 | |
| 4.66.2-preview | 437 | 12/18/2024 | |
| 4.66.1 | 28,683,697 | 10/22/2024 | |
| 4.66.0 | 316,968 | 10/18/2024 | |
| 4.65.3-preview | 6,698 | 10/2/2024 | |
| 4.65.0 | 13,094,651 | 9/25/2024 | |
| 4.64.2-preview | 5,561 | 9/17/2024 | |
| 4.64.1 | 1,827,966 | 9/12/2024 | |
| 4.64.0 | 1,971,637 | 8/24/2024 | |
| 4.63.0 | 1,820,871 | 8/6/2024 | |
| 4.62.0 | 1,832,911 | 7/22/2024 | |
| 4.62.0-preview | 3,156 | 7/16/2024 | |
| 4.61.3 | 117,760,891 | 6/6/2024 | |
| 4.61.2 | 211,164 | 6/3/2024 | |
| 4.61.1 | 701,816 | 5/22/2024 | |
| 4.61.0 | 911,589 | 5/9/2024 | |
| 4.60.4 | 945,324 | 6/19/2024 | |
| 4.60.3 | 33,925,920 | 4/16/2024 | |
| 4.60.2 | 255,273 | 4/9/2024 | |
| 4.60.1 | 12,005,274 | 4/2/2024 | |
| 4.60.0 | 169,130 | 3/27/2024 | |
| 4.59.1 | 1,040,206 | 4/16/2024 | |
| 4.59.0 | 10,845,306 | 1/17/2024 | |
| 4.58.1 | 1,598,752 | 12/8/2023 | |
| 4.58.0 | 671,003 | 11/29/2023 | |
| 4.57.0 | 11,913,448 | 10/18/2023 | |
| 4.56.0 | 155,666,821 | 9/6/2023 | |
| 4.55.0 | 5,215,516 | 7/24/2023 | |
| 4.54.1 | 28,151,080 | 5/24/2023 | |
| 4.54.0 | 1,899,317 | 5/11/2023 | |
| 4.53.0 | 4,974,012 | 4/14/2023 | |
| 4.52.0 | 1,729,236 | 3/31/2023 | |
| 4.51.0 | 2,656,567 | 3/16/2023 | |
| 4.50.0 | 4,510,338 | 2/13/2023 | |
| 4.49.1 | 41,548,757 | 12/20/2022 | |
| 4.48.1 | 7,719,351 | 11/15/2022 | |
| 4.48.0 | 2,407,194 | 11/2/2022 | |
| 4.47.2 | 78,503,161 | 10/4/2022 | |
| 4.47.1 | 1,738,151 | 9/21/2022 | |
| 4.47.0 | 2,152,540 | 9/16/2022 | |
| 4.46.2 | 1,199,640 | 8/29/2022 | |
| 4.46.1 | 4,464,615 | 8/17/2022 | |
| 4.46.0 | 27,047,794 | 8/4/2022 | |
| 4.46.0-preview2 | 38,028 | 7/8/2022 | |
| 4.45.0 | 70,815,827 | 6/23/2022 | |
| 4.44.0 | 7,259,328 | 5/20/2022 | |
| 4.43.2 | 1,256,619 | 5/2/2022 | |
| 4.43.1 | 1,296,360 | 4/15/2022 | |
| 4.43.0 | 2,165,838 | 4/6/2022 | |
| 4.42.1 | 1,571,217 | 3/15/2022 | |
| 4.42.0 | 17,616,510 | 2/28/2022 | |
| 4.41.0 | 7,544,137 | 2/8/2022 | |
| 4.40.0 | 4,034,122 | 1/8/2022 | |
| 4.39.0 | 75,373,961 | 11/30/2021 | |
| 4.38.0 | 4,277,829 | 11/19/2021 | |
| 4.37.0 | 7,784,650 | 10/22/2021 | |
| 4.37.0-preview | 65,643 | 10/6/2021 | |
| 4.36.2 | 6,803,356 | 9/29/2021 | |
| 4.36.1 | 2,771,324 | 9/8/2021 | |
| 4.36.0 | 1,307,832 | 8/31/2021 | |
| 4.35.1 | 15,317,585 | 7/30/2021 | |
| 4.35.0 | 2,071,544 | 7/23/2021 | |
| 4.34.0 | 1,459,337 | 7/8/2021 | |
| 4.33.0 | 4,111,125 | 6/22/2021 | |
| 4.32.1 | 2,169,022 | 6/10/2021 | |
| 4.32.0 | 693,649 | 6/3/2021 | |
| 4.31.0 | 2,275,179 | 5/11/2021 | |
| 4.30.1 | 82,901,184 | 4/28/2021 | |
| 4.30.0 | 2,348,966 | 4/22/2021 | |
| 4.29.0 | 4,245,542 | 3/30/2021 | |
| 4.28.1 | 1,054,804 | 3/23/2021 | |
| 4.28.0 | 219,559 | 3/18/2021 | |
| 4.27.1 | 9,932 | 4/16/2021 | |
| 4.27.0 | 1,655,347 | 2/19/2021 | |
| 4.26.0 | 1,949,319 | 2/10/2021 | |
| 4.25.0 | 2,888,796 | 1/20/2021 | |
| 4.24.0 | 2,623,956 | 12/5/2020 | |
| 4.23.0 | 2,593,921 | 11/24/2020 | |
| 4.22.0 | 145,400,718 | 10/27/2020 | |
| 4.21.1 | 159,289,836 | 10/20/2020 | |
| 4.21.0 | 829,005 | 10/15/2020 | |
| 4.20.1 | 832,228 | 10/14/2020 | |
| 4.20.0 | 40,523 | 10/13/2020 | |
| 4.20.0-wampreview1 | 11,759 | 9/30/2020 | |
| 4.19.0 | 2,723,776 | 9/25/2020 | |
| 4.18.0 | 1,642,151 | 9/2/2020 | |
| 4.17.2 | 9,350 | 1/21/2021 | |
| 4.17.1 | 6,050,276 | 8/5/2020 | |
| 4.17.0 | 391,464 | 7/27/2020 | |
| 4.16.1 | 8,351,709 | 7/10/2020 | |
| 4.16.0 | 139,662 | 7/7/2020 | |
| 4.15.0 | 1,497,652 | 6/18/2020 | |
| 4.14.0 | 83,597,952 | 5/19/2020 | |
| 4.13.0 | 823,674 | 5/5/2020 | |
| 4.12.0 | 905,148 | 4/23/2020 | |
| 4.11.0 | 1,015,224 | 4/3/2020 | |
| 4.10.0 | 1,045,494 | 3/18/2020 | |
| 4.9.0 | 4,429,602 | 3/6/2020 | |
| 4.8.2 | 6,991,534 | 2/15/2020 | |
| 4.8.1 | 541,390 | 1/29/2020 | |
| 4.8.1-preview1 | 16,575 | 1/28/2020 | |
| 4.7.1 | 1,676,695 | 11/22/2019 | |
| 4.7.0 | 259,712 | 11/7/2019 | |
| 4.6.0 | 5,630,045 | 11/4/2019 | |
| 4.5.1 | 732,973 | 10/17/2019 | |
| 4.5.0 | 61,576 | 10/16/2019 | |
| 4.4.0 | 519,912 | 9/20/2019 | |
| 4.3.1 | 776,264 | 8/27/2019 | |
| 4.3.0 | 368,980 | 8/8/2019 | |
| 4.2.1 | 198,519 | 7/24/2019 | |
| 4.2.0 | 41,447 | 7/23/2019 | |
| 4.1.0 | 16,442,643 | 7/2/2019 | |
| 4.0.0 | 1,412,559 | 6/3/2019 | |
| 3.0.9 | 62,257 | 7/31/2019 | |
| 3.0.8 | 123,977,385 | 4/30/2019 | |
| 3.0.6-preview | 126,011 | 4/19/2019 | |
| 3.0.5-preview | 13,117 | 4/16/2019 | |
| 3.0.4-preview | 42,095 | 4/11/2019 | |
| 3.0.3-preview | 75,888 | 4/8/2019 | |
| 3.0.2-preview | 16,762 | 3/25/2019 | |
| 3.0.1-preview | 9,248 | 3/21/2019 | |
| 3.0.0-preview | 34,490 | 2/27/2019 | |
| 2.7.1 | 969,526 | 2/21/2019 | |
| 2.7.0 | 403,579 | 1/16/2019 | |
| 2.6.2 | 177,888 | 12/20/2018 | |
| 2.6.1 | 162,059 | 12/18/2018 | |
| 2.6.0-preview | 29,612 | 12/12/2018 | |
| 2.5.0-preview | 192,190 | 11/21/2018 | |
| 2.4.1-preview | 15,216 | 11/16/2018 | |
| 2.4.0-preview | 778,705 | 11/9/2018 | |
| 2.3.1-preview | 46,409 | 10/26/2018 | |
| 2.3.0-preview | 30,578 | 10/19/2018 | |
| 2.2.1-preview | 18,309 | 10/17/2018 | |
| 2.2.0-preview | 40,182 | 10/5/2018 | |
| 2.1.0-preview | 54,263 | 9/27/2018 | |
| 2.0.1-preview | 67,484 | 9/15/2018 | |
| 2.0.0-preview | 73,939 | 8/28/2018 | |
| 1.1.4-preview0002 | 305,292 | 6/1/2018 | |
| 1.1.3-preview0012 | 16,735 | 5/25/2018 | |
| 1.1.2-preview0008 | 571,572 | 2/2/2018 | |
| 1.1.1-preview0040 | 78,490 | 1/6/2018 | |
| 1.1.0-preview | 593,724 | 5/9/2017 | |
| 1.0.304142221-alpha | 466,887 | 4/15/2016 | |
| 1.0.304142201-alpha | 13,770 | 4/15/2016 | |
| 1.0.303282006-alpha | 14,549 | 3/29/2016 |
The release notes are available at https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/releases and the roadmap at https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/wiki#roadmap. To provide feedback, fill-in the survey at https://ncv.microsoft.com/JrXkdySi0m.