Xton Access Manager (XTAM) Integration with ServiceNow Incident Activity
XTAM can be easily integrated with your ServiceNow tenants so that interactions within XTAM records can be added to the corresponding ServiceNow Incidents activities. Once the integration is properly configured, all you need to do in XTAM is reference the ServiceNow (SN) Incident number in your access request form and the rest will be automated for you. Review the remainder of this article to learn how to setup this easy integration as well as some screenshots detailing the process.
Configuring your XTAM and ServiceNow Integration
Login to your XTAM host server
Open the file $XTAM_HOME/web/conf/catalina.properties in a text editor and add the following new lines to the end:
xtam.integration.ticketing.pattern=SN# xtam.integration.ticketing.url=https://SERVICENOW-TENANT.service-now.com xtam.integration.ticketing.user=SERVICENOW-ADMIN xtam.integration.ticketing.password=SERVICENOW-PASSWORD xtam.integration.ticketing.script=ServiceNow Integration
Defines the pattern that XTAM will recognize as pertaining to a ServiceNow Incident number. Default is SN# meaning the user will refer to the SN incident number in XTAM as SN# INC0010009
Defines your ServiceNow tenant URL
Defines your ServiceNow administrator’s username
Defines your ServiceNow administrator’s password
Defines the XTAM script that performs the integration procedure. You should not change this default value unless you created your own XTAM script, then you should define your script’s name here.
Save and close the file
Restart the PamManagement (Windows) or pammanager (Linux) service to complete the integration.
Testing XTAM and ServiceNow Integration
Use the following procedure to both test your configuration as well as to understand how the two systems integrate.
Login to ServiceNow and create a new and find an existing Incident that can be used for testing. Copy the SN incident number.
Login to XTAM and navigate to a record that requires an access request (XTAM Workflow) and click the Request button.
In the Access Request form’s Reason field, enter a reason that includes the SN# pattern as well as the actual SN incident number. Note that the expected format is SN# space Incident Number. For example:
Rebuilding indexes as required in SN# INC0010009
Submit the XTAM request when done.
Return to the ServiceNow incident and view the activity. A new comment will have been generated detailing the access request.
Return to XTAM, approve the access request and continue testing the remaining functionality that has been approved via the Workflow. Afterwards, return to the SN incident to see each new activity comment.