com.microsoft.identity.client

Class MultipleAccountPublicClientApplication

java.lang.Object

com.microsoft.identity.client.PublicClientApplication

com.microsoft.identity.client.MultipleAccountPublicClientApplication

All Implemented Interfaces:

IMultipleAccountPublicClientApplication, IPublicClientApplication, ITokenShare

public class MultipleAccountPublicClientApplication
extends PublicClientApplication
implements IMultipleAccountPublicClientApplication

Nested Class Summary

Nested classes/interfaces inherited from class com.microsoft.identity.client.PublicClientApplication

PublicClientApplication.BrokerDeviceModeCallback

Nested classes/interfaces inherited from interface com.microsoft.identity.client.IMultipleAccountPublicClientApplication

IMultipleAccountPublicClientApplication.GetAccountCallback, IMultipleAccountPublicClientApplication.RemoveAccountCallback

Nested classes/interfaces inherited from interface com.microsoft.identity.client.IPublicClientApplication

IPublicClientApplication.ApplicationCreatedListener, IPublicClientApplication.DeviceCodeFlowCallback, IPublicClientApplication.IMultipleAccountApplicationCreatedListener, IPublicClientApplication.ISingleAccountApplicationCreatedListener, IPublicClientApplication.LoadAccountsCallback, IPublicClientApplication.SignedHttpRequestRequestCallback

Method Summary

Modifier and Type	Method and Description
void	acquireToken(android.app.Activity activity, java.lang.String[] scopes, java.lang.String loginHint, AuthenticationCallback callback) Acquire token interactively, will pop-up webUI.
IAuthenticationResult	acquireTokenSilent(java.lang.String[] scopes, IAccount account, java.lang.String authority) Perform acquire token silent call.
void	acquireTokenSilentAsync(java.lang.String[] scopes, IAccount account, java.lang.String authority, SilentAuthenticationCallback callback) Perform acquire token silent call.
IAccount	getAccount(java.lang.String identifier) Retrieve the IAccount object matching the identifier.
void	getAccount(java.lang.String identifier, IMultipleAccountPublicClientApplication.GetAccountCallback callback) Retrieve the IAccount object matching the identifier.
java.util.List<IAccount>	getAccounts() Returns a List of IAccount objects for which this application has RefreshTokens.
void	getAccounts(IPublicClientApplication.LoadAccountsCallback callback) Asynchronously returns a List of IAccount objects for which this application has RefreshTokens.
boolean	removeAccount(IAccount account) Removes the Account and Credentials (tokens) for the supplied IAccount.
void	removeAccount(IAccount account, IMultipleAccountPublicClientApplication.RemoveAccountCallback callback) Removes the Account and Credentials (tokens) for the supplied IAccount.

Methods inherited from class com.microsoft.identity.client.PublicClientApplication

acquireToken, acquireToken, acquireTokenSilent, acquireTokenSilentAsync, acquireTokenWithDeviceCode, create, create, create, create, createMultipleAccountPublicClientApplication, createMultipleAccountPublicClientApplication, createMultipleAccountPublicClientApplication, createMultipleAccountPublicClientApplication, createSingleAccountPublicClientApplication, createSingleAccountPublicClientApplication, createSingleAccountPublicClientApplication, createSingleAccountPublicClientApplication, generateSignedHttpRequest, generateSignedHttpRequest, getConfiguration, getMsaFamilyRefreshToken, getMsaFamilyRefreshTokenWithMetadata, getOrgIdFamilyRefreshToken, getOrgIdFamilyRefreshTokenWithMetadata, getSdkVersion, isSharedDevice, saveMsaFamilyRefreshToken, saveOrgIdFamilyRefreshToken, showExpectedMsalRedirectUriInfo

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.microsoft.identity.client.IPublicClientApplication

acquireToken, acquireToken, acquireTokenSilent, acquireTokenSilentAsync, acquireTokenWithDeviceCode, generateSignedHttpRequest, generateSignedHttpRequest, getConfiguration, isSharedDevice

Method Detail

acquireTokenSilent

public IAuthenticationResult acquireTokenSilent(java.lang.String[] scopes,
                                                IAccount account,
                                                java.lang.String authority)
                                         throws MsalException,
                                                java.lang.InterruptedException

Description copied from interface: IMultipleAccountPublicClientApplication

Perform acquire token silent call. If there is a valid access token in the cache, the sdk will return the access token; If no valid access token exists, the sdk will try to find a refresh token and use the refresh token to get a new access token. If refresh token does not exist or it fails the refresh, exception will be sent back via callback.

Specified by:

acquireTokenSilent in interface IMultipleAccountPublicClientApplication

Parameters:

scopes - The non-null array of scopes to be requested for the access token. MSAL always sends the scopes 'openid profile offline_access'. Do not include any of these scopes in the scope parameter.

account - IAccount represents the account to silently request tokens for.

authority - Authority to issue the token.

