Skip to content

Jira Integration Permissions

This page covers the roles and permissions required to configure and use the Jira integration in Qualytics.

Two Permission Layers

Permissions for the Jira integration are split into two layers:

  • Qualytics User Role (Admin, Manager, Member) controls who can manage the integration and perform global actions.
  • Team Permission (Editor, Author, Drafter, Viewer, Reporter). For actions that touch a specific anomaly, the user must also have the right permission on the anomaly's datastore team.

Integration Configuration

Actions that manage the integration itself (connecting, viewing, disconnecting).

Action Member Manager Admin
View integrations list
View Jira integration details
Connect Jira integration
Disconnect / delete integration
Search Jira tickets
Get Jira ticket by ID

Single Integration

Only one ticketing integration can be active at a time. Connecting a Jira integration while ServiceNow is already connected will fail until the existing one is disconnected.

Ticket Operations on Anomalies

Actions that create or manage links between anomalies and Jira issues. These require both the right user role and the right team permission on the anomaly's datastore.

Action Member Manager Admin Team Permission
View linked tickets on an anomaly Reporter
Create a Jira ticket from an anomaly Author
Link an existing Jira ticket to an anomaly Author
Remove a link between an anomaly and a ticket Author
Change a linked issue's sync mode Author

Team Permissions Hierarchy

Team permissions are hierarchical: Editor → Author → Drafter → Viewer → Reporter. Higher-tier permissions automatically include all lower-tier permissions. For example, a user with Editor permission automatically satisfies any action requiring Author, Drafter, Viewer, or Reporter.

See Team Permissions for details.

How Both Layers Work Together

For ticket operations on anomalies, both layers must be satisfied:

  1. The user must have the required Qualytics user role (e.g., Manager+ to create tickets).
  2. The user must have the required team permission on the anomaly's datastore (e.g., Reporter to view, Author to link).

Examples:

  • A Member with Editor team permission cannot create a Jira ticket, because Member is blocked at the user-role layer.
  • A Manager without team membership in the datastore cannot create tickets for anomalies in that datastore, because they are blocked at the team layer.
  • An Admin bypasses team permissions entirely and has full access regardless of team membership.

UI Behavior Without Permission

Scenario What the User Sees
Member opening the Integrations page The Integrations tab is not shown in Settings and a direct URL redirects away, so the Jira integration cannot be viewed, connected, edited, or deleted.
Member viewing an anomaly with linked tickets The linked tickets list is visible (read-only) if they have Reporter permission on the datastore.
Member trying to create/link a ticket Without the Author team permission the Link or create ticket button in the Tickets section is not shown.
Manager without team access to a datastore Cannot create or link tickets for anomalies in that datastore even with Manager role.

Jira-Side Permissions

The Jira account used for the integration must have the following permissions in the target project(s):

Permission Purpose
Browse Projects Read the projects and their issues, which is also how the project list is offered while connecting
Create Issues Open issues from anomalies and from Flow actions
Edit Issues Update issue fields
Add Comments Post the mirrored comments and the status notes
Edit Own Comments Carry an edit made in Qualytics across to the comment on the issue
Delete Own Comments Remove the copy on the issue when the comment is deleted in Qualytics
Transition Issues Move an issue to the mapped status. Without it, Anomaly status sync posts the note but the issue does not move, and the starting status chosen on the create form is not applied

Registering the webhook needs more

Webhooks live in Jira's system settings, so creating one requires a Jira administrator, not just the integration account. See Register the Jira Webhook.

See Jira Integration Requirements for the instance and account the integration needs.

Full User Roles Reference

For the complete User Roles matrix across all Qualytics features, see the User Roles page.

See Also