Connect Secure

Consume Connect Secure API

Actions222

Application Baseline Actions
- Create Application Baseline Rule
- Update Application Baseline Rule
- Delete Application Baseline Rule
- Retrieve App Baseline Plan Assets
- Retrieve App Baseline Plan Asset
- Retrieve App Baseline Plan Company
- Retrieve App Baseline Plan Global
- Retrieve Application Baseline Rules
- Retrieve Application Baseline Rule
Attack Surface Actions
- Retrieve Attack Surface Domain
- Create Attack Surface Domain
- Update Attack Surface Domain
- Delete Attack Surface Domain
- Retrieve Attack Surface Results
- Retrieve Attack Surface Result
Backup Software Actions
- Retrieve Backup Software
- Create Backup Software
- Update Backup Software
- Delete Backup Software
EDR Actions
- Retrieve Edr
- Create Edr
- Update Edr
- Delete Edr
Tags Actions
- Retrieve Tag Rules
- Retrieve Tag Rule
- Create Tag Rule
- Update Tag Rule
- Delete Tag Rule
- Retrieve Tags
- Retrieve Tag
- Create Tag
- Update Tag
- Delete Tag
PII Actions
- Retrieve Pii Scan Settings
- Retrieve Pii Scan Setting
- Create Pii Scan Setting
- Update Pii Scan Setting
- Delete Pii Scan Setting
External Scan Actions
- Retrieve Custom Profile
- Create Custom Profile
- Update Custom Profile
- Delete Custom Profile
- Scan External Endpoint
Settings Actions
- Retrieve Custom Domains
- Retrieve Custom Domain
- Custom Domain
Compliance Assessment Actions
- Retrieve Compliance Assessment
- Create Compliance Assessment
- Update Compliance Assessment
- Delete Compliance Assessment
Reports Actions
- Retrieve Report Jobs View
- Retrieve Report Job View
- Download Report
- List Standard Report
- Create Report
- Report Settings
Compliance Actions
- Retrieve Compliance Types
- Retrieve Records
Jobs Actions
- Retrieve Job Details View
- Retrieve Job Details
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
- Retrieve Audit Log
Ad Audit Actions
- Retrieve Event Stats
- Retrieve User Event Stats
- Retrieve User Locked Stats
- Retrieve User Enabled Stats
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
- Retrieve Remediated
- Retrieve Suppress Vulnerability
- Retrieve Suppres Vulnerability
- Create Suppres Vulnerability
- Update Suppres Vulnerability
- Delete Suppres Vulnerability
- Retrieve Records
Firewall Actions
- Retrieve Firewall Groups
- Retrieve Firewall Group
- Retrieve Firewall Interfaces
- Retrieve Firewall Interface
- Retrieve Firewall License
- Retrieve Firewall Rules
- Retrieve Firewall Rule
- Retrieve Firewall Users
- Retrieve Firewall User
- Retrieve Firewall Zones
- Retrieve Firewall Zone
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
- Retrieve Event Set
- Create Event Set
- Update Event Set
- Delete Event Set
Ticket Template Actions
- Retrieve Custom Ticketing Template
- Create Custom Ticketing Template
- Update Custom Ticketing Template
- Delete Custom Ticketing Template
Scheduler Actions
- Retrieve Scheduler
- Create Scheduler
- Update Scheduler
- Delete Scheduler
- Update Schedule
Credentials Actions
- Retrieve Credential
- Create Credential
- Update Credential
- Delete Credential
- Retrieve Agent Credentials Mapping
- Retrieve Agent Credential Mapping
- Create Agent Credential Mapping
- Update Agent Credential Mapping
- Delete Agent Credential Mapping
- Retrieve Credentials
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
- Authorize
Company Actions
- Retrieve Asset Windows Compatibility
- Retrieve Companies
- Retrieve Company
- Create Company
- Update Company
- Delete Company
- Retrieve Company Stats
- Retrieve Company Stat
- Retrieve Jobs View
- Retrieve Job View
- Retrieve Adaudit
- Retrieve Event Tickets
Agent Actions
- Retrieve Agents
- Retrieve Agent
- Migrate Agents

Overview

This node interacts with the Connect Secure API to retrieve detailed security report data for a specific asset. It is useful in scenarios where users need to fetch security-related information about an asset identified by its unique ID, such as vulnerability reports or compliance status. For example, a security analyst could use this node to automatically pull the latest security report of an asset into their workflow for further analysis or alerting.

Properties

Name	Meaning
X USER ID	The user identifier required for authentication or tracking purposes in the API request.
Id	The unique numeric identifier of the asset whose security report data is being retrieved.

Output

The node outputs JSON data containing the security report details of the specified asset. This typically includes various fields describing the asset's security posture, vulnerabilities, and related metadata as returned by the Connect Secure API. There is no indication that the node outputs binary 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 the bundled OpenAPI specification.
Proper configuration of the API credentials within n8n is necessary for successful execution.

Troubleshooting

Missing or invalid X USER ID: If the "X USER ID" header is not provided or incorrect, the API may reject the request. Ensure this property is set correctly.
Invalid asset Id: Providing an invalid or non-existent asset ID will likely result in an error or empty response. Verify the asset ID before running the node.
Authentication errors: Failure to provide valid API credentials will cause authentication failures. Confirm that the API key credential is configured properly.
Network or API downtime: Connectivity issues or service outages can cause the node to fail. Check network access and service status if errors occur.

Links and References

Connect Secure API Documentation (Replace with actual URL if available)
n8n Documentation - Creating Custom Nodes