AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node updates domain notes in a DNS filtering service. It allows users to modify the note associated with a specific domain, specifying whether the domain is allowed or blocked. This is useful for managing domain access policies dynamically, such as marking certain domains as safe (allow) or unsafe (block) and attaching contextual notes for auditing or informational purposes.

Practical examples:

  • Updating a domain's status to "block" with a note explaining why it was blocked.
  • Changing a previously allowed domain to blocked due to new security concerns.
  • Adding descriptive notes to domains for easier management and review.

Properties

Name Meaning
Domain The domain name to update notes for.
Id The unique resource ID of the domain note entry to update.
Type The type of note indicating if the domain is allowed or blocked. Options: allow, block.
Additional Body Fields Optional additional fields; currently supports adding a textual note describing the domain.

Output

The node outputs JSON data representing the updated domain note resource as returned by the API. This typically includes fields such as the domain, its ID, type (allow/block), and any notes attached. The output can be used downstream for logging, further processing, or confirmation of the update.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the DNS filtering service.
  • The node communicates with the DNS filtering service's REST API at https://api.dnsfilter.com.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing domain or ID values will cause the update to fail.
    • Incorrect API credentials or expired tokens will result in authentication errors.
    • Attempting to update a non-existent domain note ID may return a not found error.
  • Error messages and resolutions:

    • Authentication failed: Verify that the API key credential is correctly configured and valid.
    • Resource not found: Check that the provided ID corresponds to an existing domain note.
    • Validation errors: Ensure all required fields (domain, id, type) are provided and correctly formatted.

Links and References

Discussion