AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node interacts with the AvantGuard DNSFilter API to retrieve a CSV file containing blocked URLs for a specified policy. It is useful in scenarios where users want to export or analyze the list of URLs that have been blocked by a particular DNS filtering policy. For example, security analysts can use this node to automate the extraction of blocked URL data for reporting or further investigation.

Properties

Name Meaning
Policy Id The unique identifier of the DNS filtering policy for which the blocked URLs CSV will be retrieved.
Additional Query Parameters Optional parameters to customize the request. Currently supports:
- Timezone: Localizes the filename based on the timezone string (e.g., America/New_York). Defaults to "UTC" if not provided.

Output

The node outputs JSON data representing the response from the API call. Specifically, it retrieves a CSV file listing the blocked URLs associated with the given policy ID. The CSV content is typically returned as a string or file content within the output's json field.

If the node supports binary data output (not explicitly shown in the code snippet), it would represent the CSV file content in binary form suitable for download or further processing.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The base URL for API requests is https://api.dnsfilter.com.
  • No additional environment variables are indicated.

Troubleshooting

  • Missing or invalid Policy Id: Ensure the Policy Id is correctly set and corresponds to an existing policy in the DNSFilter system.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Timezone parameter issues: If the timezone string is invalid or unsupported, the filename localization may default to UTC or cause unexpected results.
  • Network or API availability problems: Check network connectivity and API service status if requests fail.

Common error messages might include authentication failures, invalid query parameters, or resource not found errors. Resolving these typically involves verifying credentials, input values, and API endpoint accessibility.

Links and References

Discussion