Microsoft.Identity.Abstractions
7.2.0
Prefix Reserved
dotnet add package Microsoft.Identity.Abstractions --version 7.2.0
NuGet\Install-Package Microsoft.Identity.Abstractions -Version 7.2.0
<PackageReference Include="Microsoft.Identity.Abstractions" Version="7.2.0" />
paket add Microsoft.Identity.Abstractions --version 7.2.0
#r "nuget: Microsoft.Identity.Abstractions, 7.2.0"
// Install Microsoft.Identity.Abstractions as a Cake Addin #addin nuget:?package=Microsoft.Identity.Abstractions&version=7.2.0 // Install Microsoft.Identity.Abstractions as a Cake Tool #tool nuget:?package=Microsoft.Identity.Abstractions&version=7.2.0
Microsoft.Identity.Abstractions
Microsoft.Identity.Abstractions contain interfaces and POCO classes used in the Microsoft .NET authentication libraries (Microsoft.IdentityModel, MSAL.NET and Microsoft.Identity.Web). It exposes concepts in three domains:
Application options and credentials loader
The application options are typically the options that you find in configuration files like the appsettings.json file. They describe the authentication aspects of your application. The library offers two layer. A standard layer, and a Microsoft Identity platform specialization.
An important part of the application options are the credentials. In addition to the credential descriptions, the library offers extensibility mechanisms so that implementers can add their own credential source loaders.
There can be several application options with different names (for instance in ASP.NET Core these would be different authentication schemes)
Acquire tokens from Azure AD
Once configured, an application can acquire tokens from the Identity provider. This is a low level API, in the sense that you would probably prefer to call downstream web APIs without having to be preoccupied about the authentication aspects. If you really want to use the lower level API, you should:
- get hold of a ITokenAcquirerFactory. Implementations can provide a TokenAcquirerFactory for instance, with a singleton.
- get a ITokenAcquirer (by its name, for instance). This corresponds to the application options
- From the token acquirer get a token for on behalf of the user, or the app. If you don't specify any AcquireTokenOptions, the implementation should do its best effort. The AcquireTokenOptions enable you to override the defaults.
Calling downstream web APIs
It's also possible (and recommended) to use higher level APIs:
- IDownstreamApi enables you to call a downstream web API and let the implementation handle the serialization of the input parameter (if any), handling the getting the authorization header and attaching it to the HttpClient, call the downstream web API, handle errors, deserialize the answer and return it as a strongly typed object. You can use customize all these steps, for instance by providing your own serializer / deserializer.
- IAuthorizationHeaderProvider is the component that provides the authorization header, delegating to the ITokenAcquirer. Whereas ITokenAcquirer only knows about tokens, IAuthorizationHeaderProvider knows about protocols (for instance bearer, Pop, etc ...)
Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
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.
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 | 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-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. |
.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 is compatible. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. 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
- No dependencies.
-
.NETStandard 2.0
- No dependencies.
-
.NETStandard 2.1
- No dependencies.
-
net8.0
- No dependencies.
NuGet packages (7)
Showing the top 5 NuGet packages that depend on Microsoft.Identity.Abstractions:
Package | Downloads |
---|---|
Microsoft.Identity.Web.Certificate
This package brings certificate management for MSAL.NET. |
|
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET). |
|
Rystem.Authentication.Social.Blazor
Rystem.Authentication.Social helps you to integrate with new .Net Identity system and social logins. |
|
Rystem.RepositoryFramework.Api.Client.Authentication.BlazorServer
Rystem.RepositoryFramework allows you to use correctly concepts like repository pattern, CQRS and DDD. You have interfaces for your domains, auto-generated api, auto-generated HttpClient to simplify connection "api to front-end", a functionality for auto-population in memory of your models, a functionality to simulate exceptions and waiting time from external sources to improve your implementation/business test and load test. |
|
TEM.Common.Facades
Common facade methods and models shared by TEM services. |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Microsoft.Identity.Abstractions:
Repository | Stars |
---|---|
AzureAD/microsoft-identity-web
Helps creating protected web apps and web APIs with Microsoft identity platform and Azure AD B2C
|
Version | Downloads | Last updated |
---|---|---|
7.2.0 | 955,813 | 11/7/2024 |
7.1.0 | 2,591,043 | 9/24/2024 |
7.0.0 | 13,734 | 7/30/2024 |
6.0.0 | 5,166,837 | 6/21/2024 |
5.3.0 | 6,001,030 | 4/22/2024 |
5.2.0 | 2,061 | 4/18/2024 |
5.1.0 | 8,945,745 | 1/6/2024 |
5.0.0 | 7,977,675 | 9/20/2023 |
4.1.0 | 1,015,487 | 9/7/2023 |
4.0.0 | 3,169,011 | 7/11/2023 |
3.2.1 | 28,439 | 5/29/2023 |
3.2.0 | 3,790,586 | 5/11/2023 |
3.1.0 | 1,708,329 | 4/12/2023 |
3.0.1 | 61,835 | 4/6/2023 |
3.0.0 | 706 | 4/4/2023 |
2.1.0 | 1,257,817 | 3/12/2023 |
2.0.1 | 2,727,312 | 1/20/2023 |
2.0.0 | 517 | 1/19/2023 |
1.2.0 | 87,185 | 1/11/2023 |
1.1.0 | 1,755 | 1/6/2023 |
1.0.6-preview | 363 | 12/29/2022 |
1.0.5-preview | 84,734 | 12/13/2022 |
1.0.4-preview | 53,934 | 11/16/2022 |
1.0.3-preview | 44,506 | 11/5/2022 |
1.0.2-preview | 313 | 11/3/2022 |
1.0.1-preview | 24,966 | 10/18/2022 |
1.0.0-preview | 287 | 10/18/2022 |
The release notes are available at https://github.com/AzureAD/microsoft-identity-abstractions-for-dotnet/releases and the roadmap at https://github.com/AzureAD/microsoft-identity-abstractions-for-dotnet/wiki#roadmap