AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation allows users to remove a blacklist category from a specific policy in the AvantGuard DNSFilter system. It is useful for managing and updating security policies by dynamically adjusting which categories are blacklisted, thereby controlling access to certain types of content or domains. For example, if a policy currently blocks a category like "Social Media" but you want to allow it, this operation removes that category from the blacklist of the specified policy.

Properties

Name Meaning
Id The unique identifier of the policy from which the blacklist category will be removed.
Category Id The unique identifier of the blacklist category to be removed from the policy.
Additional Body Fields Optional additional fields to include in the request body. Currently supports:
- Include Relationships (boolean): Whether to include related entities in the response (true/false). Defaults to true.

Output

The output JSON contains the updated policy object after the blacklist category has been removed. If the "Include Relationships" option is enabled, related entities such as linked categories or other policy details may also be included in the response. The node does not output binary data.

Dependencies

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

Troubleshooting

  • Common Issues:

    • Invalid or missing Policy ID or Category ID can cause the API call to fail.
    • Insufficient permissions or invalid API key may result in authentication errors.
    • Network connectivity issues can prevent communication with the DNSFilter API.
  • Error Messages:

    • "Policy not found": Verify that the provided Policy ID exists.
    • "Category not found in policy": Ensure the Category ID is currently blacklisted in the specified policy.
    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly configured and valid.
  • Resolution Tips:

    • Double-check input IDs for correctness.
    • Confirm API key validity and permissions.
    • Test network connectivity to the API endpoint.

Links and References

Discussion