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 "Reports" resource of an API, specifically performing the "Report Settings" operation. It is designed to retrieve or manipulate settings related to reports based on user identification and report type parameters. This node is useful in scenarios where users need to programmatically access or configure report settings, such as automating report generation preferences or managing report visibility (global or user-specific).
Practical examples include:
- Fetching configuration details for a specific report type for a given user.
- Setting whether a report should be global or restricted to a particular user context.
Properties
| Name | Meaning |
|---|---|
| X USER ID | The unique identifier of the user making the request. Used for authentication or scoping. |
| Reporttype | The type of report to query or configure. |
| Is Global | Boolean flag indicating if the report is global (true) or user-specific (false). |
Output
The node outputs JSON data representing the response from the "Report Settings" API endpoint. This typically includes the settings or configuration details of the specified report type for the given user context. The exact structure depends on the API response but generally contains report metadata and configuration flags.
No binary data output is indicated by the source code.
Dependencies
- Requires an API key credential for authenticating with the Connect Secure API.
- Depends on the external Connect Secure API service.
- The node uses an OpenAPI specification internally to build its properties and operations.
- Proper configuration of the API credentials within n8n is necessary for successful execution.
Troubleshooting
- Missing or invalid X USER ID: The node requires a valid user ID header; ensure this is provided and correctly formatted.
- Incorrect reporttype value: Using an unsupported or misspelled report type may cause errors or empty responses.
- Authentication failures: Ensure that the API key credential is correctly set up and has sufficient permissions.
- Network or API errors: Check connectivity and API availability; transient issues might require retries.
- Boolean property misconfiguration: The "Is Global" property must be a boolean; passing other types may cause unexpected behavior.
Common error messages will likely relate to authentication failures, missing required parameters, or invalid query values. Resolving these involves verifying input parameters and credential configurations.
Links and References
- Connect Secure API Documentation (Replace with actual URL)
- n8n Documentation on Creating Nodes
- OpenAPI Specification