Single Sign-On with Microsoft Azure

SAML SSO gives you a centralized and secure way of controlling access to your Survicate account.

Daniel avatar
Written by Daniel
Updated over a week ago

This article will guide you through enabling SAML authentication with Microsoft Azure on your account.

Single sign-on is an authentication method that allows you to sign in using one set of credentials to multiple independent software systems. With SSO you can access all needed applications without being required to authenticate using different credentials.

Please note that if you need to use OneLogin or Okta specifically, please visit specific links to learn more about the setup.

โ—This feature is available on some of our plans. If you are interested in testing this feature, contact us at sales@survicate.com or strike up a chat conversation ๐Ÿ‘‰.

How to enable SAML authentication?

โ—Before you start, you must ensure you are your organization's owner. Only account owners can set up SAML Authentication.

1. Please go to Settings > SAML Authentication and click Enable SAML authentication toggle. Leave the tab open, as you'll need the data from here.

2. Log in to your Microsoft Azure account, and go to Enterprise applications to create a new non-gallery app.

3. Once your app is created, find Single sign-on in the side menu and select SAML as a single-sign-on method.
โ€‹

4. Under Basic SAML configuration, you'll need to provide:

  • Identifier (Entity ID) is the same URL but has a different ending with /metadata instead of /acs.

    https://panel-api.survicate.com/settings/saml/{{your_organization_id}}/metadata

  • Reply URL (Assertion Consumer Service URL) can be found under ACS (Consumer) URL in Survicate:

  • Sign-on URL ends with /login

    https://panel-api.survicate.com/settings/saml/{{your_organization_id}}/login

Microsoft Azure

Corresponding Survicate field

Example:

Identifier (Entity ID)

Not available in UI

https://panel-api.survicate.com/settings/saml/12345/metadata

Reply URL (Assertion Consumer Service URL )

ACS (Consumer) URL

https://panel-api.survicate.com/settings/saml/12345/acs

Sign on URL

Not available in UI

https://panel-api.survicate.com/settings/saml/12345/login

In the end, your settings should look like this:
โ€‹

5. Go to SAML Signing Certificate and download the Certificate (Base64).

6. Open the downloaded file with any notepad app. Copy and paste the content into the Public Certificate field in Survicate settings.

7. Copy the Login URL from Azure, paste it into the Sign-on URL field, and also the Azure AD Identifier to Issuer field in Survicate settings.

Survicate

Corresponding Microsoft Azure field

Example:

Sign-on URL

Login URL

https://login.microsoftonline.com/a18ec2f5-5051-4200-82c1-0beb9a54d8a1/saml2

Issuer

Azure AD Identifier

https://sts.windows.net/a18ec2f5-5051-4200-82c1-0beb9a54d8a1/

Passwordless authentication

You can choose to require teammates to use their passwords to login to the Survicate account, or opt for a frictionless process, by switching on this option:

Thanks to this feature, by default, all new users, who use SAML won't be required to provide the password to log in to Survicate.

Enforce SAML Login for everyone in the organization

This option will become available after SAML is successfully configured and the Survicate account's first SAML login occurs. It lets you ensure that all teammates will be able to use SAML to log in.

Grant access to all workspaces when inviting users through SSO

If you choose to enable this option, and your Survicate organization has multiple workspaces, all new teammates you'll invite to join your account will automatically gain access to all the workspaces.

Once you click Save configuration you will get a list of recovery codes.

โ— Please save them; you will need those to bypass the Single Sign-On when you don't have access to the SAML provider anymore.

Logging in

Now, with SAML enabled, to avoid using your login and password on the Survicate login page, you can log in directly from your SSO provider. Once you sign-in via SSO, and Passwordless authentication is enabled, you will not be asked for your Survicate password.


โ€‹

๐Ÿ“ž If you have any questions or need assistance - feel free to reach out to our team via chat or email: support@survicate.com.

Did this answer your question?