AvantGuard - ConnectSecure icon

AvantGuard - ConnectSecure

AvantGuard - ConnectSecure

Actions223

Overview

This node interacts with the AvantGuard ConnectSecure API to retrieve asset metadata (Msdt) from the "Asset Data" resource. It is designed to fetch detailed information about assets based on user identification and optional query parameters that refine the data retrieval.

Common scenarios include:

  • Fetching asset details for a specific user in an enterprise environment.
  • Querying asset records with conditions, pagination, or sorting to integrate asset data into workflows.
  • Automating asset inventory management by retrieving filtered asset lists.

Practical example:

  • A security operations workflow might use this node to get all assets assigned to a particular user, filtering by condition and ordering results to prioritize critical assets.

Properties

Name Meaning
X USER ID The User ID header value identifying the user whose asset data is being retrieved.
Additional Query Parameters Optional parameters to customize the query:
- Condition: Filter condition string.
- Skip: Number of records to skip (pagination).
- Limit: Maximum number of records to return.
- Order By: Field(s) to order the results by.

Output

The node outputs JSON data representing the retrieved asset metadata records matching the query criteria. Each item in the output corresponds to an asset's metadata as returned by the API.

If binary data were involved, it would be summarized here; however, this node focuses on JSON asset metadata only.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard ConnectSecure API.
  • Needs the base URL of the AvantGuard ConnectSecure service configured in the credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package for building request properties and handling API communication.

Troubleshooting

  • Missing or invalid X USER ID: The node requires a valid User ID header. Ensure this property is set correctly; otherwise, the API may reject the request.
  • API authentication errors: Verify that the API key credential is properly configured and has sufficient permissions.
  • Query parameter issues: Invalid values in additional query parameters (e.g., non-numeric skip/limit) can cause request failures.
  • Network or endpoint errors: Confirm the base URL is correct and the AvantGuard service is reachable.

Links and References

Discussion