To access the V4 API Documentation, click on Profile > API Documentation from inside the portal.
API Documentation - Details
To log in and authorize, use API /w/authorize
Client-Auth-Token: (base64 (tenant+client_id:client_secret))
Use https://www.base64encode.org/ to Encode the Client-Auth-Token
Sample Example: Go to the above URL and add {{tenantname}}+ {{Client_id}}:{{client_secret}}
Refer the below screenshot.
To fetch a User’s Client_ID and Client_Secret, navigate to Global > User Management > Select User > click on Action > API Key.
Once you have the encoded data add it to POST: /w/authorize and execute
After execution, copy the ‘access_token’ from the response, click on Authorize on top of the page, paste the ‘access_token’ to the ‘Value', and click on Authorize.
Now you can use the ‘user_ID’, given under the /w/authorize response.
Navigate to the required section (IE: Company as below to GET /r/company/agents
Description: String, skip, limit, sort
String: It specifies the number of pages to skip. E.g., when the skip is set to 0, and the limit is set to 10, it will process the entire dataset by splitting it into 10 pages. The data from the first page will be returned; for the second page, the skip will be 1, and the limit will be 10, returning the next 10 data.
Limit: It limits the number of returned values. The default limit is 100.
Sort: It specifies the sorting order based on the 'severity. keyword' field in descending order.
Example Data for GET /r/company/agents
{ "status": true, "data": [ { "old_id": "string", "name": "string", "agent_version": "string", "host_name": "string", "ip": "string", "os_type": "string", "os_platform": "string", "os_name": "string", "os_version": "string", "kernel": "string", "agent_type": "string", "last_scanned_time": "string", "last_reported": "string", "max_thread_count": 0, "is_deprecated": true, "deprecated_time": "string", "reported": true, "company_ref_id": "string", "company_id": 0, "tenantid": 0, "id": 0, "created": "string", "updated": "string" } ] }
Need Support?
Contact our support team by sending an email to support@connectsecure.com or by visiting our Partner Portal, where you can create, view, and manage your tickets.
https://cybercns.freshdesk.com/en/support/login
