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. 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 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

CloudBees SDM stores the following data from a Jira 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 development mode, 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. Select Apps, and then select Jira Connect.

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

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

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

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

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

  7. On the Successful connection dialog, click Close.

Editing a Jira Cloud integration

To edit a Jira Cloud integration:

  1. Select Apps to display a list of installed and available apps.

  2. Select Jira Cloud.

  3. 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 Cloud 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. Select Apps to display a list of installed and available apps.

  2. Select Jira Cloud.

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

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

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

  6. Uninstall the CloudBees Jira Connect app.