Removal notice
Please note that the URL user and URL user password parameters were removed (see Deprecation notice: URL user and URL user password parameters). We recommend using profiles to access external data.
After migrating or installing HTML for Confluence, navigate to the Global Configuration screen:
- Log in as a System Administrator with global permission.
- Navigate to
> Settings > Atlassian Marketplace on the sidebar. - Click HTML Configuration to manage the app configuration.
The configuration settings are categorized into three tabs:
Global configuration
Use the toggle to enable or disable the Global Configuration settings.
| Parameter | Description |
|---|---|
| Restrict URL access | This parameter controls whether or not the URL parameter on the HTML for Confluence macro must conform to the allowlisted URLs. Administrators can turn on the Allowlist to restrict access to URLs configured in the Allowlist settings. If enabled, the URL parameter in the app is restricted to only the URLs available in the Allowlist tab. |
| Allow JavaScript | This option controls the usage of Javascript in the HTML macro. When enabled, the user can use Javascript in the HTML and vice versa. |
| Help us improve the product | Enabling this option reports usage data that helps us improve the app continually. The app does not send any private user data or personally identifiable information. To learn more about what is being sent, refer to Analytics data. |
Allowlist
Manage the URLs that the app can access from this page. If the Restrict URL access option is enabled, the app is restricted to allow the specified URLs only.
| Parameter | Description |
|---|---|
| Expression | Enter a URL or an expression here. |
| Type | Select a type from the following list:
|
You can perform the following actions on this page:
- Add the URL after specifying the Expression and Type.
- Update after modifying the details. Select the Expression to enable editing of the URL.
- Delete to remove the URL.
- Save after adding or modifying any URL in the list.
Profiles
Profiles consist of a common set of parameters that allow users to choose a profile in the macros. 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.
The page displays a list of profiles available for the macros. Click Add Profile to open a pop-up window as:
| Parameter | Description |
|---|---|
| Profile name | Enter a name for the profile. |
| Profile type | Displays URL as selected, by default. |
| URL | Enter the URL to be accessed. |
| User; Password | Enter the user name and password to access the specified URL. |
| Access token | Enter the access token to access the specified URL, if needed. Administrators must generate the access tokens from applications, if required, and enter that here. |
| URL parameters | Mention any extra parameters that must be appended to the URL here. |
| Request headers | Displays the request header(s) 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.
