Tenable Security Center API: LCE Client

/lce/{id}/client

Methods
GET

Gets the list of LCE Clients associated with LCE server <id>, depending on access and permissions.

Request Parameters

None

Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
{
    "type" : "regular",
    "response" : [
        {
            "clientIP" : "192.168.1.1",
            "clientType" : "tenableclient",
            "version" : "v4.x.x.x",
            "id" : "1",
            "authorized" : "No",
            "sensorName" : "unknown",
            "osType" : "windows",
            "osNumber" : "2008",
            "serverIP" : "192.168.1.1",
            "serverPort" : "31300",
            "lastUpdated" : -1,
            "lifeState" : -1,
            "authState" : -1,
            "policyFile" : "default_windows_tenableclient.lcp"      },
        {
            "clientIP" : "192.168.1.2",
            "clientType" : "tenableclient",
            "version" : "v4.x.x.x",
            "id" : "2",
            "authorized" : "Yes",
            "sensorName" : "unknown",
            "osType" : "windows",
            "osNumber" : "2008",
            "serverIP" : "192.168.1.1",
            "serverPort" : "31300",
            "lastUpdated" : -1,
            "lifeState" : -1,
            "authState" : -1,
            "policyFile" : "default_windows_tenableclient.lcp"      },
        {
            "clientIP" : "192.168.1.3",
            "clientType" : "tenableclient",
            "version" : "v4.x.x.x",
            "id" : "3",
            "authorized" : "No",
            "sensorName" : "unknown",
            "osType" : "windows",
            "osNumber" : "2003",
            "serverIP" : "192.168.1.1",
            "serverPort" : "31300",
            "lastUpdated" : -1,
            "lifeState" : -1,
            "authState" : -1,
            "policyFile" : "default_windows_tenableclient.lcp"      },
        {
            "clientIP" : "192.168.1.4",
            "clientType" : "tenableclient",
            "version" : "v4.x.x.x",
            "id" : "4",
            "authorized" : "No",
            "sensorName" : "unknown",
            "osType" : "windows",
            "osNumber" : "2008",
            "serverIP" : "192.168.1.1",
            "serverPort" : "31300",
            "lastUpdated" : -1,
            "lifeState" : -1,
            "authState" : -1,
            "policyFile" : "default_windows_tenableclient.lcp"      },
        {
            "clientIP" : "192.168.1.5",
            "clientType" : "tenableclient",
            "version" : "v4.x.x.x",
            "id" : "5",
            "authorized" : "No",
            "sensorName" : "unknown",
            "osType" : "windows",
            "osNumber" : "2003",
            "serverIP" : "192.168.1.1",
            "serverPort" : "31300",
            "lastUpdated" : -1,
            "lifeState" : -1,
            "authState" : -1,
            "policyFile" : "default_windows_tenableclient.lcp"      }
    ],
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1409767843
}

/lce/{id}/client/types

Methods
GET

Gets the types for the LCE Client associated with {id}.

Request Parameters

None

Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
    "type" : "regular",
    "response" : [
        "networkmonitor",
        "opsec",
        "netflowclient",
        "sdee",
        "lceclient",
        "wmimonitor",
        "rdep",
        "lcesplunk",
        "tenableclient",
        "reserved"  ],
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1411393801
}

/lce/{id}/client/osTypes

Methods
GET

Gets the OS Types for the LCE Client associated with {id}.

Request Parameters

None

Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "type" : "regular",
    "response" : [
        "rhel",
        "freebsd",
        "debian",
        "osx",
        "windows",
        "aix",
        "solaris",
        "hpux",
        "dragon",
        "fedora",
        "ubuntu",
        "suse",
        "appliance" ],
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1411393910
}

/lce/{serverID}/client/{clientID}

Methods
PATCH

Edits the LCE Client associated with {clientID} in server {serverID}, changing only the passed in fields.

Request Parameters
Expand
1
2
3
4
{
    "sensorName" : <string> OPTIONAL,
    "policyFile" : <string> OPTIONAL
}
Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "type" : "regular",
    "response" : {
        "clientIP" : "192.168.1.1",
        "clientType" : "networkmonitor",
        "version" : "v4.0.1.0",
        "id" : "1",
        "authorized" : "Yes",
        "sensorName" : "unknown",
        "osType" : "rhel",
        "osNumber" : "0",
        "serverIP" : "192.168.1.1",
        "serverPort" : "31300",
        "lastUpdated" : 1409839920,
        "lifeState" : "Alive",
        "authState" : "AUTH_SUCCEEDED",
        "policyFile" : "RMS2_rhel_networkmonitor.lcp"   },
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1409839975
}

/lce/{serverID}/client/{clientID}/authorize

Methods
POST

Authorizes the LCE Client associated with LCE {lceID} and client {clientID}, depending on access and permissions.

Request Parameters

None

Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "type" : "regular",
    "response" : {
        "clientIP" : "192.168.1.1",
        "clientType" : "wmimonitor",
        "version" : "v4.x.x.x",
        "id" : "1",
        "authorized" : "Yes",
        "sensorName" : "unknown",
        "osType" : "rhel",
        "osNumber" : "5",
        "serverIP" : "192.168.1.1",
        "serverPort" : "31300",
        "lastUpdated" : -1,
        "lifeState" : -1,
        "authState" : -1,
        "policyFile" : "default_rhel_wmimonitor.lcp"    },
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1409768302
}

/lce/{serverID}/client/{clientID}/revoke

Methods
POST

Revokes authorization for the LCE Client associated with LCE {serverID} and client {clientID}.

Request Parameters

None

Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "type" : "regular",
    "response" : {
        "clientIP" : "192.168.1.1",
        "clientType" : "wmimonitor",
        "version" : "v4.x.x.x",
        "id" : "1",
        "authorized" : "No",
        "sensorName" : "unknown",
        "osType" : "rhel",
        "osNumber" : "5",
        "serverIP" : "192.168.1.1",
        "serverPort" : "31300",
        "lastUpdated" : -1,
        "lifeState" : -1,
        "authState" : -1,
        "policyFile" : "default_rhel_wmimonitor.lcp"    },
    "error_code" : 0,
    "error_msg" : "",
    "warnings" : [],
    "timestamp" : 1409768331
}