Atlassian Connector for Jira & Confluence Data Center

Index content from your Jira DC & Confluence DC environments.

The Atlassian Connector for Jira & Confluence Data Center indexes:

  • Projects, issues, and comments across your Jira instance.
  • Spaces, pages, and comments across your Confluence instance.
  • Users and groups in Jira & Confluence for the purpose of understanding permissions.

The apps have been created with Atlassian SDK and designed to be installed and work for:

  • Confluence Server/DC v8.2.3 or later.
  • Jira Server/DC v9.10.0 or later.

Installing the App

First, check if you can upload apps by following these steps:

  1. Navigate to Administration (gear icon) and click on Manage apps.
  2. Under ATLASSIAN MARKETPLACE, click on Manage apps.
  3. Look for the Upload app link on the right.
  4. If you are unable to upload plugins on your instance, be sure to enable this option on your instance:
atolioctl
  1. Click on Upload app.
  2. Download the plugin file, e.g. https://atolio.s3.us-west-2.amazonaws.com/jira-dc-connector-0.0.0.3.jar.
  3. Provide the file for installation and click Upload.
  4. Ensure that the plugin is installed.

Note: you may choose to disable plugin uploads after this step, following the instructions above.

Provide Configuration

Before your configure the plugin, you will need to work with your Deployment Engineer to generate an authentication token for the Jira DC or Confluence DC connector instance. To generate the necessary token, have them run the following command with the appropriate arguments:

atolioctl connector create-jwt "atolio:jiradc:default:jiradc" --jwt-secret-sdk <secret> --jwt-audience-sdk https://search.example.com --jwt-issuer-sdk https://search.example.com

The issuer and audience are based on the domain name as specified in config.hcl (i.e. the Terraform lumen_domain_name variable with the URL scheme https:// prefixed).

If you have the values-lumen.yaml and values-lumen-templated.yaml locally available you can run the following command instead (the directory is e.g. deploy/terraform/aws):

atolioctl connector create-jwt --config-dir your-config-dir "atolio:jiradc:default:jiradc"

You can now configure the plugin to point to your Atolio deployment:

  1. Under the app, click on Configure.
  2. Under “Feeder Settings”, provide the following:
  • Host - the feeder address, which will be the feed subdomain with your chosen DNS name, e.g. feed.search.example.com.
  • Port - the port to communicate on, e.g. 443.
  • JWT Token - the token generated by your Deployment Engineer.
  1. (Optional) Under “Project Settings”, you can choose to index all projects or specify certain projects.
  2. Under “Backfiller Status”, click Start Process.