Skip to main content

FYB Connect OpenID Okta Guide

Raise a support ticket

OVERVIEW​

To use Okta Open ID with FYB Connect you are required to register the application on Okta Admin page. The registration will be used to acquire an access token to requests to access the FYB Connect and Content Manager Service API.

Note

This configuration is only required if your Content Manager Service API is protected by Okta Open Id

REGISTER AN APPLICATION IN OKTA​

  1. After logging in to Okta, navigate to the Okta Admin page (https://xxx-admin.okta.com/admin/dashboard).

    2024-01-18_9-15-48.png

  2. Navigate to the Applications page

    2024-01-18_9-13-53.png

  3. Click Create App Integration

    2024-01-18_9-18-56.png

  4. For the Sign-in method select OIDC - OpenID Connect

    2024-01-18_9-19-58.png

  5. For the Application Type select Single-Page Application then click Next

    2024-01-18_9-22-21.png

  6. Enter the details below then click Save

    NAMEVALUE
    Grant typeAuthorization Code
    App Integration NameFYB Connect
    Sign-in redirect URIsThe URL of FYB Connect
    Sign-out redirect URIsThe URL of FYB Connect
    Controlled accessAllow everyone in your organization to access
    Enable immediate accessEnabled

    2024-01-18_9-26-36.png 2024-01-18_9-33-46.png

GATHERING APP DETAILS​

Please follow the steps below to retrieve the Application ID, Authority URL and Redirect URL on the Okta Application Dashboard. These values are required for the installation.

CLIENT ID​

The Client ID can be found in the Client Credentials section of the General Tab of your Okta application

2024-01-18_9-55-49.png

AUTHORITY URL​

The Authority URL can be found by clicking your user name and copying the value above the My Settings link. you must add https:// to the copied value when configuring FYB Connect.

2024-01-18_9-58-04.png

REDIRECT URL​

The URL of FYB Connect is supplied in the Sign-in redirect URIs field

2024-01-18_10-03-17.png

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.

  • Redirect URI
  • Application ID
  • Authorization URL
NameDescription
Redirect URIThe URI where Okta will send the authentication payload upon successful authentication.
Application IDApplication's unique identifier on Okta.
Authorization URLhttps://{Okta Domain}

CONFIGURATION​

The Authentication tab allows you to specify the authentication method for FYB Connect, and is available within the admin section of FYB Connect

2024-01-18_11-03-21.png

To enable Okta Open ID Authentication:

  1. Set the Type field to OKTA.

  2. Enter the values for all the provided fields.

  3. Click Save

  4. Navigate to the FYB Connect Service application in IIS

  5. Ensure Anonymous Authentication is the only authentication method enabled for Connect Service

    2024-01-18_11-13-30.png

  6. Perform an app pool restart for FYB Connect Service