Set up single sign-on (SSO)

Single Sign-On (SSO) enables your team members to access the Clazar system using a single set of credentials. Clazar supports SAML (Security Assertion Markup Language), an open standard for authentication.

๐Ÿ“˜

What is SAML?

SAML, based on the Extensible Markup Language (XML) format, facilitates the transfer of authentication data between the Identity Provider (IdP) and the Service Provider (SP).

In Clazar, you can configure SAML-based SSO and enforce SSO login for all users.

๐Ÿšง

Good to Know

SSO setup process should be done by an IT administrator with experience creating applications in your identity provider(IdP) account.


Setup

Step 1: Create an Application in Identity Provider (IdP)

  • Log in to your Identity Provider (IdP) account.
  • Navigate to your applications section.
  • Create a new application for Clazar.
  • Obtain the required Audience URI and Sign-on URL (ACS, Recipient, or Redirect values)

Step 2: Setup SSO

  • In your Clazar account, Go to Settings > Security.
    • Under Security, click Setup on the Single Sign-on Setup Card.

Step 3: Save and Verify

  • Paste the copied values from your IdP into the corresponding fields below.
  • Click Save and Verify

Step 4: Verify Connected

  • Once your SSO credentials are successfully verified, the connection will be established.
  • A Connected indicator will appear to confirm the successful connection.

Login via SSO

Step 1: Continue with SSO

  • To begin the login process via Single Sign-On (SSO), click the Continue with SSO button on the login page.

Step 2: Enter your Email Address

  • You will be asked to enter the email address associated with your Clazar account.
  • This ensures that you are directed to the appropriate Identity Provider (IdP) for authentication.

Step 3: Redirect to Identity Provider (IdP) Login Page

  • If SSO is configured
    • After entering your email address, you will be automatically redirected to your organizationโ€™s Identity Provider (IdP) login page.
    • At the IdP login page, you must authenticate using the credentials provided by your organization.

Step 4: Authentication and Redirect Back to Clazar

  • If SSO is configured, users will be redirected to the Identity Provider (IdP) login page for authentication.
  • Upon successful authentication, the user will be redirected back to Clazar with their session established, allowing them to access the platform securely.

๐Ÿšง

Important to Note!

  • Clazar only supports Service Provider (SP) initiated logins.
  • IdP initiated logins are not allowed, ensuring that all authentication flows are managed directly through Clazar for enhanced security and control.

Login via SP (Service Provider) Sign-On URL

The SP Sign-On URL allows users to log in by being redirected to their Identity Provider (IdP) for authentication.

How does the SP Sign-on URL work?

Base URL: https://app.clazar.io/sso-login

The SP Sign-On URL accepts specific parameters, such as:

  • login_domain: The domain associated with the Clazar account.
  • login_email: The email address of the user attempting to log in.

Steps for Authentication

  • Access the SP Sign-On URL:
    • The user accesses the SP Sign-On URL with one or both parameters (login_domain or login_email)
https://app.clazar.io/sso-login?login_domain=clazar.io
https://app.clazar.io/[email protected]
https://app.clazar.io/sso-login?login_domain=clazar.io&[email protected]
https://app.clazar.io/sso-login?login_domain=clazar
https://app.clazar.io/sso-login?login_domain=clazar.io&login_email=clazar.io
https://app.clazar.io/sso-login?login_domain=clazar.io&[email protected]
  • Redirect to IdP:
    • The application redirects the user to the configured Idp for authentication.
  • Authentication at IdP:
    • The IdP verifies the user's credentials and redirects them back to the Clazar application with a successful authentication response.
  • Validation of login_email (if provided)
    • If login_email was passed in the SP Sign-On URL, the application validates whether the authenticated user's email matches the provided login_email.
    • If the emails match, the user is logged in successfully.
    • If the emails do not match, an error message is displayed.
  • Validation of login_email and login_domain (If both provided)
    • The login email domain should match the login domain.

Login Methods For Users

  • In your Clazar account, Go to Settings > Security.
  • Under Login Methods, Select allowed Login Methods for users and Admins

Enforce SSO for all users

After setting up SSO, you can mandate that all users log into Clazar using SSO credentials only.


Select Single Sign-On(SSO) and unselect all other login methods to make SSO only.

๐Ÿ“˜

Login methods for Admins

You can select the login methods for your organzation's Admins. These login methods will always be accessible to the Admin, regardless of what has been enabled for others users.