AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node interacts with the AvantGuard DNSFilter API to retrieve a CSV export of allowed URLs associated with a specific policy. It is useful for network administrators or security teams who want to audit, review, or backup the list of URLs explicitly allowed by a given policy in their DNS filtering setup. For example, you might use this node to automate the extraction of allowed URL lists for compliance reporting or to synchronize allowed URLs across multiple environments.

Properties

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

Output

The node outputs JSON data representing the response from the API call that fetches the allowed URLs CSV file. The exact structure depends on the API response but typically includes metadata and the CSV content or a link to download it. If the node supports binary data output, it would represent the CSV file itself, allowing downstream nodes to process or save the CSV directly.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node uses the base URL https://api.dnsfilter.com to make requests.
  • No additional environment variables are indicated as necessary beyond the API authentication.

Troubleshooting

  • Common Issues:
    • Invalid or missing Policy Id: Ensure the Policy Id is correctly set and corresponds to an existing policy.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Timezone formatting: If specifying a timezone, ensure it matches recognized timezone strings (e.g., "America/New_York").
  • Error Messages:
    • Unauthorized or 401 errors indicate issues with API credentials.
    • 404 errors may mean the policy ID does not exist or is inaccessible.
    • Malformed query parameters can cause 400 Bad Request errors; double-check additional query parameters.

Links and References

Discussion