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 information about asset shares. Specifically, the "Retrieve Asset Shares" operation fetches a list of shared assets based on user-defined query parameters such as filtering conditions, pagination controls, and sorting preferences.
Typical use cases include:
- Fetching shared asset data for a specific user in an automated workflow.
- Integrating asset sharing information into reporting or monitoring dashboards.
- Filtering and retrieving subsets of asset shares based on custom conditions.
For example, a user might want to retrieve all asset shares where the asset type matches a certain category, skip the first 10 records, limit the results to 50, and order them by creation date.
Properties
| Name | Meaning |
|---|---|
| X USER ID | The User ID header value identifying the user making the request. |
| Condition | A query string to filter the asset shares based on specified conditions. |
| Skip | Number of records to skip (for pagination). |
| Limit | Maximum number of records to return. |
| Order By | Field(s) by which to order the returned asset shares. |
Output
The node outputs JSON data representing the retrieved asset shares. Each item in the output corresponds to an individual asset share record matching the query parameters.
If the API supports binary data related to asset shares (e.g., files or attachments), the node would handle it accordingly, but based on the provided code and properties, the output is primarily structured JSON data.
Dependencies
- Requires an API key credential for authenticating with the Connect Secure API.
- The node depends on the external Connect Secure service endpoint defined in its OpenAPI specification.
- No additional environment variables are explicitly required beyond the API authentication setup.
Troubleshooting
- Missing or invalid User ID: Since the
X USER IDheader is mandatory, omitting it or providing an incorrect value will likely cause authentication or authorization errors. - Invalid query condition syntax: If the
Conditionparameter contains malformed queries, the API may return errors or empty results. - Pagination issues: Setting
SkiporLimitto inappropriate values (e.g., negative numbers) could lead to unexpected behavior or errors. - Ordering errors: Providing invalid field names in
Order Bymay result in API errors or default ordering. - API connectivity problems: Network issues or incorrect API credentials will prevent successful data retrieval.
To resolve these issues:
- Ensure all required fields are correctly filled.
- Validate query strings against the API's expected format.
- Use sensible numeric values for pagination.
- Confirm API credentials and network access.
Links and References
- Connect Secure API Documentation (Replace with actual URL)
- n8n documentation on HTTP Request Node for understanding API interactions.
- General guidance on pagination and filtering in APIs