ServiceNow - Update Assets

ServiceNow - Update Assets updates device details in ServiceNow for:

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

Additional Fields

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

• Split by field values - Splits the field values by the selected adapter and field.

• Do not map default Axonius fields - Select whether to map the set of default Axonius fields to the ServiceNow asset.

  • If enabled, default Axonius fields will not be mapped to the ServiceNow asset.
  • If disabled, default Axonius fields will be mapped to the ServiceNow asset. For details, see Default Field Mapping.

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

  • If Fetch dynamic dropdown values is enabled for the adapter connection, Placeholder text fields will be a list populated with the available values from ServiceNow.

• Convert Preferred Total RAM (GB) to MB - select to display the total RAM in Megabytes instead of in Gigabytes.

• Use first IP address only - Select whether the first IP address to be added to the ServiceNow asset.

  • If enabled, only the device's first IP address will be added to the ServiceNow asset.
  • If disabled, all the device's IP addresses will be added to the ServiceNow asset.

• IP addresses delimiter (default: /) - Specify the delimiter to separate between multiple IP addresses added to the ServiceNow asset.

  • If supplied, the specified delimiter will be used to separate between multiple IP addresses added to the ServiceNow asset.
  • If not supplied, the default delimiter will be used to separate between multiple IP addresses added to the ServiceNow asset.

• Use first MAC address only - Select whether the first MAC address to be added to the ServiceNow asset.

  • If enabled, only the device's first MAC address will be added to the ServiceNow asset.
  • If disabled, all the device's MAC addresses will be added to the ServiceNow asset.

• MAC addresses delimiter (default: /) - Specify the delimiter to separate between multiple MAC addresses added to the ServiceNow asset.

  • If supplied, the specified delimiter will be used to separate between multiple MAC addresses added to the ServiceNow asset.
  • If not supplied, the default delimiter will be used to separate between multiple MAC addresses added to the ServiceNow asset.

• CIDR exclude list - Specify a comma-separated list of CIDRs to be excluded.

  • If supplied, Axonius will not add to ServiceNow IP addresses in the IP range of the specified CIDRs.
  • If not supplied Axonius will add to ServiceNow IP addresses in any IP range.

• CIDR include list - Specify a comma-separated list of CIDRs to be included.

  • If supplied, Axonius will only use ServiceNow IP addresses in the IP range of the specified CIDRs.
  • If not supplied Axonius will add to ServiceNow IP addresses in any IP range.

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

• Additional fields to use by querying ServiceNow - This option allows you to specify an “external enrichment query“ (by specifying a ServiceNow table, and a mapping between Axonius fields to ServiceNow fields). You then specify mapping between the source table (the query results table) to the destination table (the table where the EC will create the asset in ServiceNow).

  • This ServiceNow query is performed for every device the EC is run for.

  • The result of the ServiceNow query is appended to the created asset (based on the mapping between the source table to the destination table).

  • Enter the required information in the following fields:

    • Table Name - the source table for query data.

    • Axonius to source table query mapping - Define the mapping between Axonius fields and the ServiceNow source table.

    • Filter Operator - Select the filter operator in ServiceNow which will be used when querying the table:

      • Is one of - Checks whether the value in Axonius is contained within a list of values in the ServiceNow field.
      • Contains - Checks whether the value in Axonius is contained in the ServiceNow field value.
      • Is - Checks for complete equality between the Axonius field and the ServiceNow field.

    • Axonius fields - Select the Axonius fields you want to use to enrich the ServiceNow table. The fields used to query the table (e.g., using the device IP address of the Axonius field to search the table to find an entry with that IP address).

  • Create Record with matching values if no existing values found - When an entity does not exist in the ServiceNow table, it will be created.

    • When not selected, and an Axonius field is missing from the mapping (i.e.,a device doesn’t have this field), the query for that device is skipped. Only the first result from each query for each device is used (i.e., for a device, every query from ServiceNow will only have a single result).

  • Source table fields to Destination table fields mapping - Mapping from the ServiceNow source table to the destination table fields. Define the fields in a JSON formatted file, as follows:

    {“source_table_field“: “dest_table_field“, “source_table_field_2“: “dest_table_field_2“}
    

    Reference fields from the source table will be mapped to the destination table using their “display_value“.

• Exclude connections - From the list, select the connections to ignore. You can select more than one.

• Update only the following tables (Comma Separated) - When the Enforcement Set runs on a device with two ServiceNow records, enter a comma separated list of ServiceNow tables. Only records from the tables listed in this fields are updated. You can enter a wildcard (*) in this field, in which caes all records are updated.