Censys ASM JIRA Integration
Setting up the Integration
Contact firstname.lastname@example.org for assistance setting up the JIRA integration.
Using the Integration
Once setup is complete, use the integration to create tickets for assets that need attention from your security teams with the click of a button.
Create a Ticket
On every Inventory details page, a Create Jira Ticket button is located in the top right corner.
Click the button to start the ticket creation process. In the modal that opens, select from the list which information about the asset to include in the ticket. Then, click Next.
See below for a list of the information you can include for each type of inventory.
Censys information available for every asset type that can be included in a Jira ticket includes:
- Asset overview information
- Asset trail (a list of associated assets that led to the discovery of this asset)
Asset-specific data is also available for some asset types:
- Ports and protocols
- Certificates presented by host
- Certificate details
- Hosts presenting this certificate
- Names on the certificate
On the next page, select the Jira project where the ticket should be filed, the type of ticket, and the reporter and assignee. The ability to set these fields, as well as the list of values shown, reflect the permissions of the Jira account used for the integration. Then, click Create Issue.
A confirmation modal will show details about the created ticket, including its project, status, and summary.
Once the ticket is created, it will be shown in a card on the details page below the Overview.
Tickets List Page
Navigate to Tickets from the top nav to see a list of all JIRA issues related to your attack surface.
The table is indexed by the Jira Ticket ID column. Other default columns include:
Created At - The date that the ticket was create on.
Status - The enumerated status of the ticket, indicating whether or not it is being worked on or has been completed.
Summary - The title of the ticket.
Linked Assets - The piece of inventory that the ticket was created for. Click this link to go to its details page.
Assignee - The name of the person to whom the ticket is assigned (if it has been assigned).
You can hide or display additional columns by clicking the Columns button above the table.
Additional columns include:
Project - The Jira project that the ticket is located in.
From this page, you can navigate to the ticket itself in JIRA, view the linked asset in the ASM platform, and remove tickets.
Filter tickets using the filter builder above the table.
Clean up your list of finished tickets by removing them from the ASM platform. Removing a ticket in the ASM platform does not remove it from your Jira project.
Select the checkbox in the row next to the ticket you wish to remove and click the Remove button that appears in the footer at the bottom of the page.