Jira Cloud

vScope can inventory Jira Cloud for users, groups and work items (issues).

This allows you to keep track of:

• Active and inactive users to ensure correct licensing
• Group memberships for security compliance
• Work item progress and their assignments

Adding Jira Cloud data to vScope

vScope currently supports Jira Cloud through Basic Auth which requires a username and password. The username is simply your Jira username (usually an email) and the password is an API token.

Get a Jira Cloud API token

To generate an API token for Jira Cloud for use with Basic Auth:

1. Navigate to your Atlassian Account security settings.
2. Click on Create and manage API tokens
3. Click on Create API token.
4. Name and expiry: Enter a Name and set Expires on to at least one year ahead.
5. Generate the token and copy it. You will not be able to copy or see it in clear text after this step.

Note

Basic Auth does not support API tokens with scopes.

Tip

Set a longer expiry for the API token to avoid having to generate new API tokens too often.

Add Jira Cloud to vScope

1. Navigate to Discovery > Credentials.
2. Click Create credential and choose Jira Cloud.
3. Enter your username and the API token you generated earlier.

Inventory Settings

You may control the inventory using the Inventory Settings:

• Accounts - Enable or disable inventory of users
• Groups - Enable or disable inventory of users
• Work Items - Enable or disable inventory of work items (issues)
  • Project keys to include - If empty, all projects are inventoried for work items. If specified, only the projects with the specified keys are inventoried.
  • Statuses to include - If empty, all work items are inventoried except for those in Statuses to exclude. If specified, only work items with the specified statuses are inventoried.
  • Statuses to exclude - If empty, no work items are excluded. If specified, work items with the specified statuses are excluded from the inventory.

Tip

The project key can be found under Project Settings in Jira or by checking the prefix of the issues within the project. For example, the work item (issue) MYPROJECT-1234 belongs to a project with the project key MYPROJECT.

Tip

To exclude Done work items, add Done to the Statuses to exclude inventory setting.

During the next discovery, vScope will attempt to retrieve users, groups and work items from Jira Cloud. These will be available as User Accounts, Groups and Work Items.