Actions222
- Application Baseline Actions
- Attack Surface Actions
- Backup Software Actions
- EDR Actions
- Tags Actions
- PII Actions
- External Scan Actions
- Settings Actions
- Compliance Assessment Actions
- Reports Actions
- Compliance Actions
- Jobs Actions
- Active Directory Actions
- Retrieve Ad Roles
- Retrieve Ad User Licenses
- Retrieve Azure Licenses
- Retrieve Azure Ad Logs
- Retrieve Azure Secure Score
- Retrieve Ad Password Policies
- Retrieve Ad Groups View
- Retrieve Ad Ous View
- Retrieve Ad Gpos View
- Retrieve Ad Computers View
- Retrieve Ad Users View
- Retrieve Ad Domain Details
- Retrieve Ad Gpos Details
- Retrieve Get Ous Details
- Retrieve Get Groups Details
- Retrieve Ad Group Users
- Retrieve Ad Group Computers
- Retrieve Get User Details
- Retrieve Get Computer Details
- Retrieve Ad Roles Details
- Retrieve Ad Roles Member
- Retrieve Ad Basic Info
- Audit Log Actions
- Ad Audit Actions
- Asset Data Actions
- Retrieve Bios Info
- Retrieve Bio Info
- Retrieve Browser Extensions
- Retrieve Browser Extension
- Retrieve Ciphers View
- Retrieve Cipher View
- Retrieve Windows Protection Status
- Retrieve Window Protection Status
- Retrieve Asset Compliance Report Card
- Retrieve Asset Firewall Policy
- Retrieve Asset Installed Drivers
- Retrieve Asset Installed Driver
- Retrieve Asset Interface
- Retrieve Asset Msdt
- Retrieve Asset Ports
- Retrieve Asset Port
- Retrieve Asset Security Report Data
- Retrieve Asset Security Report Datum
- Retrieve Asset Shares
- Retrieve Asset Share
- Retrieve Asset Storages
- Retrieve Asset Storage
- Retrieve Asset Unqouted Services
- Retrieve Asset Unqouted Service
- Retrieve Asset User Shares
- Retrieve Asset User Share
- Retrieve Asset Video Info
- Retrieve Asset Windows Reboot Required
- Retrieve Asset Window Reboot Required
- Vulnerabilities Actions
- Firewall Actions
- Integration Actions
- Retrieve Integration Credentials
- Retrieve Integration Credential
- Create Integration Credential
- Update Integration Credential
- Delete Integration Credential
- Retrieve Integration Rules
- Retrieve Integration Rule
- Create Integration Rule
- Update Integration Rule
- Delete Integration Rule
- Retrieve Company Mappings
- Retrieve Company Mapping
- Create Company Mapping
- Update Company Mapping
- Delete Company Mapping
- Event Set Actions
- Ticket Template Actions
- Scheduler Actions
- Credentials Actions
- Asset Actions
- Retrieve Records
- Retrieve Assets
- Retrieve Asset
- Create Asset
- Update Asset
- Delete Asset
- Retrieve Asset Stats
- Retrieve Asset Stat
- Retrieve Asset View
- Retrieve Cron Jobs
- Retrieve Kernel Modules
- Retrieve Suid Permissions
- Retrieve Ufw Firewall Rules
- Retrieve Selinux Settings
- Retrieve Asset Iptables Rules
- Retrieve Asset Users
- Retrieve Asset Processes Running
- Retrieve Asset Services
- Retrieve Asset Patches Info
- Retrieve Asset Firewall Rules
- Retrieve Asset Registry Misconfiguration
- Retrieve Asset Open Ports
- Retrieve Notification Tickets View
- Retrieve System Events View
- Discovery Settings Actions
- Retrieve Discovery Settings
- Retrieve Discovery Setting
- Create Discovery Setting
- Update Discovery Setting
- Delete Discovery Setting
- Retrieve Agent Discoverysettings Mapping
- Retrieve Agent Discoverysetting Mapping
- Create Agent Discoverysetting Mapping
- Update Agent Discoverysetting Mapping
- Delete Agent Discoverysetting Mapping
- Auth Actions
- Company Actions
- Agent Actions
Overview
This node interacts with the Connect Secure API to retrieve Endpoint Detection and Response (EDR) data. It is designed to query EDR records based on user-defined conditions, pagination controls, and sorting preferences. This node is useful in cybersecurity workflows where automated retrieval of security event logs or endpoint activity data is required for analysis, alerting, or further processing.
Practical examples include:
- Fetching recent EDR events matching specific threat indicators.
- Paginating through large sets of EDR records for batch processing.
- Sorting EDR data by timestamp or severity to prioritize incident response.
Properties
| Name | Meaning |
|---|---|
| X USER ID | User identifier header required for authentication or scoping the request. |
| Condition | Query condition string to filter EDR records (e.g., specific attributes or criteria). |
| Skip | Number of records to skip for pagination purposes. |
| Limit | Maximum number of records to return in the response. |
| Order By | Field(s) to order the returned EDR records by (e.g., timestamp, severity). |
Output
The node outputs JSON data representing the retrieved EDR records from the Connect Secure API. Each item in the output corresponds to an individual EDR record matching the query parameters. The structure typically includes fields relevant to endpoint detection events such as timestamps, event types, user IDs, and other metadata.
No binary data output is indicated by the source code or properties.
Dependencies
- Requires a valid API key credential for authenticating with the Connect Secure API.
- Depends on the external Connect Secure service being accessible.
- Uses the
@devlikeapro/n8n-openapi-nodepackage for OpenAPI-based operation parsing and request handling. - Requires proper configuration of the API credentials within n8n.
Troubleshooting
Common issues:
- Missing or invalid "X USER ID" header may cause authentication or authorization failures.
- Incorrect query conditions can result in empty responses or errors from the API.
- Pagination parameters (
skip,limit) set improperly might lead to unexpected subsets of data. - Network connectivity problems or incorrect API credentials will prevent successful data retrieval.
Error messages:
- Authentication errors typically indicate missing or invalid API keys or user IDs.
- Validation errors may arise if query parameters are malformed or unsupported by the API.
- Timeout or connection errors suggest network issues or API service unavailability.
To resolve these, verify that all required input properties are correctly set, ensure API credentials are valid, and confirm network access to the Connect Secure API endpoint.
Links and References
- Connect Secure API Documentation (replace with actual URL)
- n8n OpenAPI Node Integration Guide