Integrations

Jira Cloud

title: Jira Cloud description: Configure Jira Cloud integration for automatic compliance monitoring in Tidal Control sidebar_position: 7

Configuring Jira Cloud integration

The Jira Cloud integration enables Tidal Control to automatically execute compliance tests on your Jira environment via an API token configuration.

Jira Cloud is a powerful tool for issue tracking and project management that helps teams plan, assign, track, report and manage work within various projects.

Requirements:

  • Super User role in Tidal Control
  • Jira Cloud account with project access
  • Atlassian account management rights
  • Access to Jira Cloud instance

Configuration step-by-step plan

What we're going to do: We'll create a Jira API token with scopes in your Atlassian account that allows Tidal to retrieve compliance data. A scoped API token is an Atlassian mechanism that enables external applications (Tidal) to securely access specific Jira resources with limited rights.

Configuration steps:

  1. Create API token
  2. Complete integration

Step 1: Create API token

  • Go to Atlassian Account API Tokens at https://id.atlassian.com/manage-profile/security/api-tokens

  • Log in with your Jira Cloud account

  • Click Create API token with scopes top right

  • Token configuration:

    • Label: Tidal Control Integration
    • Expiry date: Select desired validity period (max. 1 year)
    • Click Next
    • Select Jira as the app for the API token
    • Click Next
    • Select the following scopes:
      • read:jira-user
      • read:jira-work
    • Click Next

  • Complete token:

    • Check API token details
    • Click Create token
    • Copy token value immediately (no longer visible after closing)
    • Click Close
Info

Token validity: Jira Cloud API tokens have a maximum validity period of one year. When your API token expires, Tidal Control can no longer retrieve data from your Jira Cloud environment.

Step 2: Complete integration

  • Go to Settings → Integrations in Tidal Control
  • Click the plus icon next to Jira Cloud
  • Fill in configuration:
    • Name: Jira Production
    • Username: The email address you use to log into Jira (and that was used to create the API token)
    • API url: Your Jira instance URL (format: https://yourcompany.atlassian.net)
    • API token: Copied token value (from step 1)
  • Click "Create" to save integration
Tip

API URL format: Always use complete URL including https:// (e.g. https://company.atlassian.net)

Setup for multiple sites

If you need to connect multiple Jira sites to Tidal Control:

  • Repeat token creation for each Jira site
  • Configure separate integration in Tidal per site
  • Use descriptive names to distinguish sites (e.g. "Jira Development", "Jira Operations")

Verification

After successful configuration, Settings → Integrations shows a "Connected" status for Jira Cloud, Jira-specific tests are available in the Tests section, and test refreshes deliver results without authentication errors.

Warning

Save API token: Note the API token securely - it's no longer visible after creation and uniquely needed for troubleshooting

Troubleshooting

Troubleshooting issues:

  • Verify API token is correctly copied (no extra spaces)
  • Check API URL format including https:// and correct domain
  • Confirm username matches the email address of the person who created the token
  • Check that token expiry date has not been reached
  • Confirm that the API token has the correct permissions (read:jira-user, read:jira-work)

For more information about Jira Cloud API management: See official Atlassian documentation

Still having trouble?

Send an email to support@tidalcontrol.com, and we'll get in touch as soon as possible.

Info

Gathering support info: Note which browser you're using, exact error messages, which steps you've already tried, and screenshots of the problem. This significantly speeds up the solution.

Previous
GitLab
Next
Getting started with user management