Configure SSO with Okta

Use the following steps to configure SSO with Okta:

Note: When entering email addresses in Okta, always use lowercase characters. Email addresses that contain uppercase characters will have permissions problems during authentication.

1. If you do not already have an Okta account, navigate to Okta to set up a free trial.

2. Enter the required settings to access your account, then click Get Started.

3. When you receive the verification email, it will include a temporary password to use to log in. Log in to Okta, create a password, select a recovery security question, and click Next.
4. If your company requires multifactor authentication, click Setup, choose your device type (iPhone or Android), and download and install the required Okta Verify app on your device.

5. Open the Okta Verify app on your mobile device and click Get Started > Next > Add Account > Organization > Scan a QR code.
6. From your desktop computer, click Next.

7. When the QR code displays on your desktop, capture it with your mobile device and tap Done. You should see a six-digit number display on your mobile device.
8. From your desktop computer, click Next.

9. Enter the code displayed in the Okta Verify app from your device into the Enter Code field on your desktop, and click Verify.

Add the integrator.io application to Okta

1. Log in to your Okta account and select the Applications tab in the Applications section of the navigation menu, then click Create App Integration.

2. Select OIDC - OpenID Connect.

3. In the Application type section, click Web Application, and click Next.

4. Enter an App integration name and click Save.

5. Copy the Client ID and Client secret.

6. Navigate to the Single sign-on (SSO) page of integrator.io and enter the Okta domain (including https://) as the Issuer URL, the Client ID, the Client secret, and your Organization ID into the Single sign-on (SSO) page of integrator.io, then click Save to see the Application login URL and the Redirect URL.
7. Return to the page that displays your client credentials in Okta, scroll down to the General Settings section and click Edit.
8. In the APPLICATION section, check the Implicit (Hybrid) checkbox, and also check both the Allow ID Token with implicit grant type and Allow Access Token with implicit grant type checkboxes.

9. In the USER CONSENT section, uncheck the Require consent checkbox.

10. In the LOGIN section, complete the following fields:
    • Sign-in redirect URIs: Enter the Redirect URL from the Single sign-on (SSO) page in integrator.io
    • Login initiated by: Select Either Okta or App.
    • Application visibility: Check Display application icon to users. 
    • Initiate login URI: Enter the Application login URL from the Single sign-on (SSO) page in integrator.io.

11. Click Save.