Configuring SAML SSO for BuildKite

These steps will guide you through setting up the single sign-on functionality between ADSelfService Plus and BuildKite

Prerequisite

1. Log in to ADSelfService Plus as an administrator.
2. Navigate to  Configuration → Self-Service → Password Sync/Single Sign On → Add Application, and select BuildKite from the applications displayed.
   Note: You can also find BuildKite application that you need from the search bar located in the left pane or the alphabet wise navigation option in the right pane.
3. Click IdP details in the top-right corner of the screen.
4. In the  pop-up screen that appears, click Download Metadata and save it.

BuildKite (Service Provider) configuration steps

1. Login to BuildKite with admin credentials.
2. Navigate to Setttings → Single Sign On → Custom SAML
3. Choose Configure Using Idp Meta Data XML File

4. Upload the  Metadata (XML) file you had downloaded in Step 4 of Prerequisite.
5. Click Create Provider
6. Once configuration created, Click Perform Test Login
7. Post sucessful test login, click Enable Provider.

ADSelfService Plus (Identity Provider) configuration steps

1. Now, switch to ADSelfService Plus’ BuildKite configuration page.
2. Enter the Application Name and Description.
3. In the Assign Policies field, select the policies for which SSO need to be enabled.
   Note:ADSelfService Plus allows you to create OU and group-based policies for your AD domains. To create a policy, go to Configuration → Self-Service → Policy Configuration → Add New Policy.
4. Select Enable Single Sign-On.
5. Enter the Domain Name of your BuildKite account. For example, if you use johndoe@thinktodaytech.com to log in to BuildKite, then thinktodaytech.com.com is the domain name.
6. In the Organization Name field, enter the organization name of your BuildKite account.
7. Enter the Assertion Consumer Service URL provided by your application service provider in the Assertion Consumer Service URL field. If required, click the + button next to the text field to add multiple Assertion Consumer URLs. These values can be found in the application's SSO configuration page or metadata. Please reach out to your application's support team if you are having trouble locating the Assertion Consumer Service URL in your application's user interface or metadata.
8. In the Name ID Format field, choose the format for the user login attribute value specific to the application.

Note: Use Unspecified as the default option if you are unsure about the format of the login attribute value used by the application.

9. Click Add Application.

   Your users should now be able to sign in to BuildKite through ADSelfService Plus.

Note: For BuildKite, single sign-on is supported only for SP initiated flow.