Configure the Jira integration in WVS

You can set up the Jira integration by configuring your project settings in WVS. You can also configure these settings at a group level, and for self-managed WVS, at an instance level.


  • Ensure your WVS installation does not use a relative URL.
  • For Jira Server, ensure you have a Jira username and password. See authentication in Jira.
  • For Jira on Atlassian cloud, ensure you have an API token and the email address you used to create the token. See authentication in Jira.

To configure your project:

  1. Go to your project and select Settings > Integrations.
  2. Select Jira.
  3. Select Enable integration.
  4. Select Trigger actions. Your choice determines whether a mention of Jira issue (in a WVS commit, merge request, or both) creates a cross-link in Jira back to WVS.
  5. To comment in the Jira issue when a Trigger action is made in WVS, select Enable comments.
  6. To transition Jira issues when a closing reference is made in WVS, select Enable Jira transitions.
  7. Provide Jira configuration information:
    • Web URL: The base URL to the Jira instance web interface you’re linking to this WVS project, such as
    • Jira API URL: The base URL to the Jira instance API, such as Defaults to the Web URL value if not set. Leave blank if using Jira on Atlassian cloud.
    • Username or Email: For Jira Server, use username. For Jira on Atlassian cloud, use email.
    • Password/API token: Use password for Jira Server or API token for Jira on Atlassian cloud.
  8. To enable issue creation for vulnerabilities , select Enable Jira issues creation from vulnerabilities.
  9. Select the Jira issue type. If the dropdown is empty, select refresh () and try again.
  10. To verify the Jira connection is working, select Test settings.
  11. Select Save changes.

Your WVS project can now interact with all Jira projects in your instance and the project now displays a Jira link that opens the Jira project.