Skip to content

Connect Jira

Step-by-step guide to connecting Jira to Thalian for issue tracking, ITSM intelligence, and alert delivery. A single Jira connection covers both Jira and Jira Service Management.

Prerequisites

  • Atlassian Cloud account with Jira access
  • Project admin or site admin permissions for OAuth consent

Connect via OAuth

  1. Go to Integrations → Browse
  2. Find Jira and click Connect
  3. Click Authorize with Atlassian
  4. Sign in with your Atlassian account
  5. Select the Jira site you want to connect
  6. Review the requested permissions — Thalian requests read-only access plus write access for creating issues when alert rules are configured
  7. Click Accept to grant consent
  8. You'll be redirected back to Thalian — the integration is now connected

Requested Permissions

Scope Justification
read:jira-work Searches open issues to surface existing tickets, avoid duplicates, and report on backlog risk
write:jira-work Creates new Jira issues when security findings require a ticket (auto-remediation)
read:jira-user Fetches all Jira users for identity sync and to populate the assignee field on auto-created tickets
read:servicedesk-request Reads open Service Desk requests to include them in ITSM metrics and risk reporting
write:servicedesk-request Creates Jira Service Management incident requests when create_as_incident is enabled
read:me Fetches accessible cloud resources after OAuth to determine the correct cloud ID for API calls
read:account Fetches account-level metadata required by the Atlassian OAuth flow
offline_access Standard OAuth — allows token refresh without re-prompting

Alternative: API Token

If your organization restricts OAuth:

  1. Go to id.atlassian.com → Security → API tokens
  2. Click Create API token and copy the value
  3. In Thalian, select the API connection method
  4. Enter your Atlassian email, API token, and site URL (e.g., yourcompany.atlassian.net)
  5. Click Save

What Thalian Syncs

  • Issues — issues across projects with status, assignee, and priority
  • Users — Jira user directory for cross-referencing with identity data
  • Service requests — Jira Service Management tickets, SLA data, and queues
  • Agents — service desk agent directory and assignments

Alert Rules

When alert rules are enabled, Thalian can automatically create Jira issues or service requests for new findings above your configured severity threshold.

For a full list of supported platforms, see Integrations Guide.