The Adaptavist Group LogoDocumentation

Confluence Plugin

To use the Confluence plugin, Venue.sh requires an API token to communicate with Confluence APIs. This document outlines the process of creating the API token and configuring the plugin.

Generating an API Token for Confluence Cloud

To generate a personal access token for Confluence Cloud, follow these steps:

  1. Log in to your Atlassian account via the Atlassian Cloud site.
  2. Navigate to the API Tokens page:
    1. Once logged in, click on your profile image or avatar in the bottom left corner.
    2. Select Account settings from the dropdown menu
    3. In the left-hand sidebar, click Security.
    4. Under API tokens, click Create API token.
  3. Create a new API token:
    1. Click Create API token.
    2. Enter a label for your token, such as Venue.sh Token.
    3. Click Create.
  4. Copy your API token
    1. Click Copy to clipboard to save the token.
    2. Save this token in a secure place. You won't be able to see it again!

Generating an API Token for Confluence Data Center (DC)

To generate a personal access token for Confluence Data Center, follow these steps:
  1. Log in to Confluence Data Center:
    1. Open your Confluence DC instance and log in with your account.
  2. Navigate to Personal Access Tokens:
    1. Click your profile image or avatar in the top-right corner.
    2. Select Settings from the dropdown menu.
    3. In the left-hand sidebar, find and click Personal Access Tokens.
  3. Generate a new token:
    1. Click Create a personal access token.
    2. Fill in the details for the token:
      • Name: Enter a descriptive name, such as Venue.sh Token.
      • Expiry date: Optionally set an expiry date for your token.
      • Permissions: Choose the appropriate permissions required for the token.
    3. Click Create.
  4. Copy your personal access token:
    1. Your new token will be displayed. Click Copy to clipboard to save the token.
    2. Save the token in a secure place. You won't be able to see it again!

Confluence Plugin Configuration

To enable and configure the Confluence plugin, you need to provide several key details. Follow the instructions below to complete the setup.

  1. Confluence URL

    • For Confluence Cloud: <atlassian-site-url>/wiki

      • e.g. https://<yourcompany>.atlassian.net/wiki

    • For Confluence Data Center (DC): <confluence-url>

      • e.g. https://confluence.yourcompany.com

  2. Space Keys:

    • Provide the keys for the Confluence spaces you want to access. Space keys are unique identifiers for Confluence spaces.

      • For example, Development, Marketing, etc.

      • Add one space key per line, using the add button if more items are needed.

  3. Instance Type:

    • Select the type of Confluence instance you are using.

      • Confluence Cloud

        • Enter the email address associated with the Confluence user account.

        • Enter the API token generated in the previous step.

      • Confluence Data Center (DC)

        • Enter the API token generated in the previous step.

Following these steps will ensure that the plugin is correctly configured to interact with your Confluence instance. Make sure to keep your API token secure and do not share it publicly.

Search documentation

Start typing to search the docs.