Tenable Security Center API: Asset

 

                                        

/asset

Methods
GET

Gets the list of Assets. The result is broken up into two lists ("usable" and "manageable").

Fields Parameter
Expand

The fields parameter should be specified along the query string, and it takes the syntax

    ?fields=<field>,...

Allowed Fields

*id
*uuid
**name
**description
type
ownerGroup

Session user not role "1" (Administrator)

**status
creator
owner
targetGroup
groups
template
typeFields

type
tags
context
createdTime
modifiedTime
repositories
ipCount
assetDataFields
viewableIPs (requesting this field for all assets may result in slow processing)

Session user role "1" (Administrator)

**organization
luminFields

Legend

* = always comes back

** = comes back if fields list not specified on GET all 

redFont =  field is a JSON object e.g. "repository" :{ "id" : <id>, "name" : <name> } )

Template Parameter

This parameter will filter assets based on templates IDs. The IDs must be provided in a comma-separated format:

	?template=<id1>,<id2>...
Filter Parameters

usable - The response will be an object containing an array of usable Assets. By default, both usable and manageable objects are returned.
manageable - The response will be an object containing all manageable Assets. By default, both usable and manageable objects are returned.
excludeAllDefined - If specified, the defined usable assets (currently id=0) will not be returned. This only applies to usable Assets.
excludeWatchlists - If specified, Assets of type 'watchlist' will be excluded from the usable and/or manageable array.

Request Query Parameters

None

Example Response
Administrator

