Guides for Admins
SAML SSO
How to setup your SAML SSO integration with Koala
Koala organizations on every plan can use Sign in with Google. Organizations on the Business plan can configure additional SAML providers. This guide will walk you through how to configure SAML SSO for Okta as an example, but the steps are similar for other SAML providers.
Okta SAML SSO
To configure Okta SAML SSO, you must:
- Be in Admin mode in Okta.
- Have admin permissions in Koala and be on the Business plan.
Now to the steps:
- Visit the Security settings of your Koala workspace, and switch on the SAML SSO toggle.
- Go back to Okta and create a custom SAML application in Okta.
- In the SAML Settings form copy the
Single-sign on URL
andAudience URI (SP Entity ID)
from Koala to the Okta form.
- For the attribute mappings we don’t require any specific attributes, but the Application Username should be set to
Email
. - Click continue until the App in Okta is created.
- Assign the app to the users or groups that should have access to Koala.
- Now with the app in Okta created, go to the “Sign On” tab and click on “More Details” link to get the
Single Sign-On URL
andCertificate
.
- Go back to Koala and paste the Identity Provider
Single Sign-On URL
and theX.509 Certificate
in the SAML SSO settings. - Click on Save and you are done.
After saving the SAML SSO settings, you will be logged out and will need to log back in. You have to type in your email address to initiate the SAML SSO flow.