Class Authenticator

ReadonlyloginSupported

expirationHandler

• get expirationHandler(): AuthenticationExpirationHandler

  The handler that will be called when authentication for this Ditto instance is about to expire.

  Important: If the Ditto instance is configured with a DittoConfigConnectServer this property must be set and the handler must properly authenticate when called.

  Returns AuthenticationExpirationHandler

  See

  setExpirationHandler

status

• get status(): AuthenticationStatus

  Returns the current authentication status.

  Returns AuthenticationStatus

StaticDEVELOPMENT_PROVIDER

• get DEVELOPMENT_PROVIDER(): string

  The built-in development authentication provider to be used together with development authentication tokens.

  Returns string

  See

  Authenticator.login() for more information about the provider parameter.

login

• login(token: string, provider: string): Promise<LoginResult>

  Log in to Ditto with a third-party token.

  Returns a promise that resolves to a LoginResult object. When the login attempt is successful, the error property of the response will be null, otherwise it will contain a DittoError object with details about the error.

  If the authentication service provides additional client info, it will be returned in the clientInfo property of the response, whether the login attempt was successful or not.

  Parameters

  • token: string

    The authentication token required to log in.

  • provider: string

    The name of the authentication provider. Use Authenticator.DEVELOPMENT_PROVIDER with development tokens.

  Returns Promise<LoginResult>

  A promise that resolves to a LoginResult object.

  Throws

  DittoError authentication/failed-to-authenticate if the Ditto instance is closed.

logout

• logout(cleanupFn?: (ditto: Ditto) => void): Promise<void>

  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 cleanupFn parameter to perform any required cleanup.

  Parameters

  • OptionalcleanupFn: (ditto: Ditto) => void

    An optional function 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.

  Returns Promise<void>

observeStatus

• observeStatus(
      callback: (authenticationStatus: AuthenticationStatus) => void,
  ): Observer

  Parameters

  • callback: (authenticationStatus: AuthenticationStatus) => void

  Returns Observer

setExpirationHandler

• setExpirationHandler(handler: AuthenticationExpirationHandler): Promise<void>

  Sets the handler that will be called when authentication for this Ditto instance is about to expire.

  Assign a handler function to be notified before authentication expires, allowing you to login or perform other necessary actions.

  Parameters

  • handler: AuthenticationExpirationHandler

  Returns Promise<void>

  See

  expirationHandler