ServiceNow

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

  1. Login to your XTAM host server
  2. Open the file $XTAM_HOME/web/conf/catalina.properties in a text editor and add the following new lines to the end:
  3. Copy
    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
    1. 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

    2. Defines your ServiceNow tenant URL

    3. Defines your ServiceNow administrator’s username

    4. Defines your ServiceNow administrator’s password

    5. 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.

  4. Save and close the file.

  5. 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.

 

  1. Login to ServiceNow and create a new and find an existing Incident that can be used for testing. Copy the SN incident number.
  2. XTAM-Service-Now-Integration-Incident

  3. Login to XTAM and navigate to a record that requires an access request (XTAM Workflow) and click the Request button.

  4. 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:

    Copy
    Rebuilding indexes as required in SN# INC0010009
  5. XTAM-Service-Now-Integration-Request-Access

  6. Submit the XTAM request when done.

  7. Return to the ServiceNow incident and view the activity. A new comment will have been generated detailing the access request.

    XTAM-Service-Now-Integration-Incident-Activity-01

  8. 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.

    XTAM-Service-Now-Integration-Incident-Activity-02