Skip to main content

Jama Connect Interchange Help

Jira Data Center troubleshooting

Question

Answer

I receive an error when I try to create a connector to my Jira Data Center instance.

If you are having trouble connecting or syncing with Jira Data Center, it's usually due to an authentication issue on the Jira side.

Check the following:

  • (Recommended) Authenticate using a Personal Access Token (PAT) — For more information, see Link to your Jira instance.

  • Verify user permissions — Make sure the service account user in Jira has the necessary permissions to read and write to the Jira projects and issue types you are syncing. The simplest way to verify this is to log in to Jira as that user and try creating or updating items in the project you intend to sync.

  • Verify authentication type — If your Jira Data Center connector uses basic authentication, ensure that basic authentication is enabled on your Jira system for all users or, at minimum, for the Jama Connect Interchange user.

    • If you must authenticate using basic authentication, see Creating an allow list when basic authentication is disabled.

    • In step 2, enter the following script, replacing "svc-jama-integration" with the username for your Jama Connect Interchange service account.

      {
              "block-requests": true,
              "allowed-paths": [
                             "/rest/issue/*",
                             "/rest/search/*",
                             "/rest/myself/*",
                             "/rest/project/*",
                             "/rest/field/*",
                             "/rest/workflow/*"
              ],
              "allowed-users": [
                             "svc-jama-integration"
              ],
              "show-warning-message": true

  • Verify IP and URL allow lists — Add the Jama Connect Interchange IP address and URL to your Jira allow lists.

    1. Add URLs to the allow list, using your Jama Connect Interchange URL in the format "https://<name>.jamainterchange.com".

    2. Specify IP addresses for product access. To obtain the Jama Connect Interchange IP address, submit a support ticket.

In this section: