Jira Cloud integration

CloudBees SDM is a preview, with early access for select preview members. Product features and documentation are frequently updated. If you find an issue or have a suggestion, please contact CloudBees Support.

Jira integration allows you to link Jira projects to associated products, and get visibility into all tickets and related data, which enables more efficient prioritization and tracking of all work related to those projects.

Integration with Jira Cloud is provided through the CloudBees Jira Connect app, which is available on the Atlassian marketplace.

During the preview, the Jira Connect app is available through a private beta program. It will be available on the Atlassian marketplace when the product is generally available.

After you install the CloudBees Jira Connect app in your Jira Cloud instance, webhooks and requests for data can be sent and received between CloudBees SDM and your Jira Cloud instance.

How CloudBees SDM handles data from Jira Cloud

CloudBees SDM stores the following data from a Jira Cloud integration:

  • Issue

  • Comment

  • Instance. CloudBees SDM stores server information for each Jira Cloud instance to get the time zone offset configured in Jira for the instance and apply it to timestamps on comment events that are missing it.

  • User, but only the following fields:

    • Display name - The public profile name

    • Key - The Jira handle

    • Account ID - The unique identifier for the profile, provided by Jira

    • URL - The URL for the user profile

    • Avatar - The URLs for the profile’s avatars

    • Time zone - The time zone for the profile

    • Active - The active/closed status for the profile

The private Jira user data associated with the Jira issues and comments, such as assignee, author, etc., is stored separately from the other Jira data. CloudBees complies with Jira’s User Privacy Guide for App Developers. This requires frequently reporting back to Jira Cloud with the data that is stored for each user. This allows for each user to know what data is stored in the System of Record for their profile, see when the data was last updated, and request the data to be modified or deleted.

After the Jira Cloud app is uninstalled, all user data associated with the Jira Cloud instance is deleted from the System of Record.

Enabling the CloudBees Jira Cloud app

To enable the CloudBees Jira Connect app:

  1. Go to the UPM page of your Jira instance. Example: https://{your-instance-name}.atlassian.net/plugins/servlet/upm?source=side_nav_manage_addons

  2. Select Settings.

  3. Select Enable private listings, and then select Apply.

  4. Select Upload app, paste in the URL https://app.cloudbees.com/data/hooks/jira/v1/descriptor, and then select Upload.

Connecting to Jira Cloud

To connect to Jira Cloud:

  1. In the top right of any screen, select the name of the organization.

  2. Select Manage integrations.

  3. Select Add integration. NOTE: You can select "Add integration" multiple times for the same account to add multiple Jira cloud instances.

  4. On the Add integration screen, select Jira Connect, and then select Add.

  5. On the Add Jira integration screen, verify that you want to install and configure the CloudBees Jira Connect app, and then click Add. You will be redirected to the Atlassian website.

  6. On the CloudBees Jira Connect screen, in Authorize for, select the account to which you want to connect Jira.

  7. Select Accept. You will be redirected to CloudBees SDM.

  8. On the Successful connection dialog, click Close.

Editing a Jira Cloud integration

To edit a Jira Cloud integration:

  1. In the top right of any screen, select the name of the organization.

  2. Select Manage integrations.

  3. On the Integrations screen, select the Jira Connect card.

  4. On the Integrations/Jira Connect screen, select the Jira Cloud instance that you want to edit, and then select Configure integration. You will be redirected to the Atlassian website to configure the Jira Connect app settings. You must have the appropriate Jira admin permissions to edit the settings.

Removing a Jira Cloud integration

To remove a Jira Cloud integration:

  1. In the top right of any screen, select the name of the organization.

  2. Select Manage integrations.

  3. On the Integrations screen, select the Jira Connect card.

  4. Select the Jira Cloud instance that you want to remove, and then select Remove organization.

  5. On the Remove organizations dialog box, select the checkbox for the organization you want to remove, and then select Remove.

  6. Go to the UPM page for your Jira instance. Example: https://{your-instance-name}.atlassian.net/plugins/servlet/upm?source=side_nav_manage_addons

  7. Uninstall the CloudBees Jira Connect app.