Expand
{
	"type" : "regular",
	"response" : {
		"assets" : [
			{
				"id" : "1",
				"name" : "dnsnameTestPost",
				"description" : "",
				"type" : "dnsname",
				"status" : 0,
				"uuid" : "1908739A-A74D-4A46-B0D1-720828ECEE1F",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			},
			{
				"id" : "28",
				"name" : "Test 1",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "370CDC1B-6AA9-4897-844C-01C4CAF80220",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			},
			{
				"id" : "29",
				"name" : "Test 2",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "359C3A46-CE56-420C-8305-6498A72AA3F6",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			},
			{
				"id" : "30",
				"name" : "Test 3",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "27351CB0-1F71-492F-AF81-EB3329F417FC",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			},
			{
				"id" : "31",
				"name" : "10287 TEST",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "2E1B2E39-01F4-436E-834E-06B60B219B12",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			},
			{
				"id" : "32",
				"name" : "TEST",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "9F3E4BED-6ECB-472D-BC95-3C326CBFE4A0",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			},
			{
				"id" : "33",
				"name" : "test",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "09075E47-BE8A-4013-88E9-57D448FA33BC",
				"organization" : {
					"id" :	"1"
					"name" : "org1",
					"description" : "",
					"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
				},
			}
		]
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1412273607
}
Organization User

Expand
{
	"type" : "regular",
	"response" : {
		"usable" : [
			{
				"id" : "1",
				"name" : "dnsnameTestPost",
				"description" : "",
				"type" : "dnsname",
				"status" : 0,
				"uuid" : "1908739A-A74D-4A46-B0D1-720828ECEE1F",
			},
			{
				"id" : "28",
				"name" : "Test 1",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "370CDC1B-6AA9-4897-844C-01C4CAF80220",
			},
			{
				"id" : "29",
				"name" : "Test 2",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "359C3A46-CE56-420C-8305-6498A72AA3F6",
			},
			{
				"id" : "30",
				"name" : "Test 3",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "27351CB0-1F71-492F-AF81-EB3329F417FC",
			},
			{
				"id" : "31",
				"name" : "10287 TEST",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "2E1B2E39-01F4-436E-834E-06B60B219B12",
			},
			{
				"id" : "32",
				"name" : "TEST",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "9F3E4BED-6ECB-472D-BC95-3C326CBFE4A0",
			},
			{
				"id" : "33",
				"name" : "test",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "09075E47-BE8A-4013-88E9-57D448FA33BC",
			}
		],
		"manageable" : [
			{
				"id" : "1",
				"name" : "dnsnameTestPost",
				"description" : "",
				"type" : "dnsname",
				"status" : 0,
				"uuid" : "1908739A-A74D-4A46-B0D1-720828ECEE1F",
			},
			{
				"id" : "26",
				"name" : "Test",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "9E8E101B-D818-450F-8B8B-4F5C8F421D68"
			},
			{
				"id" : "27",
				"name" : "Test2",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "E71EC564-26B6-46E6-8E14-511BDD0A2FE4"
			},
			{
				"id" : "28",
				"name" : "Test 1",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "370CDC1B-6AA9-4897-844C-01C4CAF80220",
			},
			{
				"id" : "29",
				"name" : "Test 2",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "359C3A46-CE56-420C-8305-6498A72AA3F6",
			},
			{
				"id" : "30",
				"name" : "Test 3",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "27351CB0-1F71-492F-AF81-EB3329F417FC",
			},
			{
				"id" : "31",
				"name" : "10287 TEST",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "2E1B2E39-01F4-436E-834E-06B60B219B12",
			},
			{
				"id" : "32",
				"name" : "TEST",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "9F3E4BED-6ECB-472D-BC95-3C326CBFE4A0",
			},
			{
				"id" : "33",
				"name" : "test",
				"description" : "",
				"type" : "dynamic",
				"status" : 0,
				"uuid" : "09075E47-BE8A-4013-88E9-57D448FA33BC",
			}
		]
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1412273607
}

POST

Adds an Asset.

NOTE #1: If a template ID is provided:

  • The template associated with the provided ID will be retrieved and used as the default values for the Asset. These values can be overwritten.
  • The 'name' will be handled by the back-end, and would default to the template name. If that name already exists for an Asset with the creatorID of the session user, it would default the name to the name plus the next-lowest integer for that user i.e. "templateName(2)"

NOTE #2: The "prepare" parameter should be set to the string "false" if this Asset pertains to an ARC that will be subsequently created. ARC add will automatically "prepare" the files for this Asset, regardless.

NOTE #3: See Lumin for Lumin synchronization settings.

Request Parameters
Expand
{
	"type" : <string> "combination" | "dnsname" | "dnsnameupload" | "dynamic" | "ldapquery" | "static" | "staticeventfilter" | "staticvulnfilter" | "templates" | "upload" | "watchlist" | "watchlisteventfilter" | "watchlistupload",
	"prepare" : <string> "true" | "false" DEFAULT "true"
...
}
type not "uploadmultiple"
...
	"name" : <string>,
	"description" : <string> DEFAULT "",
	"context" : <string> DEFAULT "",
	"tags" : <string> DEFAULT "" (not "Any" | "None",
	"assetDataFields" : [
		{
			"fieldName" : <string> DEFAULT "" (if fieldValue not empty),
			"fieldValue" : <string> DEFAULT "" (if fieldName not empty)
		}...
	] OPTIONAL,
	"template" : {
		"id" : <number>
	} OPTIONAL,
...

type "uploadmultiple" | "dnsnameupload" | "upload" | "watchlistupload"

...
	"filename" : <string>
...

type "combination"

NOTE: The assets you reference in the operators cannot be of type "combination" | "watchlist"

...
	"combinations" : {
		"operator" : <string> "complement" | "difference" | "intersection" | "union",
		"operand1" : { 
			"id" : <number> (asset ID) OR "uuid" : <string> (asset UUID)
		} | <combinationRecord>,
		
		operator not "complement"
		-------------------------
		operand2 : { 
			"id" : <number> (asset ID) OR "uuid" : <string> (asset UUID)
		} | <combinationRecord>
	}
...

type "dynamic"

...
	"rules": {
		"operator" : <string> "all" | "any",
		"children" : [
			{
				"type" : <string> "clause" | "group",
 
				child type "clause"
				-------------------
				"operator" : <string> "contains" | "eq" | "lt" | "lte" | "ne" "gt" | "gte" | "regex" | "pcre",
				"filterName" : <string> "dns" | "exploitAvailable" | "exploitFrameworks" | "firstseen" | "hostUUID" | "mac" | "os" | "ip" | "uuid" | "lastseen" | "netbioshost" | "netbiosworkgroup" | "pluginid" | "plugintext" | "port" | "severity" | "sshv1" | "sshv2" | "tcpport" | "udpport" | "xref",
				"pluginIDConstraint" : <string> (integer or comma-separated range) DEFAULT -1 (NOT_SET),
 
				filterName "pluginid" | "severity"
				--------------------------------------
				"value" : { 
					"id" : <number> 
				},
 
				filterName not "pluginid" & not "severity"
				------------------------------------------
				"value" : <string>,
 
				child type "group"
				------------------
				(attributes of "rules", aggregate)
			}...
		]
	}
...

type "dnsname"

...
	"definedDNSNames" : <string>
...

type "ldapquery"

NOTE: Session user must have permission to create LDAP Assets

...
	"definedLDAPQuery" : {
		"searchString" : <string>,
		"searchBase" : <string>,
		"ldap" : {
			"id" : <string>
		}
	}
...

type "upload" | "watchlistupload" | "static"

...
	"definedIPs" : <string>
...

type "static" | "watchlist" | "upload" | "watchlistupload" | "staticeventfilter" | "staticvulnfilter" | "watchlisteventfilter" | "uploadmultiple"

...
	"excludeManagedIPs" : <string> "true" | "false" OPTIONAL
...

type "staticeventfilter" | "staticvulnfilter" | "watchlisteventfilter"

...
	"filters" = [
		{
			"filterName" : <string>,
			"value" : <string>,
			"operator" : <string>
		}
	]
...

type "staticeventfilter" | "watchlisteventfilter"

...
	"tool" : "sumip",
	"sourceType" : <string> "archive" | "lce",
	"startOffset" : <number> DEFAULT 0,
	"endOffset" : <number> DEFAULT 9223372036854775807 (PHP_INT_MAX),
	"view" : <string>,
	"lce" : {
		"id" : <number>

	}
...

type "staticvulnfilter"

...
	"tool" : <string> "iplist" | "listmailclients" | "listos" | "listsshservers" | "listservices" | "listsoftware" | "listwebclients" |  "listwebservers" (internally forced to tool "iplist" with appropriate Plugin ID filter),
	"sourceType" : "cumulative" | "individual" | "patched" DEFAULT "",
	"startOffset" : <number> OPTIONAL,
	"endOffset" : <number> OPTIONAL,
	"sortField" : <string> OPTIONAL (must accompany sortDir),
	"sortDir" : <string> "ASC" | "DESC" OPTIONAL (must accompany sortField)
...

type "staticvulnfilter", sourceType "individual"

...
	"view" : <string>,
	"scanID" : <number>
...
Example Response
Expand
{
	"type" : "regular",
	"response" : {
		"id" : "33",
		"name" : "test",
		"type" : "combination",
		"description" : "",
		"tags" : "",
		"context" : "",
		"status" : "0",
		"templateID" : "-1",
		"createdTime" : "1412171859",
		"modifiedTime" : "1412171859",
		"typeFields" : {
			"combinations" : {
				"operator" : "intersection",
				"operand1" : {
					"id" : "28",
					"name" : "Test 1",
					"description" : "",
					"uuid" : "370CDC1B-6AA9-4897-844C-01C4CAF80220"
				},
				"operand2" : {
					"id" : "29",
					"name" : "Test 2",
					"description" : "",
					"uuid" : "359C3A46-CE56-420C-8305-6498A72AA3F6"
				}
			}
		},
		"repositories" : [
			{
				"ipCount" : "-1",
				"repository" : {
					"id" : "37",
					"name" : "ag repo1",
					"description" : "",
					"type" : "Local",
					"uuid" : "488A8EE7-69F3-4E49-A53F-0B1DB6CF8209"
				}
			},
			{
				"ipCount" : "-1",
				"repository" : {
					"id" : "38",
					"name" : "jm ipv4",
					"description" : "",
					"type" : "Local",
					"uuid" : "D7CFE6CF-8A69-4859-B9D0-9C6F05D1672D"
				}
			},
			{
				"ipCount" : "-1",
				"repository" : {
					"id" : "39",
					"name" : "ipv6 rep",
					"description" : "",
					"type" : "Local",
					"uuid" : "7C187636-3180-4E56-8E59-688AC2A7E831"
				}
			}
		],
		"ipCount" : -1,
		"groups" : [],
		"assetDataFields" : [],
		"creator" : {
			"id" : "1",
			"username" : "head",
			"firstname" : "Security Manager",
			"lastname" : "",
			"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
		},
		"owner" : {
			"id" : "1",
			"username" : "head",
			"firstname" : "Security Manager",
			"lastname" : "",
			"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
		},
		"ownerGroup" : {
			"id" : "0",
			"name" : "Full Access",
			"description" : "Full Access group"
		},
		"targetGroup" : {
			"id" : -1,
			"name" : "",
			"description" : ""
		}
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1412273575
}

/asset/{id}

/asset/{uuid}

Methods
GET

Gets the Asset associated with {id} or {uuid}.

Fields Parameter
Expand

The fields parameter should be specified along the query string, and it takes the syntax

    ?fields=<field>,...

Allowed Fields

*id
*uuid
**name
**description
**status
type
ownerGroup
Session user not role "1" (Administrator)
creator
owner
ownerGroup
targetGroup
groups
template
typeFields
viewableIPs

tags
context
createdTime
modifiedTime
repositories
ipCount
assetDataFields
Session user role "1" (Administrator)

luminFields
organization

Legend

* = always comes back

** = comes back if fields list not specified on GET all 

redFont =  field is a JSON object e.g. "repository" :{ "id" : <id>, "name" : <name> } )

Request Query Parameters
Administrator
Expand

Parameters must be passed in as query string (as opposed to JSON) in the format of: /asset/{id}?orgID={orgID} or /asset/{uuid}?orgUUID={orgUUID}

{
    "orgID" : <number> OR "orgUUID" : <string>
}		
Organization User

None

Example Response
Administrator
Expand
{
	"type" : "regular",
	"response" : {
		"id" : "33",
		"name" : "test",
		"type" : "combination",
		"description" : "",
		"organization" : {
			"id" :	"1"
			"name" : "org1",
			"description" : "",
			"uuid" : "8FDC3F6C-9901-47B8-A720-ACF1681DE8F4"
		}
		"ownerGroup" : {
			"id" :	"1"
			"name" : "group1",
			"description" : "",
		}
		"luminFields" : {
            "firstSyncTime" : "1573594357",
            "lastSyncSuccess" : "1573594357",
            "lastSyncFailure" : "-1",
            "details" : "details for LuminFields",
            "enabled" : "true",
        }
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1412273575
}
Organization User
Expand
{
	"type" : "regular",
	"response" : {
		"id" : "33",
		"name" : "test",
		"type" : "combination",
		"description" : "",
		"tags" : "",
		"context" : "",
		"status" : "0",
		"templateID" : "-1",
		"createdTime" : "1412171859",
		"modifiedTime" : "1412171859",
		"typeFields" : {
			"combinations" : {
				"operator" : "intersection",
				"operand1" : {
					"id" : "28",
					"name" : "Test 1",
					"description" : "",
					"uuid" : "370CDC1B-6AA9-4897-844C-01C4CAF80220"
				},
				"operand2" : {
					"id" : "29",
					"name" : "Test 2",
					"description" : "",
					"uuid" : "359C3A46-CE56-420C-8305-6498A72AA3F6"
				}
			}
		},
		"repositories" : [
			{
				"ipCount" : "1",
				"repository" : {
					"id" : "37",
					"name" : "ag repo1",
					"description" : "",
					"type" : "Local",
					"uuid" : "488A8EE7-69F3-4E49-A53F-0B1DB6CF8209"
				}
			},
			{
				"ipCount" : "1",
				"repository" : {
					"id" : "38",
					"name" : "jm ipv4",
					"description" : "",
					"type" : "Local",
					"uuid" : "D7CFE6CF-8A69-4859-B9D0-9C6F05D1672D"
				}
			},
			{
				"ipCount" : "0",
				"repository" : {
					"id" : "39",
					"name" : "ipv6 rep",
					"description" : "",
					"type" : "Local",
					"uuid" : "7C187636-3180-4E56-8E59-688AC2A7E831"
				}
			}
		],
		"ipCount" : 0,
		"groups" : [],
		"assetDataFields" : [],
		"viewableIPs" : [
			{
				"repository" : {
					"id" : "37",
					"name" : "ag repo1",
					"description" : "",
					"type" : "Local",
					"uuid" : "488A8EE7-69F3-4E49-A53F-0B1DB6CF8209"
				},
				"ipList" : "192.168.1.1\n",
				"ipCount" : "1"
			},
			{
				"repository" : {
					"id" : "38",
					"name" : "jm ipv4",
					"description" : "",
					"type" : "Local",
					"uuid" : "D7CFE6CF-8A69-4859-B9D0-9C6F05D1672D"
				},
				"ipList" : "192.168.1.1\n",
				"ipCount" : "1"
			},
			{
				"repository" : {
					"id" : "39",
					"name" : "ipv6 rep",
					"description" : "",
					"type" : "Local",
					"uuid" : "7C187636-3180-4E56-8E59-688AC2A7E831"
				},
				"ipList" : "",
				"ipCount" : "0"
			}
		],
		"creator" : {
			"id" : "1",
			"username" : "head",
			"firstname" : "Security Manager",
			"lastname" : "",
			"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
		},
		"owner" : {
			"id" : "1",
			"username" : "head",
			"firstname" : "Security Manager",
			"lastname" : "",
			"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
		},
		"ownerGroup" : {
			"id" : "0",
			"name" : "Full Access",
			"description" : "Full Access group"
		},
		"targetGroup" : {
			"id" : -1,
			"name" : "",
			"description" : ""
		}
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1412273575
}



PATCH

Edits the Asset associated with {id} or {uuid}, changing only the passed in fields.

Request Parameters

(All fields are optional)

See /asset::POST for parameters.

Example Response
See /asset/{id}::GET and /asset/{uuid}::GET

DELETE

Deletes the Asset associated with {id} or {uuid}, depending on access and permissions.

Request Parameters

None

Example Response
Expand
{
	"type" : "regular",
	"response" : [
		{
			"id" : "1",
			"targetGID: : -1,
			"name" : "Name String"
		}
	],
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1401911117
}

/asset/import

POST

Imports an Asset specified by a previously uploaded, plain text XML file.

NOTE: The filename field should contain the value of the same parameter passed back on */file/upload::POST*.

Request Parameters
Expand
{
	"filename" : <string>,
	"name" : <string> OPTIONAL
}
Example Response
Expand
{
	"type" : "regular",
	"response" : [
		{
			"id" : "37",
			"name" : "LDAP query IMPORTED",
			"description" : "description",
			"type" : "ldapquery",
			"tags" : "",
			"context" : "",
			"status" : "0",
			"templateID" : "-1",
			"createdTime" : "1402582394",
			"modifiedTime" : "1402582394",
			"ownerGID" : "0",
			"targetGID" : "-1",
			"typeFields" : {
				"definedLDAPQuery" : {
					"searchBase" : "DC=target,DC=tenablesecurity,DC=com",
					"searchString" : "(objectclass=Computer)"
				}
			},
			"ipCount" : "",
			"groups" : [],
			"assetDataFields" : [],
			"canUse" : "true",
			"canManage" : "true",
			"creator" : {
				"id" : "1",
				"username" : "testorg",
				"firstname" : "first",
				"lastname" : "last",
				"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
			},
			"owner" : { 
				"id" : "1",
				"username" : "testorg",
				"firstname" : "first",
				"lastname" : "last",
				"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
			},
			"ownerGroup" : {
				"id" : "0",
				"name" : "Full Access",
				"description" : "Full Access group"
			},
			"targetGroup" : {
				"id" : -1,
				"name" : "",
				"description" : ""
			}
		}
	],
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1402582394
}

/asset/{uuid}/export

/asset/{id}/export

GET

Exports the Asset associated with {id} or {uuid} as plain text XML.

Request Parameters

None

Example Response
Expand
<?xml version="1.0" encoding="UTF-8"?>
<assets>
	<asset>
		<scVersion>5.0.0</scVersion>
		<name>Bad Credentials</name>
		<description>test</description>
		<type>dynamic</type>
		<templateID>35</templateID>
		<definition>YToyOntzOjU6InJ1bGVzIjthOjM6e3M6ODoib3BlcmF0b3IiO3M6MzoiYW55IjtzOjg6ImNoaWxkcmVuIjthOjI6e2k6MDthOjU6e3M6MTA6ImZpbHRlck5hbWUiO3M6ODoicGx1Z2luaWQiO3M6ODoib3BlcmF0b3IiO3M6MjoiZXEiO3M6NToidmFsdWUiO3M6NToiMjQ3ODYiO3M6MTg6InBsdWdpbklEQ29uc3RyYWludCI7czoyOiItMSI7czo0OiJ0eXBlIjtzOjY6ImNsYXVzZSI7fWk6MTthOjU6e3M6MTA6ImZpbHRlck5hbWUiO3M6ODoicGx1Z2luaWQiO3M6ODoib3BlcmF0b3IiO3M6MjoiZXEiO3M6NToidmFsdWUiO3M6NToiMjE3NDUiO3M6MTg6InBsdWdpbklEQ29uc3RyYWludCI7czoyOiItMSI7czo0OiJ0eXBlIjtzOjY6ImNsYXVzZSI7fX1zOjQ6InR5cGUiO3M6NToiZ3JvdXAiO31zOjE1OiJhc3NldERhdGFGaWVsZHMiO2E6MDp7fX0=</definition>
	</asset>
</assets>

/asset/{id}/refresh

/asset/{uuid}/refresh

POST

Starts an on-demand recalculation of the Asset files associated with {id} or {uuid}, minus any LDAP querying or Hostname resolution. This includes the Accessible Asset files of Asset {id} or {uuid} and any, affected Defining Assets files.

NOTE: This can only be called by Administrators.

Request Parameters
Expand
{
	"orgID" : <number> OR "orgUUID" : <string>,
	"repIDs" : [
		{
			"id" : <number>
		}...
	] OR "repUUIDs" : [
		{
			"uuid" : <string>
		}...
	]
}
Example Response
Expand
{
	"type" : "regular",
	"response" : {
		"orgID" : 26,
		"repIDs" : [
			{
				"id" : 110
			}
		],
		"id" : 20
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1402579901
}

/asset/testLDAPQuery

POST

Tests an LDAP query, depending on access and permissions.

Note: This endpoint is restricted to users of role 1 (Admin)

Request Parameters
Expand
{
	"definedLDAPQuery" : {
		"searchBase" : <string> (valid dn),
		"searchString" : <string> (valid search),
		"ldap" : {
			"id" : <string>
		}
	}
}
Example Response
Expand
{
	"type" : "regular",
	"response" : {
		"hostnames" : [ 
			"system1.target.domain.com",
			"system2.target.domain.com",
			"system3.target.domain.com"
		]
	}
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1402579901
}

/asset/{id}/share

/asset/{uuid}/share

Methods
POST

Shares the Asset associated with {id} or {uuid}, depending on access and permissions

Request Parameters
Expand
{
	"groups" : [
		{
			"id" : <number>
		}...
	]
}
Example Response
Expand
{
	"type" : "regular",
	"response" : {
		"id" : "1",
		"name" : "dnsnameTestPost",
		"type" : "dnsname",
		"description" : "",
		"tags" : "",
		"context" : "",
		"status" : "0",
		"templateID" : "1",
		"createdTime" : "1407773915",
		"modifiedTime" : "1407773915",
		"ownerGID" : "0",
		"targetGID" : "-1",
		"definedDNSNames" : "1",
		"repositories" : "",
		"assetDataFields" : [],
		"canUse" : "true",
		"canManage" : "true",
		"creator" : {
			"id" : "1",
			"username" : "head",
			"firstname" : "Security Manager",
			"lastname" : "",
			"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
		},
		"owner" : {
			"id" : "1",
			"username" : "head",
			"firstname" : "Security Manager",
			"lastname" : "",
			"uuid" : "48F26F3B-6A79-4153-96DB-4C63D1BF3D46"
		},
		"ownerGroup" : {
			"id" : "0",
			"name" : "Full Access",
			"description" : "Full Access group"
		},
		"targetGroup" : {
			"id" : -1,
			"name" : "",
			"description" : ""
		}
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1409086057
}

/asset/tag

Methods
GET

Gets the full list of unique Asset tags

Request Parameters

none

Example Response
Expand
{
	"type" : "regular",
	"response" : [
		"Tag1",
		"Tag2",
		"Tag3"
	],
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1461093219
}