From 8ced9a109d150e48270d71a31c1143a7da5d5d67 Mon Sep 17 00:00:00 2001 From: TheCaptain97 Date: Fri, 18 Sep 2026 13:26:31 +0200 Subject: [PATCH] Document Jira publisher API URL and authentication options Signed-off-by: TheCaptain97 --- docs/reference/notifications/publishers.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/reference/notifications/publishers.md b/docs/reference/notifications/publishers.md index c412225b..bb4c9cd8 100644 --- a/docs/reference/notifications/publishers.md +++ b/docs/reference/notifications/publishers.md @@ -56,6 +56,16 @@ The global configuration defines how Dependency-Track connects to your Jira serv ![Jira publisher global config](../../assets/images/reference/notifications/publishers/jira-publisher-global-config.png) +Dependency-Track sends a `POST` request to `{API URL}/rest/api/2/issue` when creating an issue. + +Depending on your Jira hosting model and authentication setup, configure the fields as follows: + + +* **Jira Data Center or Jira Server:** Set **API URL** to the base URL of your Jira instance (for example, `https://jira.example.com`). Specify **Username** and either a password or personal access token in **Password or Token**. +* **Jira Cloud (basic authentication):** Set **API URL** to your site URL (for example, `https://example.atlassian.net`). Set **Username** to the account email address and **Password or Token** to an [Atlassian API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). +* **Jira Cloud (scoped OAuth 2.0 or API gateway tokens):** Set **API URL** to `https://api.atlassian.com/ex/jira/{cloudId}` (without a trailing slash), where `{cloudId}` is your Atlassian Cloud site ID. Leave **Username** empty and enter the access token in **Password or Token**. When **Username** is empty, Dependency-Track sends a `Bearer` authorization token instead of basic authentication. Ensure the token grants the `write:jira-work` scope (or the granular `write:issue:jira` scope). + + ### Alert Config {: #jira-alert-config }