Skip to main content

Jira

Connect Jira at the organisation level so projects can sync defects or link requirements seamlessly.

Prerequisites​

  • Atlassian Cloud site admin permissions (for installing the Forge app) or a Jira user account with API token permissions if using basic auth.
  • A dedicated Jira user or app client recommended for auditing and least-privilege access.

Setup steps​

  1. Go to Configuration → Integrations → Jira.
  2. Choose an authentication method:
    • Forge app (recommended) – Install the TestFish Forge app, authorise the requested scopes, and connect the workspace. TestFish handles token refresh automatically.
    • OAuth client – Provide client ID/secret and complete the OAuth consent flow (for enterprises needing custom control).
    • API token – Supply site URL, username/email, and API token (best for non-Forge Data Center setups).
  3. Click Test connection to verify credentials.
  4. Save the integration. TestFish stores credentials encrypted and surfaces token expiry warnings.

Post-setup​

  • Projects can now configure Jira project mappings, issue types, status/priority synchronisation, and resolution rules.
  • Integration webhooks keep TestFish cards up to date when changes occur in Jira.
  • Owners/Admins can revoke the integration or refresh tokens at any time.

Security tips​

  • Prefer the Forge app or OAuth flows; they support granular scopes and automatic rotation.
  • Use a dedicated Jira service account so audit logs clearly show automated changes.
  • Restrict the integration to the minimum set of projects required and monitor audit logs after enabling sync.