Skip to main content

Set up single sign on with Microsoft Entra ID (Azure AD)

Let your team or your customers sign in to Cayzu with their Microsoft work account. You add Cayzu as an app in Microsoft Entra ID (formerly Azure AD), then point Cayzu at it.

 

Before you start

  • Admin access in Cayzu, on the Pro or Enterprise plan
  • An Entra ID admin role that can add enterprise apps, like Application Administrator
  • 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: Add Cayzu as an app in Entra ID

  1. Go to entra.microsoft.com and open Enterprise apps.
  2. Click New application, then Create your own application.
  3. Name it, like "Cayzu".
  4. Pick Integrate any other application you don't find in the gallery (Non-gallery) and click Create.

 

Step 2: Turn on SAML

  1. In the new app, click Single sign-on, then SAML.
  2. Under Basic SAML Configuration, click Edit.
  3. In Identifier (Entity ID), add your Cayzu Entity ID.
  4. In Reply URL (Assertion Consumer Service URL), add your Cayzu ACS URL.
  5. Click Save. Leave Attributes & Claims as they are.

 

Step 3: Copy what Cayzu needs from Entra ID

  1. Under Set up (your app name), copy the Login URL.
  2. Under SAML Certificates, download Certificate (Base64) and open it in Notepad or TextEdit.

 

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 "Microsoft Entra ID".
  3. Pick Agent Portal for your team, or End-User Portal and a Target Brand for customers. Pick SAML 2.0, then click Next.
  4. Paste the Login URL into SAML SSO URL.
  5. Type your Cayzu Entity ID into Service Provider Entity ID (Audience URI).
  6. Paste the whole certificate into X.509 Certificate, including the BEGIN and END lines. Cayzu shows its fingerprint when it reads it.
  7. Click Next twice, check the Service Provider Details match what you put in Entra ID, then click Save.

 

Step 5: Give people access

  1. Back in Entra ID, open your app and click Users and groups.
  2. Click Add user/group, pick the people, click Select, then Assign.

 

Step 6: Test it

  1. Customers: open your portal, click Sign In, then Sign in with SSO.
  2. Agents: on the Cayzu sign in page, use Sign in with company SSO.
  3. Use a private window so you aren't already signed in.

 

Good to know

  • Entra ID sends the person's sign in name, which is usually their email. If yours isn't, map it on the Advanced step in Cayzu.
  • On the free Entra ID plan you assign people one at a time. Assigning groups needs a paid Entra ID plan.
  • 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, or you could lock yourself out.
  • The Entra ID certificate lasts three years. When you renew it, paste the new one into Cayzu.

 

Did you know? The same steps work with any SAML provider. See Set up single sign on (SSO). Using Okta? See Set up single sign on with Okta.

 

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 🗙