This URL obtains the IVX broker authentication status at Sensor/Device level.
Resource URL
POST /VXIntegration/sensor/<sensor_id>/getVxBrokerAuthStatus
Request Parameters
Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| Sensor ID | Number | Yes |
| Enable or disable certificate validation | Boolean | Yes |
| Enable or disable proxy for IVX communication | Boolean | Yes |
| IP address of the broker node NoteIf you are on a Sensor version prior to 11.1 Update 4, you need enter only IPv4 address of the single broker node. | String | Yes |
| Password for broker node authentication | String | Yes |
| Username for broker node authentication | String | Yes |
Response Parameters
Following fields are returned if the request parameters are correct, otherwise error details are returned.
Field Name | Description | Data Type |
|---|---|---|
| Success status (true or false) | Boolean |
| Message | String |
| Error message | String |
| Data | String |
| Error code | String |
| IP address of the broker node | String |
| IP address of the broker node | String |
| Authentication status of the Manager with the IVX appliance | Boolean |
| Reason for the authentication failure | String |
| Authentication status of the Sensor with the IVX appliance | String |
Example
Request
POST https://<Manager_IP>/sdkapi/VXIntegration/sensor/1001/getVxBrokerAuthStatus
Payload:
{
"vxEnableCertValidation": false,
"vxEnableProxy": true,
"vxIpAddress": "10.213.2.35",
"vxPassword": "admin123",
"vxUserName": "admin"
}
Response
{
"success": true,
"msg": null,
"errMsg": null,
"data": null,
"errorCode": 0,
"vxIpAddress": "10.213.2.35",
"managerAuthSuccessful": true,
"mgrAuthFailureReason": null,
"sensorAuthStatus": "Successful"
}Error Information
Following error codes are returned by this URL:
S.No | HTTP Error Code | SDK API errorId | SDK API errorMessage |
|---|---|---|---|
1 | 404 | 1106 | Invalid Sensor |