Public OAuth Providers Realms Declaration - Fluid Topics - 3.7

Fluid Topics Integration Guide

Operating system
Debian
Category
Reference Guides
Audience
public
Version
3.7

This task explains how to declare Fluid Topics in OAuth providers.

The most common public OAuth providers have a similar behavior. The client application (Fluid Topics) has to be declared and the provider generates a pair of key/secret that identifies it.

For security reasons, public OAuth providers require the client application to be registered.

When a client application is declared, the provider generates a pair of key/secret that has to be declared in the configuration.

The client declaration asks for information regarding the application. One field represents the callback URL. It is the client application URL users will be redirected to after a login attempt. The following URL must be entered:

$FLUID_TOPICS_URL/api/authentication/sso/$REALM_NAME/callback?client_name=$REALM_NAME

where:

  • $FLUID_TOPICS_URL is the URL of the Fluid Topics home page and
  • REALM_NAME the name of the realm in the configuration.

The procedure to declare the application for each public OAuth provider is described in the associated realm topic.