Skip to main content
Soventro

Set up single sign-on

Let your team sign in with Google Workspace, Microsoft Entra ID, Okta or another OpenID Connect provider, verify your email domains, and require single sign-on.
From the video guide Integrations, with its transcript.

Single sign-on lets your team sign in to Soventro with your company's identity provider, so you manage access in one place. Soventro uses OpenID Connect, which Google Workspace, Microsoft Entra ID, Okta and most other providers support. It doesn't use SAML.

Single sign-on is for your team only. Attendees keep signing in with the link from their registration email.

You'll need to be an Owner or Admin in Soventro, and to have someone who can create an app in your identity provider and add a DNS record for your email domain.

1. Create an app in your identity provider

In your identity provider, create a web application with a client secret that uses OpenID Connect.

  1. In Soventro, choose Single sign-on in the organization menu.
  2. Under Redirect URI, click Copy. On Soventro it's https://soventro.com/auth/sso/callback.
  3. Add it in your identity provider as an allowed redirect (or callback) URI.
  4. Allow the scopes openid, email and profile.
  5. Note the app's client ID, client secret and issuer URL.

For Microsoft Entra ID, also add the optional email claim to the ID token under Token configuration, so Soventro receives each person's email address.

2. Save the connection

  1. Under Identity provider, choose your provider: Google Workspace, Microsoft Entra ID, Okta or Other (OpenID Connect).
  2. Enter the Issuer URL. The usual values are listed below.
  3. Enter the Client ID and Client secret, then click Save connection.

Issuer URLs for the common providers:

  • Google Workspace: https://accounts.google.com
  • Microsoft Entra ID: https://login.microsoftonline.com/<your tenant ID>/v2.0
  • Okta: https://<your Okta domain>, or your authorization server's issuer URL

The secret is stored encrypted and never shown again. To replace it, enter a new one; leave the field blank to keep the saved one.

Click Test connection. Soventro checks it can reach your provider and read its settings, and says in plain words what needs fixing.

3. Verify your email domains

Single sign-on works only for email addresses on domains you've proved are yours.

  1. Under Email domains, enter a domain such as yourcompany.com and click Add domain.
  2. At your DNS provider, add the TXT record shown. Its name is _soventro-verify.yourcompany.com and its value starts with soventro-verify=.
  3. Click Check DNS. When the record is found, the domain shows Verified.

DNS changes can take a few minutes to an hour to appear. You can add up to 20 domains. Free email services such as Gmail or Outlook.com can't be used, and a domain can belong to only one organization on Soventro.

4. Choose sign-in options

Under Sign-in options:

  • Turn on single sign-on: people with an address on a verified domain can choose Sign in with single sign-on on the sign-in page.
  • Require single sign-on: members with an address on a verified domain must sign in through your identity provider, and their password stops working for your organization. Owners can always sign in with their password too, so you're never locked out if your provider is down.
  • Add new people automatically: someone with an address on a verified domain who isn't on your team yet joins it the first time they sign in, with the role you choose under Role for people added this way. Any role except Owner can be chosen. When this is off, they're asked to get an invitation from an admin.

Click Save sign-in options.

How your team signs in

On the sign-in page, they click Sign in with single sign-on, enter their work email, and are sent to your identity provider.

When sign-in doesn't work

  • "Single sign-on isn't set up for that email address": the domain isn't verified, or single sign-on is off.
  • "You're not on this organization's Soventro team yet": invite them under Team, or turn on Add new people automatically.
  • "Your identity provider signed you in with an email address this organization's single sign-on doesn't cover": the address your provider returned isn't on a verified domain.
  • "Your identity provider didn't confirm your email address": your provider must send a verified email address.
  • "Your identity provider's answer couldn't be accepted": run Test connection and check the redirect URI, client ID and secret.
  • "That sign-in attempt expired or was already used": start again from the sign-in page.

Remove a domain or turn it off

Click Remove next to a domain. People with that domain can no longer use single sign-on. To turn single sign-on off for everyone, untick Turn on single sign-on and save.

Still need help?

Email the Soventro team and a person will get back to you during business hours (US Eastern).

info@soventro.com