---
title: "Configuration - Cloud"
canonical: "https://support.appfire.com/space/HTML/70616968/Configuration%20-%20Cloud"
format: markdown
---
> Macro (aura-html)

<span style="color: #000000">After</span> [migrating](https://appfire.atlassian.net/wiki/x/zoc1B) or [installing](https://appfire.atlassian.net/wiki/x/_4g1B) <span style="color: #000000">*HTML for Confluence*</span><span style="color: #000000">, navigate to the Global Configuration screen:</span>

1. <span style="color: #000000">Log in as a </span><span style="color: #000000">**System Administrator**</span><span style="color: #000000"> with </span>[global permission](https://confluence.atlassian.com/doc/global-permissions-overview-138709.html).
2. <span style="color: #000000">Navigate to</span> > Macro (inline-media-image)

 <span style="color: #000000">***> Settings > Atlassian Marketplace***</span><span style="color: #000000">* *</span><span style="color: #000000">on the sidebar.</span>
3. <span style="color: #000000">Click</span><span style="color: #000000">* HTML Configuration*</span><span style="color: #000000"> to manage the app configuration.</span>

<span style="color: #000000">The configuration settings are categorized into the following tabs:</span>

- <span style="color: #000000">[Global configuration](https://appfire.atlassian.net/wiki/x/iIc1B#Configuration-Cloud-HTML_Cld_GlobalConfig)</span>
- <span style="color: #000000">[Allowlist](https://appfire.atlassian.net/wiki/x/iIc1B#Configuration-Cloud-HTML_Cld_Whitelist)</span>
- <span style="color: #000000">[Profiles](https://appfire.atlassian.net/wiki/x/iIc1B#Configuration-Cloud-HTML_Cld_Profiles)</span>

## > Macro (anchor)

<span style="color: #000000">Global Configuration</span>

<span style="color: #000000">Use the toggle to enable or disable the Global Configuration settings.</span>

![The Global Configuration page in HTML for Confluence](media://a517ae40-ab9c-45aa-9c22-28ec2ba6c2a7)


| **Parameter** | **Description** |
| --- | --- |
| > Macro (anchor)

<span style="color: #000000">*Restrict URL access*</span> | <span style="color: #000000">This parameter controls whether or not the URL parameter on the </span><span style="color: #000000">*HTML for Confluence*</span><span style="color: #000000"> macro must conform</span> <span style="color: #000000">to the allowlisted URLs. Administrators can turn on the Allowlist to restrict access to URLs configured in the </span><span style="color: #000000">[Allowlist settings](#Configuration-Cloud-HTML_Cld_Whitelist)</span><span style="color: #000000">. </span><br><span style="color: #000000">If enabled, the </span><span style="color: #000000">*URL*</span><span style="color: #000000"> parameter in the app is restricted to only the URLs available in the </span><span style="color: #000000">*Allowlist*</span><span style="color: #000000"> tab.</span> |
| *Enable strict allowlist* | <span style="color: #1d1c1d">This option will apply the URL </span><span style="color: #000000">[Allowlist](#Configuration-Cloud-HTML_Cld_Whitelist)</span><span style="color: #1d1c1d"> to all content in the HTML content. Note that this feature disables any nested iframes and does not support allowlist entries with regular expressions.</span><br>> ⚠️ <span style="color: #003300">The </span><span style="color: #003300">*A*</span>*llowlist *is shared between Appfire and/or Bob Swift applications. |
| <span style="color: #000000">*Allow JavaScript*</span> | <span style="color: #000000">This option controls the usage of Javascript in the </span><span style="color: #000000">*HTML*</span><span style="color: #000000"> macro. When enabled, the user can use Javascript in the HTML and vice versa.</span> |

## > Macro (anchor)

<span style="color: #000000">Allowlist</span>

<span style="color: #000000">Manage the URLs that the app can access from this page. If the </span><span style="color: #000000">*[Restrict URL access](#Configuration-Cloud-HTML_Cld_GlobalConfig_RestrictURL)*</span><span style="color: #000000"> option is enabled, t</span><span style="color: #000000">he app</span><span style="color: #000000"> is restricted to allow the specified URLs only.</span>

![The Allowlist fields in the HTML configuration page.](media://891ff88c-8fbb-4e07-9a51-30f4dccff420)


| <span style="color: #000000">**Parameter**</span> | <span style="color: #000000">**Description**</span> |
| --- | --- |
| <span style="color: #000000">*Expression*</span> | <span style="color: #000000">Enter a URL or an expression here.</span> |
| <span style="color: #000000">*Type*</span> | <span style="color: #000000">Select a type from the following list:</span><br>- <span style="color: #000000">*Domain name *</span><span style="color: #000000">- allows URLs of a specific domain. Example: </span>`https://www.example.com/`
- <span style="color: #000000">*Exact match *</span><span style="color: #000000">- allows only the specified URL. Example: </span>`https://www.example.com/thispage`
- <span style="color: #000000">*Wildcard expression *</span><span style="color: #000000">- allows all matching URLs. Use * as a wildcard character to replace one or more characters. Example: </span>`https://*example.com`
- <span style="color: #000000">*Regular expression *</span><span style="color: #000000">- allows all URLs matching the specified regular expression. Example: </span>`http(s)?://www\.example\.com`<span style="color: #000000"> </span>  
<span style="color: #000000">Refer to</span> [this Wikipedia article](https://en.wikipedia.org/wiki/Regular_expression) <span style="color: #000000">for more information about regular expressions or see the </span><span style="color: #000000">[regular expressions tutorial](https://appfire.atlassian.net/wiki/x/JIE1B)</span><span style="color: #000000">.</span> |

<span style="color: #000000">You can perform the following actions on this page:</span>

- <span style="color: #000000">**Add**</span><span style="color: #000000"> the URL after specifying the </span><span style="color: #000000">*Expression*</span><span style="color: #000000"> and </span><span style="color: #000000">*Type*</span><span style="color: #000000">.</span>
- <span style="color: #000000">**Update**</span><span style="color: #000000"> after modifying the details. Select the </span><span style="color: #000000">*Expression*</span><span style="color: #000000"> to enable editing of the URL.</span>
- <span style="color: #000000">**Delete**</span><span style="color: #000000"> to remove the URL.</span>
- <span style="color: #000000">**Save**</span><span style="color: #000000"> after adding or modifying any URL in the list.</span>

## > Macro (anchor)

<span style="color: #000000">Profiles</span>

<span style="color: #000000">Profiles consist of a common set of parameters that allow users to choose a profile in the macros. Some advantages of using profiles are:</span>

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

![The Profiles tab on the HTML Configuration page.](media://ac7e793c-cd4f-4905-a00e-b4cced34ceb8)

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

![Image shows how to add a profile.](media://8f9edb1d-f13b-45df-b555-8be3ddb8c13e)

| <span style="color: #000000">**Parameter**</span> | <span style="color: #000000">**Description**</span> |
| --- | --- |
| <span style="color: #000000">*Profile name*</span> | <span style="color: #000000">Enter a name for the profile.</span> |
| <span style="color: #000000">*Profile type*</span> | <span style="color: #000000">Displays URL as selected, by default. </span> |
| <span style="color: #000000">*URL*</span> | <span style="color: #000000">Enter the URL to be accessed.</span> |
| <span style="color: #000000">*User; Password*</span> | <span style="color: #000000">Enter the user name and password to access the specified URL.</span> |
| <span style="color: #000000">*Access token*</span> | <span style="color: #000000">Enter the access token to access the specified URL, if needed. </span><span style="color: #000000">Administrators</span><span style="color: #000000"> must generate the access tokens from applications, if required, and enter that here.</span> |
| <span style="color: #000000">*URL parameters*</span> | <span style="color: #000000">Mention any extra parameters that must be appended to the URL here. </span> |
| <span style="color: #000000">*Request headers*</span> | <span style="color: #000000">Displays the request header(s) created as per the given information.</span> |

<span style="color: #000000">You can perform the following actions on this page:</span>

- <span style="color: #000000">Click </span>:edit-pencil: <span style="color: #000000"> to edit the profile details.</span>
- <span style="color: #000000">Click </span>> Macro (inline-media-image)

<span style="color: #000000"> to remove the profile.</span>
- <span style="color: #000000">Click </span><span style="color: #000000">**Save profile**</span><span style="color: #000000"> to create the profile.</span>

## > Macro (anchor)