Jira Cloud integration

CloudBees Software Delivery Management 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. Learn more about the preview program.

The Jira app 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 SDM app.

During the preview, the CloudBees SDM 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 SDM app in your Jira Cloud instance, webhooks and requests for data can be sent and received between CloudBees Software Delivery Management and your Jira Cloud instance.

How CloudBees Software Delivery Management handles data from Jira

CloudBees Software Delivery Management stores the following data from a Jira integration:

  • Issue

  • Comment

  • Instance. CloudBees Software Delivery Management 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

This procedure requires Jira administrator rights.

To enable the CloudBees Software Delivery Management app for Jira Cloud:

  1. Sign in to your Jira instance as an admin.

  2. Open a new browser window to the CloudBees SDM app on the Atlassian Marketplace.

  3. Select Get it now.

  4. Select a Jira Cloud site to install the app.

  5. Select Install app.

  6. Follow the on-screen instructions.

Next, return to CloudBees Software Delivery Management to connect the Jira Cloud app.

Connecting to Jira Cloud

This procedure requires CloudBees Software Delivery Management administrator rights.

To connect Jira Cloud to CloudBees Software Delivery Management:

  1. Sign in to CloudBees Engineering Efficiency as an admin.

  2. Select User profile  Organization settings.

  3. Select Engineering Efficiency  Apps.

  4. Select Jira Cloud.

  5. Select Add connection. NOTE: You can select Add connection multiple times for the same user profile to add multiple Jira Cloud instances.

  6. On the Add Jira connection screen, verify that you want to install and configure the CloudBees SDM app, and then click Continue. You will be redirected to the Atlassian website.

  7. On the CloudBees SDM screen, in Authorize for, select the user profile to which you want to connect Jira.

  8. Select Accept. You will be redirected to CloudBees Software Delivery Management.

  9. Select a CloudBees user profile to use and select Confirm.

  10. On the Successful connection dialog, click Close.

Requesting data removal

Once data is imported into the System of Record, data will stay synchronized as part of normal operations as data changes. You can request to have data removed from your organization by contacting CloudBees support.

Removing a Jira Cloud integration

This procedure requires CloudBees Software Delivery Management administrator rights.

To remove a Jira Cloud integration:

  1. Select User profile  Organization settings.

  2. Select Engineering Efficiency  Apps.

  3. Select Jira Cloud.

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

  5. On the Remove organization 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 SDM app.