This guide provides step-by-step instructions on setting up Bitrise as a SAML application on Google G Suite.
Getting configuration information from Google ⚓
- Sign into your Google Admin Console.
APPS SETTINGSpage, click
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.
- 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.
- In the
Enable SSO for SAML Applicationwindow, click
SETUP MY OWN CUSTOM APP.
Google IdP Informationwindow, copy the
SSO URLand click
You will need the SSO URL and the content of the downloaded certificate on the
Single Sign Ontab of your Bitrise Workspace. Then click
Nexton 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 ⚓
- Go back to Bitrise.
- Click the Workspace you want to add SAML SSO.
- Click the Workspace’s
Single Sign Onbutton on the left.
Paste the SSO URL to the
Identity provider sign-on URLfield. (Remember, you’ve copied this URL from the
Google IdP Informationwindow in your Google Admin Console).
Paste the content of the downloaded certificate to the
Copy Linkbutton under
Single Sign-On URLor copy the URL manually.
You will need this in a minute in your Google Admin Console.
Configure SSO. Now let’s head back to your Goodgle Admin Console.
Finishing setting up Bitrise as a SAML app on Google ⚓
- In your Google Admin Console you should see the
Basic information for your Custom Appwindow.
Add a name to the
Application Namefield. (It can be any name.)
- In the
Service Provider Detailswindow, do the following:
- Paste the copied
Single Sign-OnURL from Bitrise’s
Single Sign On(Step 6 above) tab to the
Entity IDfield. This time it must be Bitrise!
- Tick the
- Paste the copied
Nextto proceed to the
If all went well, this is what you should see:
Enabling Bitrise as a SAML app on Google ⚓
- On the
Service Statuspage, select your organization unit on the left.
ONto enable Bitrise ‘s service status.
- Check your emails. You should receive a confirmation email from us (email@example.com) containing a
Sign In via SSObutton. For a smoother sign-in flow, make sure you’re already logged into Bitrise in another tab before you hit the
Sign In via SSObutton.
Sign In via SSOto 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.
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.