Last Modified Date: 09 Dec 2022
Environment
- Tableau Server
- Tableau Cloud
Resolution
Option 1
For Tableau Server on Windows 2018.2 and newer versions and Tableau Server on Linux
Add URL protocol schemes to the safe list by using the tsm configuration set command. The schemeshttp
, https
, gopher
, news
, and mailto
are whitelisted by default. This command can contain multiple comma and space-separated values enclosed by double quotes, as in this example:
tsm configuration set -k vizqlserver.url_scheme_whitelist -v scheme1, scheme2
The values you specify overwrite previous settings (excluding the default settings). Therefore, you must include the full list of schemes in the set
command. (You cannot amend the list of schemes by running the set
command repeatedly.)
The list should consist of schemes - such as mailto, file, or javascript - rather than individual urls. The following command is not valid:
- tsm configuration set -k vizqlserver.url_scheme_whitelist -v f
ile:\\pathtomyfilehere
For example, to whitelist the >file
protocol:
- On the computer running Tableau Server, open the Command Prompt window as an administrator and navigate to the Tableau Server bin directory:
- At the command prompt, run the following commands in order:
- tsm stop
- tsm configuration set -k vizqlserver.url_scheme_whitelist -v file
- tsm pending-changes apply
tsm start
Important: Only Internet Explorer allows the use of the file protocol. Chrome and Firefox block the file protocol for security reasons and whitelisting this protocol in Tableau Server cannot force Chrome or Firefox to allow the file protocol.
For Tableau Server on Windows 2018.1and older versions
Add URL protocol schemes to the safe list by using the tabadmin set command. The schemes http
, https
, gopher
, news
, and mailto
are whitelisted by default. This command can contain multiple comma and space-separated values enclosed by double quotes, as in this example:
tabadmin set vizqlserver.url_scheme_whitelist "scheme1,scheme2"
The values you specify overwrite previous settings (excluding the default settings). Therefore, you must include the full list of schemes in the set
command. (You cannot amend the list of schemes by running the set
command repeatedly.)
The list should consist of schemes - such as mailto, file, or javascript - rather than individual urls. The following command is not valid:
tabadmin set vizqlserver.url_scheme_whitelist file:\\pathtomyfilehere
For example, to whitelist the file protocol:
- On the computer running Tableau Server, open the Command Prompt window as an administrator and navigate to the Tableau Server bin directory:
- On a 32-bit computer:
cd "C:\Program Files\Tableau\Tableau Server\[version]\bin"
- On a 64-bit computer:
cd "C:\Program Files (x86)\Tableau\Tableau Server\[version]\bin"
- On a 32-bit computer:
- At the command prompt, run the following commands in order:
tabadmin stop
tabadmin set vizqlserver.url_scheme_whitelist file
tabadmin config
tabadmin start