rjhong / tableau-trusted-authentication-api

This work is to modularize the Trusted Authentication work for Tableau Server, save your time for ticket exchanging!

tableau_trusted_authentication_api

Introduction

This work is to simplify the Trusted Authentication work for Tableau Server by Node.js.

What's Tableau ? Tableau is one of well known Business Intelligence Tools.
More Info

Trusted Authentication is a Single-Sign-On method for user to retrieve views (so call viz) from Tableau Server to a Web Server using HTTP/HTTPS protocols. No matter your Web Server is built by which programming languages, as long as the program can use HTTP/HTTPS protocols you can do Trusted Authentication. In this case I use Node.js.

Begin works

First, you need to have a Tableau Server, then make some configurations on Tableau Server side. eg: tell Tableau Server to trusted your Web Server ...etc, you can either use TSM CLI or TSM web interface.

tsm authentication trusted configure -th "<trusted IP addresses or host names>"
tsm pending-changes apply

References about this setup.

Additionally, there is one thing to know, Tableau Trsuted Authentication has a default restriction, which is :

• if using this way to implement Single-Sign-On, user can only access views only. If you want to access whole Tableau Server resources, use tsm configuration set to disable this restriction as follows :

This step is optional and not recommended!

tsm configuration set --key wgserver.unrestricted_ticket --value true
tsm pending-changes apply

How to use tableau_trusted_authentication_api

• the prerequisite is to install node.js.
• Clone this project to your local file.
• Run the following command.

cd /to_project_directory/
npm install
node app.js

You will see the following output :

Listening at port : 8080

Start using it!

Open you browser, navigate to ###http://localhost:8080/home/ It will looks like the this...

tableau-trusted-authentication-api's Issues

Tableau Service Management vs Tableau Server

I am a beginner of Tableau.
I have gone through the Trusted Authentication on Tableau online help.

But I found that to add the web server IP address to https://tsm-computer-name:8850.
And I found that Tableau Server domain and Ip address are also required.

So I just want to know the following questions.

Are Tableau Server and Tableau Service Management on different computers?
If so, where should TSM be installed?
How do I create a TSM credential (admin)?