ServiceNow
  • 5 minutes to read
  • Print
  • Share
  • Dark
    Light

ServiceNow

  • Print
  • Share
  • Dark
    Light

ServiceNow provides service management software as a service, including IT services management (ITSM), IT operations management (ITOM) and IT business management (ITBM).

Parameters

  1. ServiceNow Domain (required) – The hostname or IP address of the ServiceNow server.
  2. Username and Password (required) - The credentials for a user account that has the Required Permissions to fetch assets.
  3. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in ServiceNow Domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in ServiceNow Domain will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in ServiceNow Domain will not be verified against the CA database inside of Axonius.
  4. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in ServiceNow Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in ServiceNow Domain.
    • If not supplied, Axonius will connect directly to the value supplied in ServiceNow Domain.
  5. Install Status ENUM CSV File (optional, default: empty) - Upload a CSV file with your ServiceNow Install Status values and labels.
    • If supplied, Axonius will map the Install statuses value fetched from this connection to the corresponding label derived from the uploaded CSV file.
      • The CSV file must include the following columns: Value and Label.
    • If not supplied, Axonius will not map the Install statuses value fetched from this connection.
  6. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png

Advanced Settings

  1. Fetch users data (required, default: True) - If enabled, all connections for this adapter will fetch user data and add relevant user fields to the devices (for example: Owner, Assigned To, etc.).
    • The Users table in ServiceNow is a huge table. Therefore, fetching its data requires more time, RAM and CPU from the adapters connections.
    • If this option is unchecked, all connections for this adapter will not fetch any data from the Users table at all. As a result, a lot of ServiceNow device information will be missing.
  2. Create users (required, default: True)
    • If enabled, Axonius will create ServiceNow user entities from the user data fetched from all connections for this adapter. Users will be created only if you have checked the Fetch Users Data option.
    • If disabled, Axonius will not create ServiceNow user entities from the user data fetched from all connections for this adapter.
  3. Fetch IP addresses (required, default: True)
    • If enabled, all connections for this adapter will collect information on device IP addresses.
    • If disabled, all connections for this adapter will not collect information on device IP addresses.
  4. Exclude disposed and decommissioned devices (required, default: False)
    • If enabled, all connections for this adapter will not collect information on devices if their status in ServiceNow is 'Disposed' or 'Decommissioned'.
    • If disabled, all connections for this adapter will collect information on devices with any status in ServiceNow.
  5. Exclude devices without IP address, MAC address and Serial Number (required, default: False)
    • If enabled, all connections for this adapter will only collect information on devices if they have an IP address, MAC address, or serial number.
    • If disabled, all connections for this adapter will collect information on devices even if they have no IP address, no MAC address, and no serial number.
  6. Use CMDB_CI table instead of ALM ASSET table for install status (required, default: False)
    • If enabled, all connections for this adapter will collect the Install Status from the CMDB_CI table.
    • If disabled, all connections for this adapter will collect the Install Status from the ALM ASSET table.
  7. Exclude VMs tables (required, default: False)
    • If enabled, all connections for this adapter will not collect device assets from tables in ServiceNow that are related to Virtual Machines.
    • If disabled, all connections for this adapter will collect device assets also from tables in ServiceNow that are related to Virtual Machines.
  8. Users Email Whitelist (optional, default: empty) - Specify a comma-separated list of user emails.
    • If supplied, all connections for this adapter will only fetch users whose emails contains any of the comma-separated list of user emails that have been defined in this field. (Note that the emails defined don't have to be full email addresses since Contains is used).
    • If not supplied, all connections for this adapter will fetch users with any email.
  9. Fetch Only Active Users (required, default: False)
    • If enabled, all connections for this adapter will fetch only active users.
    • If disabled, all connections for this adapter will fetch all users regardless if they are active or not.
  10. Install status number exclude list (optional, default: empty) - Specify a comma-separated list one or more numbers that represent install status to exclude from the data.
    • If supplied, all connections for this adapter will not fetch devices from ServiceNow if their install status is in the specified list
    • If not supplied, all connections for this adapter will fetch all devices from ServiceNow, regardless of their install status.
  11. Fetch only virtual devices (required, default: False)
    • If enabled, all connections for this adapter will fetch only virtual device assets from ServiceNow.
    • If disabled, all connections for this adapter will fetch any device asset from ServiceNow.
  12. Fetch operational status (required, default: True)
    • If enabled, all connections for this adapter will fetch also the operational status of device assets from ServiceNow.
    • If disabled, all connections for this adapter will not fetch the operational status of device assets from ServiceNow.
  13. Fetch device relations (required, default: True)
    • If enabled, all connections for this adapter will fetch also the device relations of device assets from ServiceNow.
    • If disabled, all connections for this adapter will not fetch the device relations of device assets from ServiceNow.
  14. Number of requests to perform in parallel (required, default: 50) - Specify the maximum parallel request all connections for this adapter will create when connecting the ServiceNow server.

image.png

NOTE

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.

Required Permissions

The value supplied in Username must have read access to devices.
To create such user:

  1. As an administrator, log into the ServiceNow admin panel and go to the User Administration panel.
    image.png
  2. Click "Users" and then "New". Fill in the details for this user.
    image.png
  3. Create the user and then search for it in the users screen, to configure it. Click "Edit" to edit the user's attached roles.
    image.png
  4. Assign the "itil", "rest_api_explorer", "web_service_admin" roles and then click "Save" and finally "Update" to save the user.
    image.png
Was this article helpful?