---
title: "Configure for cloud"
canonical: "https://support.appfire.com/space/GVIZ/70224052/Configure%20for%20cloud"
format: markdown
---
> Macro (aura-html)

<span style="color: #000000">After</span> [migrating](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70223940) <span style="color: #000000">or</span> installing <span style="color: #000000">*Graphviz Diagrams for Confluence*</span><span style="color: #000000">, navigate to the Configuration screen:</span>

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

<span style="color: #000000"> ></span><span style="color: #000000">*** ***</span><span style="color: #000000">**Settings**</span><span style="color: #000000">* *</span><span style="color: #000000">on the sidebar.</span>
3. <span style="color: #000000">Select </span><span style="color: #000000">**Graphviz Configuration**</span><span style="color: #000000"> under </span><span style="color: #000000">**ATLASSIAN MARKETPLACE**</span><span style="color: #000000"> to manage the app's configuration.</span>

<span style="color: #000000">The Configuration page contains the following tabs:</span>

- <span style="color: #000000">[Global configuration](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70224052/Configure+for+cloud#CloudConfiguration-gviz_config_global)</span>
- <span style="color: #000000">[Allowlist](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70224052/Configure+for+cloud#CloudConfiguration-Whitelist)</span>
- <span style="color: #000000">[Profiles](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70224052/Configure+for+cloud#CloudConfiguration-gviz_config_profiles)</span>

## > Macro (anchor)

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

<span style="color: #000000">Use the toggle to enable or disable the app's configuration settings.</span>

![image](media://1a111a6e-9b70-41bc-b7d2-6bde35d65185)

| **Tab** | **Default** | **Description** |
| --- | --- | --- |
| > Macro (anchor)

<span style="color: #000000">Restrict URL access</span> | <span style="color: #000000">On</span> | <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> [Allowlist](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70224052/Configure+for+cloud#CloudConfiguration-Whitelist) <span style="color: #000000">tab.</span> |
| <span style="color: #000000">Allow JavaScript</span> | <span style="color: #000000">Off</span> | <span style="color: #000000">Enable this option to use Javascript in the </span><span style="color: #000000">*Graphviz for Confluence*</span><span style="color: #000000"> macros. This option allows administrators to control the usage of JavaScript in the macros.</span><br><span style="color: #000000">If enabled, the usage of Javascript in the macros is not restricted and thus, users must be advised about the potential security issues if this feature is not used correctly. If disabled, this option prevents users from using JavaScript in the macros.</span> |
| <span style="color: #000000">Help us improve the product </span> | <span style="color: #000000">On</span> | <span style="color: #000000">If enabled, it allows us to collect some usage data that help's us improve our product. To learn more about what is being sent, refer to</span> [Analytics data](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70224479)<span style="color: #000000">.</span> |

<span style="color: #000000">Click </span><span style="color: #000000">**Save**</span><span style="color: #000000"> to save the modified settings.</span>

## > Macro (anchor)

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

<span style="color: #000000">Manage the list of all the URLs that can be accessed by the app, in this page.</span> <span style="color: #000000">If the </span><span style="color: #000000">[Restrict URL access](#CloudConfiguration-gviz_config_global_restrictURL)</span><span style="color: #000000"> option is enabled, t</span>he app<span style="color: #000000"> is restricted to allow the specified URLs only. </span>

![image](media://c0e1e7fd-c3b3-4757-ae5b-16772cc89765)

| **Parameter** | **Description** |
| --- | --- |
| <span style="color: #000000">Expression</span> | <span style="color: #000000">Enter a URL or an expression here.</span> |
| Type | <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: https://www.example.com/</span>
- <span style="color: #000000">*Exact match *</span><span style="color: #000000">- allows only the specified URL. Example: https://www.example.com/thispage</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">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 set of common parameters that allow users to access data from external applications such as GitHub or GitLab through 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 to make the page content less likely to require changes when the 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://08c28a95-0568-46cc-a9da-646c76376f07)

<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 the following pop-up window:</span>

![image](media://f2b8de1f-360f-482e-85cf-e1a4533b2bbd)

| **Parameter** | **Description** |
| --- | --- |
| <span style="color: #000000">Profile name</span> | <span style="color: #000000">Enter a name for the profile.</span><br>> ⚠️ <span style="color: #000000">This name must be unique. Otherwise, the details specified overwrite the details of the existing profile, whichmay cause errors in pages where the profile is used.</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 type.</span> |
| <span style="color: #000000">URL</span> | <span style="color: #000000">Enter the URL of the application 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 base 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">. Administrators 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 Edit to modify 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>