1. ServiceNow#

TrustView has a native integration with ServiceNow and can be accessed by going to Settings Service management integrations. When setup, this integration allows TrustView to automatically create a task, incident or Request (depending on the type you select at setup), when a certificate or monitored object is close to expiry.

Adding a ServiceNow integration in TrustView

1.1. Setup ServiceNow integration#

To connect to your ServiceNow instance, click Add and fill out the required information:

  • Name - a name for the integration (Required)

  • Type - Select ServiceNow (Required)

  • Instance link - The link to the ServiceNow instance (Required)

  • Client id - Id of the ServiceNow client (Required)

  • Client secret - Secret for the ServiceNow client (Required)

  • Username - The username for your ServiceNow client (Required)

  • Password - The password for your ServiceNow client (Required)

  • Default task type - Choose which type of task, that TrustView should create (Required)

Important

The user that is referred to is the instance user, that is associated with the ServiceNow client, you are trying to connect to. The user details can be found here https://developer.servicenow.com/ My instance Manage instance password.

Tip

If you are in doubt of where to find the information, you can checkout the ServiceNow documentation.

After the initial setup of the ServiceNow integration, we recommend that you perform the following tasks:

  • Test the connection - Click Test connection

  • Synchronize the groups - Click Sync assignment groups

  • Select a default assignment group - Choose Assignment group from dropdown

  • Create a test task or incident - Click Add test incident (this also counts for creating test tasks)

Note

Synchronization of groups does not trigger automatically and have to be manually triggered.

1.2. Per monitored object selection of ServiceNow assignment group#

It is possible to assign assignment groups to each individual object, such as SSL Endpoints or SSL Certificates etc. To enable this, you must first activate the ServiceNow integration in TrustView. Once that has been done and a default Assignment group has been selected (after successfully being synchronized with your ServiceNow instance), you can on the edit page to the right, just below Notifications, select an Assignment group that you wish to attach Incidents or Tasks to.

1.3. Object matching filters#

By using the TVQL (TrustView Query Language), it is possible to build a search query to match your needs, using the available query parameters. Use the input field Object matching filter to enter you desired TVQL search query.

Important

If a object matching filter is set, then only when an objects is matching the query, a notification will be sent. So if you do not want to limit the notifications to a object matching filter, leave the input field empty.

The common TVQL syntax looks like this:

field = value
field != value
field IS EMPTY
field IS NOT EMPTY

Supported operators:

= , AND , OR , IS EMPTY , NOT()

1.3.1. TVQL examples#

NOT(OrderId IS EMPTY)

certificationauthority=DIGICERT OR certificationauthority=LETSENCRYPT

comment IS EMPTY

status=Active

name="foo bar baz"

status=Active AND status=Ignored

status=Ignored AND status=Disabled OR status=Active

status=Ignored OR status=Disabled AND status=Active

status=Active OR status=Ignored

NOT(status=Active)

(status = Ignored OR status = Disabled) AND status = Active

NOT(OrderId IS EMPTY)