• Compare integrations
  • Jira integration
  • Jira development panel integration
  • Direct feature comparison
• Authentication in Jira
• Privacy considerations
• Troubleshooting
  • WVS cannot comment on a Jira issue
  • WVS cannot close a Jira issue
  • CAPTCHA

Jira integrations

If your organization uses Jira issues, you can migrate your issues from Jira and work exclusively in WVS. However, if you’d like to continue to use Jira, you can integrate it with WVS. WVS offers two types of Jira integrations, and you can use one or both depending on the capabilities you need. We recommend you enable both.

Compare integrations

After you set up one or both of these integrations, you can cross-reference activity in your WVS project with any of your projects in Jira.

Jira integration

This integration connects one or more WVS projects to a Jira instance. The Jira instance can be hosted by you or in Atlassian cloud. The supported Jira versions are v6.x, v7.x, and v8.x.

To set up the integration, configure the settings in WVS.

Jira development panel integration

The Jira development panel integration connects all WVS projects under a group or personal namespace. When configured, relevant WVS information, including related branches, commits, and merge requests, displays in the development panel.

To set up the Jira development panel integration, use the WVS.io for Jira Cloud app or the Jira DVCS (distributed version control system) connector, depending on your installation.

Direct feature comparison

Capability	Jira integration	Jira development panel integration
Mention a Jira issue ID in a WVS commit or merge request, and a link to the Jira issue is created.	Yes.	No.
Mention a Jira issue ID in WVS and the Jira issue shows the WVS issue or merge request.	Yes. A Jira comment with the WVS issue or MR title links to WVS. The first mention is also added to the Jira issue under Web links.	Yes, in the issue’s development panel.
Mention a Jira issue ID in a WVS commit message and the Jira issue shows the commit message.	Yes. The entire commit message is displayed in the Jira issue as a comment and under Web links. Each message links back to the commit in WVS.	Yes, in the issue’s development panel and optionally with a custom comment on the Jira issue using Jira Smart Commits.
Mention a Jira issue ID in a WVS branch name and the Jira issue shows the branch name.	No.	Yes, in the issue’s development panel.
Add Jira time tracking to an issue.	No.	Yes. Time can be specified using Jira Smart Commits.
Use a Git commit or merge request to transition or close a Jira issue.	Yes. Only a single transition type, typically configured to close the issue by setting it to Done.	Yes. Transition to any state using Jira Smart Commits.
Display a list of Jira issues.	Yes.	No.
Create a Jira issue from a vulnerability or finding.	Yes.	No.
Create a WVS branch from a Jira issue.	No.	Yes, in the issue’s development panel.

Authentication in Jira

The authentication method in Jira depends on whether you host Jira on your own server or on Atlassian cloud:

• Jira Server supports basic authentication. When connecting, a username and password are required. Connecting to Jira Server using the Central Authentication Service (CAS) is not possible. For more information, read how to set up a user in Jira Server.
• Jira on Atlassian cloud supports authentication through an API token. When connecting to Jira on Atlassian cloud, an email and API token are required. For more information, read create an API token for Jira in Atlassian cloud.

Privacy considerations

If you integrate a private WVS project with Jira using the Jira integration, actions in WVS issues and merge requests linked to a Jira issue leak information about the private project to non-administrator Jira users. If your installation uses Jira Cloud, you can use the WVS.io for Jira Cloud app to avoid this risk.

Troubleshooting

If these features do not work as expected, it is likely due to a problem with the way the integration settings were configured.

WVS cannot comment on a Jira issue

If WVS cannot comment on Jira issues, make sure the Jira user you set up for the integration has permission to:

• Post comments on a Jira issue.
• Transition the Jira issue.

Jira issue references and update comments do not work if the WVS issue tracker is disabled.

WVS cannot close a Jira issue

If WVS cannot close a Jira issue:

• Make sure the Transition ID you set in the Jira settings matches the one your project needs to close an issue.

• Make sure the Jira issue is not already marked as resolved:

  • Check the Jira issue resolution field is not set.
  • Check the issue is not struck through in Jira lists.

CAPTCHA

CAPTCHA may be triggered after several consecutive failed login attempts, which may lead to a 401 unauthorized error when testing your Jira integration. If CAPTCHA has been triggered, you can’t use Jira’s REST API to authenticate with the Jira site.

To fix this error, sign in to your Jira instance and complete the CAPTCHA.

---

For Additional Support please reach out to us on our Discord or by Email.