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

<span style="color: #000000">After </span>[migrating](https://appfire.atlassian.net/wiki/spaces/MARKDOWN/pages/72384749/Migration+to+Cloud+from+Server) or [installing](https://appfire.atlassian.net/wiki/spaces/MARKDOWN/pages/72385236/Installation) *<span style="color: #000000">Markdown for Confluence</span>*<span style="color: #000000">, navigate to the Configuration screen:</span>

1. <span style="color: #000000">Log in with the </span><span style="color: #000000">**System Administrator**</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 > </span>******<span style="color: #000000">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">Markdown Configuration</span>*<span style="color: #000000"> to manage the app configuration.</span>

<span style="color: #000000">The app configuration consists of the following tabs:</span>

- [<span style="color: #000000">Global configuration</span>](#Configuration-Cloud-Globalconfiguration)
- [<span style="color: #000000">Whitelist</span>](#Configuration-Cloud-Whitelist)
- [<span style="color: #000000">Profiles</span>](#Configuration-Cloud-Profiles)

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

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

![image](media://40a14510-cc1e-4706-af81-513efa1d96a4)

| <span style="color: #000000">**Parameter**</span> | <span style="color: #000000">**Description**</span> |
| --- | --- |
| > Macro (anchor)

<span style="color: #000000">Restrict URL access</span> | <span style="color: #000000">The </span>*<span style="color: #000000">Restrict URL access</span>*<span style="color: #000000"> parameter controls whether or not URLs conform to the</span><span style="color: #000000"> allowlisted URLs. Administrators can turn on the allowlist to restrict access to URLs configured in the </span>[<span style="color: #000000">Whitelist settings</span>](#Configuration-Cloud-MDC_Whitelist)<span style="color: #000000">. </span> |
| <span style="color: #000000">Allow JavaScript</span> | <span style="color: #000000">This option controls JavaScript usage in the Markdown </span><span style="color: #000000">macros</span><span style="color: #000000">. Enabling this option allows you to execute JavaScript within the macros.</span> |
| Help us improve the product | <span style="color: #000000">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 </span>[<span style="color: #000000">Analytics data</span>](https://appfire.atlassian.net/wiki/spaces/MARKDOWN/pages/72384771/Analytics+data+-+Cloud). |

# > Macro (anchor)

<span style="color: #000000">Whitelist</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</span>*](#Configuration-Cloud-MDC_GlobalConfig_RestrictURL)<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>

![image](media://3d9a15ed-87ba-4cc8-9b1c-fb7ec5c61d1a)

| <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><span style="color: #000000">https://www.example.com/</span><span style="color: #000000">.</span>
- *<span style="color: #000000">Exact match </span>*<span style="color: #000000">- allows only the specified URL. Example: </span><span style="color: #000000">https://www.example.com/thispage</span><span style="color: #000000">.</span>
- *<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: https://*example.com.</span>
- *<span style="color: #000000">Regular expression </span>*<span style="color: #000000">- allows all URLs matching the specified regular expression. Example: http(s)?://www\.example\.com. </span>  
<span style="color: #000000">Refer to</span> [this link](https://en.wikipedia.org/wiki/Regular_expression) <span style="color: #000000">for more information about regular expressions.</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>

![image](media://dcfbefda-ed7d-4004-86e8-95441085fcc9)

<span style="color: #000000">The page displays a list of profiles available for the macros. Click </span>**<span style="color: #000000">Add Profile</span>**<span style="color: #000000"> to open a pop-up window as:</span>

![image](media://cc837f4b-7749-4776-a255-e962aa92cfb0)

| <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">Specify whether this is a </span>*<span style="color: #000000">URL</span>*<span style="color: #000000">, </span>*<span style="color: #000000">GitLab,</span>*<span style="color: #000000"> or </span>*<span style="color: #000000">GitHub</span>*<span style="color: #000000"> profile.</span> |
| <span style="color: #000000">URL</span> | <span style="color: #000000">Enter the URL to be accessed. If the </span>*<span style="color: #000000">Profile type</span>*<span style="color: #000000"> is either </span>*<span style="color: #000000">GitLab</span>*<span style="color: #000000"> or </span>*<span style="color: #000000">GitHub</span>*<span style="color: #000000">, a default URL is displayed here that is editable.</span> |
| <span style="color: #000000">User; Password</span> | <span style="color: #000000">Enter the username and password to access the specified URL.</span> |
| <span style="color: #000000">Access token</span> | *<span style="color: #000000">Applicable for GitLab and GitHub URLs</span>*<span style="color: #000000">.</span><span style="color: #000000"> </span><span style="color: #000000">Administrators</span><span style="color: #000000"> must generate the access tokens from either the GitLab or GitHub applications 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 headers 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>> Macro (inline-media-image)

<span style="color: #000000"> </span><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>