AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node interacts with the AvantGuard DNSFilter API to count blocked URLs associated with a specific policy. It is useful for security and network administrators who want to monitor or report on the number of URLs, domains, or patterns that have been blocked under a given policy. For example, it can be used to generate statistics on how many URLs are currently blocked by a particular policy, filtered optionally by type or search terms.

Properties

Name Meaning
Policy Id The unique identifier of the policy whose blocked URLs/domains you want to count.
Additional Query Parameters Optional filters to refine the count query:
- Search: Text to search within blocked URL values or notes.
- Type: Filter by type of block (valid options: url, pattern, domain, tld).
Additional Body Fields Optional JSON fields to further specify the count request:
- Ids: Specific IDs of URL filters to count, overrides other filters.
- Exclude Ids: IDs of URL filters to exclude when using filters.

Output

The node outputs a JSON object containing the count of blocked URLs matching the specified criteria. The exact structure depends on the API response but typically includes a numeric count field indicating how many blocked URLs meet the query parameters.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node sends HTTP requests to https://api.dnsfilter.com.
  • Proper configuration of the API key credential in n8n is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or missing Policy Id will cause the API to reject the request.
    • Incorrect API credentials or expired tokens will result in authentication errors.
    • Malformed JSON in "Ids" or "Exclude Ids" fields may cause parsing errors.
    • Using unsupported filter types in the "Type" parameter may lead to empty results or errors.
  • Error messages:

    • Authentication errors: Check that the API key credential is correctly set up and valid.
    • Validation errors: Ensure required fields like Policy Id are provided and correctly formatted.
    • JSON parse errors: Verify that JSON inputs for IDs are valid JSON arrays.

Links and References

Discussion