Actions277
- User Agents Actions
- Url Filters Actions
- Users Actions
- Traffic Reports Actions
- Traffic Reports Qps Active Agents
- Traffic Reports Qps Active Users
- Traffic Reports Qps Active Collections
- Traffic Reports Top Domains
- Traffic Reports Top Categories
- Traffic Reports Top Application Categories
- Traffic Reports Top Organizations
- Traffic Reports Top Networks
- Traffic Reports Top Agents
- Traffic Reports Top Users
- Traffic Reports Top Collections
- Traffic Reports Query Logs
- Traffic Reports Total Organizations Stats
- Traffic Reports Total Domain Stats
- Traffic Reports Total Category Stats
- Traffic Reports Total Organizations Requests
- Traffic Reports Total Domain Requests
- Traffic Reports Top Organizations Requests
- Traffic Reports Total Client Stats
- Traffic Reports Total Deployments
- Traffic Reports Total Roaming Clients
- Traffic Reports Total Applications Stats
- Traffic Reports Total Applications Organizations Stats
- Traffic Reports Total Applications Networks Stats
- Traffic Reports Total Applications Agents Stats
- Traffic Reports Total Applications Users Stats
- Traffic Reports Total Applications Collections Stats
- Traffic Reports Total Requests
- Traffic Reports Total Requests Geo
- Traffic Reports Total Requests Organizations
- Traffic Reports Total Requests Agents
- Traffic Reports Total Requests Users
- Traffic Reports Total Requests Collections
- Traffic Reports Total Threats
- Traffic Reports Total Threats Organizations
- Traffic Reports Total Threats Agents
- Traffic Reports Total Threats Users
- Traffic Reports Total Threats Collections
- Traffic Reports Total Categories
- Traffic Reports Total Categories Organizations
- Traffic Reports Total Categories Agents
- Traffic Reports Total Categories Users
- Traffic Reports Total Categories Collections
- Traffic Reports Total Domains
- Traffic Reports Total Domains Organizations
- Traffic Reports Total Domains Users
- Traffic Reports Total Domains Collections
- Traffic Reports Total Collections
- Traffic Reports Total Collections Organizations
- Traffic Reports Total Collections Agents
- Traffic Reports Total Collections Users
- Traffic Reports Qps
- Traffic Reports Qps Active Organizations
- Trials Actions
- User Agent Bulk Deletes Actions
- User Agent Bulk Updates Actions
- User Agent Cleanups Actions
- User Agent Csv Exports Actions
- Policies Actions
- Policies Add Blacklist Category
- Policies Remove Blacklist Category
- Policies Add Allowed Application
- Policies Remove Allowed Application
- Policies Add Blocked Application
- Policies Remove Blocked Application
- Policies Get Permissive Mode
- Policies Index
- Policies Create
- Policies All
- Policies Show
- Policies Update
- Policies Destroy
- Policies Application
- Policies Application Update
- Policies Add Blacklist Domain
- Policies Remove Blacklist Domain
- Policies Add Whitelist Domain
- Policies Remove Whitelist Domain
- Policies Bulk Actions Actions
- Policy Ips Actions
- Scheduled Policies Actions
- Scheduled Report Previews Actions
- Scheduled Reports Actions
- Networks Actions
- Networks Lookup
- Networks Show
- Networks Update
- Networks Destroy
- Networks Bulk Create
- Networks Bulk Create Status
- Networks Index
- Networks Create
- Networks All
- Networks Msp
- Networks Msp All
- Networks Bulk Update
- Networks Bulk Update Status
- Networks Bulk Destroy
- Networks Bulk Destroy Status
- Networks Generate Secret Key
- Networks Revoke Secret Key
- Networks Rotate Secret Key
- Mac Addresses Actions
- Metrics Actions
- Network Lan Ips Actions
- Network Subnets Actions
- Organizations Actions
- Organization Users Actions
- Distributors Actions
- Distributors Msps Cancel
- Distributors Msps Reactivate
- Distributors Organizations Index
- Distributors Organizations Create
- Distributors Organizations Show
- Distributors Organizations Update
- Distributors Organizations Cancel
- Distributors Organizations Reactivate
- Distributors Organizations Add Sku
- Distributors Organizations Remove Sku
- Distributors Users Index
- Distributors Users Create
- Distributors Users Show
- Distributors Users Add Membership
- Distributors Users Update Membership
- Distributors Users Remove Membership
- Distributors Users Send Reset Password Email
- Distributors Users Reset Password Url
- Distributors Reports Usage By Organization
- Distributors Reports Usage By Sku
- Distributors Reports Covered Users Summary By Organization
- Distributors Distributors Update
- Distributors Msps Index
- Distributors Msps Create
- Distributors Msps Show
- Distributors Msps Update
- Domain Notes Actions
- Domains Actions
- Enterprise Connections Actions
- Invoices Actions
- IP Addresses Actions
- Allowed Urls Actions
- Api Key Actions
- Application Categories Actions
- Applications Actions
- Authentication Actions
- Authentication Sync Tool Actions
- Billings Actions
- Blocked Urls Actions
- Block Pages Actions
- Categories Actions
- Collection Users Actions
- Agent Local User Actions
- Agent Local User Bulk Deletes Actions
Overview
This node operation creates a CSV export of user agent data filtered by various criteria. It is useful for generating reports or backups of user agent information from a network or organization, especially when you want to analyze or archive user agent details in a structured CSV format.
Typical use cases include:
- Exporting user agent lists filtered by type (proxy or agents).
- Filtering user agents by network IDs, tags, status, or online/offline state.
- Searching user agents by hostname or friendly name.
- Exporting only those agents that have received traffic recently.
For example, a network administrator might use this node to export all active proxy user agents within certain networks that have been online and received traffic in the last 15 minutes.
Properties
| Name | Meaning |
|---|---|
| Additional Body Fields | Optional additional fields to customize the export request body. Includes: |
| - User Agent Csv Export | JSON object specifying attributes like organization IDs and specific user agent IDs to include in the export. |
| - Network Ids | JSON array of network IDs to filter user agents by; defaults to all networks if empty. |
| - Type | User agent type to export. Options: proxy (default) or agents. |
| - Search | String keywords (space delimited) to search user agents by hostname or friendly name. |
| - Name Search | A string term specifically to search client name fields such as hostname and friendly name. |
| - Tags | JSON array of tags to filter user agents by. |
| - Status | Filter user agents by status. Valid values include active, disabled, and uninstalled. |
| - State | Filter user agents by online/offline state. Options: online (default), offline. |
| - Agent State | Filter by agent state. Options: protected (default), unprotected, bypassed, uninstalled. |
| - Traffic Received Last 15 Mins | Boolean flag to filter agents that have received traffic in the last 15 minutes. Defaults to true. |
Output
The node outputs JSON data representing the result of the CSV export creation request. The exact structure depends on the API response but typically includes metadata about the export job or a link to download the generated CSV file.
If binary data output is supported, it would represent the actual CSV file content, but based on the provided code and properties, the output is primarily JSON describing the export operation.
Dependencies
- Requires an API key credential for authentication with the external service managing user agent data.
- The node uses a REST API endpoint at
https://api.dnsfilter.com(implied by bundled source) to perform the export operation. - Proper configuration of the API key credential in n8n is necessary for successful requests.
Troubleshooting
- Invalid JSON in Additional Body Fields: Since some properties expect JSON input, malformed JSON will cause errors. Ensure JSON fields are correctly formatted.
- Empty or Incorrect Filters: Providing filters that do not match any user agents may result in empty exports. Verify filter values such as network IDs, tags, and statuses.
- Authentication Errors: Missing or invalid API credentials will cause authorization failures. Confirm the API key is set up correctly.
- API Rate Limits or Downtime: If the external API is rate-limited or down, requests may fail. Check API status and retry later.
- Incorrect Property Types: For example, setting boolean fields as strings may cause unexpected behavior. Use correct types as specified.
Links and References
- DNSFilter API Documentation (assumed based on base URL)
- n8n Documentation on Creating Custom Nodes
- JSON formatting tools for validating input JSON fields