Skip to main content

Logging in via SAML SSO

Abstract

You can log in via SAML SSO if a workspace with a working SAML SSO configuration added you as a member. With a SAML SSO login, you don't need an email address and a password.

You can log in via SAML SSO if a workspace with a working SAML SSO configuration added you as a member. With a SAML SSO login, you don't need an email address and a password.

The exact process depends on how SAML SSO is configured for the workspace and whether the workspace has a verified domain.

Logging in via SAML for new users

  1. Open the Bitrise sign-up page and click Sign up with SSO.

  2. Enter your work email address and click Continue with SSO.

    sign-up-saml.png

  3. Follow the instructions:

    • If your workspace has a verified domain matching your email's domain, you will be redirected to log in to the identity provider. After logging in, you will be redirected to Bitrise: provide a username and click Finalize account. You will receive an email with a confirmation link.

    • If your workspace doesn't have a verified domain or if it doesn't match your email's domain, you will be asked to check your inbox. An email is sent with a secure login link that contains the available workspaces that use SAML SSO. To finish signing in to the workspaces, click the links in the email. You will be redirected to Bitrise to enter your username and finalize the account.

      SAML SSO unavailable

      If you haven't been invited to a workspace and no workspace has your email domain verified, you will receive an error message at this stage that states you tried to use SAML SSO without a valid target. You can only sign up or log in without SSO.

Logging in to SAML SSO for existing users

If a workspace switches to using SAML SSO to log in, members might need to authorize SAML SSO separately, depending on the workspace configuration.

  1. Open the Bitrise login page.

  2. Click Continue with SSO.

  3. Enter your email address.

  4. Follow the instructions:

    • If your workspace has a verified domain matching your email's domain, you will be redirected to the identity provider's site to log in. After successfully logging in, you will be redirected to Bitrise.

    • If your workspace doesn't have a verified domain or if it doesn't match your email's domain, you will need to authorize SAML SSO before logging in. When the workspace enabled SAML SSO, you received a confirmation email: find this email and click Authorize SSO access. Alternatively, if you are already logged in when SAML SSO is enabled, you will see the authorization screen on the website itself.

In this section:

A Workspace is an environment that allows you to manage your Bitrise apps and the team members working on the apps. You can create multiple Workspaces, and you can be invited to Workspaces by other Bitrise users. To be able to add apps and run builds, you either need to be part of a Workspace, or you have to be an outside contributor on an app's team.