# Creating an application link

An application link is a security layer telling your Jira Data Center instance that it's okay to allow Avion to ask your users to authenticate access. **This is a one-time thing that will need to be performed by an administrator**. Once this link has been established, individual users will be able to authenticate story maps with your Jira instance.

### Step one

From the **Application Links** page (Applications → Application Links), do the following:

{% tabs %}
{% tab title="v8.22 and greater" %}

1. Click **Create Link**
2. Select **Atlassian product** (confusing, yep)
3. Enter **<https://www.avion.io>** (or copy and paste from the screen in Avion)
4. Ignore any "response not found" warning

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2F0Uy0lSjUjZhsKALYZ8rH%2Fjira-app-links-new.png?alt=media&#x26;token=9a130051-b11c-47a1-8352-2225aa018f18" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="v8.21 and less" %}

1. Enter **<https://www.avion.io>** (or copy and paste from the screen in Avion)
2. Click **Create new link**

![](https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LL6HR00hwiJJav4pLph%2Fsync%2F6048c126d2b191e614c905910b3de4973db74c62.png?generation=1613583347567987\&alt=media)
{% endtab %}
{% endtabs %}

### Step two

On the next screen, do the following:

1. Enter **Avion**&#x20;
2. Check box **Create incoming link**
3. Click **Continue**

![](https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LL6HR00hwiJJav4pLph%2Fsync%2F97459af7cc11ca82a5074fce501736023e68255b.png?generation=1613583361612048\&alt=media)

### Step three

On the final stage, do the following:

1. Enter **Avion**
2. Enter **Avion**
3. Paste the **Public Key** provided from the screen in Avion
4. Click **Continue**

![](https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LL6HR00hwiJJav4pLph%2Fsync%2F094eef66b7d1d0a60ff1e2c2609ed62f8a82098f.png?generation=1613583355741691\&alt=media)

### Step four

![](https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LL6HR00hwiJJav4pLph%2Fsync%2Fbf1a4a97af063790637cb2ec9e073ce735effdde.png?generation=1613583379799024\&alt=media)

You're done! You can now click **Finish** in Avion and will be able to integrate your story maps with your Jira Data Center instance 🎉

{% hint style="info" %}
**Note:** If you have an SSO provider installed and you are not signed into your SSO session in another tab, Jira may not redirect you after typing in your sign in details in the Avion popup window. If this happens, you may need to go through the authentication process a second time.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.avion.io/docs/integrations/backlog-tools/services/jira-data-center-server/set-up/creating-an-application-link.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
