> For the complete documentation index, see [llms.txt](https://docs.devarmor.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devarmor.com/getting-started/atlassian-integration.md).

# Atlassian Integration

## Overview

DevArmor connects to your Atlassian site to read *Jira* tasks and *Confluence* pages in the context of threat model or design review workflows, and to push DevArmor tasks to *Jira* or link them to existing *Jira* tasks.

DevArmor's Atlassian integration requires installing our Atlassian *Forge* application.

## Installing the Integration

When you install the Atlassian integration for the first time from the [*Integrations*](https://app.devarmor.com/integrations) page, Atlassian asks you to select the Atlassian site (if you have more than one), grant the necessary permissions, and offers you to select the Atlassian app "connections". The *Jira* connection is required, and the *Confluence* connection is optional.

## Upgrading the Integration

From time to time DevArmor releases new versions of the Atlassian application. In this case you will see an outdated app in your Atlassian site's listing of installed apps. Go to the [Atlassian Admin Console](https://admin.atlassian.com/) and click **Apps → Sites → (your site) → Connected apps**:

<figure><img src="/files/9pdxb7sPvcwEMEfqrSYt" alt=""><figcaption></figcaption></figure>

Note the `Update` chip next to the *DevArmor* app. Click **View app details** in the *Actions* column:

<figure><img src="/files/bqw3tucNjT5hTnWATMrS" alt=""><figcaption></figcaption></figure>

Now click on the blue `Update` button at the top right corner of the page. This will open a dialog explaining the new capabilities offered and new permissions required. Click the `Accept & Update` button. After 5–10 seconds of processing, the latest version of the DevArmor app will be installed in your Atlassian site:

<figure><img src="/files/Lt3ajd52O5qQjnNY0pDo" alt=""><figcaption></figcaption></figure>

The app is always connected to *Jira*, however we have recently added support for *Confluence*, and if you did not previously connect the app to *Confluence*, you can do this by clicking the `Manage connections` button in the **CONNECTED TO** section.

This concludes the process for updating the DevArmor app in your Atlassian site. It can take up to 5 minutes for new permissions to propagate to our system and new functionality to be enabled.