Skip to main content

Targeting ServiceNow

For each ServiceNow IT Service Management Suite system, add a target system in Bravura Security Fabric (Manage the System > Resources > Target systems):

  • Type is ServiceNow IT Service Management .

  • Address uses the options described in the table below.

  • Set the Administrator ID and Password to the login ID and password for the user with permissions to perform all required operations.

The full list of target parameters is explained in Target System Options .

Table 1. ServiceNow address configuration

Option

Description

Options marked with a redstar.png are required.

Server redstar.png

The server’s host name or IP address.

(key: server)

Port

The TCP port number, typically 443.

(key: port)

Connection over SSL

Select to enforce SSL connections. Default is "true".

(key: ssl)

Validate the server’s certificate when connecting

Determines whether to validate the server’s security certificate for SSL connections. Default is "true".

(key: checkCert)

HTTP Network Proxy

(Optional) Proxy URL to use for connecting.

(key: proxy)

Set proxy credentials

(Optional) Set proxy credentials. Default is "false".

(key: useProxyCreds)

Config file path

Full path to KVGroup file mapping configuration to target custom tables.

See Targeting custom tables for details.

(key: cfgpath)

Records per page (maximum 250)

Affects the number of records returned during listing. Change to synchronize with the ServiceNow configuration.

(key: pagesize)



The address is entered in KVGroup syntax:

{server=<server url>;[port=<port>;][proxy=<ip:port>;][ssl=<true|false>;][checkCert=<true|false>;][cfgpath=<path>;][pagesize=<records per page>][useProxyCreds=<true|false>;]}

for example:

{server=server.example.com;port=443;proxy=proxy.example.com;cfgpath=agtsvcnow.cfg;ssl=true;checkCert=false;useProxyCreds=true;}

Targeting custom tables

You can target custom tables in ServiceNow with a configuration file written in KVGroup format as illustrated below:

# KVGROUP-V2.0
   #
   # Sample configuration file for agtsvcnow.
   #
   "agtsvcnow" "node" = {
        "user" "u_bravura_user_profiles" = {
            "user_name" = "u_profile_id";
            "first_name" = "u_first_name";
            "last_name" = "u_last_name";
            };
        "group" "u_bravura_grp" = {
            "name" = "u_groupid";
            "description" = "u_groupname";
            };
        "grpmbr" "u_bravura_grpmbr" = {
            "group" = "u_groupid";
            "user" = "u_userid";
            };
        "asset" "u_bravura_compsvr" = {
            "ID" = "asset_tag";
            "name" = "display_name";
            "status" = "install_status";
            "disabled" = "1";
            "deleted" = "0";
            "getall" = "true";
            "sysparm_query"="asset_tagISNOTEMPTY";
            };
   };

The configuration file describes the mapping between the custom table and the built-in sys_user table from which the connector pulls users’ information with default behaviour.

The file maps the default user_name, first_name, last_name columns from sys_user to columns in a custom table. The "group" KVGroup should contain "name", "description" mapping. The "grpmbr" KVGroup should contain "group", "user" mapping if any of them are to be listed from a custom table. If empty, the information will be pulled from the system built-in tables. In addition, the "asset" KVGroup can be used to list any available computer server objects from a custom table.

By default, groupid is mapped to sys_id in the built-in table, which may result in empty group members. If you encounter this, add the following line to "grpmbr" to list all custom group members:

"group_is_sysid"="false";

The configuration file can be placed anywhere. The default path is the <Program Files path>\Bravura Security\Bravura Security Fabric\<instance>\ script\ directory.

In this section: