HashiCorp Terraform Cloud - SAML Relying Party Configuration - RSA Ready Implementation Guide
Last Modified: 2024-06-07
This article describes how to integrate RSA with HashiCorp Terraform Cloud using SAML Relying Party.

Configure RSA Cloud Authentication Service

Perform these steps to configure RSA Cloud Authentication Service as Relying Party to HashiCorp Terraform Cloud.
Procedure
  1. Sign in to the RSA Cloud Administration Console.
  2. Navigate to the Authentication Clients menu, and from the dropdown, select Relying Parties.image.png
  3. In the Relying Party Catalog, select Add a Relying Party and click Add for Service Provider SAML.image.png
  4. On the Basic Information page, enter a name for the application in the Name field and click Next Step.image.png
  5. In the Authentication tab, select SecurID manages all authentication.
  6. Select the Primary Authentication Method and Access Policy for Additional Authentication as required and click Next Step.image.png
  7. Provide the Assertion Consumer Service (ACS) URL and Service Provider EntityID  in the following format:
    1. Assertion Consumer Service (ACS) URL: https://app.HashiCorp Terraform Cloud.io/sso/saml/<ACS_ID>/acs
    2. Service Provider EntityID: https://app.HashiCorpTerraformCloud.io/sso/saml/<EntityID>/metadata
image.png
Refer to the Configure HashiCorp Terraform Cloud configuration section to obtain the ACS URL and EntityID.
  1. In the SAML Response Protection section, select IdP signs assertion within response, and download the certificate by clicking Download Certificate.image.png
  2. Under the User Identity section, select Show Advanced Configuration, then configure Identifier Type and Property as follows: 
    1. Identifier Type: Auto Detect 
    2. Property: Auto Detect
image.png
  1. Click Save and Finish.
  2. On the My Relying Parties page, click Edit dropdown and select Metadata option to download the metadata.image.png
  3. Click Publish Changes to save your settings. After publishing, your application will be enabled for SSO.image.pngimage.png

Configure HashiCorp Terraform Cloud

Perform these steps to configure HashiCorp Terraform Cloud.
Procedure
  1. Log in to HashiCorp Terraform Cloud using admin credentials.
  2. Navigate to Organization and select the required Organization name.image.png
  3. Navigate to the Settings page and select SSO.image.pngimage.png
  4. Click the Setup SSO button.image.png
  5. Select SAML and click Next.
image.png
  1. To configure SSO settings for SAML, click the SAML Configuration radio button.image.png
  2. Configure using the IdPs metadata URL or manually with the Sign-On URL, Entity ID, and X.509 Certificate:
    1. Single Sign-On URL: This is the value of SingleSignOnService, obtainable from the metadata file downloaded from the RSA platform.
    2. Entity ID or Issuer URL: This is the value of Entity ID, obtainable from the metadata file downloaded from the RSA platform.
    3. X.509 Certificate: Upload the certificate downloaded from the RSA platform.
image.png
  1. The Management settings details will be auto filled. Click Save settings.image.png
  2. After saving the settings, click Test and copy the HashiCorp Terraform Cloud Entity ID and Assertion Consumer URL. These two values will be used to configure the RSA platform.
image.png
  1. Click Enable.
image.png
  1. Click Enable SAML.
image.pngimage.png
The configuration is complete.
Return to HashiCorp Terraform Cloud - RSA Ready Implementation Guide