Buildkite - SAML SSO Agent Configuration - RSA Ready SecurID Access Implementation Guide

This section describes how to integrate RSA SecurID Access with Buildkite using a SAML SSO Agent.

Architecture Diagram

Configure RSA Cloud Authentication Service

Perform these steps to configure RSA Cloud Authentication Service as an SSO Agent SAML IdP to Buildkite.

Procedure

1. Sign into the RSA Cloud Administration Console and browse to Applications > Application Catalog.

2. Click on Create From Template found in he upper right of the page then select SAML Direct.

3. On Basic Information page enter a Name for the application, ie. Buildkite Then click on Next Step.

4. On Connection Profile page.

   1. In Connection URL field, verify the default setting.

   2. Choose IDP-Initiated or SP-Initiated.
      

   1. Scroll down to SAML Identity Provider (Issuer) section.

   2. Note the Identity Provider URL and Issuer Entity ID. These values are automatically generated. They may be needed later for the configuration of Buildkite.

   3. Click on Generate Cert Bundle, set a a common name for your company certificate. Then click Generate and Download .

   4. Select Choose File and upload the private key from the generated certificate bundle.

   5. Select Choose File and upload the cert from the generated certificate bundle.

   6. Select Include Certificate on Outgoing Assertion.

      1. 
   1. Scroll down to Service Provider section.
      
      

   2. Enter the Assertion Consumer Service (ACS) This is the ACS URL found in your instance of Buildkite . For example https://[ACCOUNT NAME].userecho.com/saml/acs/.

   3. Enter the Audience (Service Provider Issuer ID) This is the Metadata URL found in your instance of Buildkite . For example https://[ACCOUNT NAME].userecho.com/saml/metadata/.
      

      

   1. Scroll down to User Identity section.
      
      

   2. Ensure Identifier Type = Email Address, set your Identity Source and Property = mail.

   1. Expand Show Advanced Configuration .
      
      

   2. In Attribute Extension section click +ADD.

   3. Add Attribute Name = "Email" and Property = mail.

   4. In Attribute Extension section click +ADD.

   5. Add Attribute Name = "Last name" and Property = sn.

   6. In Attribute Extension section click +ADD.

   7. Add Attribute Name = "First name" and Property = givenName.

   8. Note that the property values may differ in your configuration.

   9. Click Next Step

5. On User Access page select the Access Policy you require. Allow All Authenticated Users is the least restrictive. Click Next Step
   

1. On Portal Display Page

   1. Select Display in Portal

   2. Upload an Application Icon if you wish

   3. Set an Application Tooltip if you wish.

   4. Click on Save and Finish

2. Click on Publish Changes. Your application is now enabled for SSO. If you make any additional changes to the application configuration you will need to republish.
   

Configure Buildkite

Perform these steps to integrate Buildkite with RSA SecurID Access as a SAML SSO Agent.

Procedure

1. Sign into Buildkite and browse to Settings > Single Sign On > Custom SAML.

2. Click on  Configure IdP Metadata Manually.

3. In the Service Provider section note the Issuer (Entity ID), Assertion Consumer Service URL, and Meda Data URL, they may be used above to configure the SecurID Cloud Authentication Service above.

4. For SAML Target URL, enter the Identity Provider Entity ID from the RSA CAS configuration above. For example, https://rsa-blr-pe.auth-demo.securid.com/saml-fe/sso.

5. For Enitity ID, enter the Identity Provider Entity ID from the RSA CAS configuration above. For example, https://rsa-blr-pe.auth-demo.securid.com/saml-fe/sso.

6. For the Certificate paste the contents of downloaded certificate from step 4c in the RSA CAS configuration above.

7. Click on Save Settings.

8. Click on Perform Test Login.

9. Click on Enable Provider.

Configuration is complete.

Next Step: Head back to the main page.