Before you start ⚓
Before connecting SAML SSO to your Workspace, make sure:
- An Auth0 administrator who is logged into Auth0 is at hand.
- Your account on Bitrise has a Workspace with the Velocity plan. If it doesn’t have an Org, go ahead and create one. Setting up SAML SSO is the same for existing and brand new Orgs on Bitrise.
- As with other Workspace management actions, only the Workspace owner can set up SAML SSO to a Bitrise Org.
Navigating to the Single Sign-On page of Bitrise ⚓
If you are a Workspace owner on Bitrise, you will have to use the Single Sign-On tab to set up a SAML SSO connection between Auth0 and your Bitrise Org.
- On your Bitrise Dashboard click your avatar, then click Profile settings in the dropdown.
- The Overview page displays all the Orgs you’re a member of. Select the Workspace where you wish to set up the SAML SSO connection.
- On the left menu bar, click the Single Sign-On tab which will take you to the Enable Single Sign-On page.
Setting up SAML SSO connection between Auth0 and Bitrise ⚓
You first create a regular web application for Bitrise on Auth0, enable it and then there are two ways to retrieve app specific SAML SSO connection data from Auth0. We will show you both ways!
Creating Bitrise as a web application on Auth0 ⚓
- Log into Auth0 as an admin.
- Click Applications on the left menu bar and then the + Create Applications button on the right hand side of the Applications page.
- On the Create application window, type Bitrise in the Name field. In the Choose application type select Regular Web Applications, and click the Create button.
- You are landing on your newly created Bitrise app’s Quick Start page. Click the Addons tab. Toggle the SAML2 WEB APP’s switch to the right. This will take to to the Addon: SAML2 WEB APP page automatically.
- Copy the Single Sign-On URL from Bitrise and paste it into the Application Callback URL field on the Settings tab of the Addon: SAML2 WEB APP page. Scroll down to the bottom of the Addon: SAML2 WEB APP page and hit ENABLE.
- Go back to the Addons page where you can see the switch turned on.
- Continue with retrieving SAML SSO information from Auth0 to populate the required fields on the Single Sign On page of Bitrise.
Retrieving SAML SSO information from Auth0 ⚓
Once you have enabled Bitrise as a web application on Auth0, it’s time to grab the certificate and the Identity provider’s unique login URL to finish up the SAML configuration on Bitrise.
- Go to Application, then select the Addons tab to find your enabled Bitrise app.
- Click the SAML2 WEB APP web app and select the Usage tab. Click on the Download Auth0 certificate link next to the Identity Provider Certificate label. Open the downloaded certificate file and copy its content into the Certificate field of Bitrise. Go back to Auth0 and copy paste the Identity Provider Login URL into Bitrise’s Identity provider sign-on URL.
- Click Configure SSO button on Bitrise.
- Now you can close the dialog on Auth0.
What’s next? ⚓
Learn how you can log into your Workspacenow that SAML SSO is set up.
You might wan to check out Workspace member’s SAML SSO statuses once the connection is up.
You might want to enforce SAML SSO login to the Org once all Workspace members have authorized their SAML SSO connection to the Org.
Disabling SAML SSO is very simple - learn how.