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:
- Log in as an administrator and select Cog menu > Manage apps.
- Select Advanced Tables under the BOB SWIFT CONFIGURATION section in the sidebar.
The following configuration options are available:
| 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.
This parameter is not applicable for the Attachment Table macro.
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:
|Help us improve the product||Enable 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 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:
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 type||Specify whether this is a URL, GitLab, or GitHub profile.|
|URL||Enter the URL to be accessed. If the Profile type is either GitLab or GitHub, a default URL is displayed here that is editable.|
|User; Password||Enter the username and password to access the specified URL.|
|Access token||Applicable for GitLab and GitHub URLs. Administrators must generate the access tokens from either the GitLab or GitHub applications and enter that here.|
|URL parameters||Mention any extra parameters that must be appended to the URL here. |
|Request headers||Displays 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.