Table of contents

SAML for Single Sign-on in Checkly

Setting up SSO for your organisation starts with providing Checkly Support with the following information:

• name / type / brand of your identity provider
• email domain
• sign in URL
• sign out URL
• public X509 certificate

After your configuration has been processed on Checkly’s side, you’ll receive the following information to configure your IdP:

• a redirect URL (e.g. https://auth.checklyhq.com/login/callback?connection=<YOUR_CONNECTION_ID>)
• a signout URL (normally https://auth.checklyhq.com/logout)
• XML metadata (e.g. https://auth.checklyhq.com/samlp/metadata?connection=<YOUR_CONNECTION_ID>)

Ensure your SSO IdP is sending Checkly the correct email address. Checkly can then map the existing user to your IdP user. The object returned should have an “email” field, e.g.:

{
	"email": "<EMAIL_ADDRESS>",
	...
}

Once that is taken care of, logging in to Checkly via SSO is ready. Entering an email address associated with the domain you have provided in the login prompt should result in the password field disappearing:

After submitting the Checkly login form, you should be redirected to your SSO login interface. Completing the login procedure will then lead you to your existing Checkly account, if you have one, or to the new account creation screen, in case you don’t.

Just-in-time user provisioning is now enabled for Enterprise customers using a single Checkly account.

This allows all users from your SSO organisation to join your Checkly account by simply by logging in. You don’t need to invite anyone manually (although you still can).

There are two ways your users can access Checkly:

• Go through your SSO provider and access Checkly from the list of your approved apps.
• Access the Checkly Login Page directly.
  • This requires a user to enter their email in the email field, and then click Continue.

Both approaches seamlessly allow the user to be added to your Checkly account.

By default, all users provisioned via SSO receive Read & Write permission within Checkly. You are able to modify this behaviour by going to the SSO Configuration and choosing a different role.

If you want to remove users that have been previously provisioned through SSO, there is a two-step process:

1. Remove their access within your SSO provider.
2. Remove them from your Checkly Team.

Single Sign-on in Checkly Using Microsoft Azure AD for Single Sign-on in Checkly

Last updated on November 25, 2024. You can contribute to this documentation by editing this page on Github