AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation allows users to add a domain to the blacklist of a specified policy in the AvantGuard DNSFilter system. It is useful for network administrators or security teams who want to block access to certain domains by enforcing policies that prevent DNS resolution for those domains. For example, if an organization wants to block access to malicious or unwanted websites, they can use this node to add those domains to the blacklist under a specific policy.

Properties

Name Meaning
Id The unique identifier of the policy to which the domain will be added to the blacklist.
Domain The domain name to be blacklisted under the specified policy.
Note A note or comment describing the reason or context for blacklisting the domain.
Additional Body Fields Optional additional fields to include in the request body. Currently supports:
- Include Relationships Boolean flag indicating whether to include relationships in the response (true/false, default true).

Output

The node outputs JSON data representing the updated policy with the newly added blacklisted domain. If the "Include Relationships" option is enabled, the output may also contain related entities or metadata associated with the policy. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node uses the base URL https://api.dnsfilter.com and expects JSON content-type headers.
  • No other external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Invalid or missing Policy ID: Ensure the policy ID provided exists and is correct.
    • Invalid domain format: The domain must be a valid domain string.
    • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
    • Network connectivity issues: Confirm that the n8n instance can reach the DNSFilter API endpoint.
  • Error messages:

    • Unauthorized or 401 errors typically indicate invalid or missing API credentials.
    • 404 errors may mean the specified policy ID does not exist.
    • Validation errors may occur if required fields like domain or note are missing or malformed.

Links and References

Discussion