- 18 Sep 2024
- 7 Minutes to read
- Print
- DarkLight
- PDF
ServiceNow - Create Incident
- Updated on 18 Sep 2024
- 7 Minutes to read
- Print
- DarkLight
- PDF
The ServiceNow - Create Incident action creates an incident in ServiceNow for all the entities 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.
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 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.
NOTETo use this option, you must successfully configure a ServiceNow adapter connection.Required Fields
These fields must be configured to run the Enforcement Set.
- Incident short description - Specify the incident title.
- Incident description - Specify an incident description.
- Message severity - Select the message severity:
- info (default)
- warning
- error
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.
ServiceNow domain - URL for the ServiceNow admin panel.
User name and Password - To connect to ServiceNow, you will need to create a user with action privileges.
Client ID and Client Secret - The OAuth Client ID and Client Secret for OAuth access to ServiceNow. Refer to OAuth 2.0 with Inbound REST for full details on how to obtain the OAuth Token.
Refresh Token - When using the OAuth method of authentication, enter the value of the Refresh Token issued by a ServiceNow instance.
- 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.
Add link to Saved Query to the incident short description - When selected, a link to the saved query defined as the trigger for the enforcement set will be appended to the short description of the created incident.
Add default incident description - When selected, Axonius will include the default incident description (mentioned below) in the ServiceNow incident.
Example message:_Alert - "test" for the following query has been triggered: Missing Sophos_ _Alert Details_ _The alert was triggered because: The number of entities is above 0 The number of devices returned by the query:4 The previous number of devices was:4_ _You can view the query and its results here: https://demo-latest.axonius.com/devices?view=Missing Sophos_
Multiple optional incident related settings - Enter information for the fields you want to add to the incident:
- Incident Type
- Caller ID
- Requested for
- Symptom
- Assignment group
- Category
- Subcategory
NOTESince the valid values of the different parameters are customer specific, Axonius does not validate any of those parameters values. You must make sure inserted values are correct, otherwise, the request might fail.Additional fields - 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.
- If not supplied, Axonius will not add any additional fields to the created incident.
Send CSV as attachment
- If enabled, the created incident will include an attached CSV file with the query results.
- If disabled, the created incident will not include an attached CSV file with the query results.
NOTEThis field is relevant only for Create ServiceNow Incident action and is not part of the Create ServiceNow Incident Per Entity action settings.Include only added entities in attached CSV
- If enabled, the attached CSV file with the query results will only contain information about the assets added in the trigger query since the previous execution of the enforcement task.
- If disabled, the attached CSV file with the query results will contain information about all the relevant assets.
NOTEThis checkbox is relevant only when Send CSV as attachment is True.Send created issue link to webhook URL - Specify the webhook URL the created ServiceNow incident link will be sent.
- When supplied, Axonius will send the message specified in the Webhook content field to the specified webhook URL.
- When left empty, Axonius will only create the ServiceNow incident.
NOTEThis field is relevant only for Create ServiceNow Incident action and is not part of the Create ServiceNow Incident Per Entity action settings.Webhook content - Specify the webhook content in a JSON format.
- The default webhook content in JSON format is:
{"text": "Created incident link is:<<ISSUE_LINK>>"} - When supplied, Axonius sends the specified content to the specified webhook URL. Otherwise, Axonius will only create the ServiceNow incident.
NOTE- <<ISSUE_LINK>> - will include the ServiceNow incident URL.
- This field is relevant only for Create ServiceNow Incident action and is not part of the Create ServiceNow Incident Per Entity action settings.
- The default webhook content in JSON format is:
Table name (default: incident) - Specify the ServiceNow table name in which the incident will be created.
Link created task to another new table record - Link this new task to another table with the following parameters:
- Name of table to populate into (default: sc_req_item)
- Field to base a relation on (default: request)
- JSON entry to send
Link created task to another new table record - Link the newly created incident to another new incident in the table.
- Name of table to populate into (default: sc_req_item) - Fill in the name of the table.
- Field to base a relation on (default: request) - Fill in the field to use as a base for the relation.
- JSON entry to send - Fill the XML value field in ServiceNow.
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. If you do not select this option, all values on a device are in the same cell on the CSV file.
- Split by field values - Choose field value - For complex fields and lists you can create a CSV file where the values of complex fields and lists are represented as separate rows in the file. From the drop-down box select the value that you want to display in the file, 'Tags' for instance. Only fields that have been discovered are available. For example, if you export by Installed Software, you will be able to see each installed Software name and its version.
- Don't split complex objects into columns - When selected, complex objects appear in a single column in JSON format. By default, each field in a complex object is split into a separate column in 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. (note that this value is the maximum value supported by Excel, setting a higher value generates a file that can't be displayed fully or correctly in Excel)
- 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. Once you select fields, you can drag and drop to rearrange in the order that you want them to appear in the CSV file. Click the bin icon to remove a device field.
- Include Associated fetch events (only for Fetch History) - For Adapter Fetch History queries, select this option to include details of the associated Fetch Events in the CSV file that is created.
- Exclude parent complex objects columns (default: Disabled) - Enable this option to hide the parent field of complex fields in exported files.
For more details about other Enforcement Actions available, see Action Library.