Session management

UUID regeneration mechanism

The UUID is regenerated when:

• the application is reinstalled and UUID cannot be recovered

• one of the UUID regeneration methods is invoked:

  • Regenerate customer
  • Regenerate customer with identifier
• the destroy session method is invoked - Destroy customer session

• the SDK is reinitialized by changing the Profile API Key with one of these methods:

  • Change Profile API Key dynamically for Android SDK
  • Change Profile API Key dynamically for iOS SDK
  • Change Profile API Key dynamically for React Native SDK
  • Change Profile API Key dynamically for Flutter SDK
• the customer is authenticated by Simple Profile Authentication with your own UUID set

• the customer is authenticated by one of the following options and the authId/authID parameter is used:

  • Simple Profile Authentication
  • Registration as a Service
  • OAuth
  • External Providers
  the authId/authID parameter is used for decreasing the number of UUID refreshes, so it must be unique for every customer)

• the customer is signed out with SESSION_DESTROY mode
• the customer is removed by the removal methods

Session management methods

Refresh customer token

This method refreshes the customer’s current token.

Retrieve customer token

This method retrieves the customer’s current, active token. Authentication required.

Get current customer UUID

This method retrieves the customer’s current UUID.

Regenerate customer

This method regenerates the UUID and clears the authentication token, login session, custom email, and custom identifier. This operation works only if the customer is anonymous.

Regenerate customer with identifier

This method regenerates the UUID and clears the authentication token, login session, custom email, and custom identifier. The optional clientIdentifier parameter is a seed for UUID generation.

Destroy customer session

This method clears all session data and creates a new anonymous session with a new profile UUID.