https://support.tethr.com/hc/en-us/categories/115002448427-Admins Admins
https://support.tethr.com/hc/en-us/sections/360008667094-Configure-access-security Configure access & security

Guide to SAML 2.0 single sign-on (SSO) settings for your team

New feature: content organization, collaboration and filtering

This article describes a new feature that may not be available to all users. If you don't see this feature and want to learn more, please contact your Tethr admin.
Section only

As a Tethr Admin user you can enable SAML 2.0 single sign-on (SSO) as an added security layer within your team or organization’s Tethr account. SAML SSO helps you effortlessly manage your team or organization’s access to all the products you use.

With SSO, your users can use one set of login credentials (e.g., username/email and password) to access multiple applications. SSO authenticates your users once for all applications they have rights to, eliminating the need for multiple logins or managing multiple username/password credentials each time they switch applications in the same session.


SAML SSO benefits:

  • Improves users’ online experience, allowing them to quickly login to Tethr with a single sign-on while promoting their privacy.

  • Reduces your organization’s administrative cost to maintain user account information.

  • Transfers the risk of managing multiple user accounts from the business service provider to the identity provider (IdP).

  • SSO doesn't require maintenance and synchronization of user account information between your systems.


What we'll cover:

  1. General steps to configure your IdP for SAML 2.0 SSO

    1. Forcing SSO by specific email domain
    2. Auto SSO
    3. Link a Tethr user to an identity provider
    4. Bypassing SSO
    5. Signing out of Tethr
  2. Elevated admin permission for User Account Control (UAC)

  3. Changing and resetting passwords

  4. Tethr account activation and sign-in experience

  5. Configure SAML SSO for a specific IdP


Before you begin:

Before you can configure SAML 2.0 SSO for your organization, you'll need:

  • to be an Administrator of your organization’s Tethr users so you can activate users and test the integration
  • an identity provider account with Administrator privileges
  • an identity provider that is SAML 2.0 compliant and is accessible via a public IP address.

General steps to configure your IdP for SAML 2.0 SSO

This section shows you how to configure the identity provider to enable SAML single sign-on in Tethr.
Within your chosen IdP you’ll create a new SAML 2.0 Web application and add Tethr.

  1. For Application Name use "Tethr".

    Tethr’s logos can be found at https://tethr.com/brand.

  2. Use https://mycompanyname.tethr.com/AuthServices/Acs for ACS URL.

  3. Use https://mycompanyname.tethr.com/AuthServices for Entity ID.

  4. Use https://mycompanyname.tethr.com/ for Start URL.

  5. Tethr needs the following attribute included in the SAML token: user.id needs to contain the user’s primary email address.

  6. Required: Ensure the encryption signature algorithm be SHA-256 or stronger. Tethr does not support SHA-1.

  7. Finally, provide your Tethr Integrations Specialist with the identity provider (IdP) SAML metadata file.


Forcing SSO by specific email domain

We recommend the organizations who work with Tethr enforce the use of SSO. To enforce SSO in your organization, provide a list of email domains you’d like SSO enforced on to your Tethr Integrations Specialist.


Auto SSO

Auto SSO is useful when all of your organization’s user accounts are utilizing single sign-on to log in to Tethr. Auto SSO will automatically attempt to log in your users, bypassing Tethr’s login page and redirecting them to your identity provider’s login page. We recommend you enable auto SSO if every user in your organization is logging in with SSO.

Important: To enable auto SSO for your organization, you’ll need to work with a Tethr Integrations Specialist.

Link a Tethr user to an identity provider

This section is for those who already have a Tethr user account with an active username and password.

  1. First, the user will need to sign in to Tethr via their identity provider.
  2. Then, the user should sign in to Tethr using their existing Tethr username and password.
    a) If the organization has enforced the use of SSO for its users, Tethr will automatically redirect the user to sign in to their identity provider. b) If the organization has not enforced the use of SSO for its users, the user will need to go to their Profile page and select link account to link the accounts together.
  3. Tethr will then link the two accounts together.

Bypassing SSO

If you’re managing SSO for your organization and need to troubleshoot or modify Tethr’s SSO configuration, you may need to bypass SSO.

In the scenario where either or both the forced SSO domain list and auto SSO are enabled, users will always be able to sign in to Tethr directly by visiting: mycompanyname.tethr.com/login.

When a user is in the forced SSO domain list and they attempt to sign in with their Tethr username and password, they’ll automatically be redirected to their IdP for authentication.


Signing out of Tethr

When configuring your identity provider, you have the option of setting it up to sign you out of your identity provider when you sign out of Tethr. To configure your SSO in this manner, provide the single sign-on logout URL to your Tethr Integrations Specialist.


Elevated admin permission for User Account Control (UAC)

An SSO user who is a Tethr Admin and needs to reset a user’s password, change a user’s name, or perform any other user management functions in your organization, will no longer be prompted for additional authorization.


Changing and resetting passwords

You cannot reset a user password if that user is configured for SSO.

If you need to force a user’s immediate logout, use the reset password option on the user’s Profile under Users in Tethr Settings.


Tethr account activation and sign-in experience

When a Tethr user needs to be activated and they’re using SSO, they should utilize the Sign-in with SSO button rather than selecting the Activate account button, as shown below:

Tethr_activate_your_account_sign-in_with_Okta_SSO.png


If you’ve enabled SSO in your organization, your users’ login page will include a Sign in with SSO option as shown below:

Tethr_sign-in_with_Okta_SSO.png


Configure SAML SSO for a specific IdP