Actions99
- InterACT Actions
- Notification Actions
- Organization Actions
- Task Actions
- Policy Actions
- Repository Actions
- Setting Actions
- Triage Rule Actions
- User Actions
- Acquisition Actions
- API Token Actions
- Asset Actions
- Auto Asset Tag Actions
- Baseline Actions
- Case Actions
- Evidence Actions
Overview
The node manages "Auto Asset Tags" within the Binalyze AIR platform. Specifically, for the Create Auto Asset Tag operation, it allows users to define a new auto asset tag by specifying a name and a query that determines the criteria for assets to be automatically tagged. This is useful in scenarios where you want to dynamically categorize or group endpoint assets based on specific attributes or conditions without manual tagging.
Practical examples include:
- Automatically tagging all assets that belong to a certain organization.
- Creating tags for assets that meet security compliance criteria defined by a query.
- Grouping assets based on software versions or configurations detected via queries.
Properties
| Name | Meaning |
|---|---|
| Tag Name | The name of the auto asset tag to create. |
| Query | The query string defining the criteria for which assets will be automatically tagged with this tag. |
| Additional Fields | Optional extra fields; currently supports: - Organization: Specifies the organization scope for the tag. Default 0 applies to all organizations. |
The Organization field can be specified in three ways:
- From a selectable list of organizations.
- By entering an organization ID (positive number or 0 for all).
- By entering an organization name.
Output
The node outputs JSON data representing the created auto asset tag object as returned by the Binalyze AIR API. This typically includes details such as the tag's unique identifier, name, query, associated organization, creation timestamps, and other metadata.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Binalyze AIR API using an API key credential configured in n8n.
- The node depends on the Binalyze AIR service being accessible and the API token having permissions to create auto asset tags.
- No additional external dependencies beyond the API access are required.
Troubleshooting
Common Issues:
- Invalid or malformed query strings may cause the API to reject the creation request.
- Specifying an invalid organization ID (non-numeric or negative) will fail validation.
- Insufficient API permissions can result in authorization errors.
- Network connectivity issues to the Binalyze AIR API endpoint.
Error Messages & Resolutions:
- "Unknown resource" — Occurs if the resource parameter is incorrect; ensure "autoassettags" is selected.
- Validation errors related to organization ID format — Ensure the ID is a positive integer or zero.
- Authentication errors — Verify the API key credential is valid and has necessary scopes.
- Query syntax errors — Review and correct the query string according to Binalyze AIR query language specifications.