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 to authenticate users 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.

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

Prerequisites

  • An Acceptto account with a configured Identity Provider and LDAP Agent.

    For more information, see the LDAP Agent deployment guide.

  • A Terraform Cloud user account with administrative access.

  • A user with administrative privileges for the Acceptto Cloud dashboard.

Configure Terraform as a Service Provider

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

    Metadata Download at https://sso.acceptto.com/<myorganization>/saml/download/metadata or view at https://sso.acceptto.com/<myorganization>/saml/metadata

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

  2. Login to Terraform as an administrator and navigate to your organization and click on Settings.

  3. Click on SSO and select Setup SSO.

  4. Choose SAML and click Next.

    terraform_setup_sso.png

  5. 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.

    terraform_idp_config.png

  6. Select Save Settings. You can click on the Test button to test your configuration if you have completed an Acceptto SAML Configuration before. Verify your configuration and click on Enable.

  7. Copy Entity ID and ACS of Terraform to use for Accepto Configuration in the next section.

    terraform_entity_id.png

Acceptto SAML Configuration as Identity Provider (IdP)

  1. Login to the Acceptto Dashboard with an administrative account and go to the Applications.

  2. Create a new application by clicking Create New Application.

    Create new application

  3. In the New Application form, enter the following values under the General tab.

    • Name - The application name displayed in the admin panel and application portal and used for push notifications and audit logs (e.g. Terraform).

    • Type - Select "SAML Service Provider" from the options.

    • Out of Band Methods - Select the allowed methods for approving MFA requests

    • Message for MFA Requests - Enter the user-facing message for Push, SMS, and email MFA requests (optional)

    terraform_add_app.png

  4. Under the SAML Service Provider Configuration tab, enter the following values:

    • Issuer or Entity ID – The Issuer/EntityID of Terraform that was copied before.

    • Sign in URL - Same as Issuer or Entity ID.

    • NameID Format - Email Address.

    • Name Identifier - Email.

    • ACS URL - The Assertion Consumer Service URL of Terraform that was copied before.

    terraform_sp_settings.png

  5. Click on Save.

Test your application integration

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

    terraform_login.png

  2. You will be redirected to the Acceptto SSO page.

    SSO login

  3. After successful authentication, you’ll see the Acceptto MFA options. Select your desired method.

    Select MFA method

  4. Finally, 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.

In this section: