quaxar-asm-asset

Get the detail of a single exposed asset by asset ID from the S2W Quaxar ASM service.

Syntax

quaxar-asm-asset id=STRING [profile=STRING] [orgs=STRING] [pretty=BOOL]

Options

id=STRING: Required. Asset unique ID to look up. Use the asset_id output value of quaxar-asm-assets.
profile=STRING: Optional. QUAXAR connect profile code. If omitted, an available profile is used automatically.
orgs=STRING: Optional. Comma-separated customer organization names.
pretty=BOOL: Optional. Set t to enable pretty print with line breaks (default: f).

Output fields

Field	Type	Name	Description
profile	string	Connect profile	Profile name of QUAXAR
asset_id	string	Asset ID	Asset unique ID
asset_type	string	Asset type	DOMAIN or IP
value	string	Value	Asset name
detected	date	Detected	Asset detection time
last_scanned	date	Last scanned	Asset last scanned time
severity	string	Severity	EXTREME, MAJOR, MODERATE or MINOR
severity_descriptions	string	Severity descriptions	Newline-separated severity descriptions
seed_values	string	Seed values	Newline-separated matched seeds
ips	string	IPs	Newline-separated IP addresses
cloud_provider	string	Cloud provider	Cloud provider name
host_names	string	Host names	Newline-separated host names
asn	string	ASN	AS number
isp	string	ISP	AS operator
country	string	Country	Country of IP
city	string	City	City of IP
certificates	string	Certificates	Certificate list (JSON)
ports	string	Ports	Port list (JSON, screenshot stripped)
notes	string	Notes	Note list (JSON)

Error codes

Parsing errors

Error message	Cause	Resolution
Specify id option please.	Missing or empty id option	Specify the target asset_id in id
Specify valid Quaxar profile.	Invalid profile in the profile option	Specify a valid Quaxar connect profile code
No available Quaxar profile found.	No Quaxar connect profile registered	Register a Quaxar connect profile first

Runtime errors

Error message	Cause	Resolution
quaxar asm api error: status=..., message=...	ASM API returned an error state	Check id validity, profile permission and service

Description

quaxar-asm-asset is a source command that looks up the detail of a single asset ID. Nested fields such as certificates, ports, and notes are returned as JSON strings, and the ports field is returned with the large screenshot data stripped out. Set pretty=t to print the JSON as indented multiple lines for readability.

The asset ID comes from the asset_id output value of the quaxar-asm-assets command.

Examples

Example: Inspect the detail of a selected asset

Situation: You want to look up the certificate, port, and note detail of a specific asset found via quaxar-asm-assets.

quaxar-asm-asset id=a1b2c3d4e5 pretty=t

Expected result:

asset_id	value	severity	ips	ports
a1b2c3d4e5	example.com	EXTREME	192.0.2.1	[ { ... } ]

Interpretation: The detail fields of a single asset are returned as one row. Parse the JSON values of certificates, ports, and notes for further analysis.