# Tableau

The following guide will walk you through how to set up a Tableau connector in the Datalogz Control Tower using the **personal access token** method for authentication. [This is Tableau's recommended method for authentication to the Tableau REST API without requiring hard-coded credentials or user interactive sign-in.](https://help.tableau.com/current/server/en-us/security_personal_access_tokens.htm)

### Setup Overview

Below is the order of operations for completing the Tableau connector setup

1. Create a Tableau personal access token
2. Create a Tableau connector in Datalogz Control Tower

### Prerequisites

{% stepper %}
{% step %}

### Generate a Tableau personal access token

1. Follow the steps outlined [here](https://help.tableau.com/current/pro/desktop/en-us/useracct.htm#create-a-personal-access-token) on generating a personal access token

**Note**: We recommend to use a Site Administrator Creator user for the personal access token (PAT). If this is not available, please check the supported licenses and roles [here](https://docs.datalogz.io/guides/organizational-setup/platform-connectors/tableau/tableau-roles-and-licenses).

There are several pieces of information required from your Tableau host to complete the next steps.

1. Host URL
   1. This is everything after `https://` but before `/#/`
      1. Example: https\://<mark style="background-color:green;">**prod-useast-a.online.tableau.com**</mark>/#/site/...
2. Site Name
   1. This everything after `/site/` but before `/home`&#x20;
      1. Example: ...tableau.com/#/site/<mark style="background-color:green;">**mysite**</mark>/home
3. API Version
   1. This [table](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm#version_and_rest) identifies which version of Tableau Server and Cloud correspond to the supported version of the ReST API.
4. Personal Access Token Name
   1. This will be the name you specified in the creation of the personal access token above.
5. Personal Access Token Secret
   1. This will be the value generated as the **Secret**

**Note:** The steps above will need to be repeated for each additional site as connectors are site specific.
{% endstep %}

{% step %}

### Create a Tableau connector in the Datalogz Control Tower

1. [Log in to your Datalogz account](https://app.datalogz.io/#/auth/signin)
2. [Navigate to your organizations connectors](https://app.datalogz.io/#/organization/connectors)
3. [Select New Connector](https://app.datalogz.io/#/organization/connectors/new)
4. [Select Tableau](https://app.datalogz.io/#/organization/connectors/new/tableau)
5. Enter the following information obtained in the previous steps
   1. **Host**
   2. **Site Name**
   3. **API Version**
   4. **Access Token Name**
   5. **Access Token Secret**
6. Click **Connect**
7. Enter a **Connector Name**
8. Select the snapshot frequency, e.g., **Weekly** or **Daily**
9. Click **Next**
10. Click **Confirm and Finish**
    {% endstep %}
    {% endstepper %}

For questions or assistance with this setup, please contact Datalogz support <support@datalogz.io>