After installing or updating the app, you can configure the app settings in the Configuration screen.
| Note |
|---|
The configuration option is available from version 3.2. |
To navigate to the screen:
...
- Log in as an administrator and select Cog menu (
) > Manage apps. - Select Graphviz under the BOB SWIFT CONFIGURATION section in the sidebar to open the Graphviz for Confluence Configuration page.
...
- .
...
The Configuration page provides the following tabs:
- Global configuration
- Graphviz Diagrams for Confluence configuration
- Graphviz Diagrams for Confluence configuration70222084
- 70222084
Anchor gviz_330_globalConfig gviz_330_globalConfig
Global configuration
| gviz_330_globalConfig | |
| gviz_330_globalConfig |
Use the toggle to enable or disable the Global configuration settings.
| Parameter | Default | Description | |||
|---|---|---|---|---|---|
| Restrict URL access | Off | This option controls if the macros can access or are restricted from accessing specified URLs. The specified URLs in the macro editors must conform to the Confluence Allowlist; provided, the allowlist is enabled. Confluence allows the administrator to turn on allowlist to restrict incoming and outgoing connections to only those connections that are configured in the Allowlist settings. If enabled, the URL to Graphviz file or URL to UML file parameters are also restricted to the URLs that are configured in the Allowlist settings for Confluence only. | |||
| Allow JavaScript | On | This option controls Javascript usage in the Graphviz for Confluence app. Disable this option to restrict execution of JavaScript within the macros. Available since 3.3.
| |||
| Blacklist domains | Off | This option controls whether or not certain domains are blacklisted. By default, this option is disabled for backward compatibility. Available since 3.3. 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. Click the link named listed (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, by default:
| Help us improve the product | On | This option allows us to collect some usage data to help us improve our product. To learn more about what is being sent, refer to Analytics Data. |
Anchor gviz_330_templates gviz_330_templates
Templates
| gviz_330_templates | |
| gviz_330_templates |
...
This tab lists all the default templates provided by Graphviz Diagrams for Confluence. These templates provide users with a quick start to creating diagrams and the respective macro editors are pre-configured with these templates.
Anchor profiles profiles
Profiles
| profiles | |
| profiles |
Profiles are a set of basic parameters required to access relevant data from a remote location and render the required graphs on Confluence pages.
...
| Parameter | Description | ||
|---|---|---|---|
| Profile name | Enter a name for the profile. Profile names given here are populated in the Profile field in the macro editor.
| ||
| Profile type | Specify whether this is a URL, GitLab, or GitHub address. The default option for this parameter is URL. | ||
| URL | Enter the URL of the remote location to be accessed. It is recommended to provide the base URL here.
| ||
| User; Password | Enter the username and password, if required, to access the specified URL.
| ||
| Access token | Enter an access token or an API token for the application or service to be connected with.
Each application has its own method of generating tokens. Access tokens or API tokens are a means of user authentication; so, if mentioned, this token is used for authentication instead of using user credentials.
Here are some of the links associated with GitLab and GitHub applications to generate a personal access token:
| ||
| URL parameters | Mention any extra parameters (for the query string) that must be appended to the specified URL here. | ||
| Request headers | 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: Authorization: token $accessToken, Accept:application/vnd.github.v3.raw 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. |
Click Save profile to create the profile.
| Info |
|---|
The Help us improve the product parameter was removed. We do not collect or transmit private user data or personally identifiable information. Refer to the Appfire Trust Center for EULA and other policies. |
Additional references
Click any of the following links to learn more about creating profiles:
...