Skip to main content

Set up single sign on with Okta

Let your team or your customers sign in to Cayzu with their Okta account. You add Cayzu as a SAML app in Okta, then point Cayzu at it.

 

Before you start

  • Admin access in Cayzu, on the Pro or Enterprise plan
  • Admin access to your Okta Admin Console
  • Your Cayzu Entity ID: https://app.cayzu.com
  • Your Cayzu ACS URL. For agents: https://app.cayzu.com/account/saml/respond?domain=yourcompany. For customers: https://your-portal-address/account/saml/respond. Cayzu shows yours on the last step of Add SSO.

 

Step 1: Create the app in Okta

  1. In the Okta Admin Console, go to Applications, then Applications.
  2. Click Create App Integration, pick SAML 2.0 and click Next.
  3. Give it an App name, like "Cayzu", and click Next.

 

Step 2: Fill in the SAML settings

  1. In Single sign-on URL, paste your Cayzu ACS URL. Leave Use this for Recipient URL and Destination URL ticked.
  2. In Audience URI (SP Entity ID), type your Cayzu Entity ID.
  3. Set Name ID format to EmailAddress and Application username to Email.
  4. Click Next, answer Okta's feedback question, then click Finish.

 

Step 3: Copy what Cayzu needs from Okta

  1. On the app's Sign On tab, under Metadata details, click More details.
  2. Copy the Sign on URL.
  3. Next to Signing Certificate, click Copy.

 

Step 4: Add the connection in Cayzu

  1. In Cayzu, go to Admin, then Single Sign On, and click Add SSO.
  2. Give it a Name, like "Okta".
  3. Pick Agent Portal for your team, or End-User Portal and a Target Brand for customers. Pick SAML 2.0.
  4. For agents, tick Allow just-in-time agent creation on first sign-in if Okta users without a Cayzu account should get one. Click Next.
  5. Paste the Sign on URL into SAML SSO URL.
  6. Type your Cayzu Entity ID into Service Provider Entity ID (Audience URI).
  7. Paste the certificate into X.509 Certificate, including the BEGIN and END lines.
  8. Click Next twice, check the Service Provider Details match Okta, then click Save.

 

Step 5: Give people access and test it

  1. In Okta, open the app's Assignments tab, click Assign and pick people or groups.
  2. Agents can click the Cayzu tile on their Okta dashboard, or use Sign in with company SSO on the Cayzu sign in page.
  3. Customers click Sign In, then Sign in with SSO on your portal.

 

Good to know

  • With just-in-time creation on, a new agent is added with the Agent role the first time they sign in.
  • Your help desk has one SSO connection for agents. Each brand's customer portal has its own.
  • Don't turn on Single sign-on only until a test sign in works. When it's on, password sign in is refused and agents are told to use company SSO.
  • If Okta sends something other than an email, map it on the Advanced step in Cayzu.

 

Using Microsoft instead? See Set up single sign on with Microsoft Entra ID (Azure AD).

 

Need help? Submit a ticket here.

Was this helpful?

Support Policy

We are here to help you. If you have any questions, please contact us.

An error has occurred. This application may no longer respond until reloaded. Reload 🗙