Single Sign-On with OneLogin

OneLogin can be used as an SSO provider for your Buildkite organization. To complete this tutorial, you will need admin privileges for both OneLogin and Buildkite.

Step 1. Add the Buildkite app to your OneLogin Account

Log into your OneLogin account, and follow these steps:

  1. In the 'Apps' tab of your OneLogin organization's Admin area, select the 'Add App' button to search the OneLogin directory
  2. Search for 'Buildkite'
  3. Add the Buildkite app to your OneLogin account
  4. Click on the 'Configuration' tab of your new Buildkite application
  5. Enter your Buildkite organization slug
  6. Click the 'Save' button in the top right to save your configuration

Step 2. Create an SSO Provider

In your Buildkite Organization Settings' Single Sign On menu item, choose the OneLogin provider:

Screenshot of the Buildkite SSO Settings Page

On the following screen in the setup form, enter your IdP data. The following three required fields can be found in the 'SSO' tab on the Buildkite app page in OneLogin:

SAML 2.0 Endpoint (HTTP) The URL where you can log in to OneLogin's SAML service.
Issuer URL The URL that identifies your OneLogin service.
X.509 certificate The public key certificate generated for you by OneLogin. You'll need the whole file, not just a link to the file.

You can also set up SSO providers manually with GraphQL. See the SSO Setup with GraphQL Guide for detailed instructions and code samples.

Step 3. Perform a Test Login

Follow the instructions to perform a test login. Performing a test login will verify that SSO is working correctly before you activate it for your organization members.

Step 4. Enable the new SSO Provider

Once you've performed a test login you can enable your provider. Activating SSO will not force a log out of existing users, but will cause all new or expired sessions to authorize through OneLogin before organization data can be accessed.

If you need to edit or update your OneLogin provider settings at any time, you will need to disable the provider first. For more information on disabling a provider, see the disabling SSO section of the SSO overview.