Endpoint Management

Endpoint management is the process of actively monitoring, detecting, and preventing malware attacks on devices that are connected to a network. This is typically done to implement security policies and monitor suspicious activities on endpoints. It can be done by:

1. Inventory / management of Endpoints or servers (Windows, Linux, macOS and others)
2. Active Directory Sync for users (one way only)
3. Workflows to control permissions
4. Endpoint user management through Endpoint User Management Service

List Instances

The List Instances API allows users to retrieve a list of computing instances that belong to an endpoint group in a system or application.

curl POST 'https://api.authnull.kloudlearn.com/api/v1/instances/list' \
--header 'Content-Type: application/json' \
--data '{
  "domainId": 1,
  "pageId": 1,
  "pageSize": 10,
  "filter": ""
}'

POST /api/v1/instances/list HTTP/1.1

{
  "domainId": 1,
  "pageId": 1,
  "pageSize": 10,
  "filter": ""
}

Access Token

Authorization Key Required

HTTP Request

POST /api/v1/instances/list HTTP/1.1

Query Parameters

HTTP Response

{
  "domainId": 1,
  "groupId": 0,
  "totalCount": 7,
  "instances": [
    {
      "totalUsers": 38,
      "instanceName": "SK2014",
      "osName": "RedHat",
      "publicIp": "192.168.3.1",
      "privateIp": "",
      "hostName": "",
      "status": "Inactive",
      "instanceId": 1,
      "totalGroups": 8
    }
  ]
}

Add Instances

The Add Instance API allows users to add a new computing instance to an endpoint group in a system or application.

curl POST 'https://api.authnull.kloudlearn.com/api/v1/instances/addInstance' \
--header 'Content-Type: application/json' \
--data '{
  "domain_id": 25,
  "instance_name": "kloudone.vm",
  "os_id": 1,
  "public_ip": "144.32.55.5",
  "private_ip": "10.32.45.1"
}'

POST /api/v1/instances/addInstance HTTP/1.1

{
  "domainId": 1234,
  "instanceName": "kloudone.vm",
  "osId": 1,
  "publicIp": "144.32.55.5",
  "privateIp": "10.32.45.1"
}

Access Token

Authorization Key Required

HTTP Request

POST /api/v1/instances/addInstance HTTP/1.1

Query Parameters

HTTP Response

{
  "instanceId": "fdsf-dfdf-gfdsgf-fdsgfdg-fdge",
  "code": 200,
  "message": "success"
}

Update Auth Type

The Update Auth Type API allows users to update the authentication type used for a computing instance within an endpoint group.

curl PUT https://api.authnull.kloudlearn.com/api/v1/instances/updateAuthType \
--header 'Content-Type: application/json' \
--data '{
  "instanceId": 1,
  "domainId": 1,
  "authType": "SSH,DID,Password"
}'

PUT /api/v1/instances/updateAuthType HTTP/1.1

{
  "instanceId": 1,
  "domainId": 1,
  "authType": "SSH,DID,Password"
}

Access Token

Authorization Key Required

HTTP Request

PUT /api/v1/instances/updateAuthType HTTP/1.1

Query Parameters

HTTP Response

{
  "Auth Type Updated"
}

Assign User to Endpoints

The Assign User to Endpoints API allows users to assign one or more users to specific computing instances within an endpoint group.

curl POST 'https://api.authnull.kloudlearn.com/api/v1/instances/assignUsersToMachines' \
--header 'Content-Type: application/json' \
--data '{
  "instanceIds": [1, 2],
  "domainId": 1,
  "userIds": [106, 103],
  "action": "add"
}'

POST /api/v1/instances/assignUsersToMachines HTTP/1.1

{
  "instanceIds": [1, 2],
  "domainId": 1,
  "userIds": [106, 103],
  "action": "add"
}

Access Token

Authorization Key Required

HTTP Request

POST /api/v1/instances/assignUsersToMachines HTTP/1.1

Query Parameters

HTTP Response

{
  "code": 200,
  "message": "Successfully Added"
}

Assign Groups To Endpoints

The Assign Groups to Endpoints API allows users to assign one or more groups to specific computing instances within an endpoint group.

curl PUT 'https://api.authnull.kloudlearn.com/api/v1/instances/assignGroupToMachines' \
--header 'Content-Type: application/json' \
--data '{
  "instanceId": [1, 2],
  "domainId": 1,
  "groupId": [1, 2, 3],
  "action": "add"
}'

PUT /api/v1/instances/assignGroupToMachines HTTP/1.1

{
  "instanceId": [1, 2],
  "domainId": 1,
  "groupId": [1, 2, 3],
  "action": "add"
}

Access Token

Authorization Key Required

HTTP Request

PUT /api/v1/instances/assignGroupToMachines

Query Parameters

HTTP Response

{
  "code": 200,
  "message": "Successfully Added"
}