1. Curator Styles

    2. Homepage

    3. Titles and Toolbars

    4. Group Overrides

    1. Pages Overview

    2. Tiles

    3. SSRS Embedding

    4. Explorer

    5. User Customized Metrics

    6. Error Pages

    1. Tutorials

    2. Search

    3. Managing Menus

    4. Menu Items

    5. Keywords

    6. Files

    7. Notices

    8. Loading Screens

    1. Embedded Tableau Server Views

    2. Thumbnails

    3. Tagged Workbooks

    4. Favorites

    5. Email Subscriptions

    6. Data Export

    7. Download Workbook

    8. Share Workbook

    9. Custom Views

    10. Pause/Resume Changes

    11. Dashboard Titles

    1. Filters

    2. Parameters

    3. Apply Button

    4. Filter Categories

    5. Hidden Sticky Filters/Parameters

    6. Specify Filter Sheet

    7. Mark Commenting

    8. URL Action Overrides (Link Target)

    9. Hidden Dashboards

    10. Replace Dashboard URLs

    11. Site Switcher

    12. Cache Filter/Parameter Options

    1. Data Manager Basics

    2. Web Data Connector (WDC)

    3. Connecting to Data Manager

    4. User Commenting

    5. Field Calculations

    1. Overview and Enabling

    2. Report Builder: Email Option

    3. Report Builder: Watermark Text

    4. Report Builder: Scheduled Reports Option

    1. Automatic License Provisioning

    2. Just-in-time (JIT) Provisioning

    3. Users and Groups

    4. Reset User's Password

    5. User Sync and Membership Sync Overview

    6. Custom Attributes

    1. Frontend User Permissions

    2. Password Change

    3. Password Reset

    4. Password Expiration and Complexity

    5. Bypass Link-preview Security

    1. E-mail Configuration

    2. System Notifications

    1. Force SSL

    2. Trusted Tickets

    3. Basic HTTP Authentication

    1. Import / Export

    2. Backend Users

    3. Frontend Users

    4. Updating License Key

    5. Linux: Cron Troubleshooting

    6. Filesystem Permissions

    7. Backend Administrator Password Reset

    8. Dependency Updates

    9. Updating Curator Logging

    10. Third Party Cookies

    11. Troubleshooting Load Times

    12. Manual Restoration of Curator Backup

    13. Curator Backup

    14. Taking a Manual Full Backup

    1. System Upgrade

    2. Disable Curator Upgrades

    3. Offline Upgrades (Airgapped)

    4. Troubleshooting Upgrades

    1. Scripts

    2. Commands

    3. Subscription Routing

    1. Curator API Overview

    2. Integration

    3. Curator API

    4. Tableau API

    5. Content

    6. User API

    1. Username Mapping

Setup: Authentication

Azure AD (SAML)

Provisioning Users on Azure AD

For provisioning users with Azure AD, you will need to have a user created in both Azure AD and Tableau server - their username's must match (the "Application username format" step in #4 below).

Once the user logs in, their username in Azure needs to match exactly the username of a user on Tableau Server.

1. Curator Setup

If you have not installed Curator you can do this with the commands in the Installation documentation.

Also ensure you have connected to your Tableau Server instance following the Tableau Server connections steps.

2. Tableau Setup

Tableau Online
Tableau has excellent documentation on connecting Azure AD to Tableau Online. https://help.tableau.com/current/online/en-us/saml_config_azure_ad.htm

Make sure to follow the additional setup steps in the Tableau Online documentation.

Tableau Server
To ensure that after a user signs in to SAML via Curator they do not have to re-sign in to the embedded Tableau Server dashboard:

On your Tableau Server run the command below:

tsm configuration set -k wgserver.saml.iframed_idp.enabled -v true

Next, either run:

tsm pending-changes apply
tsm restart

Or open TSM in your browser and click Pending Changes at the top of the page then click 'Apply Changes and Restart'.

3. Azure App Creation

Note: This will be in addition to the one you already setup for Tableau

Create your Azure App

  1. Login to https://portal.azure.com
  2. In the search bar search for "Azure Active Directory" and click the result that matches from the result list.
  3. From the left-hand menu click "Enterprise Applications"
  4. Click "Create a new application"
  5. Click the "+ Create your own application"
  6. Enter a name for your app and select the non-gallery option (We recommend the name "Curator" but you can pick another name)
  7. Click "Create"

4. Azure to Curator Configuration

Import Curator Metadata to your Azure App

  1. Login to the backend of your Curator instance (e.g. https://www.site.com/backend)
  2. Navigate to the Settings > Security > Authentication Settings section from the left-hand menu.
  3. Change the "Authentication Type" to SAML
  4. This will expose two buttons, click the "Download SAML Metadata" button, and save the file somewhere you can soon retrieve.
  5. Return to the app you created in the steps above in the Azure portal, and from the left-hand navigation click "Single sign-on".
  6. At the top click "Upload metadata file" and upload the file you downloaded from Curator in step #4 here.

Import Azure Metadata to your Curator Instance

  1. Continuing from the steps above, while still on the same page find the section of the page titled "SAML Signing Certificate" and click the "Download" link next to Federation Metadata XML
  2. Save this file.
  3. Click the "Import SAML Metadata" button and follow the steps to upload the file downloaded in step #7.
  4. After the file is uploaded, ensure your Authentication Type is still set to SAML and re-save your settings.

Troubleshooting Attributes and Claims In many cases you will need to adjust the "Attributes and Claims" section on your app by adding a new claim with the name "username". If you see an error on logging in after setting up saying "User [username] not found" the [username] is what Azure is sending to Curator. That must match exactly the username found on Tableau Server.

Note: If you have already created a Tableau app in Azure and your authentication is running successfully, then simply ensure the Attributes and Claim and configuration of your Curator app matches exactly the setup you have for your Tableau app.

Troubleshooting Tableau Login If a Tableau login button appears where a dashboard should be after configuring SAML, be sure to follow the steps to enable iFrame embedding in the following document: https://help.tableau.com/current/online/en-us/saml_config_okta.htm#optional-enable-iframe-embedding