AvantGuard - DNSFilterInstall

Overview

This node operation, Traffic Reports Total Threats Organizations, retrieves aggregated traffic threat data grouped by organizations. It is designed to provide insights into the total number of threats detected across multiple organizations within a specified time range and filtered by various criteria such as agent types, network IDs, application IDs, and more.

Typical use cases include:

• Security teams monitoring threat activity across their managed organizations.
• Network administrators analyzing threat trends over time.
• Automated reporting systems generating summaries of blocked or allowed traffic threats.

For example, a user could configure this node to fetch all blocked threats from specific networks during the last 7 days, grouped by organization, to identify which organizations are most affected.

Properties

Output

The node outputs JSON data containing the aggregated threat report grouped by organizations according to the applied filters. The structure typically includes:

• Organization identifiers.
• Counts or totals of threats detected.
• Breakdown by threat type or status (allowed, blocked).
• Time-bucketed data if bucket size is specified.

If binary data output is supported, it would represent downloadable reports or raw data files, but this is not indicated in the provided code or properties.

Dependencies

• Requires an API key credential for authenticating requests to the external traffic reporting service.
• The node uses a base URL endpoint https://api.dnsfilter.com (inferred from bundled code context) to fetch data.
• Proper configuration of the API authentication token in n8n credentials is necessary.

Troubleshooting

• Invalid Date Format: If the "From" or "To" date strings are not in the expected ISO format, the API may reject the request or default to fallback dates. Ensure correct formatting.
• Empty Results: Applying overly restrictive filters (e.g., very specific agent IDs or network IDs) might return no data. Try broadening filters.
• Authentication Errors: Missing or invalid API keys will cause authorization failures. Verify that the API key credential is correctly set up.
• API Rate Limits: Frequent or large queries may hit rate limits imposed by the external service. Implement retry logic or reduce query frequency.
• Boolean Parameter Issues: The "Show Individual Organizations" parameter defaults to true; setting it incorrectly might affect grouping behavior.

Links and References

• No direct links were found in the provided source code.
• For further details, consult the official documentation of the traffic reporting API used by the node (likely DNSFilter or AvantGuard services).