ServiceNow Integration
ServiceNow integration is supported with basic authentication or OAuth. The user will need enough permissions to create change requests.
Preparing for ServiceNow Integration with FlexDeploy
See ServiceNow Required Permissions and ServiceNow OAuth Support for details.
Create Change Management Instance
Property Name | Property Code | Required | Description |
---|---|---|---|
ServiceNow URL |
| Yes | The URL for accessing ServiceNow. |
ServiceNow User Name |
| Yes | A local ServiceNow service account user with a non-expiring password. |
ServiceNow Password |
| No* | The password for the ServiceNow User Name above. Note that encrypted properties are stored in Credential Store (Local or External) and can be configured using Edit button next to credential name drop down. Alternatively, you can reuse single credential for multiple properties also, in which case you should name that credential appropriately. Required for the following Auth Types, BasicAuth and OAuthResourceOwner |
ServiceNow Auth Type |
| Yes | Authentication method for connecting to ServiceNow, BasicAuth, OAuthResourceOwner, OAuthJWTAssertion. Defaults to BasicAuth. |
ServiceNow Client ID |
| No* | The auto-generated unique ID of the application. The instance uses the client ID when requesting an access token. Required for the following Auth Types, OAuthResourceOwner and OAuthJWTAssertion. |
ServiceNow Client Secret |
| No* | The shared secret string that both the instance and the client application use to authorize communications with one another. The instance uses the client secret when requesting an access token. (Encrypted). Required for the following Auth Types, OAuthResourceOwner and OAuthJWTAssertion. |
ServiceNow Keystore Path |
| No* | ServiceNow Keystore Path (path to the jks file). Required for the following Auth Types, OAuthJWTAssertion. |
ServiceNow Keystore Passphrase |
| No* | Java keystore passphrase for the ServiceNow Keystore (Encrypted). Required for the following Auth Types, OAuthJWTAssertion. |
ServiceNow Certificate Alias |
| No* | Private certificate alias. Required for the following Auth Types, OAuthJWTAssertion. |
ServiceNow Certificate Passphrase |
| No* | Passphrase for the ServiceNow Certificate (Encrypted). Required for the following Auth Types, OAuthJWTAssertion. |
ServiceNow JWT Verifier Map Key ID |
| No* | ServiceNow JWT Verifier Map Key ID. Required for the following Auth Types, OAuthJWTAssertion. |
ServiceNow Certificate Algorithm |
| No* | Algorithm used for the certificate. Defaults to RS256. Required for the following Auth Types, OAuthJWTAssertion. |
ServiceNow Refresh Token Lifespan |
| No | The number of seconds that a refresh token is valid. The instance uses the lifespan value when requesting a refresh token. By default, refresh tokens expire in 100 days (8640000 seconds). |
ServiceNow Request GET URL |
| No | The URL to get the change request details as json response.
/api/now/table/u_instance_change?sysparm_query=number%3D{SN_CHANGE_NUMBER}&sysparm_fields=number,state,active,approval Adding &sysparm_display_value=true to the end of the URL will return the display value for things like state. For example instead of returning state = 3, the value of state = Ready would be returned. |
ServiceNow Navigation Request URL |
| No | The URL to open ServiceNow and navigate to the Change ticket associated to the project workflow execution
|
ServiceNow Request POST URL |
| No | The URL to create a change request.
|
Approved Check Script |
| No | A Groovy expression which determines whether a task for the change ticket is approved or not. The expression must return a boolean, and has access to the following variables:
If the Approved Check Script is left blank, the default implementation is to return true if the "approval" field of the ticket is set to "approved". Simple Example which is used by default |