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).
Download the SAML metadata and certificate for your organization from Arculix.
Metadata download:
https://sso.acceptto.com/<myorganization>/saml/download/metadataView metadata:
https://sso.acceptto.com/<myorganization>/saml/metadataCertificate download:
https://sso.acceptto.com/<myorganization>/saml/download/certLog in to Terraform Cloud as an administrator and navigate to your organization and click Settings.
Click SSO and select Setup SSO.
Select SAML and click Next.
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.
Save your changes.
Test your configuration. Verify your configuration and click Enable.
If you have completed an Arculix (formerly Acceptto) SAML configuration before, you can click Test.
Copy the Entity ID and ACS of Terraform Cloud to use in the Arculix SAML configuration.
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.
Log in to Arculix with an administrative account and go to Applications.
Click Create New Application.
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.
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.
Save your changes.
Test your application integration
Go to the Terraform Cloud SSO login page and enter your organization name.
You will be redirected to the Arculix SSO page.
After successful authentication, select your preferred MFA method to approve access to the Terraform Cloud application.
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.