-
Notifications
You must be signed in to change notification settings - Fork 365
MSAL.NET 2.x to MSAL.NET 3.x
Jean-Marc Prieur edited this page Mar 26, 2019
·
20 revisions
This page explains how to change the code to move from the MSAL 2.x to MSAL 3.x
IEnumerable<string> scopes;
IAccount account;
string authority;
bool forceRefresh;
Used to acquire an access token from the user cache, and refresh it if needed
Instead of | use |
app.AcquireTokenSilentAsync(scopes,
account) |
app.AcquireTokenSilent(scopes,
account)
.ExecuteAsync()
.ConfigureAwait(false); |
app.AcquireTokenSilentAsync(scopes,
account,
authority,
forceRefresh) |
app.AcquireTokenSilent(scopes, account)
.WithAuthority(authority)
.WithForceRefresh(forceRefresh)
.ExecuteAsync()
.ConfigureAwait(false); |
Instead of calling the constructor of PublicClientApplication directly, use the PublicClientApplicationBuilder.Create()
or the PublicClientApplicationBuilder.CreateWithOptions()
methods. The reference documentation page for PublicClientApplicationBuilder shows all the options that you can use.
Instead of | use |
app=new PublicClientApplication(clientId); |
app=PublicClientApplicationBuilder
.Create(clientId)
.Build(); |
app=new PublicClientApplication(clientId,
authority); |
app=PublicClientApplicationBuilder
.Create(clientId)
.WithAuthority(authority)
.Build(); |
MSAL.NET 2.x had 13 overrides of AcquireTokenAsync
Instead of | use |
app.AcquireTokenAsync(scopes) |
app=AcquireTokenInteractive(scopes, null)
.ExecuteAsync().
.ConfigureAwait(false); |
app.AcquireTokenAsync(scopes, loginHint) |
app=AcquireTokenInteractive(scopes, null)
.WithLoginHint(loginHint)
.ExecuteAsync()
.ConfigureAwait(false); |
app.AcquireTokenAsync(scopes, loginHint) |
app=AcquireTokenInteractive(scopes, null)
.WithAccount(account)
.ExecuteAsync()
.ConfigureAwait(false); |
app.AcquireTokenAsync(scopes,
loginHint,
uiBehavior,
extraQueryParameters) |
app=AcquireTokenInteractive(scopes, null)
.WithLoginHint(account)
.WithPrompt(prompt)
.WithExtraQueryParameters(extraQueryParameters)
.ExecuteAsync()
.ConfigureAwait(false); |
- Home
- Why use MSAL.NET
- Is MSAL.NET right for me
- Scenarios
- Register your app with AAD
- Client applications
- Acquiring tokens
- MSAL samples
- Known Issues
- AcquireTokenInteractive
- WAM - the Windows broker
- .NET Core
- Maui Docs
- Custom Browser
- Applying an AAD B2C policy
- Integrated Windows Authentication for domain or AAD joined machines
- Username / Password
- Device Code Flow for devices without a Web browser
- ADFS support
- Acquiring a token for the app
- Acquiring a token on behalf of a user in Web APIs
- Acquiring a token by authorization code in Web Apps
- High Availability
- Token cache serialization
- Logging
- Exceptions in MSAL
- Provide your own Httpclient and proxy
- Extensibility Points
- Clearing the cache
- Client Credentials Multi-Tenant guidance
- Performance perspectives
- Differences between ADAL.NET and MSAL.NET Apps
- PowerShell support
- Testing apps that use MSAL
- Experimental Features
- Proof of Possession (PoP) tokens
- Using in Azure functions
- Extract info from WWW-Authenticate headers
- SPA Authorization Code