Authentication with JWT - Fluid Topics - Latest

Fluid Topics API Reference Guide
Category
Reference Guides
Audience
public
Version
Latest

This public web service allows a user to sign in using a JSON Web Token (JWT). The portal must have a working JWT realm.

Method Endpoint
POST 
/api/authentication/jwt
Header Type Required? Description
Authorization String Yes Takes a JSON Web Token (JWT) as value. The value must be Bearer XXX, where XXX is the token.

It is necessary to provide an Ft-Calling-App value when using Fluid Topics web services. See Fluid Topics calling app.

Response body

For a response code of 200 OK, Fluid Topics returns a session cookie, which allows the user to remain logged in.

Fluid Topics also returns a response body in JSON format. The following is an example:

{
  "profile": {
    "userId": "e42c472d-7208-4a1f-9ee4-3aba0703579d",
    "displayName": "test",
    "emailAddress": "test@test.fr",
    "roles": [
      "AI_USER",
      "SAVED_SEARCH_USER",
      "PERSONAL_BOOK_USER"
    ],
    "tags": [],
    "otpValidated": true
  },
  "authenticationIdentifier": {
    "identifier": "228964cb-cfdc-4571-a62a-c8a05416ad4d",
    "realm": "test"
  }
}
Field Type Description
profile Object An object containing information about the user.
userId String The identifier of the connected user.
displayName String The display name of the user.
emailAddress String The email address of the user.
roles Array Indicates the roles of the user.
tags Array The tags that an administrator has assigned manually to the user, or provided by a post-authentication script.
authenticationIdentifier Object Information about the authentication of the user.
identifier String The user identifier in the realm.
realm String Indicates the realm to which the user belongs.