Issues connecting using Atlassian Jira Integration for Agile Development

Adam Geil
Kilo Sage

I'm attempting to set up the Atlassian Jira Integration for Agile Development plugin, but I'm encountering issues connecting.

 

The Docs article (Connecting Agile Development to Jira) indicates that Basic Auth needs to be used, but Atlassian seems to only allow API keys to be used for integrations. Because of this, I'm not sure how the Basic Auth credentials should be set up. I've tried the following without any success:

  • Option 1
    • Username: <blank>
    • Password: <API Key>
  • Option 2
    • Username: <Jira username of individual that generated the API Key>
    • Password: <API Key>

Any help/guidance would be greatly appreciated!

3 REPLIES 3

Rajesh_Singh
Kilo Sage
Kilo Sage

@Adam Geil 

 

The Atlassian Jira Integration for Agile Development plugin in ServiceNow requires API tokens for authentication instead of using the traditional Basic Auth with a username and password. To set up the integration, you should follow these steps:

  1. Generate an API token in Jira:

    a. Log in to your Atlassian account (https://id.atlassian.com/manage-profile/security/api-tokens). b. Click on "Create API token." c. Provide a descriptive name for the token, such as "ServiceNow Integration." d. Click "Create," and your new API token will be displayed. e. Make sure to copy the token and store it securely, as you won't be able to see it again.

  2. Configure the ServiceNow Jira integration with the API token:

    a. In ServiceNow, navigate to "System Web Services" > "Outbound" > "REST Message." b. Find and open the "Jira" REST message. c. Click on the "HTTP Basic Auth" tab. d. Click "New" to create a new Basic Auth profile. e. Provide a name for the profile, such as "Jira Integration." f. In the "Username" field, enter the email address associated with your Atlassian account. g. In the "Password" field, enter the API token you generated earlier. h. Click "Submit."

  3. Test the connection:

    a. Open the "Jira" REST message again. b. On the "Related Links" section, click "Test Credential" and select the Basic Auth profile you created. c. ServiceNow will attempt to connect to Jira using the provided credentials. If the connection is successful, you should see a "Connection is successful" message.

By following these steps, you should be able to set up the Atlassian Jira Integration for Agile Development plugin in ServiceNow using API tokens for authentication. Make sure to use the correct Atlassian account email address and API token when configuring the Basic Auth profile in ServiceNow.

If you found my response helpful or applicable, please consider marking it as correct or helpful to assist others who may be seeking the same information.

---------------
Regards,
Rajesh Singh

Mathieu Lepoutr
Mega Guru

hi Adam

 

API keys are now the preferred way to authenticate with Jira instead of using Basic Auth.

Please have a look at Exalate aswell, it will be beneficial here.

 

Thanks

scotcbrown
Kilo Contributor

It looks like the issue stems from Atlassian deprecating Basic Auth in favor of API tokens for integrations. Instead of using a blank username, try the following approach:

Use your Atlassian email as the username
Use the API key as the password

So your credentials should be:

Username: <your Atlassian email>
Password: <your API key>

If you're still facing issues, check whether:

  • The API key was generated for the correct user permissions.

  • You're using HTTPS, as Atlassian requires it for API authentication.

  • The integration settings in your Agile Development plugin support API token authentication.

For a seamless Jira integration setup, working with custom software development experts can help ensure proper implementation and troubleshooting. If the issue persists, you may need to explore OAuth 2.0 authentication, as some newer integrations require it instead of API keys. Let me know if you need further troubleshooting!