Setting up Google SSO for Bitrise

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

SAML SSO restrictions

SAML SSO is only available for a Workspace with the Velocity or Enterprise Build plans.

Since the SAML SSO feature is tied to the above plans, if you decide to downgrade, you will lose this feature. All Workspace members will receive an email about the downgrade and you’ll have two weeks to re-upgrade if you wish to use SAML SSO in your Workspace again.

Before connecting SAML SSO to your Workspace:

  • Make sure you have a Google administrator account where you can add Bitrise as a SAML app. The G Suite administrator can help setting up SAML SSO on G Suit.

  • Be aware that only the Workspace owner can set up SAML SSO to a Bitrise Workspace.

  • Your account on Bitrise has a Workspace with the Velocity or Enterprise plan.

You'll need to:

Getting configuration information from G Suite and Bitrise

  1. Sign into your Google Admin Console.

  2. Select Apps on the Admin Console page.

    googleadmin-apps.jpg
  3. On the Apps page, click SAML apps.

    appsamlapp.jpg
  4. On the Web and mobile apps page, click the Add apps button, and select the Add custom SAML app option from the dropdown.

    addappsaml.jpg
  5. On the App details page add Bitrise as your app name. Please note it must be Bitrise as no other format is accepted. Click Continue.

    addappname.jpg
  6. On the Getting Identity Provider details page:

    • Copy the SSO URL and paste it on the SAML SSO provider Single Sing-On URL (SSO URL) on Bitrise.

    • Copy the whole content of the Certificate field and paste it in the SAML SSO provider certificate field of Bitrise. You can upload the Certificate from your local computer too.

      identityproviderdetails.jpg
  7. While you are in Bitrise, click the Copy Link button to copy the Assertion Consumer Service URL (ACS URL). We will need it on G Suite in a second. Let’s NOT click the Configure SSO button just now!

  8. Let’s head back to the Getting Identity Provider details page of G Suite. Click Continue.

  9. On the Service provider details page:

    • Paste the Assertion Consumer Service URL (ACS URL) of Bitrise in the ACS URL field on G Suite. (Remember, we got the link at Step 7.)

    • Type Bitrise in the Entity ID field. Please note it must be Bitrise as no other format is accepted.

    • Tick the Signed response checkbox under START URL (optional).

    • Click CONTINUE.

      serviceproviderdetails.jpg
  10. Click the Configure SSO button on Bitrise.

  11. On G Suite’s Attribute mapping page, click Finish - you do not have to configure anything here.

Enabling Bitrise app for a group or an organizational unit

All there is left to do on G Suite is to enable the newly created Bitrise app for a group or organization of your choice.

  1. Go to the Web and mobile apps page on G Suite and select Bitrise from the Apps list.

  2. Click User access to get to the Service status page.

  3. Select ON for everyone and hit Save.

    useraccess.jpg