Skip to main content

Organization Settings

General Settings

General settings determine the options available to your users when they create their Sauce Labs accounts.

To access General settings:

  1. On Sauce Labs, click ACCOUNT and then click Organization Management.
Organization management navigation
  1. On the Organization Management page, in the ORGANIZATION SETTINGS section, click VIEW SETTINGS.
View settings
  1. On the General tab, you have the following option:
OptionDescription
Require Full Name for UsersWith this option enabled, users must enter both a first name and a last name when creating their accounts.

Security Settings

Enterprise Plans only

Sauce Labs security settings allow organization admins to manage how users in their enterprise can run tests.

To access Security settings:

  1. On Sauce Labs, click ACCOUNT and then click Organization Management.
  2. On the Organization Management page, in the ORGANIZATION SETTINGS section, click VIEW SETTINGS.
View settings
  1. On the Security tab, you have the following options:
OptionDescription
Require Sauce Connect Proxy/VPNSauce Connect Proxy and IPSec VPN provide a secure connection between the Sauce Labs cloud and apps under test that are typically behind a firewall or on a local machine.

When this option is set to Enabled:
  • All network traffic from real devices, virtual platforms (browsers, emulators, and simulators) MUST go through a Sauce Connect Proxy or IPSec VPN tunnel.
  • No network traffic can occur outside the tunnel, unless intentionally directed by the user (i.e., exceptions for specific domains can be made with certain Sauce Connect Proxy commands).
  • If no Sauce Connect Proxy or IPSec VPN tunnels are available, all tests on real devices, virtual browsers, emulators, and simulators will fail.
This feature is disabled by default.

Allow Only Organization Admins to Start Sauce Connect Proxy TunnelsWhen this option is set to Enabled, all users except organization admins will be prevented from starting new Sauce Connect Proxy tunnels. Users would need to run tests using existing, shared Sauce Connect Proxy tunnels.

This feature is disabled by default.
Enable Sauce Connect Proxy/VPN for Public Cloud Devices

RDC PUBLIC DEVICES ONLY

When this option is set to Enabled:
  • An organization admin must accept the waiver before toggling this option on.
  • All users will be allowed to use Sauce Connect Proxy tunnels for the Real Device Public Cloud.
This feature is disabled by default because a waiver must be accepted by an organization admin in order to enable it.
Enable Job Visibility Across TeamsWhen this option is set to Enabled, users across teams will be able to see jobs and builds from all other teams in your organization. If disabled, users will only be able to see jobs and builds from their team.

This feature is enabled by default.
Logout URLThis option allows you to run custom processes after the user logs out. You can define a secure https:// URL to redirect the user to that URL on logout or if a session times out. If this field is empty, users will be redirected to the default login page.
Should you decide to use this, you must enter a URL starting with HTTPS (HTTP will not work).
Reset All Access KeysAll users have a unique access key that they use to authenticate to Sauce Labs, which is usually integrated into their test scripts. Clicking Reset All Access Keys will invalidate all access keys for your organization, and require users to update their tests scripts with new access keys.

If a user attempts to run a script containing an invalidated access key, the test and any build that contains it will fail. You should only click Reset All Access Keys in the event of a major security issue.

Single Sign-On Settings (Deprecated Flow)

Deprecated

caution

This SSO flow has been deprecated. Use this documentation only if your organization was not migrated to the new SSO.

If you do not have any SSO integrations set up at Sauce Labs and you wish to establish a new integration, see Setting Up SSO to get started.

If you have previously implemented the deprecated SSO integration and wish to migrate to the new SSO implementation, see the step-by-step migration guide.

When you set up SSO with Sauce Labs, you are establishing a connection between the IdP used by your organization, such as Okta or Microsoft's Active Directory, and your Sauce Labs account, that will enable users to log in to Sauce Labs with their IdP credentials.

note

For more detailed information about setting up SSO, see Setting Up Single Sign-On (Deprecated Flow).

  1. On Sauce Labs, click ACCOUNT and then click Organization Management.
  2. On the Organization Management page, in the ORGANIZATION SETTINGS section, click VIEW SETTINGS.
View settings
  1. On the Organization Settings page, click the SINGLE SIGN-ON tab.
SSO Settings tab
  1. Enter a unique identifier string. The string will be applied to user names to make sure that your users will have unique names associated with your account.
  2. Upload the SAML metadata file provided by your IdP that contains the list of your SSO users. Sauce Labs SSO supports most SAML 2.0 metadata files. For more information about specific IdPs, see Configuring Active Directory Federation Services (AD FS) and Configuring Okta.
  3. Under Enable Single Sign On, toggle the switch to Enabled. For more information about adding new users and SSO considerations, see Adding and Deactivating Users.
note

If the account you're setting up with SSO is not the only account your organization has with Sauce, the EntityID field must be unique for each account or the setup will fail. The EntityID field is a simple string that can be changed manually in the metadata file prior to upload. If users are added to your IdP after you've set up SSO with Sauce Labs, then Sauce Labs accounts will be created for them the first time they attempt to log in using their SSO credentials.

SSO Advanced Options

OptionDescription
Default Team PlacementAssign SSO users to a default team when they are added to Sauce Labs.
Require SSO Login (Recommended)Enabling this option will require users to log in to Sauce Labs using their SSO credentials, even if they already have individual Sauce Labs accounts. These users can run test automation using credentials. For more information about adding new users and SSO considerations, see Adding and Deactivating Users.