Throws:

MsalException

java.lang.InterruptedException

acquireTokenSilentAsync

public void acquireTokenSilentAsync(java.lang.String[] scopes,
                                    IAccount account,
                                    java.lang.String authority,
                                    SilentAuthenticationCallback callback)

Description copied from interface: IMultipleAccountPublicClientApplication

Perform acquire token silent call. If there is a valid access token in the cache, the sdk will return the access token; If no valid access token exists, the sdk will try to find a refresh token and use the refresh token to get a new access token. If refresh token does not exist or it fails the refresh, exception will be sent back via callback.

Specified by:

acquireTokenSilentAsync in interface IMultipleAccountPublicClientApplication

Parameters:

scopes - The non-null array of scopes to be requested for the access token. MSAL always sends the scopes 'openid profile offline_access'. Do not include any of these scopes in the scope parameter.

account - IAccount represents the account to silently request tokens for.

authority - Authority to issue the token.

callback - SilentAuthenticationCallback that is used to send the result back. The success result will be sent back via SilentAuthenticationCallback.onSuccess(IAuthenticationResult). Failure case will be sent back via {

getAccounts

public void getAccounts(IPublicClientApplication.LoadAccountsCallback callback)

Asynchronously returns a List of IAccount objects for which this application has RefreshTokens.

Specified by:

getAccounts in interface IMultipleAccountPublicClientApplication

Parameters:

callback - The callback to notify once this action has finished.

getAccounts

public java.util.List<IAccount> getAccounts()
                                     throws java.lang.InterruptedException,
                                            MsalException

Description copied from interface: IMultipleAccountPublicClientApplication

Returns a List of IAccount objects for which this application has RefreshTokens.

Specified by:

getAccounts in interface IMultipleAccountPublicClientApplication

Throws:

java.lang.InterruptedException

MsalException

getAccount

public void getAccount(java.lang.String identifier,
                       IMultipleAccountPublicClientApplication.GetAccountCallback callback)

Retrieve the IAccount object matching the identifier. The identifier could be homeAccountIdentifier, localAccountIdentifier or username.

Specified by:

getAccount in interface IMultipleAccountPublicClientApplication

Parameters:

identifier - String of the identifier

callback - The callback to notify once this action has finished.

getAccount

public IAccount getAccount(java.lang.String identifier)
                    throws java.lang.InterruptedException,
                           MsalException

Description copied from interface: IMultipleAccountPublicClientApplication

Retrieve the IAccount object matching the identifier. The identifier could be homeAccountIdentifier, localAccountIdentifier or username.

Specified by:

getAccount in interface IMultipleAccountPublicClientApplication

Parameters:

identifier - String of the identifier

Throws:

java.lang.InterruptedException

MsalException

removeAccount

public void removeAccount(IAccount account,
                          IMultipleAccountPublicClientApplication.RemoveAccountCallback callback)

Description copied from interface: IMultipleAccountPublicClientApplication

Removes the Account and Credentials (tokens) for the supplied IAccount.

Specified by:

removeAccount in interface IMultipleAccountPublicClientApplication

Parameters:

account - The IAccount whose entry and associated tokens should be removed.

removeAccount

public boolean removeAccount(IAccount account)
                      throws MsalException,
                             java.lang.InterruptedException

Description copied from interface: IMultipleAccountPublicClientApplication

Removes the Account and Credentials (tokens) for the supplied IAccount.

Specified by:

removeAccount in interface IMultipleAccountPublicClientApplication

Parameters:

account - The IAccount whose entry and associated tokens should be removed.

Returns:

True, if the account was removed. False otherwise.

Throws:

MsalException

java.lang.InterruptedException

acquireToken

public void acquireToken(android.app.Activity activity,
                         java.lang.String[] scopes,
                         java.lang.String loginHint,
                         AuthenticationCallback callback)

Description copied from interface: IMultipleAccountPublicClientApplication

Acquire token interactively, will pop-up webUI. Interactive flow will skip the cache lookup.

Specified by:

acquireToken in interface IMultipleAccountPublicClientApplication

Parameters:

activity - Non-null Activity that will be used as the parent activity for launching the com.microsoft.identity.common.internal.providers.oauth2.AuthorizationActivity.

scopes - The non-null array of scopes to be requested for the access token. MSAL always sends the scopes 'openid profile offline_access'. Do not include any of these scopes in the scope parameter.

loginHint - Optional. If provided, will be used as the query parameter sent for authenticating the user, which will have the UPN pre-populated.

callback - The Non-null AuthenticationCallback to receive the result back. 1) If user cancels the flow by pressing the device back button, the result will be sent back via AuthenticationCallback.onCancel(). 2) If the sdk successfully receives the token back, result will be sent back via SilentAuthenticationCallback.onSuccess(IAuthenticationResult) 3) All the other errors will be sent back via SilentAuthenticationCallback.onError(MsalException).