FX User Guide

Connect Your Own Identity Provider (IdP)

Link your company's existing Identity Provider (IdP) to the Federity-X Portal so users can authenticate with their corporate credentials.

Key Concepts

Authentication Type – OIDC (OpenID Connect): A standardized identity layer on top of OAuth 2.0 that verifies users and fetches profile information securely.

Identity Provider Type – Own: Use this when connecting to your company's own IdP. This is suitable for internal user authentication.

Redirect URL: The endpoint to which the user is redirected after successful authentication. This must be registered in your IdP (no wildcard allowed).

Metadata URL: Provides your IdP's configuration (including public keys and endpoints). Must end with: /.well-known/openid-configuration

Identity Provider (IdP): A system (e.g., Azure, Keycloak) responsible for authenticating users.

IdP Data: Includes credentials, roles, and permissions used to enforce secure access.

Provider ID: A unique user ID from your IdP system. Example: Azure sub-ID or Keycloak user ID.

Configure Your Identity Provider (IdP)

This involves entering your Metadata URL, Client ID, and Client Secret, which are critical for authenticating your users.

Navigate to Profile Icon → Identity Provider Configuration → Add Identity Provider

** Identity Provider Config selection SS goes here **

Select:

Authentication Type: OIDC

Identity Provider Type: Own

** Add Identity Provider SS goes here **

After Creating the IDP entry, you need to configure the connection details to your company IdP.

** Select Configure SS goes here **

Provide:

Your Metadata URL

Your Client ID and Client Secret from your OpenID instance (Azure, Keycloak, etc.)

Register the redirect URL in your Open ID instance (without the wildcard)

** Add your identity Provider Page SS goes here **

Last Step: Connect Your User Profile

You need to link your Federity-X user account to your IdP by entering your IdP User ID (also referred to as Provider ID in Azure).

** Add your identity Provider Step 3 Page SS goes here **

Retrieving the Provider ID from Federity-X (Azure Example):

To retrieve your Provider ID from Federity-X:

Log out from your current account

Log in using your newly created IdP within the Federity-X Portal

Complete the Azure login if prompted

After successful login, a screen will display your username, and This is your Provider ID.

** Update your Account Information Page SS **

Add Users Manually

Once your IdP is set up, you must manually add each user in User Management.

Note: Automatic role synchronization is not currently supported.

** Manual Add user selection SS goes here **

If you have any questions or require additional support, feel free to reach out to us here [support email address].