Troubleshooting Jira DVCS connector

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

When working with the Jira DVCS connector, you might encounter the following issues.

Jira cannot access the GitLab server

If you complete the Add New Account form, authorize access, and you receive this error, Jira and GitLab cannot connect. No other error messages appear in any logs:

Error obtaining access token. Cannot access https://gitlab.example.com from Jira.

Session token bug in Jira

When you use GitLab 15.0 and later with Jira Server, you might encounter a session token bug in Jira. This bug affects Jira Server 8.20.8, 8.22.3, 8.22.4, 9.4.6, and 9.4.14.

To resolve this issue, ensure you use Jira Server 8.20.11 and later or 9.1.0 and later.

SSL and TLS problems

Problems with SSL and TLS can cause this error message:

Error obtaining access token. Cannot access https://gitlab.example.com from Jira.

• The Jira issues integration requires GitLab to connect to Jira. Any TLS issues that arise from a private certificate authority or self-signed certificate are resolved on the GitLab server, as GitLab is the TLS client.
• The Jira development panel requires Jira to connect to GitLab, which causes Jira to be the TLS client. If your GitLab server's certificate is not issued by a public certificate authority, add the appropriate certificate (such as your organization's root certificate) to the Java Truststore on Jira Server.

For more information about setting up Jira, see the Atlassian documentation and Atlassian Support.

• Add a certificate to the trust store.
  • The simplest approach is keytool.
  • Add additional roots to Java's default Truststore (cacerts) to allow Jira to also trust public certificate authorities.
  • If the integration stops working after upgrading Jira Java runtime, the cacerts Truststore may have been replaced during the upgrade.
• Troubleshoot connectivity up to and including TLS handshaking, using the SSLPoke Java class.
• Download the class from the Atlassian knowledge base to a directory on Jira Server, such as /tmp.
• Use the same Java runtime as Jira.
• Pass all networking-related parameters that Jira is called with, such as proxy settings or an alternative root Truststore (-Djavax.net.ssl.trustStore):

${JAVA_HOME}/bin/java -Djavax.net.ssl.trustStore=/var/atlassian/application-data/jira/cacerts -classpath /tmp SSLPoke gitlab.example.com 443

The message Successfully connected indicates a successful TLS handshake.

If there are problems, the Java TLS library generates errors that you can look up for more detail.

Scope error when connecting to Jira with DVCS

The requested scope is invalid, unknown, or malformed.

Potential resolutions:

1. Verify that the URL shown in the browser after being redirected from Jira in the Jira DVCS connector setup includes scope=api in the query string.
2. If scope=api is missing from the URL, edit the GitLab account configuration. Review the Scopes field and ensure the api checkbox is selected.

Error: 410 Gone

When you connect to Jira and synchronize repositories, you might get a 410 Gone error. This issue occurs when you use the Jira DVCS connector and your integration is configured to use GitHub Enterprise.

For more information, see issue 340160.

Synchronization issues

If Jira displays incorrect information, such as deleted branches, you may have to resynchronize the information:

1. In Jira, select Jira Administration > Applications > DVCS accounts.
2. For the account (group or subgroup), select Refresh repositories from the {{< icon name="ellipsis_h" >}} (ellipsis) menu.
3. For each project, next to the Last activity date:
   • To perform a soft resync, select the sync icon.
   • To complete a full sync, press Shift and select the sync icon.

For more information, see the Atlassian documentation.

Error: Sync Failed

If you get a Sync Failed error in Jira when you refresh repository data for specific projects, check your Jira DVCS connector logs. Look for errors that occur when executing requests to API resources in GitLab. For example:

Failed to execute request [https://gitlab.com/api/v4/projects/:id/merge_requests?page=1&per_page=100 GET https://gitlab.com/api/v4/projects/:id/merge_requests?page=1&per_page=100 returned a response status of 403 Forbidden] errors:
{"message":"403 Forbidden"}

If you get a 403 Forbidden error, this project might have some GitLab features disabled. In the previous example, the merge requests feature is disabled.

To resolve the issue, enable the relevant feature:

1. In the top bar, select Search or go to and find your project.
2. Select Settings > General.
3. Expand Visibility, project features, permissions.
4. Use the toggles to enable the features as needed.

Find webhook logs in a DVCS-linked project

To find webhook logs in a DVCS-linked project:

1. In the top bar, select Search or go to and find your project.
2. Select Settings > Webhooks.
3. Scroll down to Project hooks.
4. Next to the log that points to your Jira instance, select Edit.
5. Scroll down to Recent events.

If you can't find webhook logs in your project, check your DVCS setup for problems.