Identity

Securely pass the identity of the current user.

Passing identity is optional and only used where a user is already authenticated and verified.

External Session

Where a widget session has previously been created and securely associated with a user, it may be provided here.

Note: The session secret must be provided

Note: By default sessions in QEX only last a maximum of 5 days.

{
  "public_api_key": "pk_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "config_version": "1.2",
  ...
  "identity": {
    "user_session": {
      "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "session_secret": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
  }
}

Passthrough Authentication

Pass an opaque single use JWT which will be verified against the Liquid Authentication Service.

{
  "public_api_key": "pk_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "config_version": "1.2",
  ...
  "identity": {
    "liquid_user_jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
  }
}