NexThink

NexThink’s platform provides several APIs, that you can use to connect it to the Aisera Gen AI platform.

Rest API Authorization

The Authorization mechanisms that are supported are described in this page: API credentials | API Documentation

We have prepared the following API Authorization method:

Basic Credentials to Bearer Token (OAuth2: client credentials)

The following cURL call describes the HTTP call we support, to exchange Basic credentials (Username & Password - or - clientId & clientSecret) for a Bearer Token. We can use the Bearer token to execute Rest API calls. The token has an expiration date, and once that time is passed Aisera’s backend will execute a new authorization call to acquire a new Bearer token.

curl --location --request POST 'https://aisera.api.us.nexthink.cloud/api/v1/token' \ --header 'Authorization: Basic *****'

UI wizard for NexThink’s Authorization configuration:

This Authorization logic (BasicToBearer) should enable access to the V1 family of NexThink APIs

https://aisera.api.us.nexthink.cloud/api/v1/

NexThink Documentation About BasicToBearer: Getting an authentication token | API Documentation

This “BasicToBearer” mechanism, is also mentioned as OAuth2: client credentials, and is a custom version of the standard OAuth2 flow (with grant_type: client_credentials)

To Generate a new set of Credentials form the NexThink interface, navigate to:

Administration → API Credentials:

And then click on the “New OAuth client credentials” option on the top right corner:

Setting Up a New Integration

After selecting the NexThink option in the available Integrations, you can type the baseURL for you instance:

In the Authentication Tab, fill the credentials you generated from the NexThink’s interface, along with the appropriate Access Token URL (this value has a pattern, which contains the id of the instance which in the following example is “aisera”).

The Access Token Extraction Key and the Expires In Extraction Key are optional.

Click OK to proceed until you complete the new Integration. Authentication Tab example for Aisera Sandbox

Rest Call Actions

Once an Integration has been created, we can create a Rest Call Action in the Flow Editor and make requests to NexThinks API Endpoints that support the BasicToBearer Authorization Logic. For example:

curl --location 'https://aisera.api.us.nexthink.cloud/api/v1/act/remote-action' \ --header 'Authorization: Bearer <TOKEN>'

We don’t have to worry about authorization when we configure the “Rest Call Action” block, we just have to pick the right Integration.

Webhook Setup

Before configuring the webhook, it is essential to establish a connection between Nexthink and Aisera within the Nexthink platform. This connection is facilitated through the Nexthink connector credentials, as detailed in the documentation: Connector credentials .

In summary, this involves defining the protocol (HTTPS in our case), specifying the Aisera base URL, and providing the necessary credentials, such as bearer token authorization or basic authorization.

To set up the webhook, we follow the outlined steps on this page: Managing webhooks

Here, we select the previously configured connector credentials and include the specific endpoint we intend to reach in Aisera, such as, /alerts. Additionally, we configure the payload that needs to be sent to Aisera. Lastly, we set the Nexthink Query Language (NQL) to determine the conditions triggering the webhook, such as CPU usage exceeding a defined threshold. This NQL condition ensures that the webhook is activated when specified criteria are met.

** Aisera side Webhook setup: Setup of a Webhook connector at Aisera