bomgar pa integration with...

19
Bomgar PA Integration with ServiceNow © 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC:6/7/2018

Upload: nguyenmien

Post on 16-Jun-2018

225 views

Category:

Documents


0 download

TRANSCRIPT

Bomgar PA Integrationwith ServiceNow

© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC:6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Table of Contents

Bomgar PA Integration with ServiceNow 4

Requirements for the ServiceNow Integration with Bomgar PA 5

Base Integration Requirements 5

Additional Integration Requirements 5

Firewall Test 5

Configure Bomgar PA for the ServiceNow Integration 7

Verify that the API is enabled 7

Create a ServiceNow API Account 7

Add outbound events 7

Create custom fields 8

Set up the custom link 8

Set up change management workflow 8

Configure ServiceNow for Integration with Bomgar PA 10

Install Bomgar Integration 10

Create Local Update Set 10

Update Bomgar PA Session Event Types 11

Set Up Bomgar OAuth Application Registry 11

Set Up Bomgar PA Appliance 12

Configure Events to Import 13

Configure Bomgar Session Related Lists 13

Configure Incident CMDB Jump Macros 14

Configure Bomgar Username and Authentication 14

Assign Users Appropriate Roles 14

ServiceNow MID Server Option 15

Set Up Change Management Workflow 15

Test the Setup of the Bomgar PA and ServiceNow Integration 17

Test Access Configuration Item Button 17

Test Bomgar Session Import 17

Transfer the Bomgar PA-ServiceNow Integration Update Sets 18

Transfer Update Set 18

Configure Production Outbound Event 18

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 2© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Configure Custom Link 18

Use Cases for the ServiceNow Enterprise Integration with Bomgar Privileged Access19

Jump to Configuration Item 19

Import Bomgar Session Data into a ServiceNow Record 19

Change Management Workflow 19

Access ServiceNow Records from Access Console 19

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 3© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

Bomgar PA Integration with ServiceNow

IMPORTANT!

You must purchase this integration separately from both your Bomgar software and your ServiceNow solution. For moreinformation, contact Bomgar sales.

Organizations using ServiceNow can integrate with Bomgar PA to provide secure privileged access to critical assets from withinServiceNow, satisfy internal and external compliance requirements with comprehensive audit trails, and integrate with changemanagement processes.

l Outbound Access Sessions - Technicians can launch Bomgar access sessions from within ServiceNow Incidents usingBomgar Jump Technology.

l Session Updates - Bomgar access session data is written back to ServiceNow Incidents, Change Requests, andConfiguration items. This includes file transfers, system information, session notes, and session recordings.

l Change Management Endpoint Approval - Bomgar PA can be configured to request approval from ServiceNow before adevice is accessed via the Bomgar PA access console.

ServiceNow Application Scope

As of version Fuji, ServiceNow supports integrations that are developed in a global scope and integrations that are developed inan application scope. This documentation covers an integration that was developed in our Bomgar PA application scope.

For this integration, administrators are prompted when configuringitems that live in the global scope. For example, when configuring theForm Layout of an Incident, the user is prompted with an option to Editthis Section in Global. The recommendation for this integration is toedit the section in the global scope, which allows the user to edit theform or record without having to switch out of our Bomgar applicationscope.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 4© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Requirements for the ServiceNow Integration with Bomgar PAOutlined below are requirements for the Bomgar PA and ServiceNow integration. If any of the integration requirements are not yetmet, they must be in place prior to starting the integration setup process unless the associated features of the integration are notrequired.

Base Integration Requirements

l ServiceNow instance with:

o Version Fuji or latero A working Service Desk application

l Bomgar PA Appliance (physical or virtual) with:

o Version 15.1 or latero At least one usable access console

l Network firewall rules to allow:

o TCP 443 traffic from the Bomgar PA Appliance to reach the appropriate ServiceNow instanceo TCP 443 traffic from the appropriate ServiceNow instance to reach the Bomgar PA Applianceo Optionally, ServiceNow MID Servers can be used for this integration. For more information on MID Servers, see

wiki.servicenow.com/index.php?title=MID_Server_Configuration

Additional Integration Requirements

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

l A working ServiceNow configuration management database (CMDB)l One or more ServiceNow Configuration Items on which Bomgar Jump Client services can be or have been installed

