- 26 Mar 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
ServiceNow - Create Incident per Asset
- Updated on 26 Mar 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
ServiceNow - Create Incident per Asset creates an incident in ServiceNow for each entity that matches the parameters of the saved query supplied as a trigger (or from the entities selected in the asset table).
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
- Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapter Fetch History and Asset Investigation Modules
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
- Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
- 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 ServiceNow adapter - Select this option to use the ServiceNow connected 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.
- Incident short description - Specify the incident title.
- Message severity (default: info) - Select the message severity: info, warning or error.
- Instance Name - 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.
ServiceNow domain (optional) - URL for the ServiceNow admin panel.
NOTEIf Use stored credentials from the ServiceNow adapter is disabled, this field is required.User name and Password - To connect to ServiceNow, you will need to create a user with action privileges.
NOTEIf Use stored credentials from the ServiceNow adapter is disabled, these fields are required.Verify SSL - 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 - Connect the adapter to a proxy instead of directly connecting it to the domain.
Incident description and Map Axonius fields to fields in the description - These fields allow you to create custom incident descriptions. In Incident description, enter a description template that includes field placeholders for field mapping. The placeholder is enclosed by double {{ }}. Then, in Map Axonius fields to fields in the description, enter the field placeholder in Placeholder text fields on the left and select an Axonius field in Axonius fields on the right. The value of the Axonius field is populated into the description in place of the placeholder text.
In the example below, the template in Incident description maps the fields selected under Axonius fields into the placeholders dev_hostname, dev_ip, and dev_serial. Each asset that matches the query parameters will have its data added to the incident description.
Multiple optional incident related settings:
- Incident Type
- Caller ID
- Requested for
- Symptom
- Assignment group
- Category
- Subcategory
NOTESince the valid values of these parameters are customer specific, Axonius does not validate any of these parameter's values. You must make sure inserted values are correct, otherwise, the request might fail.Additional fields (optional, default: empty) - Specify additional fields to be added as part of the incident as key/value pairs in a JSON format.
For example:{"field1": "value1", "field2": "value2"}.
- If supplied, Axonius will add the specified fields and values to the created incident. If one of the specified fields is invalid, the request might fail.
Table name (optional, default: incident) - Specify the ServiceNow table name in which the incident will be created.
- If supplied, the incident will be created in the specified table name.
- If not supplied, the incident will be created in the 'incident' table.
Axonius to ServiceNow field mapping - Field mapping allows you to map Axonius fields to the CMDB fields. The input should be key/value pairs in a JSON format.
For example:{"axonius_field1":"servicenow_field1", "axonius_field2":"servicenow_field2"}