AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node interacts with the AvantGuard DNSFilter API to retrieve a list of allowed URLs associated with a specific policy. It is useful for scenarios where you want to programmatically fetch and manage allowed URLs within a DNS filtering policy, such as auditing allowed sites, integrating with other security tools, or automating policy reviews.

For example, a security administrator could use this node to get all allowed URLs for a given policy ID and then analyze or export them for compliance reporting.

Properties

Name Meaning
Policy Id The unique identifier of the policy whose allowed URLs you want to retrieve.
Additional Query Parameters Optional filters and options to refine the query results:
- Ids: Filter allowed URLs by specific IDs (JSON array).
- Include Categories And Applications: Boolean flag to include related categories and applications.
- Search: Search string to filter URLs by value or note fields.
- Sort: Comma-separated attributes to sort by, valid values are type and value.
- Type: Filter by type of allowed URL, valid types are url or pattern.

Output

The node outputs JSON data representing the list of allowed URLs retrieved from the API. Each item typically includes details such as the URL or pattern, its ID, associated categories, applications (if included), and any notes or metadata provided by the API.

If binary data were involved, it would be summarized here, but this node only returns JSON data.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node uses the base URL https://api.dnsfilter.com.
  • No additional environment variables are required beyond the API authentication token.

Troubleshooting

  • Missing or invalid Policy Id: Ensure that the Policy Id property is set correctly and corresponds to an existing policy in your AvantGuard DNSFilter account.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions to access allowed URLs.
  • Empty results: If no allowed URLs are returned, check if the policy actually has allowed URLs configured or adjust the optional query parameters like search or filters.
  • Invalid query parameters: Make sure that optional parameters such as ids, sort, and type are formatted correctly according to their expected types.

Links and References

Discussion