This guide provides step-by-step instructions on setting up Bitrise as a SAML application on OneLogin.
- A OneLogin Administrator.
- A Bitrise Organization owner who is logged into the Organization (with Org Elite subscription) on Bitrise.
Configuring Bitrise on OneLogin ⚓
- Log into OneLogin as an Administrator.
Click Administration on the top bar.
Select Applications and click Add App. This will take you to the Find Applications page.
Bitrisein the search bar and select the SAML2.0 type from the search results.
Click the Configuration tab on the left sidebar. You can change the icon and add descriptions if you wish. Make sure Organization (Bitrise) is ticked. Hit Save.
Click the Configuration tab again and paste the Single Sign-On URL from your Bitrise Organization’s Single Sign On tab to the Single Sign-On URL field on OneLogin. Hit Save.
- Select SSO on the left sidebar.
- Click the View details for the X.509 Certificate. Copy the content of the X.509 Certificate and paste it to the Certificate field on the Enable Single Sign-On page of Bitrise.
- Go back to the SSO page on OneLogin and copy the SAML 2.0 Endpoint (HTTP) link. Paste it in the Identity provider sign-on URL field on Bitrise.
- Go back to Bitrise and click Configure SSO.
If you’ve completed setting up Bitrise on OneLogin and connected it with your Bitrise Organization, then all Organization members will get an email from Bitrise which contains a link to activate their SSO connection to the Organization.
Enabling SAML SSO on Bitrise ⚓
All Organization members (including the Organization owner) must enable their SAML SSO connection to their Bitrise Organization to use SAML SSO as a secure login method. Only once that’s done, can the Organization owner enforce SAML SSO as the single gateway to the Organization.
- Find the email from firstname.lastname@example.org in your inbox.
- Make sure you are already logged into Bitrise in the usual way (using your credentials).
Click Sign in via SSO or open the URL in a new tab of the same browser where you are logged in.
- On the Allow “Organization name” to sign you in window, click Authorize if you trust the Organization.
You should be landing on your Bitrise Dashboard. If you go to your Organization’s Groups tab, you can see that you are automatically added as a SAML user. All Organization members, who enable SAML SSO, appear here automatically. From now on you can log into your Bitrise Organization with SAML SSO.