- 04 Jun 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
AssetSonar - Update Asset
- Updated on 04 Jun 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
AssetSonar - Update Asset updates assets retrieved from the saved query supplied as a trigger (or devices that have been selected in the asset table).
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
- Add description - Add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
- Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
Use stored credentials from AssetSonar adapter - Select this option to use AssetSonar connected adapter credentials.
- When you select this option, the Select Adapter Connection drop-down is available, and you can choose which adapter connection to use for this Enforcement Action.
Note:To use this option, you must successfully configure a AssetSonar adapter connection.
Required Fields
These fields must be configured to run the Enforcement Set.
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
These fields are optional.
Connection Parameters
If Use stored credentials from the AssetSonar adapteris not enabled, these fields are required.
- Host Name or IP Address - The hostname or IP address of the AssetSonar server.
- API Key - The API key of the account used to access AssetSonar. This should be in the format of <COMPANY_TOKEN>. It is an Access token generated from the Asset Sonar Settings page.
Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
HTTPS Proxy User Name - The user name to use when connecting to the server using the HTTPS Proxy.
HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.
- Asset Name - The name of the asset to update.
- Group ID - The Group ID of the asset to update.
- Sub Group ID - The Sub Group ID of the asset to update.
- Purchased On - The date the asset was acquired.
- Location ID - The location of the asset to update.
- Image URL - The Image URL of the asset to update.
Map Axonius fields to adapter fields - Use the Field Mapping Wizard to map Axonius fields to fields in external systems. In this way you can transfer data found in Axonius into the external system as part of the configuration of relevant enforcement actions. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily.
Note:For details, see Axonius to External Field Mapping.
Gateway Name - Select the gateway through which to connect to perform the action.
APIs
Axonius uses the AssetSonar API
Ports
Axonius must be able to communicate with the value supplied in Host Name or IP Address via the following ports:
- TCP port 80/443
Version Matrix
This adapter was only tested with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed, which is not functioning as expected.
Version | Supported | Notes |
---|---|---|
AssetSonar v1 | Yes |
For more details about other Enforcement Actions available, see Action Library.