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
{
	"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
{
	"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
{
	"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
{
	"sensorName" : <string> OPTIONAL,
	"policyFile" : <string> OPTIONAL
}
Example Response
Expand
{
	"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
{
	"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
{
	"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
}