Connect ServiceNow
This guide connects a client’s ServiceNow instance to a workspace, so that Raise Ticket appears on every event.
You need
Section titled “You need”- The admin role in the workspace.
- The Super plan, with ITSM ticketing ticked under Policies, in the Feature flags list.
- A ServiceNow administrator for step 1.
1. Prepare ServiceNow
Section titled “1. Prepare ServiceNow”Ask the ServiceNow administrator to do this on the instance.
- Check that the instance runs the Washington DC release or newer.
- Set the system property
glide.oauth.inbound.client.credential.grant_type.enabledtotrue. - Under System OAuth → Application Registry, create an Application endpoint for external clients. Leave it confidential, not public.
- Set an OAuth Application User on the registry record, and give that user the
itilrole. Incidents are created as this user. - Copy the client ID and the client secret.
2. Connect it in Identiguard
Section titled “2. Connect it in Identiguard”- Open ITSM under Workspace.
- In the ServiceNow connection card, enter the ServiceNow instance URL, for example
https://your-instance.service-now.com. - Enter the OAuth client ID and the OAuth client secret.
- Optional: enter an Assignment group, as a group name or a
sys_id, to send every incident to one queue. - Optional: enter a Caller sys_id.
- Tick Enable ticketing.
- Choose Save changes.
You see ServiceNow connector saved.
3. Test it
Section titled “3. Test it”- Choose Send test incident.
- You see Test incident with a number created in ServiceNow.
- In ServiceNow, find the incident titled “Identiguard connection test - no action required” and close it.
4. Check it from an event
Section titled “4. Check it from an event”Open the dashboard. Raise Ticket is now on each event row in Real-time events. Admins and members can use it. See Raise a ticket.
Change the client ID and secret
Section titled “Change the client ID and secret”- Open ITSM.
- Choose Replace beside the masked client.
- Enter the new OAuth client ID and OAuth client secret.
- Choose Save changes, then Send test incident.
Move to another instance
Section titled “Move to another instance”- Open ITSM and change the ServiceNow instance URL.
- The credential fields appear again. Enter the client ID and secret for the new instance. The stored client is never sent to a different instance.
- Choose Save changes, then Send test incident.
Stop or remove ticketing
Section titled “Stop or remove ticketing”- To hide Raise Ticket and keep the connector, untick Enable ticketing and choose Save changes.
- To remove the connector, choose Disconnect, then Disconnect again in the dialog Disconnect ServiceNow? The stored OAuth client is deleted. Incidents already raised are not affected.
If it does not work
Section titled “If it does not work”| What you see | What to do |
|---|---|
| ITSM is not in the sidebar | Check that you are an admin, that the plan is Super and that ITSM ticketing is ticked under Policies. |
| ServiceNow instance URL host is not allowed. | The URL must be on service-now.com or servicenowservices.com and use HTTPS. |
| ServiceNow authentication failed with a status | Check the client ID and secret, that the client is confidential, that the system property is true and that an OAuth Application User is set. |
| A message ending redirects are not followed | Use the direct instance URL, not an address that redirects. |
| ServiceNow assignment group with the name was not found on the instance. | Correct the group name, or paste its sys_id. |
| ServiceNow incident creation failed with a status | Usually the OAuth Application User has no itil role, or the caller sys_id is wrong. |
| Send test incident is disabled | Save the connector first. |
Every message is explained in ServiceNow ticketing.