Ditto 3.0.3
Public Member Functions | Properties | List of all members
DittoSDK.DittoAuthenticator Class Reference

Provides access to authentication information and methods for logging on to Ditto Cloud. Relevant when using an OnlineWithAuthentication or an Online identity. More...

Public Member Functions

async Task< DittoErrorLoginWithToken (string token, string provider)
 Log in to Ditto with a third-party token. More...
 
async Task< DittoErrorLoginWithCredentials (string username, string password, string provider)
 Log in to Ditto with a username and password. More...
 
IDisposable ObserveStatus (Action< DittoAuthenticationStatus > callback)
 Registers a callback that is called whenever the authentication status changes. More...
 
void Logout (Action< Ditto > cleanupAction=null)
 Log out of Ditto. More...
 

Properties

DittoAuthenticationStatus Status [get]
 Gets the current authentication status.
 

Detailed Description

Provides access to authentication information and methods for logging on to Ditto Cloud. Relevant when using an OnlineWithAuthentication or an Online identity.

Member Function Documentation

◆ LoginWithCredentials()

async Task< DittoError > DittoSDK.DittoAuthenticator.LoginWithCredentials ( string  username,
string  password,
string  provider 
)
inline

Log in to Ditto with a username and password.

Parameters
usernameThe username component of the credentials used for log in.
passwordThe password component of the credentials used for log in.
providerThe name of the authentication provider.
Returns
A DittoError if the login attempt failed, otherwise null.

◆ LoginWithToken()

async Task< DittoError > DittoSDK.DittoAuthenticator.LoginWithToken ( string  token,
string  provider 
)
inline

Log in to Ditto with a third-party token.

Parameters
tokenThe authentication token required to log in.
providerThe name of the authentication provider.
Returns
A DittoError if the login attempt failed, otherwise null.

◆ Logout()

void DittoSDK.DittoAuthenticator.Logout ( Action< Ditto cleanupAction = null)
inline

Log out of Ditto.

This will stop sync, shut down all replication sessions, and remove any cached authentication credentials. Note that this does not remove any data from the store. If you wish to delete data from the store then use the optional cleanupAction argument to perform any required cleanup.

Parameters
cleanupActionAn optional action that will be called with the relevant Ditto instance as the sole argument that allows you to perform any required cleanup of the store as part of the logout process.

◆ ObserveStatus()

IDisposable DittoSDK.DittoAuthenticator.ObserveStatus ( Action< DittoAuthenticationStatus callback)
inline

Registers a callback that is called whenever the authentication status changes.

Parameters
callbackAn action reference to the caller's closure.
Returns
An IDisposable that you can use to stop this observation.