This guide shows how to configure the integration between Segura® Platform and ServiceNow using the REST API.
Requirements
- ServiceNow instance URL.
- Authentication data for one of the two supported methods:
- OAuth 2.0 (Client Credentials) (recommended): Client ID and Client Secret.
- Basic (username + password): Username and Password.
Configure ServiceNow
- On Segura® Platform, in the navigation bar, hover over the Products menu and select Settings.
- In the side menu, select Integrations > ITSM > ITSM Connections.
- In the ITSM Connections report, in the top bar, click on + Add.
- In the Registration of integration with ITSM screen, select ServiceNow.
- In the General tab, complete the following fields:
- Connection name *: name of the integration in the Segura® Platform.
- Instance URL *: URL of the ServiceNow instance.
- Description: optional description of the integration.
- Active: select Yes to enable the connection.
- Click Continue.
- In the Authentication tab, select the Authentication method *. The options are OAuth 2.0 (Client Credentials) or Basic (user + password).
- Complete the fields according to the selected method:
- For OAuth 2.0 (Client Credentials): complete the Client ID and Client Secret fields.
- For Basic (user and password): complete the Username and Password fields.
- Click Continue.
- In the Behavior tab, define the operational parameters:
- Connection timeout (seconds)
- Read timeout (seconds)
- Maximum retries
- Validation cache TTL (seconds)
- Health check interval (minutes)
- Click Continue.
- In the Fallback tab, select the desired behavior in case the ITSM is unavailable:
- Deny access when the ITSM is unavailable
- Allow emergency access only (break-glass)
- Allow access and log for later audit
- If necessary, click Test connection to validate the configuration.
- Click Continue.
- In the Review tab, review the configured information.
- Click Save.
Make the connection available
Creating an ITSM connection does not automatically put it into use. Choose one of the following:
- Set it as the global default: go to Settings > Integrations > ITSM > ITSM Connections, and select this connection as the default. Access policies that do not specify their own connection use this one.
- Override it for a specific access policy: in the access policy's Approvers tab, select this connection in the ITSM connection field. This takes precedence over the global default for that policy.
Info
The ServiceNow integration uses the endpoint /api/now/table/ and the approval flow accepts requests only for tickets with the status In Progress.