How to configure Cayosoft Administrator for authentication with Okta

Summary: This article explains how to configure Cayosoft Administrator for authentication with Okta.

Applies to: Cayosoft Administrator 9.1.0 and later.

Integrate Okta with Active Directory

1. Download and install the latest version of the Okta Active Directory (AD) Agent on your host servers.

2. Import user and groups from Active Directory to Okta:

   1. When you install the Okta AD Agent, you need to define how and when user data is imported. Learn more in: Configure Active Directory import and account settings

   2. Import Active Directory users on demand (on-demand, by schedule, or JIT)

Integrate Okta with Microsoft 365

1. Add existing app integrations.

2. Import Microsoft 365 users to Okta.

Create Cayosoft Administrator application integration

1. In the Okta Admin Console, browse for the Applications section.

2. Click Application > Create App Integration.

3. On the Create a new app integration dialog, select the following:

   • Sign-in method: OIDC - Open ID Connect.

   • Application type: Web Application.

4. Click Next.

5. Specify App integration name. For example, CayoAdmin.

6. In the Sign-in redirect URIs, set https://<HostName>/cayosoftwebadmin/externalsignin

   where

   <HostName> - the server name where the Cayosoft Administrator Service is installed.

   NOTE: The URL is case-sensitive.

7. In the Sign-out redirect URIs, set https://<HostName>/cayosoftwebadmin/signedout

   NOTE: The URL is case-sensitive.

8. Select an option for controlled access: select whether to assign the app integration to everyone in your org, only selected group(s), or skip assignment until after app creation.

9. Click Save.

   NOTE: In the created CayoAdmin application, the Client secret and Client ID should be copied from the General tab and pasted into the Client credentials in the Okta extension settings in the Cayosoft Administrator Console.

For more details please see Create OpenID Connect app integrations | Okta.

Configure Okta extension in Cayosoft Admin Console

1. In the Cayosoft Administrator Console, navigate to Home > Configuration > Connected Systems Extensions > Okta.

2. Specify Okta domain and client credentials. You can copy them from the General tab of the created CayoAdmin application in the Okta Admin Console.

3. Click Save Changes.

4. Click Check settings to validate the specified settings.

   For more details please see Okta extension settings.

Configure Cayosoft Web Portal settings

1. In the Cayosoft Administrator Console, navigate to Home > Configuration > Web Portal > Web Portal Settings.

2. In the User sign-in authentication method, select Automatic sign-in (SSO) for Okta accounts.

3. Click Save Changes.