AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation allows you to remove a domain from the whitelist of a specific policy in the AvantGuard DNSFilter service. It is useful for managing network security policies by dynamically updating which domains are allowed or blocked. For example, if a previously trusted domain should no longer be accessible under a certain policy, this operation can remove it from that policy's whitelist.

Properties

Name Meaning
Id The unique identifier of the policy from which the domain will be removed.
Domain The domain name to be removed from the whitelist of the specified policy.
Note A note or comment explaining the reason for removing the domain from the whitelist.
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 output JSON contains the response from the API after attempting to remove the domain from the whitelist. This typically includes details about the updated policy and confirmation of the removal. If the "Include Relationships" option is enabled, related entities may also be included in the response.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node uses the base URL https://api.dnsfilter.com for API requests.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing Policy ID: Ensure the policy ID provided exists and is correct.
    • Domain not found in whitelist: Attempting to remove a domain that is not whitelisted may result in an error or no change.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network connectivity issues: Confirm that the n8n instance can reach the DNSFilter API endpoint.
  • Error Messages:

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

Resolving these usually involves verifying input parameters, checking API credentials, and ensuring network access.

Links and References

  • AvantGuard DNSFilter API documentation (refer to official AvantGuard resources)
  • n8n documentation on creating and using API credentials
  • General best practices for managing DNS filtering policies

Discussion