---
title: "Configuration"
canonical: "https://support.appfire.com/space/CVP/69174093/Configuration"
format: markdown
---
> Macro (aura-html)

<span style="color: #000000">The configuration settings affect the way certain parameters of the </span><span style="color: #000000">*Visio Viewer*</span><span style="color: #000000"> macro works, in general.</span>

<span style="color: #000000">After</span> <span style="color: #000000">installing</span> <span style="color: #000000">*Visio for Confluence*</span><span style="color: #000000">, navigate to the Visio for Confluence 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).
2. <span style="color: #000000">Select </span>> Macro (inline-media-image)

<span style="color: #000000"> </span><span style="color: #000000">***> Manage apps***</span><span style="color: #000000">.</span>
3. Either search for *Visio for Confluence*<span style="color: #000000"> or scroll to </span>*Bob Swift Configuration,*<span style="color: #000000"> and click </span>*Visio*<span style="color: #000000"> to view app configuration.</span>

> ✅ ### Try this for older Confluence versions!
> ✅ 
> ✅ 1. <span style="color: #000000">Navigate to</span> > Macro (inline-media-image)
> ✅ 
> ✅  <span style="color: #000000">***> Settings > Atlassian Marketplace ***</span><span style="color: #000000">on the sidebar.</span>
> ✅ 2. <span style="color: #000000">Scroll to </span><span style="color: #000000">*Bob Swift Configuration*</span><span style="color: #000000"> and click </span><span style="color: #000000">*Visio*</span><span style="color: #000000"> to view the configuration page.</span>

<span style="color: #000000">The following configuration tabs are available:</span>

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

## > Macro (anchor)

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

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

