GetSID API

Overview

The GetSID API lets you retrieve the Security Identifier (SID) of end users.

Because triggering a campaign via the Engage API requires the SID of the targeted users as a parameter, the GetSID API is specially useful for automatically triggering campaigns from environments where the SID of users is not readily available.

Calling the GetSID API

The Portal exposes the Engage API as a REST API under the URL:

https://[portal.company.com]/api/inventory/v1/getusersid

In the URL, substitute [portal.company.com] for the external DNS name of your Portal.

To get the SID of an end user, submit a POST request to the URL of the API (note that GET requests are not supported, returning a 404 error) with a JSON payload encoded in UTF-8 that contains two parameters:

Name	Description
fieldName	Name of the field that serves to retrieve the user. Look for users either by: name: User logon name. dn: Distinguished name of the user in Active Directory.
fieldValues	List of values to search on the specified field (currently limited to 1 element).

Example of the JSON payload of a request to the API of Engage:

{
 "fieldName": "name",
 "fieldValues" : ["[e-mail]"]
}

HTTP headers

Send your POST request to the GetSID API with the following HTTP headers to specify JSON content and basic authentication:

Content-type: application/json

Authorization: Basic [base-64(user:password)]

Replace [base-64(user:password)] with the credentials (in base-64 encoding) of a Nexthink user who has the right to access the API for triggering campaigns.

Error conditions

In response to a request, the Portal may send one of the following answers if something goes wrong:

Error type	HTTP code	Cause
Access Denied	Unauthorized 401	Authentication error
Validation error	Bad request 400	Invalid JSON Invalid encoding Invalid Content-type Missing or invalid fieldName Missing or too many fieldValues
Unknown error	Internal server error 500	Undefined internal error

---

RELATED TASK

• Triggering campaigns via their API