Setting up Google SSO for Bitrise

Last updated at 2021-01-05

Japanese translation unavailable

This page has not been translated into Japanese yet - we apologise for the inconvenience! If you’re interested in helping us out, feel free to translate any article in the jp folder of the DevCenter repository and open a PR!

このページは日本語への翻訳がまだ完了しておりません。ご不便をおかけして申し訳ございません! もしお手伝いできる方がいらっしゃれば、ご自由にjpフォルダの記事を日本語に訳していただき、PRを開いてください

This guide provides step-by-step instructions on setting up Bitrise as a SAML application on Google G Suite.

Google administrator account

Please note that you must have a Google administrator account to add Bitrise as a SAML app.

Getting configuration information from Google

  1. Sign into your Google Admin Console.
  2. Select Apps.
  3. In the APPS SETTINGS page, click SAML apps.

    You will see a list of the apps with their statuses (either turned on or off). On this page you can add or remove a service and enable/disable it.

  4. Click the + mark in the yellow circle on the bottom right corner of the screen to add Bitrise as a SAML application to the list.
  5. In the Enable SSO for SAML Application window, click SETUP MY OWN CUSTOM APP.
  6. In the Google IdP Information window, copy the SSO URL and click DOWNLOAD. Setting up Google SSO for Bitrise

    You will need the SSO URL and the content of the downloaded certificate on the Single Sign On tab of your Bitrise Workspace. Then click Next on the bottom right corner.

Now that we have the config information, we will leave Google Admin Console for a minute and fill out the required SAML SSO fields on Bitrise.

Configuring SAML SSO on Bitrise

  1. Go back to Bitrise.
  2. Click Account Settings.
  3. Click the Workspace you want to add SAML SSO.
  4. Click the Workspace’s Single Sign On button on the left.
  5. Paste the SSO URL to the Identity provider sign-on URL field. (Remember, you’ve copied this URL from the Google IdP Information window in your Google Admin Console).

    Paste the content of the downloaded certificate to the Certificate field.

    Setting up Google SSO for Bitrise

  6. Click the Copy Link button under Single Sign-On URL or copy the URL manually.

    You will need this in a minute in your Google Admin Console.

  7. Click Configure SSO. Now let’s head back to your Goodgle Admin Console.

Finishing setting up Bitrise as a SAML app on Google

  1. In your Google Admin Console you should see the Basic information for your Custom App window.
  2. Add a name to the Application Name field. (It can be any name.)

    Setting up Google SSO for Bitrise

  3. Click Next.
  4. In the Service Provider Details window, do the following:
    • Paste the copied Single Sign-On URL from Bitrise’s Single Sign On (Step 6 above) tab to the ASC URL field.
    • Type Bitrise to the Entity ID field. This time it must be Bitrise!
    • Tick the Signed Response box.

    Setting up Google SSO for Bitrise

  5. Click Next to proceed to the Attribute Mapping window.
  6. Click FINISH.

    If all went well, this is what you should see:

    Setting up Google SSO for Bitrise

Enabling Bitrise as a SAML app on Google

  1. Click EDIT SERVICE.

    Setting up Google SSO for Bitrise

  2. On the Service Status page, select your organization unit on the left.
  3. Click ON to enable Bitrise ‘s service status.

    Setting up Google SSO for Bitrise

  4. Check your emails. You should receive a confirmation email from us ( containing a Sign In via SSO button. For a smoother sign-in flow, make sure you’re already logged into Bitrise in another tab before you hit the Sign In via SSO button.
  5. Click Sign In via SSO to proceed to our Authorization page.

    NOTE! Below error message only appears if you’ve been trying to access the Authorization page in a Safari browser.

    Error: The CORS policy for this site does not allow access from the specified Origin....

    We suggest you to copy the URL and paste it in a new tab if using Safari. It will work! For all other browser types, you should be safely landing to the Authorization page.

  6. Click Authorize.

You should be landing on your Bitrise Dashboard now. If you click Profile settings and select the Single Sign-On tab from the left menu, you should see SAML SSO is enabled for your Workspace. Once all Workspace members have enabled their SAML SSO connection, you can enforce SAML SSO on the whole Workspace with a simple toggle.