SSO Integrations - OKTA

McQuaig users now can leverage the powerful capabilities of single sign on(SSO) systems. As our first provider, we implemented the SSO using Okta.

Configuration

Due to the specifics of our system, McQuaig platform requires a user to exist before they can login using Okta. This is because the user is attached to organizations and we cannot create users on the fly.

Okta configurations

Before you are able to be connect to McQuaig using Okta, you will need to create an application within Okta.

Logged in as an administrator, navigate through the side menu and expand “Applications”. Some options will show up. Just click at Applications.

Create a new application if you did not do it yet. In the modal that will show up, select options as below:

 

Once you click next, the application details page will open up and you will fill out the following fields.

App integration name: “Any name you wish. Make it meaningful”

Sign in redirect URIs: “https://app.mcquaig.com/<your_org_slug_goes_here>/login/okta/callback”

Don't forget to replace “<your_org_slug_goes_here>” to a proper value.

You will also need to take note of the base url for your organization. This can be found in the widget from your login info in the Okta platform. In this case, we will have “trial-8415431.okta.com”.

 

Configuration at McQuaig

Now that you have configured Okta to integrate with McQuaig, you will need to tell McQuaig how to process login operations.

As a Client Administrator, navigate to Settings and scroll all the way down to expose the link to Access “SSO Settings”.

The page to create a new configuration will open up.

Create a new configuration as follow. Some fields will be extracted from Okta’s configuration you created previously.

The redirect field is formatted as follows:

https://app.mcquaig.com/<your_org_slug_goes_here>/login/okta/callback

Don't forget to change “<your_org_slug_goes_here>” appropriately.

Conclusion

You are all set. Use the URL https://app.mcquaig.com/<your_org_slug_goes_here>/login/okta to login using Okta SSO. Don't forget to change “<your_org_slug_goes_here>” appropriately.

A page to login will show up as below:

If you fill out the proper credentials the login will redirect to McQuaig platform

If you have any questions, please reach out to us at [e-mail].