![image](media://20286314-d654-4c17-a6f2-2a4f44fef48e)

| **Parameter** | **Description** |
| --- | --- |
| <span style="color: #000000">*Default output type*</span> | <span style="color: #000000">Specify the output format for the Visio diagram. The options are as follows:</span><br>- <span style="color: #000000">*default*</span><span style="color: #000000"> - Display output in the format that has been chosen as the default for this Confluence instance.</span>
- <span style="color: #000000">*best*</span><span style="color: #000000"> - Display output in the best format applicable for the system and browser used. This means using the Visio control on Internet Explorer (IE) or IE tab capable browsers and a converted image (if available) otherwise.</span>
- <span style="color: #000000">*visio*</span><span style="color: #000000"> - Display using the IE Visio control. This requires IE or IE tab capable browser on Windows.</span>
- <span style="color: #000000">*svg*</span><span style="color: #000000"> - Display as a SVG image converted from the Visio diagram. Only available if conversion support has been enabled on your Confluence installation.</span> |
| <span style="color: #000000">*Restrict URL access*</span> | <span style="color: #000000">Enable this option to restrict access to remote locations through the </span><span style="color: #000000">*URL to Visio file*</span><span style="color: #000000"> parameter in the </span><span style="color: #000000">*Visio Viewer*</span><span style="color: #000000"> macro. The specified URLs in the macro editors must conform to the Confluence Whitelist; provided, whitelisting is enabled.</span><br><span style="color: #000000">Confluence allows the administrator to turn on whitelisting to restrict incoming and outgoing connections to only those connections that are configured in the Whitelist settings. If enabled, the </span><span style="color: #000000">*URL to Visio file*</span><span style="color: #000000"> parameter for the </span><span style="color: #000000">*Visio Viewer*</span><span style="color: #000000"> macro is also restricted to only URLs that are configured in the Whitelist settings for Confluence.</span> |
| <span style="color: #000000">*Blacklist domains*</span> | <span style="color: #000000">Enable this option to blacklist certain domains. By default, this option is disabled for backward compatibility.</span><br><span style="color: #000000">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 administrator to disable this option.</span><br>> ⚠️ <span style="color: #000000">If this option is disabled, access to all domains is permitted!</span><br><span style="color: #000000">Click the link named </span><span style="color: #000000">***listed***</span><span style="color: #000000"> (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:</span><br>- <span style="color: #000000">10.0.0.0/8</span>
- <span style="color: #000000">100.64.0.0/10</span>
- <span style="color: #000000">127.0.0.0/8</span>
- <span style="color: #000000">169.254.0.0/16</span>
- <span style="color: #000000">172.16.0.0/12</span>
- <span style="color: #000000">192.168.0.0/16</span>
- <span style="color: #000000">192.0.0.0/24</span>
- <span style="color: #000000">198.18.0.0/15</span>
- <span style="color: #000000">255.255.255.255/32</span>
- <span style="color: #000000">0.0.0.0/32</span>
- <span style="color: #000000">192.88.99.0/24</span>
- <span style="color: #000000">198.51.100.0/24</span>
- <span style="color: #000000">203.0.113.0/24</span>
- <span style="color: #000000">224.0.0.0/4</span>
- <span style="color: #000000">240.0.0.0/4</span> |
| <span style="color: #000000">*Help Us Improve the Product*</span> | <span style="color: #000000">Enable this option to allows us to collect some usage data that helps us improve our product. </span> |

## > Macro (anchor)

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

<span style="color: #000000">Profiles are a common set of parameters used to access content from external locations. Available since 5.3.0. </span>

<span style="color: #000000">Use profiles to:</span>

- <span style="color: #000000">Allow user authentication as 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">Enable macro editors to quickly configure the macro by reusing a shared definition for URL access. </span>
- <span style="color: #000000">Make lesser changes to page contents when base URLs are relocated as relative addressing is used in profiles. </span>
- <span style="color: #000000">Macro configured URL (that is not a full URL) is appended to the profile provided URL. This absolute URL then points to the actual location of the content to be rendered.</span>

> ⚠️ <span style="color: #000000">The base URL of the remote location to be accessed must be given in profiles, and the raw URL must be entered in the </span><span style="color: #000000">*URL to the Visio file*</span><span style="color: #000000"> field in the macro editor. </span>
> ⚠️ 
> ⚠️ <span style="color: #000000">A raw URL is defined as the part of the URL following the domain information and includes the query string, if present. For example, in the URL string </span><span style="color: #000000">*http://www.contoso.com/articles/recent.aspx*</span><span style="color: #000000">, the raw URL is </span><span style="color: #000000">*/articles/recent.aspx*</span><span style="color: #000000">.</span>

![image](media://39783075-fa19-40ea-a3e3-376fae4fe7e5)

<span style="color: #000000">The page displays a list of profiles available for the macros. 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">To create a new profile, click </span><span style="color: #000000">**Add Profile**</span><span style="color: #000000"> to open a pop-up window as:</span>

![image](media://0c71acff-bf41-456c-9a6f-6486bd6d8627)

| **Parameter** | **Description** |
| --- | --- |
| <span style="color: #000000">*Profile name*</span> | <span style="color: #000000">Enter a name for the profile. Profile names given here are populated in the </span><span style="color: #000000">*Profile*</span><span style="color: #000000"> field in the macro editor.</span><br>> ⚠️ <span style="color: #000000">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.</span> |
| <span style="color: #000000">*Profile type*</span> | <span style="color: #000000">The default option for this parameter is </span><span style="color: #000000">*URL*</span><span style="color: #000000">. </span><br>> ℹ️ <span style="color: #000000">Currently, only URLs are supported for use in profiles. In the upcoming releases, the support will be extended to access Visio files in other applications such as GitLab and GitHub.</span> |
| <span style="color: #000000">*URL*</span> | <span style="color: #000000">Enter the URL of the remote location to be accessed. It is recommended to provide the base URL here.</span><br>> ⚠️ <span style="color: #000000">A raw URL must be provided in </span><span style="color: #000000">*URL to the Visio file*</span><span style="color: #000000"> in the macro editor. A raw URL is defined as the part of the URL following the domain information and includes the query string, if present. For example, in the URL string </span><span style="color: #000000">*http://www.contoso.com/articles/recent.aspx*</span><span style="color: #000000">, the raw URL is </span><span style="color: #000000">*/articles/recent.aspx*</span><span style="color: #000000">.</span> |
| <span style="color: #000000">*User*</span><span style="color: #000000">; </span><span style="color: #000000">*Password*</span> | <span style="color: #000000">Enter the username and password, if required, to access the specified URL. </span><br>> ⚠️ <span style="color: #000000">Specify either the </span><span style="color: #000000">*User*</span><span style="color: #000000"> and </span><span style="color: #000000">*Password*</span><span style="color: #000000"> parameters or the </span><span style="color: #000000">*Access token,*</span><span style="color: #000000"> as an access token is also a means of user authentication. It is recommended to use either of the user authentication methods but not both.</span> |
| <span style="color: #000000">*Access token*</span> | <span style="color: #000000">Enter an access token or an API token for the application or service to be connected with.</span><br>> ⚠️ <span style="color: #000000">If this parameter is specified, ensure that the </span><span style="color: #000000">*User*</span><span style="color: #000000"> and </span><span style="color: #000000">*Password*</span><span style="color: #000000"> parameters are left empty. It is recommended to use either of the user authentication methods but not both.</span><br><span style="color: #000000">Each application has its own method of generating tokens. </span>A<span style="color: #000000">ccess tokens</span> <span style="color: #000000">or API tokens are a means of user authentication; so, if mentioned, this token is used for authentication instead of using user credentials. </span><br>- <span style="color: #000000">Tokens are generated for a user after the application or service to be connected verifies the user's credentials. </span>
- <span style="color: #000000">Enter the generated token here for a seamless connection between the app's macros and the application or service.</span><br><span style="color: #000000">For example, refer to </span><span style="color: #000000">[this article](https://confluence.atlassian.com/bitbucketserver/personal-access-tokens-939515499.html)</span><span style="color: #000000"> for information about generating a personal access token for Bitbucket.</span> |
| <span style="color: #000000">*URL parameters*</span> | <span style="color: #000000">Mention any extra parameters (for the query string) that must be appended to the specified URL here. </span> |
| <span style="color: #000000">*Request headers*</span> | <span style="color: #000000">Displays the request headers created as per the given information. Request headers are name or value pairs that are added to the request. For example, GitHub requires the following request headers be specified:</span> *Authorization: token $accessToken, Accept:application/vnd.github.v3.raw*<br><span style="color: #000000">This field is automatically populated with a comma-separated list of name or value pairs using the provided information. If required, enter additional name or value pairs separated with commas.</span> |

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

# <span style="color: #000000">Additional resources</span>

- <span style="color: #000000">[Create a profile with a URL](https://appfire.atlassian.net/wiki/x/T4IfB)</span>
- <span style="color: #000000">[Link to another application using application links](https://appfire.atlassian.net/wiki/x/dYMfB)</span>