From b5768ce434c5b8e766ce19243ca59b98a3b81f89 Mon Sep 17 00:00:00 2001 From: Michael Lussier Date: Wed, 2 Apr 2025 21:18:34 +0000 Subject: [PATCH 1/2] Add jira credential reset troubleshooting --- doc/integration/jira/troubleshooting.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/integration/jira/troubleshooting.md b/doc/integration/jira/troubleshooting.md index 3f71a73f048098..34cbe78a545337 100644 --- a/doc/integration/jira/troubleshooting.md +++ b/doc/integration/jira/troubleshooting.md @@ -14,6 +14,18 @@ title: Troubleshooting Jira issues integration When working with the [Jira issues integration](configure.md), you might encounter the following issues. +## Verified Jira credentials failing + +If verified Jira credentials are still resulting in failure, `Reset` of the credentials may help: + +** Settings > Integrations > Jira Issue ** + +At the bottom right of this page, there should be a `Reset` button. + +After being used, re-enter the validated credentials and it may resolve the issue. + +This can be required if initial credentials are interpreted or entered incorrectly causing this state. + ## GitLab cannot link to a Jira issue When you mention a Jira issue ID in GitLab, the issue link might be missing. -- GitLab From f236785f2dd2dc5f3274d8c01c5f8ef42f73209d Mon Sep 17 00:00:00 2001 From: Michael Lussier Date: Thu, 3 Apr 2025 18:19:11 +0000 Subject: [PATCH 2/2] Apply 4 suggestion(s) to 1 file(s) Co-authored-by: Brendan Lynch --- doc/integration/jira/troubleshooting.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/integration/jira/troubleshooting.md b/doc/integration/jira/troubleshooting.md index 34cbe78a545337..6a735b4785c15f 100644 --- a/doc/integration/jira/troubleshooting.md +++ b/doc/integration/jira/troubleshooting.md @@ -14,17 +14,21 @@ title: Troubleshooting Jira issues integration When working with the [Jira issues integration](configure.md), you might encounter the following issues. -## Verified Jira credentials failing +## Verified Jira credentials failing -If verified Jira credentials are still resulting in failure, `Reset` of the credentials may help: +If you verified your Jira credentials are correct, the integration may still fail to connect. +This can happen when credentials become stuck in an incorrect state in the GitLab system. -** Settings > Integrations > Jira Issue ** +To resolve this issue, reset the credentials: -At the bottom right of this page, there should be a `Reset` button. +1. On the left sidebar, select **Search or go to** and find your project. +1. Select **Settings > Integrations**. +1. Select **Jira issues**. +1. At the bottom of the page, select **Reset**. +1. Re-enter your credentials and select **Save changes**. -After being used, re-enter the validated credentials and it may resolve the issue. - -This can be required if initial credentials are interpreted or entered incorrectly causing this state. +This reset clears any cached or incorrectly stored credential data and forces GitLab to establish a +fresh connection with your Jira instance. ## GitLab cannot link to a Jira issue -- GitLab