Using Trusted Auth on Tableau Server
This article describes how you can use Trusted Auth from Metric Insights to Tableau Server. The procedure includes the following steps:
In Tableau Server you will configure Trusted Authentication. The steps for doing this are covered in this article. Trusted authentication simply means that you have set up a trusted relationship between Tableau Server and the Metric Insights. When Tableau Server receives requests from Metric Insights, Tableau assumes the credentials of the Metric Insights user.
For more detailed information on Trusted Authentication in Tableau Server, refer to the Tableau Server Administration Guide.
If the Trusted Authentication is set up at your Tableau server, you should define your Metric Insights instance's IP or Host name as "trusted".
Follow the link to get step-by-step instructions on how to do it.
1. Configure Tableau Server for Trusted Auth
To use Tableau Trusted Auth, each Username created on Metric Insights must have an identical Username in Tableau Server. For example, if you sign in with Username 'Mary Jane' in Metric Insights, then to be able to sign on to Tableau server you must also have the Username 'Mary Jane' in Tableau server.
1.1. Find IP Address of Metric Insights Instance (for Tableau Server v8.0 and prior)
For Tableau server 8.1 and beyond, you can use the fully qualified domain name of the Metric Insights instance.
For example, one way to find is from the following:
root@demo:~# ifconfig eth0 Link encap:Ethernet HWaddr inet addr:10.146.246.13
root@sandbox:~# ifconfig eth0 Link encap:Ethernet HWaddr inet addr:10.192.61.233
1.2. Configure Tableau Server for Trusted Authentication
Starting Version 2018.2+ Tableau Server on Windows includes Tableau Services Manager (TSM), which replaces the Configuration Utility and the command line tool.
- For more information, refer to Add Trusted IP Addresses or Host Names to Tableau Server
1.2.1. Tableau Version 2018.2+ (via Tableau Services Manager)
Having signed in to Tableau Services Manager:
- Click [User Identity & Access] on the Configuration tab
- Under Trusted Authentication, for each trusted host, enter the hostname or IP address and then click [Add]
- Optionally, specify Token Length value
- Save Pending Changes
- Click [Pending Changes] that appears at the top of the page
- Apply Changes and Restart
Use Tableau Server command line utilities to add Metric Insights IP address (or fully qualified domain name for Tableau server 8.1 and beyond) to the list of trusted sites.
Using Metric Insights IP address:
D:\Tableau\Tableau Server\10.1\bin> .\tabadmin.bat set wgserver.trusted_hosts "10.146.246.13, 10.192.61.233" D:\Tableau\Tableau Server\10.1\bin> .\tabadmin.bat config D:\Tableau\Tableau Server\10.1\bin> .\tabadmin.bat restart
Using Metric Insights fully qualified domain name:
D:\Tableau\Tableau Server\10.1\bin> .\tabadmin.bat set wgserver.trusted_hosts "mi-dev.mycompany.com, mi-prod.mycompany.com" D:\Tableau\Tableau Server\10.1\bin> .\tabadmin.bat config D:\Tableau\Tableau Server\10.1\bin> .\tabadmin.bat restart
1.3. Verify Trusted Auth from Metric Insights for the User
From Metric Insights server, run a command line utility to confirm trusted authentication to Tableau server. Use a username that exists on Tableau server. For example, 'admin'
curl -k -dusername=admin https://tableau-test.metricinsights.com/trusted/ curl -3 -k -dusername=admin https://tableau-test.metricinsights.com/trusted/ curl -ssl -k -dusername=admin https://tableau-test.metricinsights.com/trusted/
In the curl request, supply the username (e.g., 'admin') and the url of Tableau server (e.g., https://tableau-test.metricinsights.com/trusted/). Any of the above curl request arguments should work.
The above curl request returns -1 from Tableau server if not trusted, and returns non-negative ticket value if trusted. For example,
root@sandbox:~# curl -3 -k -dusername=admin https://tableau-test.metricinsights.com/trusted/ -1
root@sandbox:~# curl -3 -k -dusername=admin https://tableau-test.metricinsights.com/trusted/ Co_GwPDEfUzAuj1mDO2MH-FE
1.4. Enable Variable ALLOW_TRUSTED_SERVER_USERNAME_OVERRIDE
Assign the "Y" Value to the ALLOW_TRUSTED_SERVER_USERNAME_OVERRIDE variable to let MI Users be mapped to licensed Tableau Users.
2. Configure Metric Insights for Tableau Trusted Auth
The following steps show how to configure Metric Insights for Trusted Auth
2.1. Add External Report Type for Tableau Trusted Auth
Access Admin>Advanced>External Report Types
- In the Report Type field choose Add New Report Type from the drop-down list.
- Then choose Tableau Single-Sign in the Drill-Down Authentication field.
NOTE: If you already have an existing External Report Type defined for Tableau, you can enable authentication for all reports associated with this type by modifying the Drill Down Authentication setting to Tableau Single-Sign.
Alternatively, you can do this while creating a new External Report (the procedure is described Create a new External Report Type)