Class Asset

The Asset class provides methods to store asset information representing enterprise assets. This asset information is used to provide additional metadata to aid in analysis of inbound events; the mapping service is used to "attach" asset information to these events. The class accepts a pre-defined set of asset attributes:

GUID {GUID} : Unique identifier for this asset (assigned by Sentinel)
IPv4* {String} : The IPv4 address of the asset, in dotted-quad notation; this is required
IPv6 {String} : The IPv6 address of the asset (eight groups of four hex digits, colon-separated)
Customer* {Customer} : The customer who owns this asset (defines a namespace)
Hostname {String} : The hostname of the asset as provided by a name service (DNS, WINS)
MAC {String} : The MAC address of the asset (hex pairs, colon separated)
Category^ {String} : The class of asset being described (server|desktop|laptop|etc)
Description {String} : A readable description of the asset
Value {String} : The value of the asset, in terms of currency
Criticality^ {String} : The criticality rating of the asset (low|med|high)
Vendor {String} : The vendor which provides this asset
Product {String} : The product name of this asset
Version {String} : The product version of this asset
Owner {Identity} : The owner of this asset
Maintainer {Identity} : The maintainer of this asset
BusinessUnit {String} : The business unit which holds this asset
Department^ {String} : The department which holds this asset
Location {String} : The location at which this asset is located; use internal codes or full address
Coordinates {Coordinates} : The latitude/longitude coordinates of the asset (not yet implemented)

* : This field is used as a key field for mapping metadata into the event ^ : This field is copied into the raw event structure for use in correlation. Other fields are available via lookup for reporting.
Defined in: asset.js.

Class Summary
Constructor Attributes	Constructor Name and Description
	Asset(properties) Constructs an instance of the Asset class which represents objects managed by Sentinel.

Method Summary
Method Attributes	Method Name and Description
	find() Finds the asset(s) in the Sentinel database.
	save() This method saves the Asset object in the Sentinel database.

Class Detail

Asset(properties)

Constructs an instance of the Asset class which represents objects managed by Sentinel.
Author: Novell Engineering.

var asset1 = new Asset();
asset.Description = "Main web server";
asset.IPv4 = "10.0.0.23";
var asset2 = new Asset({IPv4:"10.0.0.24",Vendor:"Novell"});
asset2.MAC = "0f:34:23:12:56:23";
asset.save();
asset2.save();

Parameters:
{Object} properties: Set of pre-defined properties used to initialize this object

Method Detail

{Asset[]} find()

Finds the asset(s) in the Sentinel database. NOT YET IMPLEMENTED.

Returns:: {Asset[]} Matching assets.

{Boolean} save()

This method saves the Asset object in the Sentinel database.

Example:

this.testasset = new Asset({"Hostname":"testname","IPv4":"10.0.0.12"});
this.testasset.save();

Returns:: {Boolean} Result Result of the attempted save.

Classes

Class Asset