After installing or updating the app, as an admin you can configure the app settings in the Global Configuration screen (available since version 8.0.0).

To navigate to the screen:

  1. Log in as an administrator and select Cog menu  > Manage apps.
  2. Select Advanced Tables under the BOB SWIFT CONFIGURATION section in the sidebar.

The following configuration options are available:

Global Configuration

ParameterDescription
Restrict URL access

Enable this option to restrict access to remote locations specified in the URL parameter of the CSV Table and JSON Table macros must conform to the Confluence Allowlist; provided, the allowlist is enabled.

Confluence allows the administrator to turn on the allowlist to restrict incoming and outgoing connections to only those connections that are configured in the Allowlist settings. If enabled, the URL parameter of the CSV Table and JSON Table macros are also restricted to only URLs that are configured in the Allowlist settings for Confluence only.

Allow JavaScript

Enable this option to allow execution of JavaScript within the Advanced Tables for Confluence macros. Available since version 8.3.0. 

This parameter is not applicable for the Attachment Table macro.

You can also control JavaScript usage on pages that are using the Advanced Tables for Confluence macros by enabling the relevant entries in the Macro Security for Confluence Configuration page. Refer to Macro Security Configuration to understand how to enable macros.

Show JavaScript warning

Enable this option to display the warning message if the macro contains JavaScript content. To hide the warning message disable this option. Available since 8.5.0.

This option is available only if Allow JavaScript is disabled.

If Allow JavaScript option is disabled, and the macro contains JavaScript content, the JavaScript code is removed, and the macro renders the remaining content on the Confluence page. In such a case:

  • If the Show JavaScript warning option is enabled then, a warning message "JavaScript use in the macro is disallowed by your Confluence administrator and has been removed from the page. Please see your Confluence administrator for additional details." is displayed.
  • If an administrator has restricted JavaScript through Macro Security, then the warning message "JavaScript use in the macro is restricted by your Confluence administrator at Macro Security hence it has been removed from the page. Please see your Confluence administrator for additional details." is displayed.
Blacklist domains

Enable this option to blacklist certain domains. By default, this option is disabled for backward compatibility. Available since version 8.1.0.

If enabled, and if a request from any of these sites is received, an error message is displayed. However, if users still need to access a blacklisted site, they must contact their system administrator to disable this option. 

If this option is disabled, access to all domains is permitted!

Click the link named listed (in the description beneath the option) to view a pre-defined list of the most commonly blacklisted domains in a pop-up window. The following sites are blacklisted, by default:

  • 10.0.0.0/8
  • 100.64.0.0/10
  • 127.0.0.0/8
  • 169.254.0.0/16
  • 172.16.0.0/12
  • 192.168.0.0/16
  • 192.0.0.0/24
  • 198.18.0.0/15
  • 255.255.255.255/32
  • 0.0.0.0/32
  • 192.0.2.0/24
  • 192.88.99.0/24
  • 198.51.100.0/24
  • 203.0.113.0/24
  • 224.0.0.0/4
  • 240.0.0.0/4
Help us improve the productEnable this option to report usage data that helps us to improve the app continually. The app does not send any private user data or personally identifiable information. To learn more about what is shared, refer to Analytics data.

Profiles

Profiles consist of a common set of parameters that allow users to choose a profile in the macros. Available since 8.1.0. Some advantages of using profiles are:

  • Profiles allow user authentication required by some URLs to be hidden from page viewers and editors. Only Confluence administrators have access to this information.
  • Enables macro editors to quickly configure the macro by reusing a shared definition for URL access. 
  • Relative addressing can be used making the page content less likely to require changes when base URLs are relocated. 
    • Macro configured URL (that is not a full URL) is appended to the profile provided URL.

As only the CSV Table and JSON Table macros have the ability to access external data through URLs, profiles can be used only in these macros.

The page displays a list of profiles available for the macros. Click Add Profile to open a pop-up window as:

ParameterDescription
Profile name

Enter a name for the profile.

This name must be unique; else, the details specified overwrites the details of the existing profile. This may cause errors in pages where the profile is used.

Profile typeSpecify whether this is a URL, GitLab, or GitHub profile.
URLEnter the URL to be accessed. If the Profile type is either GitLab or GitHub, a default URL is displayed here that is editable.
User; PasswordEnter the username and password to access the specified URL.
Access tokenApplicable for GitLab and GitHub URLs. Administrators must generate the access tokens from either the GitLab or GitHub applications and enter that here.
URL parametersMention any extra parameters that must be appended to the URL here. 
Request headersDisplays the request headers created as per the given information.

You can perform the following actions on this page:

  • Click  to edit the profile details.
  • Click  to remove the profile.
  • Click Save profile to create the profile.