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  

ID: KB20220117-1

Content: 

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. 
   2. Import Active Directory users to Okta. (on-demand, by schedule, or JIT)

Integrate Okta with Microsoft 365

1. Add existent Microsoft Office 365 app integration.
2. Import Microsoft 365 users to Okta.

Create Cayosoft Administrator application integration

1. In Okta Admin Console browse for the Applications section.
2. Click Application > Create App Integration.
3. On Create a new app integration form select:
   1. Sign-in method: OIDC - Open ID Connect.
   2. Application type: Web Application.
4. Click Next.
5. Specify App integration name. For example, CayoAdmin.
6. In Sign-in redirect URIs set https://<HostName>/cayosoftwebadmin/externalsignin
   <HostName> - the server name where Cayosoft Administrator Service is installed.
   Note: The URL is case-sensitive.
7. In 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 Client secret and Client ID should be copied on the General tab and pasted into Client credentials in the Okta extension in Administrator Console.

For more details please see Create OIDC app integrations using AIW | Okta.

Configure Okta extension in Cayosoft Admin Console

1. In Cayosoft Admin Console navigate to Home > Configuration > Connected Systems Extensions > Okta.
2. Specify Okta domain and client credentials. You can copy them on 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 – Cayosoft Help Center.

Configure Cayosoft Web Portal settings

1. In Cayosoft Admin Console navigate to Home > Configuration > Web Portal > Web Portal Settings.
2. In User sign-in authentication method select Automatic sign-in (SSO) for Okta accounts.
3. Click Save Changes.