The CMDB is used to launch Bomgar sessions based on the hostname of the machine added to the Configuration Item field of anincident. If the CMDB is not populated with any available hosts, Bomgar Jump cannot be used to remotely access them throughServiceNow'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 morecomputers running one of these operating systems needs to be populated in ServiceNow's CMDB in order for Bomgar's Jumpfeatures to work through ServiceNow. As mentioned above, this can be done after initial installation of the integration.

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 andServiceNow administrators within their respective systems, but to test the network firewall, the Bomgar admin should take thefollowing steps to confirm that the necessary rules are in place.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 5© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

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 fullyqualified domain name only (e.g., servicenow.example.com). In most environments, the Bomgar Appliance resides in a DMZnetwork and has a public DNS address which ServiceNow contacts over the public internet. In some environments, Bomgar isnot publicly accessible. In these cases, you should contact ServiceNow about implementing a VPN connection to your internalnetwork for ServiceNow. Please see wiki.servicenow.com/index.php?title=Setting_Up_a_Virtual_Private_Network_between_ServiceNow_and_a_Business_Network.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 6© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Configure Bomgar PA for the ServiceNow IntegrationAll of the steps in this section take place in the Bomgar /login administrative interface. Access your Bomgar interface by going to thehostname of your Bomgar Appliance followed by /login (e.g., https://access.example.com/login).

Verify that the API is enabled

The Bomgar Integration requires the Bomgar XML API to be enabled.This feature is used from within the integrating software tocommunicate with the Bomgar APIs.

Go to /login > Management > API Configuration and verify that Enable XML API is checked.

Create a ServiceNow API Account

The ServiceNow API account is used from within ServiceNow to make Bomgar Command API calls to Bomgar.

1. Go to /login > Management > API Configuration.2. Click Create New API Account and name it ServiceNow or

something similar.3. Set Command API to Full Access.4. Under Reporting API, check all options.5. The OAuth Client ID and OAuth Client Secret are used during

the OAuth configuration step in ServiceNow. Make note of theseand store them in a secure location.

6. Click Save Changes.

Add outbound events

Outbound events are used to notify ServiceNow that a Bomgar Sessionhas finished and is ready to be imported into ServiceNow.

1. Go to /login > Management > Outbound Events.2. Click Add New HTTP Recipient and name it ServiceNow

Integration or something similar, depending on yourServiceNow instance.

3. Set the URL to https://access.example.com/x_bmgr_bomgar_pa_bomgar_post.do where support.example.comis the ServiceNow instance name.

4. If using the an outbound event token for added security, appendoutbound_event_token=YOUR-TOKEN to the end of the URL,so that the entire URL resembles https://support.example.com/x_bmgr_bomgar_pam_bomgar_post.do?outbound_event_token=YOUR-TOKEN. You must also store this token with the Bomgar Appliance record inServiceNow.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 7© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

5. Scroll to Events to Send and check Access Session End.6. Scroll to the bottom and click Add Recipient.

Create custom fields

Bomgar custom fields are used to map ServiceNow Tasks (incidents,change requests, problem records, and service catalog requests) andConfiguration Items to Bomgar access sessions.

1. Browse to Management > API Configuration.2. Under API :: Custom Fields, click Create New Field.3. Enter the following values:

a. Display Name - ServiceNow Task IDb. Code Name - snow_task_idc. Show in Rep Console - checked

4. Click Add Custom Field to save the new field.5. Repeat the steps above for the following custom field values:

a. Display Name - ServiceNow Configuration Item IDb. Code Name - snow_cmdb_ci_idc. Show in Rep Console - checked

Set up the custom link

Bomgar custom links can be configured to allow users to quicklyaccess the ServiceNow Incident that is associated with the session.

1. Browse to Access Console > Custom Links.2. Under Access Console :: Custom Links, click Create New

Custom Link.3. Enter a name for the link, and then set the URL to https://access.example.com/nav_to.do?uri=task.do?sys_

id=%SESSION.CUSTOM.EXTERNAL_KEY% where access.example.com is the ServiceNow instance name. If needed, youcan use any of the available macros to customize the link according to your specifications.

4. Click Add Custom Link to save the new link.

Set up change management workflow

Bomgar change management workflow can be configured to require approval through an ITSM system before allowing access toBomgar Jump Clients.

1. Browse to Jump > Jump Policies.2. Under Jump Policies :: Ticket System, enter an appropriate

Ticket System URL similar to https://example.service-now.com/x_bmgr_bomgar_pam_bomgar_endpoint_approval.do.

3. Upload the CA certificate from the ServiceNow instance.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 8© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

4. Enter the desired User Prompt.5. Click Save.6. Next, under the Jump Policies section, click the Add New

Jump Policy button or click the Edit link next to an existingJump Policy.

7. Under the Jump Approval area, check the box labeled Requirea ticket ID before a session starts.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 9© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Configure ServiceNow for Integration with Bomgar PAUnless otherwise noted, all of the steps in this section take place in the ServiceNow interface. The development and/or testinstances of ServiceNow should be used initially so that the integration can be thoroughly tested before installation in theproduction instance.

Install Bomgar Integration

Customers have two options for installing the Bomgar ServiceNow Integration. The first option involves importing the BomgarServiceNow Integration Update Set. The second option involves requesting the Bomgar ServiceNow Integration from theServiceNow Store.

Install via Update Set

1. Log into ServiceNow with an administrative user account andbrowse to System Update Sets > Retrieved Update Sets.

2. Click Import Update Set from XML at the bottom of the page. Insome instances, it may be necessary to right-click the headercolumn of the update sets table and select Import Update Setfrom XML from the resulting menu.

3. Click Browse, locate the update set XML file, and click Upload. Bomgar Technical Support normally sends the necessaryupdate set XML file via email after the ServiceNow integration has been purchased through Bomgar's Sales team. If youhave not yet received a copy, please contact Bomgar Technical Support.

4. Find the update set you just imported in the list of retrieved update sets and click it. The name should be similar to BomgarPA Integration 1.0.11 Full, and its Loaded date should be the most recent in the list.

5. Click Preview Update Set to check for errors. Look through each update set.6. If the preview is satisfactory, return to the main page of the update set and click Commit Update Set.

Install via App Store

Please see ServiceNow's FAQ regarding app installation via theServiceNow App Store.

l ServiceNow Store:store.servicenow.coml ServiceNow Store FAQ:store.ser-vicenow.com/appStoreAttachments.do?doc_type=store_faq&in-line=true

Create Local Update Set

Local update sets are used in ServiceNow to capture configurationchanges. They can be used to quickly transfer these configurationchanges to other environments.

1. Browse to System Update Sets > Local Update Sets, and clickthe New button above the list of update sets to create a newlocal update set.

2. In the Name field, enter Bomgar - ServiceNow Integration Configuration (or an equivalent).

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 10© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

3. Click Submit and Make Current. This update set will capture any changes you make during the configuration process. Justmake sure that the Bomgar - ServiceNow Integration Configuration update set is selected in ServiceNow's update setdropdown for the following steps.

4. Make sure the Application is set to Bomgar PA Integration. If it is not, use the settings cog in the upper right of the screen toswitch to the aforementioned scope.

5. After configuration is complete and tested, the local update set can be imported or promoted to new instances ofServiceNow (e.g., the production instance) to quickly replicate the integration. This must be done after transferring theBomgar - ServiceNow retrieved update set. See "Transfer the Bomgar PA-ServiceNow Integration Update Sets" on page 18for details.

Update Bomgar PA Session Event Types

Event Types are used to control which Bomgar events are processedwith a Bomgar Session import. This step updates the database with allthe available event types.

1. Browse to Bomgar PA > Update Event Types.2. This loads all the available Bomgar Session Event Types into

the database, so that unwanted events can be filtered out in asubsequent step when setting up your appliance(s).

Set Up Bomgar OAuth Application Registry

Bomgar OAuth is used for communication between the ServiceNowinstance and the Bomgar Appliance.

1. Browse to System OAuth and click Application Registry.2. In the list of registered applications, click Bomgar API OAuth

and enter the following values:

a. Client ID - the OAuth client ID obtained from the APIaccount created in Bomgar in "Create a ServiceNow APIAccount" on page 7.

b. Client Secret - the OAuth client secret obtained from the API account created in Bomgar in "Create a ServiceNowAPI Account" on page 7.

c. Token URL - the URL used to obtain a token from the Bomgar Appliance (e.g.https://support.example.com/oauth2/token)

d. Default Grant type - Authorization Codee. Redirect URL - set this value to empty. You should have to do this only during the initial setup.

3. Click the Update button.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 11© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Set Up Bomgar PA Appliance

Bomgar Appliances are set up in ServiceNow to connect ServiceNowwith a Bomgar Appliance.

1. Browse to Bomgar PA > Appliances.2. Click New to add a new Bomgar Appliance and enter the

following values:

a. Name - must be Default.b. Hostname - hostname of the Bomgar Appliance.c. OAuth Client ID - the OAuth client ID that is used to authenticate to the Bomgar Appliance. This is obtained in a

previous step, "Create a ServiceNow API Account" on page 7.d. OAuth Client Secret - the OAuth client secret that is used to authenticate to the Bomgar Appliance. This is obtained

in a previous step, "Create a ServiceNow API Account" on page 7.e. Integration Enabled - turns the integration on and off.f. Import External Sessions - if checked, session reports for sessions that are started external to ServiceNow are

imported into ServiceNow.g. Accepted IP Addresses - a comma-separated list of IP addresses from which this integration accepts outbound

events.

h. Auto Associate With User - if checked, when the session report is imported, the integration attempts to associate aServiceNow User with the session. The lookup is based on the session's primary user's username.

i. Auto Associate With Config Item - if checked, when the session report is imported, the integration attempts toassociate a ServiceNow Config Item with the session.

j. Events to Import - a list of Bomgar session events to process when importing a Bomgar session.

Note: You will not be able to configure this setting until after the appliance has been saved.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 12© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Configure Events to Import

Event Types are used to control which Bomgar events are processedwith a Bomgar session import. This step defines which events areprocessed for each Bomgar session import.

1. Browse to Bomgar PA > Appliances.2. Click the name of your appliance.3. Click the Edit Events to Import button (the lock icon).4. Click the Add/Remove multiple button (the group of people

icon) located on the right side of the field.5. Select the events you want from the Collection field on the left

and use the arrows to move the events to the List field on theright.

Note: You can use CTRL+A to select all events.

6. Click the Save button when you are finished.

Configure Bomgar Session Related Lists

Related lists are used to provide a list of Bomgar Sessions that areassociated with a Task (incident, change request, or service catalogrequest), Call Record, or Configuration Item.

Task Configuration

1. Browse to Incident.2. Click Open to see a list of open incidents.3. Select an incident by clicking the Incident Number.4. Right-click the Incident title bar and select Configure > Related Lists.5. Ensure that Access Session > Task has been moved to the Selected column.6. Click the Save button.7. The Bomgar Sessions list should appear towards the bottom the incident form once these steps are complete.

CMDB Configuration

1. Browse to Configuration > Servers.2. Click All to see a list of servers.3. Select a server by clicking the Name of a server.4. Right-click the Incident title bar and select Configure > Related Lists.5. Ensure that Access Session > Configuration Item has been moved to the Selected column.6. Click the Save button.7. The Bomgar Sessions list should appear towards the bottom the configuration item form once these steps are complete.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 13© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Configure Incident CMDB Jump Macros

Bomgar Jump technology can be used for unattended access todevices through the Bomgar Appliance.

1. Browse to Incident.2. Click Open to see a list of open incidents.3. Select an incident by clicking the Incident Number.4. Populate the Configuration Item field by clicking the

magnifying glass icon, then selecting an item in the list.5. Once the Configuration Item is populated, click the Update

button on the Incident title bar. This takes you back to theIncident list.

6. Click the name of the incident you just updated.7. Right click the Configuration Item Label and click Configure Dictionary.8. Locate the Attributes field and take note of the part of the value that reads ref_contributions=task_show_ci_map;show_

related_records.9. Add the Jump To value of x_bmgr_bomgar_pam_bomgar_pam_jump_to or x_bmgr_bomgar_pam_bomgar_pam_

jump_to_webas a semicolon-separated item in ref_contributions (e.g., ref_contributions=x_bmgr_bomgar_pam_bomgar_pam_jump_to;task_show_ci;show_related_records).

10. Click the Update button to save your changes.

Configure Bomgar Username and Authentication

1. Log into your Bomgar /login interface with the same credentialsas a ServiceNow user who is expected to be using Bomgar.

2. Download and install a Bomgar access console from the /login> My Account tab.

If login fails:

l Make sure that Bomgar and ServiceNow are checkingcredentials against the same LDAP server(s), if appropriate.Check the LDAP server in the Bomgar interface under /login > Users & Security > Security Providers. To check the LDAPserver for ServiceNow, see the LDAP Integration Setup article at wiki.servicenow.com/index.php?title=LDAP_Integration_Setup.

l If LDAP authentication is not being used, log into ServiceNow, browse to User Administration > Users, select the user tobe used for testing, and focus the Bomgar Username field.

l If this field does not exist while viewing a user, hover over the icon next to User on the title bar, select Configure > FormLayout, and move the Bomgar Username field from the Available list to the Selected list. Once done, enter the name of aknown-working Bomgar user account in this field and save.

Assign Users Appropriate Roles

ITIL users who provide technical support using this integration should be given the x_bmgr_bomgar_pam.user role.

Note: You must elevate the admin's role in order to make the following change.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 14© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

1. Browse to User Administration > Users.2. Select a user3. Find the Roles tab and click the Edit button.

4. Add the x_bmgr_bomgar_pam.user role from the Collectionlist to the Roles list

5. Click Save.

ServiceNowMID Server Option

It is possible to avoid direct connection between ServiceNow andBomgar by using an MID server for internal Bomgar deployments.

For more information on MID servers, seewiki.servicenow.com/index.php?title=MID_Server_Configuration.

Set Up Change Management Workflow

Bomgar change management workflow works out of the box with adefault Servicenow configuration. It can be customized if necessary.

The Default Approval Processing list includes the checks that aremade when a ticket approval request is processed in ServiceNow.

1. Find the Ticket (aka Task) - searches for the task based ontask number. If not found by number, searches by task sys_id.If the task is not found, a failure response is sent back toBomgar.

2. Match the Rep - Checks to make sure the rep usernamematches the task assigned_to field user's user_name (User Id)or Bomgar PA username field. If the reps do not match, a failureresponse is sent back to Bomgar.

3. Match the Computer Name - Ensures the task's cmdb_ci name matches the computer name being Jumped to in Bomgar. Ifthe computer names do not match, a failure response is sent back to Bomgar.

4. Ensure Task Approval - Ensures the task's approval field is approved. If the task is not approved, a failure response is sentback to Bomgar.

5. Ensure Field State - Ensures the task's state field is not closed, cancelled, or resolved (i.e., value is less than 3). If thestate is not less than 3, a failure response is sent back to Bomgar.

A developer can provide Customized Approval Processing by taking the following steps:

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 15© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

1. Browse to System UI > UI Pages.2. Open the page named bomgar_endpoint_approval that lives in the Bomgar PA Integration application.3. Locate the section of code that pertains to custom endpoint approval and comment the standard call: (new x_bmgr_

bomgar_pam.BomgarPAM()).handleEndpointApproval(endpointApproval);

4. Uncomment the custom call: (new x_bmgr_bomgar_pam.BomgarEndpontApproval()).handleEndpointApproval(endpointApproval);

5. Browse to System UI > Script Includes.6. Open the script include named BomgarEndpointApproval that lives in the Bomgar PA Integration application.7. Put your custom approval code in the designated area in the handleEndpointApproval function.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 16© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Test the Setup of the Bomgar PA and ServiceNow Integration

Test Access Configuration Item Button

1. Log into the Bomgar access console, and then log intoServiceNow with the same account. If Bomgar and ServiceNowuse different authentication systems, manually assign yourBomgar user to your ServiceNow user as described in"Configure Bomgar Username and Authentication" on page 14.

2. Open a configuration item in ServiceNow that has acorresponding Jump Client in Bomgar, and make sure theAccess CI button shows up.

3. Click the Access CI button. It should launch the Bomgar access console. In case of failure, make sure the following are true:

l The ServiceNow user account is mapped to a Bomgar user account as described in this guide.l The ServiceNow API User Connection test completes successfully.l The Bomgar Hostname, Username, and Password fields are set correctly in ServiceNow under Bomgar PA >Appliances. These should match the API User Connection test.

Test Bomgar Session Import

1. Log into ServiceNow as an ITIL user or an admin.2. Use the Access CI button as described above to start a

Bomgar session.3. End the session from the access console and close any session

end messages on the user and/or customer sides of thesession.

4. Refresh the ServiceNow incident from which the session keywas generated, scroll to the bottom of the page, and check theBomgar Sessions list. There should be an entry for the recentsession. If not, make sure the following are true:

a. The API User Connection test works correctly as described above.b. There are no Bomgar errors reported for your ServiceNow instance in the Bomgar Outbound Events list. Your

Bomgar admin can check this in Bomgar from the /login web interface under Management > Outbound Events.c. The IP address is set up correctly, following the steps below:

i. Log into ServiceNow as an admin.ii. Browse to System Logs > Transactions, remove all existing filters, and add a URL filter of /x_bmgr_

bomgar_pam_bomgar_post.do.iii. Click one of the results and make sure the originating IP address of the transaction is included in the Bomgar

PA Appliance IP Address field of the integration appliance settings under Bomgar PA > Appliances >Default.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 17© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Transfer the Bomgar PA-ServiceNow Integration Update SetsThe steps below are typically used after the integration has been imported and configured in a test/development instance ofServiceNow and is being transferred to a production instance. However, they are also applicable to transferring the integrationbetween any ServiceNow instances.

Transfer Update Set

1. Follow the steps in the ServiceNow documentation to transfer the Bomgar - ServiceNow Integration update set(s) into thedestination instance of ServiceNow.

Note: This is typically done by retrieving the update sets from the destination instance or by exporting the update setsfrom the original instance as XML files. For details, see wiki.servicenow.com/index.php?title=Transferring_Update_Sets.

2. Follow the same steps to transfer the Bomgar - ServiceNow Integration Configuration update set.

Configure Production Outbound Event

1. In the Bomgar interface, go to /login > Management >Outbound Events.

2. Copy the URL of the event for the original ServiceNow instance.3. Click Add New HTTP Recipient.4. In the URL field, paste and replace the name of the original

ServiceNow instance with that of the new one such that /x_bmgr_bomgar_pam_bomgar_post.do is preserved at the end.The result should be similar tohttps://prod.example.com/x_bmgr_bomgar_pam_bomgar_post.do as opposed tohttps://dev.example.com/x_bmgr_bomgar_pam_bomgar_post.do.

5. Scroll to Events to Send and check the Access Session End event.6. Scroll to the bottom and click Add Recipient.7. Locate the outbound event created during testing and click Edit.8. Check the Disabled checkbox and save.

Configure Custom Link

1. Browse to Access Console > Custom Links.2. Under Access Console :: Custom Links, update the

ServiceNow URL to direct to the destination instance ofServiceNow. Be careful to preserve /nav_to.do?uri=task.do?sys_id=%EXTERNAL_KEY% at the end.

3. Click Save.4. Test the integration setup in its new location following the same steps used to test the original instance. See "Test the Setup

of the Bomgar PA and ServiceNow Integration" on page 17.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 18© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW

Use Cases for the ServiceNow Enterprise Integration withBomgar Privileged AccessOrganizations using ServiceNow can integrate with Bomgar PA to provide secure, privileged access to critical assets from withinServiceNow. This satisfies internal and external compliance requirements while maintaining comprehensive audit trails andintegrating with change management processes.

Jump to Configuration Item

Technicians can leverage Bomgar Jump Technology to access aconfiguration item associated with an incident directly from the incident.Additionally, this same technology can be leveraged directly fromwithin a configuration item as well, even if it is not associated with anincident.

Once the session ends, a detailed report of the session is imported intoServiceNow and associated with the incident and/or configuration itemrecord from which it originated.

Import Bomgar Session Data into a ServiceNow Record

Once the Bomgar access session ends, ServiceNow is automaticallyupdated with information gathered during the session, including:

l File Transfer Informationl Endpoint System Informationl Users Involvedl Endpoint Detailsl Access Session Recordings

Change Management Workflow

Bomgar access requests can require a ServiceNow incident ID to beentered as part of the access request process. Once entered, therequest is sent to ServiceNow where it can be programmatically deniedor allowed using the Bomgar API.

Access ServiceNow Records from Access Console

Using Bomgar's custom link ability, a user can access the associated ServiceNow record directly from within the access console.This saves time searching for the record in ServiceNow and provides the user with any available session details, history, or othercontext to help resolve issues quickly.

CONTACT BOMGAR [email protected] | 866.205.3650 (US) | +44 (0) 1628 480 210 (UK/EMEA) BOMGAR.COM 19© 2018 Bomgar Corporation. All rights reserved worldwide. BOMGAR and the BOMGAR logo are trademarks of Bomgar Corporation; other trademarks shown are the property of their respective owners. TC: 6/7/2018

BOMGAR PA INTEGRATION WITH SERVICENOW