Create ServiceNow Asset
  • 23 May 2022
  • 6 Minutes to read
  • Dark
    Light
  • PDF

Create ServiceNow Asset

  • Dark
    Light
  • PDF

The Create ServiceNow Asset action creates an asset in ServiceNow for each entity retrieved from the saved query supplied as a trigger (or from the entities selected in the asset table).

To configure the Create ServiceNow Asset action, from the Action Library, click Manage CMDB Assets, and then click Create ServiceNow Asset.

Connection Settings

  1. Use stored credentials from the ServiceNow adapter (required, default: False) - Select this option to use the first connected ServiceNow adapter credentials.
    NOTE
    To use this option, you must successfully configure a ServiceNow adapter connection.
  2. ServiceNow domain (optional, default: empty) - URL for the ServiceNow admin panel.
    NOTE
    If Use stored credentials from the ServiceNow adapter is disabled, this field is required.
  3. User name and Password (optional, default: empty) - To connect to ServiceNow, you will need to create a user with action privileges.
    NOTE
    If Use stored credentials from the ServiceNow adapter is disabled, these fields are required.
  4. Verify SSL (required, default: True) - Verify the SSL certificate offered by the host supplied in ServiceNow domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the host will be verified against the CA database inside of Axonius. If it fails validation, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the host will not be verified against the CA database inside of Axonius.
  5. HTTPS proxy (optional, default: empty) - A proxy to use when connecting to ServiceNow domain.
    • If supplied, Axonius will utilize the proxy when connecting to the host defined for this connection.
    • If not supplied, Axonius will connect directly to the host defined for this connection.

Action Settings

  1. CMDB CI table name (optional, default: cmdb_ci_computer) - Specify the table that the CI will be created in.

    • If supplied, Axonius will create the CI in the specified table.
    • If not supplied, Axonius will create the CI in cmdb_ci_computer table.
  2. Additional fields (optional, default: empty) - Specify additional fields to be added as part of the ServiceNow asset 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 asset in ServiceNow. 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 asset in ServiceNow.
  3. Do not map default Axonius fields (required) - 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.
  4. Map Axonius fields to ServiceNow fields (optional) - Use the Field Mapping Wizard to map Axonius fields to fields in ServiceNow. In this way you can transfer data found in Axonius into ServiceNow. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily.

    NOTE
  5. Use IdentifyReconcile API endpoint to create computer (optional)

    • If supplied, the asset will be created in ServiceNow via the Identification and Reconciliation (IdentifyReconcile) API. The supplied value will be used as the source for the new created asset.
      • The Identification and Reconciliation (IdentifyReconcile) API uses the Identification and Reconciliation engine (IRE) to minimize creation of duplicate Configuration Items (CIs) and to reconcile CI attributes by only accepting information from authorized sources when updating the Configuration Management Database (CMDB).
      • It is recommended to use ‘Axonius’ as the source value.
    • If not supplied, the asset will be created in ServiceNow via the Table API, and the CMDB will be updated directly.
  6. Use first IP address only (required) - 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.
  7. IP addresses delimiter (optional, 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.
  8. Use first MAC address only (required, 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.
  9. MAC addresses delimiter (optional, 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.
  10. Create ServiceNow asset even if device's asset entities include ServiceNow (required, default: False) - Select whether to create a new ServiceNow asset even if one of the device's asset entities has been fetched from ServiceNow.

    • If enabled, an asset will be created in ServiceNow even if one of the device's asset entities has been fetched from ServiceNow.
    • If disabled, an asset will not be created in ServiceNow even if one of the device's asset entities has been fetched from ServiceNow.
  11. CIDR exclude list (optional, default: empty) - 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.
  12. CIDR include list (optional, default: empty) - 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.
  13. Additional fields to use by quering ServiceNow (optional) - allows you to specify “external enrichment query“ (by specifying a service now table, and a mapping between axonius fields to that tables fields), and then specify mapping between the source table (the query table) to the destination table (the table where the EC will create the asset).

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

  14. Create ServiceNow asset for each installed software (required, default: False) - Select whether to create a new ServiceNow asset for each of the devices' installed software.
    * If enabled, an asset will be created in ServiceNow also for each of the devices' installed software.
    * If disabled, an asset will be created in ServiceNow only for the device.

  15. Number of parallel requests (optional) - The maximum number of requests that can be sent to ServiceNow simultaneously. If the total number of requests is lower than the limit, only the total request count is sent.

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

Default Field Mapping

When the Create ServiceNow Asset action creates an asset in ServiceNow for each of the query results entities, the asset in ServiceNow is created with a set of attributes populated based on the following mapping:

Axonius Device Field ServiceNow Attribute
Asset Name / Host Name name
Device Manufacturer manufacturer
Device Manufacturer Serial / BIOS Serial serial_number
Network Interfaces: IPs ip_address
Network Interfaces: MAC mac_address
OS Type os

Required Permissions

  • IdentifyReconcile API - The value supplied in User name must have the 'itil' or 'asset' role to use this API.

To learn more about configuring Enforcement Sets, see Configuring Enforcement Sets.


First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.