Skip to main content

Terraform Cloud SAML integration

Multi-Factor Authentication (MFA) is an extra layer of security used when logging into websites or apps. Individuals are authenticated through more than one required security and validation procedure that only they know or have access to.

Security Assertion Markup Language (SAML) is a protocol for authenticating to web applications. SAML allows federated apps and organizations to communicate and trust one another’s users.

Arculix™, as a SAML provider, improves the user login experience for Terraform Cloud users with its convenient SSO-MFA solution.

Prerequisites

  • Configured Arculix instance and user account with administrative privileges for Arculix.

  • Configured Arculix LDAP Agent.

    For more information, see the Arculix LDAP Agent deployment guide.

  • User account with administrative access for Terraform Cloud.

Terraform Cloud configuration

In this section, you'll configure Terraform Cloud as a service provider (SP).

  1. Download the SAML metadata and certificate for your organization from Arculix.

    Metadata download: https://sso.acceptto.com/<myorganization>/saml/download/metadata

    View metadata: https://sso.acceptto.com/<myorganization>/saml/metadata

    Certificate download: https://sso.acceptto.com/<myorganization>/saml/download/cert

  2. Log in to Terraform Cloud as an administrator and navigate to your organization and click Settings.

  3. Click SSO and select Setup SSO.

  4. Select SAML and click Next.

    terraform_setup_sso.png
  5. On the Identity provider configuration page, set the following configurations: Fill Identity Provider Configuration fields through Acceptto Metadata URL or manually enter the values from the Acceptto Metadata and certificate files that were downloaded earlier.

    Single Sign-On URL

    Enter the login URL found in the Arculix metadata.

    For example, https://sso.acceptto.com/<myorganization>/saml/auth.

    Entity ID or Issuer URL

    Enter the Entity ID or Issuer URL found in the Arculix metadata.

    For example, https://sso.acceptto.com/<myorganization>/saml.

    X.509 Certificate

    Copy and paste the Arculix certificate you downloaded earlier.

    terraform_idp_config.png
  6. Save your changes.

  7. Test your configuration. Verify your configuration and click Enable.

    If you have completed an Arculix (formerly Acceptto) SAML configuration before, you can click Test.

  8. Copy the Entity ID and ACS of Terraform Cloud to use in the Arculix SAML configuration.

    terraform_entity_id.png

Arculix SAML configuration as an Identity Provider (IdP)

In this section, you'll add an application for Terraform Cloud and set the SAML configuration settings. This will be the Identity Provider (IdP) side of the configuration.

  1. Log in to Arculix with an administrative account and go to Applications.

  2. Click Create New Application.

    Create new application
  3. In the New Application form, on the General tab, set the following configurations:

    Name 

    Set the name of the application. This is the name to display for push notifications, in the Admin panel, Application portal, and audit logs.

    For example, Terraform Cloud.

    Type 

    Set to SAML Service Provider.

    Out of Band Methods 

    Select the allowed methods end users can choose to approve MFA requests.

    For example, Arculix Mobile app (push notifications), SMS, or Security Key.

    Message for MFA Requests 

    Optional. Type a message displayed to end users when sending an MFA request via push notification, SMS, or email.

    arculix_new_app_terraform.png
  4. Select the SAML Service Provider Configuration tab, and set the following configurations:

    Issuer or Entity ID 

    The Entity ID copied earlier from Terraform Cloud.

    Log in URL 

    Same URL as Issuer or Entity ID.

    NameID Format 

    Set to Email Address.

    Name Identifier 

    Set to Email.

    ACS URL 

    The Assertion Consumer Service URL copied earlier from Terraform Cloud.

    terraform_sp_settings.png
  5. Save your changes.

Test your application integration

  1. Go to the Terraform Cloud SSO login page and enter your organization name.

    terraform_login.png
  2. You will be redirected to the Arculix SSO page.

    Application login page with email
  3. After successful authentication, select your preferred MFA method to approve access to the Terraform Cloud application.

    Select MFA method
  4. You will be redirected to your Terraform Cloud workspace.

Support

If you have questions or need assistance, contact SecureAuth Support.

Sales

Want to learn more about our MFA solutions? Contact our Professional Services for a demo today.

Disclaimer

All product names, trademarks, and registered trademarks are the property of their respective owners.

All company, product, and service names used in this document are for identification purposes only. The use of these names, trademarks, and brands do not constitute an endorsement by the SecureAuth Corporation.