Configure Active Directory Federated Services

Learn how to configure ADFS to work with ThoughtSpot.

You can configure Active Directory Federated Services (ADFS) to work with ThoughtSpot.

Prerequisites

Before you configure ADFS, complete these prerequisites.

  1. Configure SAML in ThoughtSpot.

  2. Install ADFS 2.0. ThoughtSpot supports ADFS 3.0, but recommends ADFS 2.0.

  3. Make sure you can run ADFS 2.0 Federation Server Configuration Wizard from the ADFS 2.0 Management Console.

  4. Make sure that the DNS name of your Windows Server is available at your service provider (SP) and vice versa. You can do this by running the command nslookup in the command line on both machines, supplying the DNS of the other server. The syntax is nslookup [HOST] [SERVER]. Replace HOST and SERVER with your specific information.

     $ nslookup [HOST] [SERVER]

ADFS 2.0 supports SAML 2.0 in IDP (Identity Provider) mode and can be easily integrated with the SAML Extension for both SSO (Single Sign-On) and SLO (Single Log Out).

Step 1: Initialize IDP metadata

  1. Download the IDP metadata Download the ADFS 2.0 IDP metadata from the ADFS server. You can reference this file by its URL:

     https://<adfsserver>/FederationMetadata/2007-06/FederationMetadata.xml
  2. SSH into your cluster Log in to the Linux shell using SSH.

     $ ssh admin@<cluster-IP>
  3. Change directories to the SAML directory

     $ cd /usr/local/scaligent/release/production/orion/tomcat/callosum/saml
  4. Update the metadata Replace the contents of the file idp-meta.xml with the metadata of the IDP that you downloaded. Do not change the name of the file.

  5. Restart Tomcat Contact ThoughtSpot Support^ for help restarting ThoughtSpot’s Tomcat instance.

Step 2: Initialize the Service Provider metadata

1: Import metadata

  1. Open the ADFS 2.0 Management Console.

  2. Select Relying Party Trusts  Add Relying Party Trust.

  3. Select Import data about the relying party from a file.

  4. Upload the metadata.xml file that you downloaded from ThoughtSpot earlier.

  5. Select Next.

    • There may be a warning that some of the content of the metadata is not supported. You can safely ignore this warning.

2: Edit claim rules

  1. In the Ready to Add Trust section, make sure that the tab endpoints contain multiple endpoint values.

    • If not, verify that your metadata was generated with the HTTPS protocol URLs.

  2. Ensure that the Open the Edit Claim Rules dialog checkbox is checked.

  3. Click Next.

  4. Select Add Rule.

  5. Choose Send LDAP Attributes as Claims.

  6. Click Next.

  7. For NameID enter the name of your claim rule.

  8. For Attribute store, choose "Active Directory".

  9. For LDAP Attribute, choose "SAM-Account-Name".

  10. For Outgoing claim type, choose "Name ID".

    • If you are using ADFS 3.0, you might need to configure the Name ID as a Pass Through claim.

  11. Finish the wizard.

  12. Confirm that all information is correct in the claim rules window.

3. Specify your level of security

  1. Open the provider by double-clicking it.

  2. Select the Advanced tab.

  3. Under Secure hash algorithm, choose "SHA-256".

    • If you have trouble with SHA-256, try SHA-1 instead.

You can now use ADFS.

Step 3: Test your ADFS integration

After setting up the ADFS integration, make sure it works properly. To test your ADFS integration, go to the ThoughtSpot login page using a Web browser and try to login with SAML.