Session Management

A REST session is a glide session established with a ServiceNow instance by any external REST client like SailPoint Identity Governance connector for ServiceNow. It was observed that for every request the connector would open one session which resulted in opening a number of sessions on ServiceNow. With this release of the SailPoint Identity Governance connector for ServiceNow, the connector will maintain a pool of sessions (using the following parameters) which will be reused for subsequent operations:

  • sessionPoolSize: It defines how many maximum sessions can be opened on the ServiceNow. This parameter can be set in the application template using the debug page. The default value is 10.

  • sessionRetryCounter: It defines how many times IdentityIQ should try to get a free session from the sessionPoolSize. This parameter can be set in the application template using the debug page. The default value is 10.

Behavioral Change

The following are the behavioral changes observed with an increase or decrease of the sessionPoolSize or sessionRetryCounter parameters:

  • If the value of the sessionPoolSize or sessionRetryCounter parameters have been increased, you must perform a test connection for the changes to take effect. The following examples set the sessionPoolSize or sessionRetryCounter to 15.

    <entry key="sessionRetryCounter" value="15"/>

    <entry key="sessionPoolSize" value="15"/>

    Note

    If the value of sessionPoolSize is increased, the ServiceNow connector opens a new set of sessions. The sessions that were opened in ServiceNow, are closed after timeout in ServiceNow.

  • If the value of sessionPoolSize is decreased (for example from 10 to 5) the value is changed after restarting the Server.

  • If the value of the sessionRetryCounter is decreased, you must perform a test connection for the changes to take effect.

Note

  • The SailPoint Identity Governance connector for ServiceNow creates a new set of sessions on each test connection.

  • Consider the following while defining the session pool size. The number of session pool size required to handle the ServiceNow connector requests depends on the number of client requests. It also depends on the load on IdentityIQ, and the ability of the ServiceNow instance to work with those sessions.