ServiceNow - Update Assets
  • 09 Jul 2024
  • 5 Minutes to read
  • Dark
    Light
  • PDF

ServiceNow - Update Assets

  • Dark
    Light
  • PDF

Article summary

ServiceNow - Update Assets takes the saved query supplied as a trigger (or devices that have been selected in the asset table) with devices fetched by ServiceNow and update those devices' details in ServiceNow.

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

Required Fields

These fields must be configured to run the Enforcement Set.

  • Use stored credentials from the ServiceNow adapter - Select this option to use the first connected ServiceNow adapter credentials.
    NOTE
    To use this option, you must successfully configure a ServiceNow adapter connection.

Additional Fields

Connection Parameters

If Use stored credentials from ServiceNow adapter is NOT enabled, these fields are required:

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

  • 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:
    AdditionalFieldsFunctionsCurrentDate.png

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

    • 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 (default: True) - 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.
  • 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.


For more details about other Enforcement Actions available, see Action Library.


Was this article helpful?