Atlassian Jira

Access Levels: Advanced | Enterprise

The Censys Attack Surface Management (ASM) integration with Atlassian Jira enables you to remediate exposures and risks in your attack surface rapidly. After you set up a connection between ASM and Jira, you can create tickets in Jira directly from assets in ASM.

Prerequisites

• You must have an active subscription to Atlassian Jira.
• You will need your Jira API token and hostname.
  • This information is in your Jira profile, or you can follow Atlassian's documentation to create a new API token.
• An Admin must configure this integration in your Jira account.

📘

Note

The Jira tickets created via this integration will show your Jira username as the creator of the tickets.

Configure the integration in Censys ASM

1. Go to the ASM web console and click Integrations.

2. Locate Jira and click Set Up.

3. Configure the integration settings:

   1. Connection type: Select Cloud.

   2. Auth type: Select API token.

   3. Host name: Enter the host name for your Jira account.

   4. Email: Enter your admin email address for your Jira account.

   5. API token: Enter your Jira API token.

      

4. At the bottom of the page, click Connect.

5. Above the configuration form, click Submit, then click Done.

   

Edit your Jira integration

If you need to make changes to your integration, follow the Configure the Jira integration in Censys steps above to go through the setup wizard again.

Create a Jira Ticket

1. On the Inventory details page, click Create Jira Ticket.

   

2. Select the Censys information to include in the Jira ticket:

   1. Risks
      1. Asset overview information
      2. Asset trail (a list of associated assets that led to the discovery of this asset)
      3. Asset-specific data is also available for some asset types:
   2. Hosts
      1. Ports and protocols
      2. Software
      3. Certificates presented by host
   3. Certificates
      1. Certificate details
      2. Hosts presenting this certificate
      3. Names on the certificate

3. Click Next.

   

4. On the next page, select the Jira project where you want the ticket filed, the type of ticket, and the reporter and assignee. The values you can set and the list of values shown are based on the permissions of the Jira account used for the integration.

5. Click Create Issue. The ticket is displayed in the Tickets area below the Overview.