INTEGRATIONS > ServiceNow > Requirements

Requirements for the Bomgar Integration with ServiceNow

Outlined below are requirements for the basic and enterprise versions of the Bomgar and ServiceNow integration. If any of the integration requirements are not yet met, they will need to be in place prior to starting the integration setup process unless the associated features of the integration are not required.

Basic Integration Requirements

  1. ServiceNow instance with:
    • Version Aspen or later
    • A working Service Desk application
    • A working email configuration
  2. Bomgar Appliance (physical or virtual) with:
    • Version 13.1 or later
    • At least one usable representative console which can generate session keys
    • A working Bomgar public site through which users can connect to representatives
  3. Network firewall rules to allow:
    • TCP 443 traffic from the Bomgar Appliance to reach the appropriate ServiceNow instance
    • TCP 443 traffic from the appropriate ServiceNow instance to reach the Bomgar Appliance

Additional Enterprise Integration Requirements

Note: The enterprise version of Bomgar's ServiceNow integration has some additional features which require certain ServiceNow functions to be operational in order to work correctly. If these functions are not setup or actively used, the integration can still be installed and the basic features will work, but the enterprise features will not be usable until the necessary ServiceNow functionality is implemented. This can be done after the initial installation of the integration update set(s) and the additional features should immediately be usable, assuming the appropriate setup steps were taken during the integration setup as described in this guide.

  1. A working ServiceNow configuration management database (CMDB)
  2. One or more ServiceNow Configuration Items on which Bomgar Jump Client services can be or have been installed
  3. A working ServiceNow Employee Self Service (ESS) application and portal

The CMDB is used to launch Bomgar sessions based on the hostname of the machine added to the CI field of an incident. If the CMDB is not populated with any available hosts, Bomgar Jump cannot be used to remotely access them through ServiceNow's interface. These hosts can be added after the initial setup without making any changes to the integration.

Bomgar's supported operating systems include all of the major modern versions of Microsoft, Apple and Linux. One or more computers running one of these operating systems need to be populated in ServiceNow's CMDB in order for Bomgar's Jump features to work through ServiceNow. As mentioned above, this can be done after initial installation of the integration.

ServiceNow's ESS portal is leveraged by the integration to allow ServiceNow users of the Portal to request remote support from logged-in Bomgar representatives. This is not always desired, so some administrators prefer not to use the ESS portal. This is perfectly acceptable for the purposes of installation, and the ESS portal can be deployed after the integration setup to enable the associated Bomgar features.

 

Firewall Test

It is important to test all requirements of the integration prior to beginning setup. Most of these can be tested by the Bomgar and ServiceNow administrators within their respective systems, but to test the network firewall, the Bomgar admin should take the following steps to confirm that the necessary rules are in place.

  1. Log into a machine either external to the Bomgar Appliance's network or in the same VPN as the ServiceNow instance, depending on how ServiceNow is connecting to the appliance's network.
  2. Log into the Bomgar Appliance's /appliance interface.
  3. Browse to Support > Utilities :: TCP Connection Test.
  4. Enter the hostname of the ServiceNow instance, enter the port number of 443, and click Test. The result should be a Connected status message.

    Note: Do not enter the protocol of the ServiceNow instance (e.g., https://servicenow.example.com). Instead, use the fully qualified domain name only (e.g., servicenow.example.com). In most environments, the Bomgar appliance resides in a DMZ network and has a public DNS address which ServiceNow contacts over the public internet. In some environments, Bomgar is not publicly accessible. In these cases, you should contact ServiceNow about implementing a VPN connection to your internal network for ServiceNow. See "Setting Up a Virtual Private Network between ServiceNow and a Business Network" on wiki.servicenow.com.