Atlassian Connector for Jira & Confluence Data Center
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:
- Navigate to Administration (gear icon) and click on
Manage apps
. - Under ATLASSIAN MARKETPLACE, click on
Manage apps
. - Look for the
Upload app
link on the right. - If you are unable to upload plugins on your instance, be sure to enable this option on your instance:
- Jira Data Center: https://confluence.atlassian.com/jirakb/how-to-re-enable-plugin-upload-1364557898.html.
- Confluence Data Center: https://confluence.atlassian.com/doc/managing-system-and-marketplace-apps-25788666.html.
![atolioctl](jiradc-upload.png)
- Click on
Upload app
. - Download the plugin file, e.g. https://atolio.s3.us-west-2.amazonaws.com/jira-dc-connector-0.0.0.3.jar.
- Provide the file for installation and click
Upload
. - 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.yourdomain.com --jwt-issuer-sdk https://search.yourdomain.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:
- Under the app, click on
Configure
. - 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.yourdomain.com
. - Port - the port to communicate on, e.g.
443
. - JWT Token - the token generated by your Deployment Engineer.
- (Optional) Under “Project Settings”, you can choose to index all projects or specify certain projects.
- Under “Backfiller Status”, click
Start Process
.