Generate Fluid Topics Tenant Metadata File - Fluid Topics - 3.7

Fluid Topics Integration Guide

Operating system
Debian
Category
Reference Guides
Audience
public
Version
3.7

In order to know how to talk to the SAML Identity Provider, Fluid Topics needs to retrieve the Identity Provider's Metadata File.

It has to be stored in the saml directory.

Ensure that you have the ADMIN role to perform the following action.

Call the SSO debug web service

Open the following URL:

$FLUID_TOPICS_URL/api/authentication/sso/$REALM_NAME/debug

Where:

  • $FLUID_TOPICS_URL is the URL of the Fluid Topics homepage.
  • $REALM_NAME is the name of the realm in the configuration.

This URL returns some debug information in the form of an XML file: the Fluid Topics Service Provider Metadata. It describes the Fluid Topics configuration relative to the Identity Provider in order to ensure that messages are really sent by Fluid Topics.

The Service Provider Metadata file contains information such as:

  • the entity id (Fluid Topics tenant identifier),
  • the callback URL (where the user will be redirected after a successful login) and
  • the public part of the certificate that enables to ensure that messages were signed with its private part.