Skip to main content

Jira: Quickstart

Set up the Vanta and Jira integration in minutes

✅ Feature availability: This integration is now available for Vanta Government customers.

Connect Jira to Vanta so that security work your team tracks in Jira automatically counts as compliance evidence with no manual uploads required.

Note: This guide covers Jira Cloud only.

ℹ️ Note: This guide covers the new Jira connection experience. If you click Connect and see a side drawer with a Link Jira window instead of a Jira listing page, see the Jira Integration Guide for the earlier connection steps.

What you'll do (~10 minutes total)

  1. Allow user-installed apps in Atlassian admin (~2 min)

  2. Connect Jira in Vanta, select your features, and sign in to Atlassian (~4 min)

  3. Set your sync filters and label your Jira issues (~4 min)

Before you begin

Confirm the following before starting:

  • You have admin access to Vanta

  • Your Atlassian account has the Browse users and groups global permission and Browse Projects permission on the projects you want Vanta to monitor

  • Your Atlassian organization allows user-installed apps (see Step 1)

💡 Tip: For production use, connect with a dedicated service account instead of a personal account. See the Jira Integration Guide for details.

Step 1: Allow user installed apps in Atlassian

Note: This setting requires Atlassian Organization Admin access. If your organization blocks user-installed apps, the Accept button during the Atlassian approval step will be unavailable and the connection cannot be completed.

  • Go to admin.atlassian.com.

  • Select your organization.

  • Expand apps → Sites, then select your site.

  • Click Connected apps → Settings.

  • Set User Installed Apps to Allowed. (In some versions of Atlassian, this appears as turning off Block user apps.)

  • Click Save.

Note: Navigation options may vary depending on your Atlassian version. The goal is to locate Connected Apps → Settings under your organization's site. For example, if you’re on Atlassian’s improved user management experience, go to Products → Select your site → Connected apps → Settings instead.

Step 2: Connect Jira and select features in Vanta

  • In Vanta, go to the Integrations page, click Add integration, and search for Jira. For help, see our guide to the Integrations Page.

  • On the Jira listing page, click Connect. This opens the connection guide.

  • On the Select features screen, access reviews are always on. Choose what else you want Vanta to do with Jira:

    • Task tracking: Track the Jira work items your team uses for security and incident work, and whether they're resolved within your SLAs.

    • Task creation: Create Jira work items from Vanta to track remediation work. Turn this on if you want to create Jira work items directly from Vanta tests. Vanta asks for write permissions only if it's on.

  • Click Save.

ℹ️ Note: If you have Advanced Vendor Risk Management, Vanta may also ask whether to create procurement requests from Jira work items. This is optional. See the Jira Integration Guide for details.

How to find your Atlassian site URL:

Note: You may have a different version of Atlassian which may cause variation in the following setup steps or website screenshots.

  • Click on the 4-square icon in Atlassian

  • Expand Jira

  • Select the organization you want to connect

Step 3: Sign in to Atlassian and choose your site

  • Click Connect. Vanta sends you to Atlassian.

  • Sign in, select your Jira site from the dropdown, and review the requested permissions.

  • Click Accept. Atlassian returns you to Vanta automatically.

  • On the Choose Jira site screen, select the site you want Vanta to monitor, then click Save.

ℹ️ Note: Each connection monitors one Jira site. To monitor more than one site, add each as a separate Jira connection.

Step 4: Set your sync filter

On the Set sync filters screen, choose which Jira work items Vanta tracks in the projects your Atlassian account can browse, including matching work items created later. For each category, Vanta tracks the work items that match any of the labels or the JQL you set.

  • Enter at least one label for Security, Incident management, and Incident resolution. Vanta suggests security, incident-management, and incident-resolution, or you can type your own.

  • Access offboarding is optional. Leave it empty to skip it.

  • Labels are case-sensitive and can't contain spaces, quotes, or backslashes. A label entered as Security won't match security.

  • Prefer JQL? Select Use JQL instead of labels for that category and enter a query. Leave out ORDER BY, because Vanta sorts results itself and won't save a query that includes it.

  • Click Save. You'll see "You're connected."

You can change these filters later from the integration settings.

Step 5: Label your security issues in Jira

Vanta tracks Jira issues that carry the Security labels you entered in Step 4. Add the same label, exactly as you typed it, to any issue you want Vanta to pick up as compliance evidence.

Add this label to any issue you want Vanta to pick up as compliance evidence.

  • Open an issue in Jira

  • In the Labels field, add your security label (for example, security).

  • Repeat for any other issues you want Vanta to track

Tip: You can add the security label to issues in bulk using Jira's bulk edit feature. You can also add it to new issues going forward as part of your team's workflow.

  • Need to change your labels? Edit the connection from Integrations → Jira → Settings, then click the three dots next to the connection and select Edit. See the Jira Integration Guide for details.

Step 6: Verify tasks are appearing in Vanta

  • In Vanta, navigate to Tests and filter the All resource monitoring tab by integration.

  • Select Jira as the integration filter.

  • Then click on any security-related test that appears (e.g. a test that tracks whether security issues are resolved within your SLA).

  • You’ll land on the results tab by default.

  • If Jira issues with your configured label are being pulled in, you’ll see them listed under a header like “{18} issues need remediation.

Don't see anything yet? Sync is not instant. Most issues appear within 1-2 hours of connecting, though it can take longer for very large Jira instances.

You’re connected

Once your Jira issues are appearing in Vanta, your integration is working. From here, your team can continue working in Jira as normal. Vanta will now sync matching Jira issues automatically. No further action needed.

Troubleshooting

Accept button is unavailable during setup

  • Likely cause: Your Atlassian organization blocks user-installed apps.

  • Fix: Return to your Atlassian admin console and confirm User Installed Apps is set to Allowed (in some versions, turn off Block user apps), then retry the connection.

Vanta says the connected account can't browse users, groups, or projects

  • Likely cause: The Atlassian account you signed in with is missing a permission. -

  • Fix: Grant the account the Browse users and groups global permission and Browse Projects on at least one project you want Vanta to monitor, then try again. You can also choose a different Jira site or reconnect with a different account.

Tasks are not appearing in Vanta after setup

  • Likely cause: The label on the Jira issue doesn't exactly match the label you entered in Step 4. Labels are case-sensitive.

  • Fix: Confirm the label is in the Labels field on the Jira issue (not a comment or the description) and matches your sync filter exactly. Allow a few hours for the initial sync to complete.

My JQL query won't save

  • Likely cause: The query contains ORDER BY, or Jira can't parse it.

  • Fix: Remove ORDER BY (Vanta sorts results itself) and check the query for syntax errors.

Additional resources

To create Jira issues directly from Vanta tests or configure advanced settings, see the Jira Integration Guide.

For issues not covered here, Contact Vanta Support or refer to the troubleshooting section of the full guide.