AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation allows users to remove a domain from the blacklist of a specific policy in the AvantGuard DNSFilter service. It is useful for managing DNS filtering policies by dynamically updating which domains are blocked or allowed. For example, if a domain was mistakenly blacklisted or no longer poses a threat, this operation can be used to remove it from the blacklist, thereby restoring access to that domain.

Properties

Name Meaning
Id The unique identifier of the policy from which the domain will be removed from the blacklist.
Domain The domain name to be removed from the blacklist.
Note A note or comment explaining the reason for removing the domain from the blacklist.
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 blacklist. This typically includes details about the updated policy and confirmation of the removal action. If the node supports binary data output, it would represent any associated files or attachments returned by the API, but this operation primarily deals with JSON responses.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node uses the base URL https://api.dnsfilter.com for making requests.
  • The HTTP headers specify Accept: application/json and Content-Type: application/json.
  • No other external dependencies are indicated.

Troubleshooting

  • Common Issues:
    • Invalid or missing Policy ID may cause the API to reject the request.
    • Providing a domain that does not exist in the blacklist might result in an error or no changes.
    • Missing or invalid API authentication token will prevent successful API calls.
  • Error Messages:
    • Authentication errors usually indicate issues with the API key; verify credentials.
    • Validation errors may occur if required properties like Id, Domain, or Note are missing or malformed.
    • Network or connectivity errors should be checked by verifying internet access and API endpoint availability.

Links and References

Discussion