Skip to main content

Authentication

The plugin requires authentication to access the Jira Cloud API using an API token.

Setting Up​

When you open the Jira Issues tool window for the first time:

  • If you have already configured a Jira Cloud instance through the built-in Tasks plugin (Settings | Tools | Tasks | Servers), the plugin reuses those credentials automatically — your instance will appear in the dropdown.
  • Otherwise, click Click to add instance, enter your Jira Cloud URL, and authenticate when prompted.

API Token​

  1. Go to Atlassian API tokens and click Create API token.
  2. Give the token a name and click Create.
  3. Copy the generated token.
  4. When the plugin prompts for authentication, enter your Atlassian account email and the API token.
note

The API token requires the following scopes: read:jira-work, write:jira-work, and read:jira-user.

Changing Account​

To switch to a different Jira account, use the Change Account action in the Jira Issues tool window toolbar. This opens the login dialog where you can enter new credentials.

Credential Storage​

All credentials are stored securely in the IDE's built-in credential store (Settings | Appearance & Behavior | System Settings | Passwords). No passwords or tokens are stored in plain text or in project files.