- 18 Sep 2024
- 6 Minutes to read
- Print
- DarkLight
- PDF
Jira Service Management - Create Ticket per Asset
- Updated on 18 Sep 2024
- 6 Minutes to read
- Print
- DarkLight
- PDF
This Enforcement Action replaces Jira - Create Issue per Asset, which was deprecated.
Jira Service Management - Create Ticket per Asset creates an incident in ServiceDesk for each entity retrieved from the saved query supplied as a trigger (or from the entities selected in the asset table).
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
Details for all devices are included in the ticket message as well as the CSV.
General Settings
- Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
- Use stored credentials from Jira Service Desk adapter - Select this option to use the first connected Jira Service Management adapter credentials. When you select this option, the Select Adapter Connection drop-down is available, and you can choose which adapter connection to use for this Enforcement Action.
Required Fields
These fields must be configured to run the Enforcement Set.
Request description - Enter a description for the request.
Request summary - Enter a summary for the created issue.
Note:You can replace text with parameters that can provide specific information to the Service Desk incident.
The following parameters can be used:
{{HOSTNAME}}, {{USERNAME}}, {{FIRST_NAME}}Issue type - Indicate the issue type.
Service Management (Desk) key - Specify the desired project in Service Desk where the issue will be created.
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
These fields are optional.
Connection and Credentials
When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.
- Host Name or IP Address - The hostname or IP address of the Jira Service Management server.
- Jira Service Management API version - Specify the Jira Service Management API version.
- User name and API Token - The credentials to connect to Jira Service Management.
- Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
- HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
- HTTPS Proxy User Name (optional) - The user name to use when connecting to the server using the HTTPS Proxy.
- HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.
Use Cloud API - Select this option to explicitly specify that the enforcement should use the Cloud API instead of Jira Server API. When the user uses the cloud API the default host name or IP address should be https://api.atlassian.com. Even when left unselected, the action will attempt to use the cloud API if the domain specified is “api.atlassian.com”.
Use full URL - Select this option if the URL references to a specific endpoint. For example: https://my-jira.com/jira.
Assignee - Enter a user name or email address to which to assign the incident. It is recommended to use the user's email address.
Use assignee name instead of ID - When Assignee has a value, Jira Service Management will search for the assignee by username or email address, depending on which is entered. When not selected, enter the user ID in the Assignee field.
Labels - Comma separated labels that will be added to the tickets.
Components - Comma separated components that will be added to the tickets.
Include missing adapters in description - Select to add to the description of the issue all the adapters that aren’t connected to the asset.
Add asset fields to issue description - Select to add a list of fields from the asset entity to the description of the issue.
Add asset description to issue description - Select to add the aggregated ‘description’ field from the asset to the issue description.
Add asset host name to issue description - Select to add the aggregated hostname field value to the description of the issue.
Add fields to issue description - Select field values to add to the description of the issue. You can select multiple additional fields. The values of the selected fields are added to the Request description.
Custom fields (JSON format) - Custom fields to add to this incident described in JSON format.
NOTEIf a custom field is already configured by this Enforcement Action, the new custom value is ignored.Map Axonius fields to adapter fields - Use the Field Mapping Wizard to map Axonius fields to fields in external systems. In this way you can transfer data found in Axonius into the external system as part of the configuration of relevant enforcement actions. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily.
Note:For details, see Axonius to External Field Mapping.
Send CSV data - Select to include a CSV file with the query results in the issue created. For Vulnerabilities the first row shows the vulnerability information, and the next rows show the linked devices.
Additional CSV Settings
Split by asset entities - Select to create a CSV file where each asset on a device is shown as a separate row. This separates each asset as the 'expand' option in the application. It separates each asset by its entity. For example, you will be able to know which values were fetched from each adapter connection.
a. If supplied, each value on a device or user is shown as a separate row.
b. If not supplied all values on a device are in the same cell on the CSV file.Export CSV delimiter to use for multi-value fields (default: Export CSV delimiter to use for multi-value fields field under the System Settings section in the GUI Settings) - Specify a delimiter to separate between values within the same field of an exported CSV file, otherwise the delimiter defined in Export CSV delimiter to use for multi-value fields is used.
Maximum rows (default: 1048500) - Specify the maximum number of rows to be included in the CSV file. When you set a value here the generated CSV file will include the top x rows, based on the specified values. Otherwise, the generated CSV file will include the default maximum rows, set as 1048500.
Include associated devices (only for Vulnerabilities and Software) - For Software and Vulnerabilities queries. Toggle on this option to include the associated devices with the preferred hostname as a predefined field for each software or vulnerability. When you create a CSV file with associated devices (for Vulnerabilities or Software), if the exported query results are larger than the value set under Maximum rows (or the default value of 1048500), an appropriate notice is displayed at the end of the CSV file.
Device fields - This option is available for Software and Vulnerabilities. Select the device fields to add. By default Preferred Host Name is selected. Click add to select more fields. At least one field must be selected. Click the bin icon to remove a device field.
Permissions
To perform this action you need to create a user with action privileges.
For more details about other Enforcement Actions available, see Action Library.