Skip to main content

The Atlassian Cloud sensor

The Atlassian Cloud sensor integrates with and protects collaboration, project management, and software development applications from the Atlassian Cloud suite, such as Confluence and Jira.

Atlassian Cloud sensor prerequisites

  1. Check the prerequisites and get the required information for your Atlassian organization:

    1. Log in to your Atlassian Admin.

    2. Select the organization you want to create the integration for.

    3. Make sure you have a license with access to the Atlassian Guard product.

      Atlassian_Cloud_sensor_view_products_en_934130.png

    4. Go to the Settings page, and select API keys from the menu on the left side of the page.

      Atlassian_Cloud_sensor_API_keys_en_934130.png

      This will take you to the API keys page.

    5. Click the Create API key button on the upper right side of the page.

    6. Under the Name tab, type in a descriptive name for the key, set an expiration date, and click Next.

      Atlassian_Cloud_sensor_add_key_en_934130.png

      The API key tab is displayed.

    7. Write down the Organization ID and API key shown on the screen.

    8. Click Done.

  2. (Optional) If you want to add a Jira or Confluence sensor, check the prerequisites and get the required information for your Atlassian instance.

    Note

    For Jira or Confluence sensors, any organization account can be used if it has application administrator rights for the specific Jira or Confluence product to be integrated. It is not mandatory to use an organization admin account for this step.

    1. While still logged in to Atlassian Admin, click the User icon on the upper right side of the screen and select Account Settings.

      Atlassian_Cloud_sensor_Account_Settings_en_934130.png

    2. Write down the email address of the administrator account of the instance.

    3. Write down the site domain of your Atlassian instance.

    4. Go to the Security tab, scroll down to the API tokens section, and click Create and manage API tokens.

      The API Tokens page is displayed.

    5. Click the Create API token button on the top of the page.

      Atlassian_Cloud_sensor_API_tokens_en_934130.png

      The Create API token window is displayed.

    6. Type in a descriptive name and click Create.

      The Your new API token window is displayed.

    7. Click the Copy button and write down the API token.

Setting up the Atlassian Cloud sensor

  1. In the Configuration > Sensors Management page, select Add new to integrate a new sensor.

  2. Select the Atlassian Cloud sensor and click Integrate.

  3. On the Check Requirements page, confirm that the prerequisite steps have been completed.

  4. Name the integration and provide the necessary details for your Atlassian organization.

  5. (Optional) Select the Allow response actions from GravityZone incidents checkbox to enable response actions from XDR incidents.

    Note

    The Atlassian Admin sensor is is mandatory for the Atlassian Cloud XDR integration. The Jira and Confluence sensors are optional, although strongly recommended to improve protection.

  6. Under the Jira and Confluence integration section, enable the sensors for each product instance in the Atlassian organization.

    Note

    You can create multiple sensors.

  7. Choose which Atlassian application to connect to.

  8. Add the required credentials information for the sensor you want to create and click Add to list.

  9. Repeat for any other sensors.

  10. Select Add sensor.

    A confirmation window will appear, containing integration details and a list of sensors that have been created.

  11. Click Done.

The new integration will be available in the Sensors Management grid.

In this section: