Organizations

info

What you'll learn

• What an Organization ID is and how it is useful
• How to manage Organizations
• How to apply for an Open Source (OSS) plan

Organizations are used to group and manage projects. Here you can create projects, manage users, access billing and usage information, leverage third party integrations, and apply org-level settings.

Organization ID

An Organization's ID is a unique identifier in UUID format that can be found under the "Organization settings" section of Cypress Cloud. This ID is used frequently by the Support, Success, and Sales teams to reference an Organization.

To locate your Organization's ID, go to "Organization settings" then Organization ID. Click on the clipboard icon to copy the ID for easy sharing with Cypress teams.

Managing Organizations

Create Org

You can create an organization from within Cypress Cloud by opening the organization switcher and clicking Create new organization.

Delete Org

You can delete organizations that you own as long as they do not have any projects in the organization. You must first delete or transfer ownership of your projects your projects to another organization before you can delete the organization.

Billing & Usage

Open Source Plan

To support the community, we provide the Open Source (OSS) plan to take advantage of Cypress Cloud with unlimited test runs. To qualify, all Projects in your Organization must meet the following criteria:

• Be a non-commercial entity
• Be Public in Cypress Cloud
• Your Project source code is available in a public location with an OSI-approved license
• Record minimum of 500 tests included with the Free Plan

Requesting OSS plan for an Org

1. Login to the Cypress Dashboard, or create an account if you are a new user.

2. Go the Organizations page to select the Organization you want to associate with an OSS plan. If you have no Organizations, you can create one by clicking the + Create New Organization button.

   

3. Go to the Billing & Usage page, click Upgrade and then click on the Apply for an open source plan link at the bottom of the page. Note: Access to all Projects must be set to public to enable this link.

   
   

4. Fill in and submit the OSS plan request form.

   

5. You'll receive an email confirming your request. The Cypress Team will review your request and, if approved, an OSS plan subscription will be applied to your Organization.

If you have any questions regarding the OSS plan, please feel free contact us.

Integrations

Owner and admin roles can integrate Cypress Cloud with many third party tools under Organization > Integrations and edit those settings from within the Project settings page.

See our integration guides to learn more:

CI/CD

•   GitHub integration guide
•   GitLab integration guide
•   Bitbucket integration guide

Project Management

•   Jira integration guide

Messaging

•   Cypress integration for Slack guide
•   Cypress integration for Microsoft Teams guide

Enterprise SSO

tip

Premium Cypress Cloud Feature

Enterprise SSO is included in our Business and Enterprise paid pricing plans.

caution

Requires Owner Permissions

All instructions below must be done by an Owner of the organization. If you are not an Owner of the Organization, coordinate with an Owner of the Organization to set up SSO.

Enable SSO

1. Log in to Cypress Cloud and navigate to the Integrations page for your organization.
2. Scroll down to the Enterprise SSO section. Select your SSO provider and take note of the information provided and required. Keep this window open and continue to the configuration instructions for your specific SSO provider below.

SSO Provider Configuration

Follow the instructions below for your specific SSO provider.

caution

Smart Card Authentication

For Smart Card implementation, please reach out to Support for assistance.

• Okta
• SAML
• Azure AD

Okta

Cypress Cloud can integrate with Okta via SAML. In addition to the documentation below, refer to Okta's official documentation for setting up a new SAML application.

1. Log into your Okta dashboard and head to the Admin section.
   
2. Create a new SAML-based Web application.
   
   
3. Supply the following information requested in the Okta setup wizard:

• App name: Cypress Cloud
• App logo: Cypress logo download
• Single sign on URL: The URL provided in Cypress Cloud
• Audience URI: The URI provided in Cypress Cloud
• Attribute statements: Add the attribute statements described in Cypress Cloud

1. Click Next then select I'm an Okta customer and click Finish.
2. Click the View Setup Instructions button in the middle of the page. Cypress Cloud needs the information provided here:

• Copy the Identity Provider Single sign-on URL to Cypress Cloud.
• Download the certificate and upload that to Cypress Cloud.
  

1. Navigate to the Assignments tab and grant your users access to Cypress Cloud.
2. Save Configuration.

SAML

Cypress Cloud can integrate with your identity provider via SAML. In addition to the documentation below, refer to your provider's official documentation for configuring a SAML integration.

1. Log into the admin interface for your identity provider.
2. Work through the setup wizard supplying the information requested:

• App name: Cypress Cloud
• App logo: Cypress logo download
• Single sign on URL: Collect the URL provided by Cypress Cloud
• Audience URI: Collect the URI provided by Cypress Cloud
• Add a custom mapping of AttributeStatements with the following:
  • User.Email: User's email
  • User.FirstName: User's first name
  • User.LastName: User's last name

1. Collect the sign-on URL and certificate from your identity provider. Supply that to Cypress Cloud.
2. Save Configuration.

Azure AD

Cypress Cloud can integrate with your identity provider via Azure AD. In addition to the documentation below, refer to the Microsoft Guides for configuring an application.

1. Log into the Azure portal and create a new Application.
2. Work through the application setup, supplying the following information when requested:

• App name: Cypress Cloud
• App logo: Cypress logo download
• Login URL: Collect the URL provided by Cypress Cloud

1. Collect the Client ID for your application provided in the Application overview page.
2. Go to Certificates and Secrets in your Azure Application and create a new secret that does not expire. Copy this newly-created secret and paste it in the Azure Client Secret field in Cypress Cloud.
3. Under API Permissions in Azure AD, ensure the application has access to User.Read permissions
4. Enter the domain used for your Active Directory, as well as the list of SSO domains you wish to allow user to authenticate with, in Cypress Cloud. This is used for SSO discovery from the login screen.
5. Save Configuration.

Save Configuration

Return to Cypress Cloud and click Save Configuration. Cypress Cloud will attempt to authenticate.

🎉 Your integration is now complete! You can invite all of the users in your organization to sign in through your SSO provider.

Notes

• Once SSO is successfully set up, users will need to be invited via your SSO provider, as the Cypress Cloud invitation option will be disabled.
• All SSO Users are initially added with the User Role of Member. If a User needs different User Role permissions, this can be changed via Cypress Cloud by a current member with the role of Owner or Admin.
• SSO users are separate accounts from Google/GitHub or email/password users. If there are duplicate users, duplicates can be removed by any Owner or Admin.