AWS EC2 Process If you need help creating and connecting to an AWS EC2 instance from Windows using Putty, view this documentation: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html Aut...
Automatic Installation Download the installer for Windows (Apache) by clicking here. From the web server, right-click and Run as Administrator If you would like to change the install path, click &quo...
Installer Unavailable Curator no longer supports new installations on IIS. Instead, download the installer for Windows. NOTE: If you already have IIS installed, Curator's support team will continue to...
Find the curator.conf file (default location is C:\InterWorks\Curator\curator.conf). Locate the references in the file (listed below) and replace your new .crt, .pem, and .key files where they are re...
First, find your curator.conf file. For Ubuntu installations, this is located in /etc/apache2/sites-enabled. For all other Linux distributions, this file is located in /etc/httpd/conf.d/curator.conf...
LEGACY SYSTEMS ONLY Curator no longer supports new installations on IIS In IIS Manager, on the left-hand pane, select the server (note: not the site). On the server Home page double-click Server C...
Curator utilizes internet access to connect to Tableau Server as well as Curator's web servers for updates. When configured without outbound internet access, Curator upgrades must be performed manuall...
When installing Curator, you may wish to place Curator behind a reverse proxy or load balanced solution. Healthchecks Healthchecks should be run against the /ping route instead of simply the base / ...
Infrastructure Curator can be configured to run in a high availability (HA) infrastructure to ensure better "up time" for your users as well as handling more concurrent user load. The stand...
When using Curator to embed content from other applications (e.g. Tableau, PowerBI) Curator relies on those systems to authorize a user to see and interact with content that is embedded in Curator. ...
Provisioning Users on Okta For provisioning users with Okta, you will need to have a user created in both Okta and Tableau server - their username's must match (the "Application username format&q...
1. Server Setup If the server is not already setup for web traffic, install Apache, MySQL, PHP, and dependencies. You can do this with the commands in the setup documentation. 2. Tableau Online Setup ...
LEGACY SYSTEMS ONLY Curator no longer supports new installations on IIS For current information on how to set up Active Directory on Windows, please see our Active Directory documentation. Only use...
If you would like to use SAML for authentication with your Curator users, but do not want to use a 3rd party tool (e.g. Okta) you're in luck - you can utilize Curator as your Identity Provider (IdP)! ...
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 usern...
OneLogin Setup Go to the Applications page in the Administration area of OneLogin and click "Add App." Enter "oidc" in the search bar and select "OpenId Connect (OIDC)."...
If your Curator system is using a Curator-based authentication form, multifactor authentication is available utilizing Google Authenticator. After enabling multifactor authentication, users will be pr...
Before We Begin This is an optional step in addition to configuring Curator for SAML authentication. See these links for help configuring SAML within Curator first: Okta OneLogin AzureAD Configurin...
Web Server Setup (Apache) Find the curator.conf file (default location is C:\InterWorks\Curator\curator.conf). Un-comment the lines (by deleting the # at the front of the line) starting at LoadMod...
Curator leverages Tableau’s REST API to communicate with your Tableau Server or Tableau Online Site to retrieve data related to your reports and users, so it can display the right information to the r...
1. Server Setup Follow the steps in the Tableau Connection Setup section to get connected to your Tableau Server. 2. Connected App Setup As of the 01-04-23 Curator release, Tableau Cloud's connected a...
Curator connects to Tableau Server to verify a user's access and permissions. Sometimes, Tableau Server is configured to live behind a "Reverse Proxy". There are many reasons why this config...
Sometimes, it's difficult to establish a connection to Tableau and the reason why isn't clear. One method to help rule out bugs in Curator is to use the Postman application to directly make the API c...
Sometimes (but very rarely) you may need to connect directly to Tableau Server's repository. Generally this is recommended when your user-count is very high (5000+ users), your Tableau Server connect...
Curator supports Tableau Server version 2019.1 and on. This includes the latest version of Tableau Server as well. Due to the fact that each new version of Tableau Server includes the older versions o...
To use Tableau REST API calls we need access to a Tableau Site or Server Admin account. Curator’s API calls need a user that has high-level permissions to check another user’s permissions, access all ...
Creating an App within the Azure Portal Log in to the Azure Portal (https://portal.azure.com). Search for “App Registrations” to start the process. You will need to provide a redirect URI during thi...
Create a Service Principal with Password A service principal is needed to query your Power BI tenant to get lists of dashboards and reports, which aid in easily publishing those elements to Curator. ...
If your InterWorks Portal has the Power BI plugin (an Enterprise license is required for this plugin), you can connect it to your Power BI content by configuring the Power BI settings: Note: You will ...
If your InterWorks Portal has the ThoughtSpot plugin (an Enterprise license is required for this plugin), you can follow this guide to connect to your ThoughtSpot instance. Preparing ThoughtSpot Veri...
Install Curator using Apache installer like usual. Move central dispatch portal to subfolder of htdocs Make directory C:\InterWorks\Curator\htdocs\centraldispatch Move all other files and folders in...
Install Curator using Linux installer like usual. You can make a new directory called centraldispatch at /var/www and move the contents of the webroot (/var/www/html) there or you can leave it...
Curator allows controls related to your site design across all content types, however having a central place to modify styles that will impact every page your user visits allows you to create a standa...
Curator allows you to create unique web pages using Curator's page builder to customize the layout and content of any page on your site. This is particularly useful when creating your homepage to ens...
The title and toolbar location, for most options, are dependent upon one another for the styling of your site. While titles help your users understand where they are and what they are looking at, To...
When using Curator, you may want to surface different content to different users. You can achieve this using Curator's Group Overrides. Whether you want to show a homepage to a certain subset of use...
When adding content from your analytics environments, Curator will automatically create default template pages for you. These can be accessed via the edit page of those individual pieces of content. ...
Creating a central location to link all of the content users have access to is a breeze with Curator's tiles feature. You can bring in content that pulls across different source-systems, from Curator...
When things go wrong, you want to be sure to send the right messages to your audience. By default, Curator has error pages that will let users know when they don't have access, they visit a broken li...
Getting the Report URL In your web browser, navigate to the SSRS report you wish to embed within Curator. Once the report has loaded, copy the link in the URL bar of your browser. Adding SSRS to a Cu...
Explorer is an interactive and dynamic tile layout element that can be added in the Page Builder. It provides users the ability to search and filter displayed content. Filters utilize keywords to get ...
User Customized Metrics gives your users the ability to customize their landing page with their desired dashboards that will be displayed in a grid layout. For the best experience it’s recommended to ...
Getting the Embed Widget In your web browser, navigate to your box environment from which you wish to embed a folder within Curator. In the row of your folder, hover over the right-hand-site, click o...
Whether it's storing small data-sets from around your business, getting valuable feedback from your users, or creating a simple contact-us / request access form Curator's data manager has the web form...
When using Curator, you may need to notify your audience about udpates related to news in your business or may need to help break down important concepts, and allow those updates to be highlighted in ...
Tutorials can be used to explain how to use a page, embedded visualization, or for any other supporting documentation related to content on your Curator site. They can be shown every time a dashboard ...
The frontend search functionality helps explore your Curator content or access specific content directly without navigating through the menus. To enable search: Navigate to the backend of the system...
You can only display one top-level menu item at a time. It is recommended that you nest your entire navigation under the default 'Main Menu' parent-item or create a new "Dropdown Placeholder"...
To Create a Navigation menu item: Navigate to the backend of the system (e.g. https://www.site.com/backend). Navigate to the Content > Navigation section from the left-hand menu. Expand/collapse t...
Keywords can be associated with dashboards, pages, individual files, and menu items. These keywords can be utilized in the Search and Explorer feature when pulling in results, as well as when determin...
The system supports adding downloadable files and linking to them using the regular navigation menu process. File access can be restricted based on Groups from the Tableau Server. Search keywords are ...
Curator supports adding a text banner across the top of individual pages. These can either be created on a per-menu-item basis, or set globally to appear across every page on your site. To create a no...
Loading screens can be used to show text or animations while a dashboard is loading. To create a loading screen: Navigate to the backend of the system (e.g. https://www.site.com/backend). Log in if p...
One of the primary functions of the system is to display embedded Tableau Server views as dashboards*. *Note: Due to limitations in Tableau's JS API we do not support embedding worksheets. We recomme...
When viewing a list of dashboards, Curator has the ability to display a custom preview of the Tableau Server view as a thumbnail image. These thumbnails can either be set manually while creating or ed...
The system can automatically create dashboards for any workbooks that have a matching tag on the associated Tableau Server. It will poll the Tableau Server every 10 minutes to check for any newly tag...
Curator has the ability to mark dashboards as favorites. Favorited dashboards will show up first on the home page once the user logs in. This functionality requires any authentication method other th...
Curator allows users to subscribe to dashboards where updates to the underlying Tableau Server views will be emailed to them on a set schedule. Known Limitations There is currently a limitation in Tab...
There are multiple ways for end-users to export data from Curator. The current Dashboard data-exports all utilize Tableau's standard export functionality with some optional overrides. Check out the ...
Curator can allow users to download the Tableau workbook. To enable workbook downloads: Navigate to the backend of the system (e.g. https://www.site.com/backend). Log in if prompted. Click on the Set...
Curator can allow users to share the Tableau workbook. To enable workbook sharing: Navigate to the backend of the system (e.g. https://www.site.com/backend). Log in if prompted. Click on the Settings...
Curator can allow users to save a custom view of a dashboard, which will include any applied filters and parameters, and then load it again at a later date. To enable custom views: Navigate to the ba...
Curator can allow users to pause a dashboard so that multiple changes (e.g. applying multiple filters) can be made before the dashboard is refreshed. To enable dashboard pausing: Navigate to the back...
When viewing a dashboards via Curator, you can choose whether or not the page title is retrieved from the name you have entered in the edit-dashboard page or the name of the dashboard on Tableau Serve...
Filters are used to filter the underlying data in a dashboard. They can even be shared with more than one dashboard. To create a filter: Navigate to the backend of the system (e.g. https://www.site.c...
Parameters are used for various purposes within a dashboard. The system provides a user-friendly way to enter and change the parameter values for dashboards. Parameters can even be shared with more th...
Each Filter and Parameter gets applied as soon as their values are changed. When you have many filters and parameters, this can become time-consuming. To alleviate this issue we have created the "...
Filter Categories can group filters/parameters together under a specific category. When the dashboard filter pop out is rendered on the right side, it will group all of the filters/parameters together...
Hidden sticky filters and parameters are used to remember the filter/parameter values a user selects across the system, without showing up in the filters list on a dashboard. You can blacklist sheets ...
Curator provides the ability to get your filter options from the data. The standard dynamic filtering looks at the first worksheet loaded. However, you may have multiple data sources compromising your...
Curator can allow you to capture input from a user after they select a specific data point on your dashboard. Once you associate a Data Group with a specific field/column from your dashboard, any tim...
When a URL action gets triggered in Curator, there are different settings that allow Curator to handle these actions in a more sophisticated manner directing your users to the location they want to en...
Sometimes we have dashboards that we don't want to display on the front page or in our search results. In these cases, we can enable the Hidden switch. When hidden, the dashboard should only be access...
You can find/replace URLs in bulk. If you are modifying your overall Tableau Server Connection settings you may need to update the URL on your Tableau Server Settings or update your REST API connecti...
Some Tableau Servers have different sites with different dashboards associated with those sites. The site switcher allows a frontend user to filter the dashboards in the navigation by Tableau Site fro...
Curator has the ability to populate the filter and parameter options from the dashboard's data by using the "Get Filter Options from data". This option is normally only enabled when you have...
Data Manager allows you to create forms for users to fill out, and to store that data for retrieval later. These forms can even retrieve data-points that users click on in a Tableau dashboard to be s...
The Web Data Connector allows you to connect easily to your Data Manager tables and a few usage statistics. The Data Manager needs to be only enabled if you want to connect to your Data Manager tables...
If you already have data collected somewhere else for your form and want to bring everything together in your Curator table, use the Data Manager Batch Import option. Using Batch Import In the backen...
When using Data Manager you will likely need to connect to the underlying database that stores the data input by your users. You can find the connection information on the "Data Group" edit...
User Commenting provides the option to allow comments on individual dashboards, pages, and mixed content pages. The Data Manager must be enabled to use the "User Commenting" feature. To enab...
Preforms some formula calculations on fields like addition, subtraction, multiplication, division, and concatenate with a separator. For more on this check out our blog post. Navigate to the backend ...
The system can allow users to export one or more dashboard snapshots as a Microsoft PowerPoint or PDF presentation. This functionality requires that trusted ticket authentication is enabled and it onl...
The Scheduled Reports feature allows you to set a report to be sent out via email on a recurring schedule. This feature does require that the Report Builder and Report Builder: Email Option be turned ...
This feature allows the frontend user to email their newly created report to multiple individuals. The Report Builder Email Option requires that the Report Builder feature is enabled and that Curator ...
With Watermark Text, you can add your own custom text to the bottom left of every image exported out by the Report Builder feature. To enable the Watermark Text: Navigate to the backend of the system...
Tableau allows Administrators to manage their licences in a way that all users can be added as unlicensed and only grant them a license once they are logging into Tableau Server. You can now use this ...
JIT Provisioning on Curator When paired with externally managed authentication providers (SAML, Tableau Server, Active Directory, etc.), Curator will automatically create a user record in its own data...
Frontend Users "Frontend users" (or local Curator users) are how your various platforms are brought together for the individual frontend experiences. They are matched up by leveraging the us...
When managing users you may find a need to change a user's password on Curator. The method used to change user's passwords will depend on the authentication type you are using on Curator: when using ...
If your analytic infrastructure was built by several independent groups within your organization, it's possible that the username formats don't match across the platforms. Authenticating to each platf...
There are two different sync process that run in Curator: the user sync and the group membership sync. There used to be one sync that did both, but we found bringing over every user and group resulted...
With Tableau Cloud, and Tableau versions 2023.1 and above, you can now pass through User Attributes from Curator or your SAML IdP (e.g. Okta, Azure AD) seamlessly through to your Tableau Dashboards. ...
In order to manage permissions on Curator, there are a few different ways to control access to content - it's largely dependent upon which content type you're working with. First, we'll begin with tr...
The Password Change feature allows frontend users to reset their password through Curator. NOTE: This only works if you have chosen Curator Users or Tableau Server as your Authentication Type in the S...
Some users want the ability to reset their Tableau Server account password from Curator. The Password Reset feature can address that issue but will require some additional setup. To use this it is req...
For sites that use password change or password reset options you can now enable password expiration to force frontend users to change their passwords on a frequent basis. To further bolster security, ...
Curator will automatically check the Analytic Connection when a user logs in to determine their access. However, you can bypass this initial check and expose links to all content to your users while ...
There are a variety of places that use e-mail settings across Curator. The largest piece is the Report Builder, but you may want to also set up email to get notified when someone fills out a data-man...
To ensure you are able to easily manage your Curator instance without having to check-in all the time, you can subscribe to emails that generate from Curator's notification system. These emails will ...
Force SSL (https) will force all HTTP request to be https instead. This will require you to set up SSL certificates first before enabling the feature. Otherwise, the site will run into an issue. To en...
Curator can take advantage of trusted ticket authentication. By default, if the Tableau Server workbook views which are embedded in dashboards require a login, the user will be prompted for their user...
Basic HTTP Authentication provides a secondary browser-level authentication system. Usually used to secure non-production setups. To enable the Basic HTTP Authentication: Navigate to the backend of t...
We provide a simple manual backup process that can help with migrating your Curator content from one environment to another, or to the server as a backup so you don't lose all that hard work. NOTE: It...
Backend Administrators accounts are separate from Tableau Server users and only exist on Curator. Permissions can be customized for a backend user to allow for a range of access. New permissions becom...
If you're using Curator as the authentication source (or SAML IdP), the system will enable administrators to manage the frontend users. To enable management of frontend users: Navigate to the backend...
Adding or updating your license key is only required for new installations, or migrations that have failed to carry over your license key. Typical license keys are allowed on up to 3 instances so lon...
Curator runs regularly scheduled tasks on Linux using the web-server's cron. This takes care of things like status checks, scheduled reports, user-syncing along with a host of other very important it...
Curator needs full access to its filesystem to run correctly. Often, permissions errors can occur when elements, such as the job system, are misconfigured, or external processes, such as an antivirus ...
Forget your backend administrator password? A Curator backend administrator user's password can easily be reset by other users who have Backend User access. No one left to reset your password? If ther...
Warning If you haven't attempted to use the Curator interface to restore from a full backup, go do that now (Backend > Settings > Curator > Import/Export > Full Backup tab). This guide is...
In a recent update to Curator, we changed the structure of the logging system. In some instances, the automated update may not work due to server configuration issues. Below you'll find the steps to...
Embedding visualizations within Curator requires third party cookies to be enabled. By default Chrome and Firefox allow this but Safari does not. When you encounter this issue, the embedded visualiz...
When determining the root-cause of latency issues on Curator, using the debug mode for Curator is the fastest way to rule out a number of issues that may be causing slow loading times. This can come ...
Sometimes there are issues that are hard to diagnose without seeing exactly which API calls Curator is making to Tableau and what responses Curator is getting back from Tableau. To log all of those A...
The Import / Export is a great way to backup your Curator data but sometimes a more complete backup is needed. The Full Backup will export an entire snapshop of all your Curator data (it's a full data...
While we highly recommend using the built-in Full Backup functionality within Curator, there are times where that isn't possible or when implementing your own full backup process. This guide will cov...
There are several easy ways to update Curator. To see if Curator needs an update, check the status of your Curator instance on the homepage of the backend, or on the System Upgrade page. The "Cur...
Curator can be set up on a server that does not have access to outside networks. When you have this setup it is advised to Disable Upgrades. This will prevent any issues if someone accidentally clicks...
If you've installed Curator on a server that is cut off from internet access, we provide a Manual Update option. This requires enabling the Disable Curator Upgrades setting to be enabled so you can pe...
Need to update PHP, Apache, or MariaDB on your webserver? Curator's upstream dependencies need to be upgraded every so often as well! Windows First and foremost: ensure all relevant Windows Updates ha...
Occasionally, you may run into issues during the upgrade process. We've provided some common scenarios and how to quickly resolve them below. NOTE: While running updates, it is always a good idea to h...
You can set up custom scripts to run by the site. This requires the "Integration" setting to be enabled. To create a custom script to be run on a schedule or ad hoc: Navigate to the backend...
You can set up custom commands to run by the site. This requires the "Integration" setting to be enabled. To create a command to be run on a schedule or ad hoc: Navigate to the backend of t...
Curator integrates nicely with Tableau's native subscription system. When users receive a subscription email, however, you may not wish the users to be routed to Tableau Server. If you would rather us...
The Integration System gives you many options for interfacing programmatically with the backend. This API gives you access to the metadata behind your portal content as well as the ability to update c...
/integration/commands Returns a list of all commands Returns: array Example Response: { "result": "Success", "msg": [ { "id": 1, "name": "Test Command", ...
/portal/info Returns all information about Curator. Parameters: boolean ini Shows PHP ini settings boolean extensions Shows loaded PHP extensions Returns: array Example Response: { "version": "20...
/tableau/createDashboard Creates a dashboard record Common Parameters: title required The title of your dashboard url required This is the url of the dashboard on the Tableau Server environment. slu...
/content/createFile Creates a file model Example Usage: Python Script Parameters: file The file Returns: array Example Response: { "result": "Success", "msg": 0 } /content/createNavMenu Cre...
/user/createBackendUser Creates a backend user Returns: array /user/createFrontendGroup Creates a Frontend Group. Note: To add members to your Frontend Group, use the addUserToGroup API endpoint. Exam...
...
...
...
...
...
...
...
...
...
...
...
...
...
When installing Curator, you may wish to place Curator behind a reverse proxy or load balanced solution.
Healthchecks should be run against the /ping route instead of simply the base / route.
The base / route will often return a 302 redirect, which many load balancers view as a "down" response.
The /ping route will always return a 200 response.
When your users access Curator over the reverse proxy, specific "headers" are used to tell Curator how to process the request.
X-FORWARDED-FOR : The IP address of the end user.
X-FORWARDED-HOST : The host name of the request.
Note: A "Forced Domain" in Portal Settings->Security overrides this value.
X-FORWARDED-PROTO : Whether to use HTTPS or HTTP for routes.
Often, reverse proxy solutions are missing some or all of these headers.
To help configure a reverse proxy with Curator, Apache configuration files can be used.
On Windows, the curator.conf file is a great place for this configuration.
On Linux, /var/www/html/.htaccess, or any of the httpd.conf files can also be utilized.
SetEnv HOST "example.curator.interworks.com"
SetEnv HTTP_X_FORWARDED_HOST "example.curator.interworks.com"
SetEnv HTTPS "on"
SetEnv HTTP_X_FORWARDED_PROTO "https"
In addition to these settings, the security settings in Settings->Curator->Portal Settings->General can be used.
In particular, Forced Domain and Force SSL should be utilized to specify the domain of Curator and to use SSL.