AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter
Join our community

Actions277

Overview

This node updates an existing policy in the AvantGuard DNSFilter system. It allows users to modify various aspects of a policy such as domain whitelists and blacklists, category blacklists, and application allow/block lists. This is useful for administrators who want to dynamically adjust filtering policies to control network traffic or enforce security rules.

Practical examples include:

  • Adding new domains to a whitelist to allow access.
  • Blocking certain categories of websites by updating the blacklist categories.
  • Appending additional domains to existing allow/block lists without overwriting them.
  • Modifying application-level permissions within a policy.

Properties

Name Meaning
Id The unique identifier of the policy to update.
Policy JSON object containing the policy parameters to update, including:
- whitelist_domains
- blacklist_domains
- blacklist_categories
- allow_applications
- block_applications
Additional Body Fields Optional fields to customize the update request:
- Include Relationships (boolean): Whether to include related entities in the response; defaults to true.
- Append Domains (boolean): Whether to append domains to existing allow/block lists instead of replacing them; defaults to false.

Output

The node outputs the updated policy data in JSON format. This includes the full details of the policy after the update, potentially including related entities if requested via the "Include Relationships" option.

If the API supports binary data, it is not indicated here, so the output is purely JSON.

Dependencies

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

Troubleshooting

  • Invalid Policy ID: If the provided policy ID does not exist, the API will likely return an error indicating the resource was not found. Verify the ID before updating.
  • Malformed JSON in Policy: The policy property expects valid JSON. Invalid JSON syntax will cause parsing errors. Ensure the JSON structure is correct.
  • Permission Errors: Insufficient API credentials or permissions may result in authorization errors. Confirm that the API key has rights to update policies.
  • Appending Domains Misconfiguration: Setting "Append Domains" incorrectly might overwrite existing lists instead of appending. Double-check this flag based on your intended behavior.
  • Network Issues: Connectivity problems to the API endpoint can cause timeouts or failures. Check network settings and API availability.

Links and References

Discussion