ServiceNow - Manage Assets with Scripted REST API

ServiceNow - Manage Assets with Scripted REST API executes a custom REST API endpoint on assets returned by the selected query or assets selected on the relevant asset page.

Required Fields

These fields must be configured to run the Enforcement Set.

• Use stored credentials from the ServiceNow adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.

  • When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.
  NOTE

  To use this option, you must successfully configure a ServiceNow adapter connection.

• API endpoint (default: api/now/table/cmdb_ci_computer) - The endpoint to execute.

• 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.

• 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.

• Additional fields - Specify additional fields to be added as part of the ServiceNow asset as key/value pairs in JSON format. For example: {"field1": "value1", "field2": "value2"}. You can also use functions within the field value either by themselves or embedded within larger text strings. In this example, the {{CURRENT_DATE}} function is embedded into the field value for the field Date of Update:
  

  • Use the {{CURRENT_DATE}} function to add the current date:
    • Using {{CURRENT_DATE}} with no format codes is the same as using the format codes: %B %d, %Y. This produces a date string like this: August 09, 2022.
    • Use format codes to specify a date format. For example, in the string AX VM Update - {{CURRENT_DATE:%m/%d/%Y}}, the %m/%d/%Y format codes will be replaced with 08/09/2022. The full string will be AX VM Update - 08/09/2022. The available format codes are described here: Format Codes.

• Number of parallel requests (default: 10) - The number of requests allowed at the same time.

• Retry count (default: 1) - If the action fails, Axonius will retry to execute it this many times for each device.

• Gateway Name - Select the Gateway through which to connect to perform the action.