Skip to main content

OpenID Confidential Client - Okta Guide

Raise a support ticket

OVERVIEW​

When using Content Manager with only OpenID Authentication enabled, a Confidential Client is required to be configured for FYB Software applications to Authenticate.

Note

This configuration is only required if your Content Manager dataset has Windows Authentication disabled, and Okta Authentication enforced

CONFIGURING THE CONTENT MANAGER CONFIDENTIAL CLIENT APP REGISTRATION​

  1. Sign in to your Okta Administration portal

  2. Once signed in, expand Applications and click on Applications

    image.png

  3. Click on the Create App Integration option

    image.png

  4. Select API Services and click Next

    image.png

  5. Set the name of your application

    image.png

  6. Copy the Client ID and Client Secret values for use later

    image.png

CONFIGURING THE CUSTOM SCOPE​

  1. On the Left Side menu, expand Security and click on API

    image.png

  2. Select the Default Authorization server and take note of the Issue Metadata URI

    image.png

  3. Navigate to the Scopes tab and click Add Scope

    image.png

  4. Give your Scope a name and ensure Implicit is selected

    image.png

  5. Take note of the Scope Name for later

CREATING THE TRUSTED LOCATION​

  1. Navigate to Content Manager

  2. Create a new Person Location

  3. Supply a name for the Location

    2024-10-01_12-28-47.png

  4. On the Network Login tab, enable the Accept Logins option and supply a username

  5. Paste the Client ID into the Alternative logins field

    image.png

  6. On the Profile tab, set the User Type as Administrator and click Ok

    2024-10-01_12-38-38.png

CONFIGURE CONFIDENTIAL CLIENT IN ENTERPRISE STUDIO​

  1. Log on to the CM Server and open Content Manager Enterprise Studio

  2. Right Click on the required dataset and select Properties

  3. Navigate to the Authentication tab and select Add from the OpenID Confidential Clients section

    Add CC.jpg

  4. Enter the details as per the below table:

    FieldValue
    Client IDThe Application ID of the Confidential Client App Registration created above
    ScopeThe name of the Scope configured within the Default Authorization Server

    image.png

  5. Click OK to save and then Test to confirm the Confidential Client is working. Enter the Client Secret from the Confidential Client App Registration when prompted to test.

  6. Once tested successfully, click OK and then perform a Save and Deploy to save the changes to CM

VALUES REQUIRED FOR INSTALLATION​

The following values will be required for the installation of FYB Connect. Please ensure that the person responsible for the installation has these values.

  • Application ID
  • Client Secret
  • Network Login of Confidential Client Location

Once the above has been completed, you can continue with the installation of your FYB Software