ServiceNow ticketing system integration
ServiceNow is a cloud-based issue tracking system. SPP can exchange the following ticket types with ServiceNow:
- CHG (change) tickets
- RITM (request) tickets
- PRB (problem) tickets
The data items specific to ServiceNow may be optional based on your configuration.
To use ServiceNow, the root CA Certificate required for ServiceNow must be installed in SPP. For more information, see Trusted CA Certificates.. To add a trusted certificate, see Adding a trusted certificate.
Tickets can be viewed in the Activity Center, Ticket # column.
Setting up the integration
- Go to Ticket Systems:
- web client: Navigate to External Integration > Ticket Systems.
- Click Add to add a ticket system.
- Do the following:
- web client: Select ServiceNow.
- Complete the authorization information based on your installation:
- Name: Enter the name of your ticketing system
- URL: Enter the web site address to the ticketing system.
- Username: Enter an account for SPP to use to access the ticketing system.
- Password: Enter the user account's password.
- Client Identifier: Enter the ServiceNow Client ID.
- Client Secret: Enter the ServiceNow secret key.
- Click Test Connection to test the connection to ServiceNow.
Ticket workflow
- The Security Policy Administrator creates an access request policy that requires the requester to provide a ticket number when creating an access request.
- When the requester makes a request, they must enter the existing ServiceNow ticket number on the New Access Request dialog, Request Details tab, Ticket Number field. See:
- SPP queries all configured ticket systems to see if that ticket number represents a ticket that exists and is in an open state. For ServiceNow, Safeguard checks the Active property of the identified ticket returned from the ServiceNow API and considers the ticket number valid if the Active property is not false for that incident.
- If the ticket is not active, the request is denied.
- If the ticket is active, the access workflow continues.
Remedy ticketing system integration
You can use ticketing that is configured to work with Remedy.
Tickets can be viewed in the Activity Center, Ticket # column.
Safeguard checks the Status property of the incident returned from the Remedy API. The ticket is considered valid if Status is not Closed or Cancelled.
The data items specific to Remedy may be optional based on your configuration.
Setting up the integration
- Go to Ticket Systems:
- web client: Navigate to External Integration > Ticket Systems.
- Click Add to add a ticket system.
- Do the following:
- web client: Select Remedy.
- Complete the authorization information based on your installation:
- Name: Enter the name of your ticketing system.
- URL: Enter the web site address to the ticketing system.
- Username: Enter an account for SPP to use to access the ticketing system.
- Password: Enter the user account's password.
- Authentication String: Enter the authentication credential for the Remedy AR (Action Request) system server.
- Click Test Connection verify the connection to Remedy works.
Ticket workflow
- The Security Policy Administrator creates an access request policy that requires the requester to provide a ticket number when creating an access request.
- When the requester makes a request, they must enter the existing Remedy ticket number on the New Access Request dialog, Request Details tab, Ticket Number field. See:
- SPP queries all configured ticket systems to see if that ticket number represents a ticket that exists and is in an open state.
Not integrated with ticketing system
You can use ticketing that is not configured with an external ticketing system to track tickets.
Tickets can be viewed in the Activity Center, Ticket # column.
Security Policy Administrators can require requesters to reference a ticket number in their password, SSH key, or session access request but not have the ticket validated against an external ticketing system but, optionally, may be validated against the regular expression of a generic ticketing system. The ticket number is used in the decision to approve the request.
Setting up ticketing
- Go to Ticket Systems:
- web client: Navigate to External Integration > Ticket Systems.
- Click Add to add a ticket system.
- Select Other and complete this information:
- Click Validate to validate the Regular Expression entry.
Ticket workflow
- The Security Policy Administrator creates an access request policy that requires the requester to provide a ticket number when creating an access request.
- When the requester makes a request, they must enter a ticket number on the New Access Request dialog, Request Details tab, Ticket Number field. See:
- Safeguard for Privileged Passwords validates the ticket number against the regular expression. If the ticket number is an exact match to the regular expression, the workflow continues.
Trusted Servers, CORS, and Redirects
You can restrict login redirects and Cross Origin Resource Sharing (CORS) requests to a specified list of IP addresses, host names (including DNS wildcards), and CIDR notation networks. By default, a single asterisk (*) means there are no restrictions. This will allow you to easily join multiple Safeguard for Privileged Passwords appliances together to form a cluster. In addition, you will also be able to link to a Safeguard for Privileged Sessions appliance.
However, as a best practice, you should change or delete this value after configuring your cluster. It is recommended to set it to the empty string to prevent external CORS requests and login redirects to unknown servers. Or, set it to a list of known servers that integrate with the Safeguard API.
One or more values can be separated by a space, comma, or new line. Do not include the scheme, port, or path. The maximum length for the setting is 512 characters, including separators. Example values and additional details can be seen in the following table.
Table 58: Value detail
IPv4
No reverse DNS lookup will be performed. No scheme or port values are considered. |
10.5.33.37
192.168.0.2 |
IPv6
No reverse DNS lookup will be performed. No scheme or port values are considered. |
2001:0db8:85a3:0000:0000:8a2e:0370:7334
2001:0db8:85a3:0:0:8a2e:0370:7334
2001:db8::1:0:0:1
2001:db8::2:1
2001:db8::1 |
DNS/Host Names
Case insensitive match. No scheme or port values are considered. If using Internationalized Domain Names (IDN), you must also manually include the punycode equivalent. |
spp.contoso.corp
primary.spp.contoso.corp
widget.contoso.corp
widget |
DNS Wildcards
Only one level to the wildcard is allowed, just like SSL certificates. No scheme or port values are considered. If using Internationalized Domain Names (IDN), you must also manually include the punycode equivalent. |
*.spp.contoso.corp
*.contoso.corp |
CIDR Notation
Any DNS or host name values being validated will have DNS lookup performed to see if any resolved IP addresses are contained within any of the specified CIDR networks. No scheme or port values are considered. |
10.0.0.0/8
172.16.0.0/12
192.168.0.0/16
76.240.155.0/24
fd12:3456:789a:1::/64
fd00::/8 |
Allow All
A single asterisk, no other values allowed. |
* |
Allow None
Delete all values and leave as the empty string. |
|
Considerations:
- When adding a new node to the SPP cluster, the node’s host name or IP address must be specified in this list, or enter a single asterisk to allow all.
- When linking Safeguard for Privileged Sessions to SPP, the host name or IP address of the Safeguard for Privileged Sessions appliance must be specified in this list, or enter a single asterisk to allow all.
- As a best practice, after clustering (or if using just a single appliance/VM), change the setting value to the empty string or a list of integration applications you wish to allow.
To set up Trusted Servers, CORS and Redirects:
- Go to Trusted Servers, CORS and Redirects:
- web client: Navigate to External Integration > Trusted Servers, CORS and Redirects.
- Refresh: Update the information displayed.
- In Allow Hosts, enter the list of IP addresses, host names (including DNS wildcards), and CIDR notation networks. As mentioned above, the default is a single asterisk (*) which means there are no restrictions.
- Click Save (web client).