Configuring ServiceNow and SNSC

You can enhance your ServiceNow instance with the CA Automic ServiceNow Service Connector (SNSC) to enable the execution and monitoring of Automation Engine services directly from the ServiceNow service catalog.

This page includes the following:

Updating Application Access for Tables

Prerequisite: You have a ServiceNow user that has admin and security_admin roles.

  1. Log in to the target instance with a user with admin and security_admin roles.
  2. Set the Application Scope to Global.
  3. Navigate to Automic SNSC > Support > Used ServiceNow's Tables.
  4. Open each of the following tables io_set_item, item_option_new, item_option_new_set, sc_category, sc_cat_item, sysauto_script.

    Ensure that the options Can create, Can update, Can delete are checked in the Application Access section for all six tables.

  5. The application access is now configured.

Configuring ServiceNow System Properties

SNSC uses ServiceNow System Properties to store SAPI and OAuth configuration properties.

Note: You may use an intermediate MID server when you cannot connect from your ServiceNow instance to SAPI or OAuth servers. See also: https://wiki.servicenow.com/index.php?title=MID_Server.

To configure ServiceNow for using OAuth and SAPI start the Automic OAuth Configuration wizard.

To Configure Service Now System Properties

  1. Log in to the target ServiceNow instance with a user who owns the roles admin and security_admin.
  2. Navigate to Automic SNSC > Automic Configuration > Automic OAuth Configuration.
  3. In Automic OAuth Configuration and modify the following configuration parameters:

    Image showing configuration of Oauth client

    Configuration Parameter

    Description

    Client ID

    Identity of the OAuth client (AE_system_name/client_number/user_name)

    Example: AE/777/SERVICE_NOW

    Note: Generally, this is the ID of the ServiceNow instance registered with OAuth server. This the same client ID that you used in the VARA object called OAUTH.[CLIENT_ID].CLIENT_INFORMATION. See Adding the OAuth Configuration to AE Clients.

    Client Secret

    Secret phrase of OAuth client user

    Example: AES_12345, the value will be encrypted in ServiceNow

    Technical User

    User Name/Department

    Example: TECHSYNC/AUTOMIC

    SAPI Endpoint

    Root endpoint URL of SAPI, the URL from which SNSC discovers services

    Example: http://mycompany.com/sapi

    Important! A protocol indication (http/https) is required.

    Token Endpoint

    Endpoint for token requesting/refreshing URL

    Example: http://mycompany.com/oauth2/token

    Important! A protocol indication (http/https) is required.

    Authorization Endpoint

    Authorization endpoint URL

    Example: http://mycompany.com/oauth2/auth

    Important! A protocol indication (http/https) is required.

    Note: If the Technical User does not have a valid token (empty or expired token) or no access data has been stored before (this is the first login), an OAuth login window will pop up.

  4. Click Store OAuth Client Settings.

    Note: New values are effective immediately.

  5. OAuth Client Settings are activated.

Setting up the Approval Group

  1. Log in to the target instance with a user with admin role and set the scope to Automic SNSC.
  2. Navigate to Workflow > Workflow Editor.
  3. Search for and select the workflow named Sara Service:

  4. Click Menu and Checkout the workflow:

  5. Double-click the Waiting for Approval activity.

  6. Choose the group name which you want to be Approval Group in Groups:

  7. Click Edit Groups.

  8. Add the approver from the look-up list.

    Note: Approvers have to be assigned to your Approval Group and granted with approver_user and x_ausgh_snsc.user roles.

  9. Click Update.
  10. Publish the workflow again:

  11. You have just configured the Approval Group for SNSC.

Configuring the Log Level

  1. Go to Automic SNSC Components > Sara System Properties.
  2. In the Suffix field, enter logging.verbosity. This property is used to configure the log verbosity.
  3. Enter one of the following levels in the Value field: error, warn, info, debug, trace.
  4. Click Submit.

Next steps: Continue with Optimizing the SNSC Performance.