com.amazonaws.mobile.auth.core.signin

Class SignInManager

java.lang.Object

com.amazonaws.mobile.auth.core.signin.SignInManager

public class SignInManager
extends java.lang.Object

The SignInManager is a singleton component, which orchestrates sign-in and sign-up flows. It is responsible for discovering the previously signed-in provider and that provider's credentials, as well as initializing sign-in buttons with the providers.

Method Summary

Modifier and Type	Method and Description
static void	dispose() Dispose the SignInManager
static SignInManager	getInstance() Gets the singleton instance of this class.
static SignInManager	getInstance(android.content.Context context) Gets the singleton instance of this class.
SignInProvider	getPreviouslySignedInProvider() Call getPreviouslySignedInProvider to determine if the user was left signed-in when the app was last running.
SignInResultHandler	getResultHandler() Retrieve the reference to SignInResultHandler
boolean	handleActivityResult(int requestCode, int resultCode, android.content.Intent data) Handle the Activity result for login providers.
void	handleRequestPermissionsResult(int requestCode, java.lang.String[] permissions, int[] grantResults) Handle the Activity request permissions result for sign-in providers.
android.view.View.OnClickListener	initializeSignInButton(java.lang.Class<? extends SignInProvider> providerClass, android.view.View buttonView) Call initializeSignInButton to initialize the logic for sign-in for a specific provider.
void	refreshCredentialsWithProvider(android.app.Activity activity, IdentityProvider signInProvider, SignInProviderResultHandler resultsHandler) Federate the token in the Sign-in Provider with Amazon Cognito Federated Identities to get an identity that can be used to access AWS resources.
void	setProviderResultsHandler(android.app.Activity activity, SignInProviderResultHandler resultsHandler) Sets the results handler results from sign-in with a provider.
void	setResultHandler(SignInResultHandler signInResultHandler) Set the passed in SignInResultHandler

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static SignInManager getInstance()

Gets the singleton instance of this class.

Returns:

instance

getInstance

public static SignInManager getInstance(android.content.Context context)

Gets the singleton instance of this class.

Returns:

instance

setResultHandler

public void setResultHandler(SignInResultHandler signInResultHandler)

Set the passed in SignInResultHandler

Parameters:

signInResultHandler -

getResultHandler

public SignInResultHandler getResultHandler()

Retrieve the reference to SignInResultHandler

Returns:

SignInResultHandler

dispose

public static void dispose()

Dispose the SignInManager

getPreviouslySignedInProvider

public SignInProvider getPreviouslySignedInProvider()

Call getPreviouslySignedInProvider to determine if the user was left signed-in when the app was last running. This should be called on a background thread since it may perform file i/o. If the user is signed in with a provider, this will return the provider for which the user is signed in. Subsequently, refreshCredentialsWithProvider should be called with the provider returned from this method.

Returns:

false if not already signed in, true if the user was signed in with a provider.

refreshCredentialsWithProvider

public void refreshCredentialsWithProvider(android.app.Activity activity,
                                           IdentityProvider signInProvider,
                                           SignInProviderResultHandler resultsHandler)

Federate the token in the Sign-in Provider with Amazon Cognito Federated Identities to get an identity that can be used to access AWS resources. This involves retrieving the token from the Sign-in Provider and putting into the loginsMap and setting it with the CredentialsProvider. After setting it, a refresh operation is made to get an identity from Cognito.

Parameters:

activity - the calling activity.

signInProvider - the sign-in provider that was previously signed-in.

resultsHandler - the handler to receive results for credential refresh.

setProviderResultsHandler

public void setProviderResultsHandler(android.app.Activity activity,
                                      SignInProviderResultHandler resultsHandler)

Sets the results handler results from sign-in with a provider. Results handlers are always called on the UI thread.

Parameters:

activity - the calling activity.

resultsHandler - the handler for results from sign-in with a provider.

initializeSignInButton

public android.view.View.OnClickListener initializeSignInButton(java.lang.Class<? extends SignInProvider> providerClass,
                                                                android.view.View buttonView)

Call initializeSignInButton to initialize the logic for sign-in for a specific provider.

Parameters:

providerType - the SignInProvider class.

buttonView - the view for the button associated with this provider.

Returns:

the onClickListener for the button to be able to override the listener.

handleActivityResult

public boolean handleActivityResult(int requestCode,
                                    int resultCode,
                                    android.content.Intent data)

Handle the Activity result for login providers.

Parameters:

requestCode - the request code.

resultCode - the result code.

data - result intent.

Returns:

true if the sign-in manager handle the result, otherwise false.

handleRequestPermissionsResult

public void handleRequestPermissionsResult(int requestCode,
                                           java.lang.String[] permissions,
                                           int[] grantResults)

Handle the Activity request permissions result for sign-in providers.

Parameters:

requestCode - the request code.

permissions - the permissions requested.

grantResults - the grant results.