AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node interacts with the AvantGuard DNSFilter API to retrieve a list of policies. Specifically, the "Policies All" operation fetches all policies available to the user, optionally including global policies and filtering by organization or pagination parameters. This is useful for administrators who want to audit, review, or manage DNS filtering policies across their organization or globally.

Practical examples include:

  • Listing all DNS filtering policies applied within an organization.
  • Retrieving global policies that affect multiple organizations.
  • Paginating through large sets of policies to display or process them in batches.

Properties

Name Meaning
Additional Query Parameters Optional query parameters to customize the request:
- Include Global Policies: Whether to include global policies in the listing (true/false)
- Organization Id: Numeric ID of the organization to filter policies by
- Page: JSON object specifying page number and size for paginated results

Output

The node outputs JSON data representing the list of policies retrieved from the API. Each item in the output corresponds to a policy object as defined by the AvantGuard DNSFilter API schema. The exact structure depends on the API response but typically includes policy identifiers, names, scopes, and settings.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The base URL for API requests is https://api.dnsfilter.com.
  • The node uses standard HTTP headers for JSON content negotiation (Accept: application/json and Content-Type: application/json).

Troubleshooting

  • Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Invalid query parameters: Verify that additional query parameters such as organization_id and page are correctly formatted and valid.
  • API rate limits: If many requests are made in a short time, the API may throttle; implement retries or backoff strategies.
  • Empty responses: Confirm that the specified filters (e.g., organization ID) actually have associated policies.

Links and References

  • AvantGuard DNSFilter API documentation (refer to official AvantGuard resources for detailed API specs)
  • n8n documentation on creating and using API credentials

Discussion