Skip to main content

Authentication

The authentication methods depend on whether you connect to Jira Cloud or Jira Data Center. Until the plugin has connected to the instance, it tells them apart by the URL: a site on atlassian.net or jira.com gets the Jira Cloud prompt, and any other URL the Data Center one.

API Token (Cloud)​

Create a token at Atlassian API tokens, using either option Atlassian offers:

  • Create API token — an unscoped token that inherits your full account permissions.
  • Create API token with scopes — select the Jira app and the read:jira-work, write:jira-work, and read:jira-user scopes.

When the plugin prompts for authentication, enter your Atlassian account email and the token. A Jira Cloud site on a custom domain gets the Data Center prompt: enter the email as the username and the token as the password.

Username and Password (Data Center)​

Enter your Jira Data Center username and password when prompted.

Personal Access Token (Data Center)​

Personal access tokens must be enabled by your Jira administrator.

  1. When the plugin prompts for authentication, click Use personal access token.
  2. Click Create token to open the personal access tokens page of your Jira profile, and create a token there.
  3. Paste the token into the prompt.

Changing Account​

To switch to a different Jira account, use the Change Account action in the Jira Issues tool window toolbar.

Default Account​

Check Use this account for other projects by default when logging in to reuse these credentials in every project in this IDE that connects to the same Jira instance and has no account of its own. Otherwise, the account belongs to this project in this IDE only: opening the project in another IDE asks you to sign in again.

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.

Each IDE keeps its own credentials, so signing in, changing the account, or signing out in one IDE doesn't affect another.