SOCRadar icon

SOCRadar

Comprehensive SOCRadar API integration
Join our community

Actions21

Overview

The node integrates with the SOCRadar API to retrieve digital footprint data related to a company. Specifically, the "Get Digital Assets" operation fetches various types of digital assets associated with a given company ID. This can include domains, IP addresses, websites, login pages, DNS records, SSL certificates, IP blocks, mobile applications, technologies used, cloud buckets, social accounts, and source code repositories.

This node is beneficial for cybersecurity analysts, threat intelligence teams, or IT asset managers who want to gather comprehensive information about an organization's digital presence and assets. For example, it can be used to monitor an organization's external attack surface, identify exposed assets, or track changes in technology usage.

Properties

Name Meaning
Company ID The unique identifier of the company whose digital assets are being queried.
Asset Type The type of digital asset to retrieve. Options include: Domain, IP Address, Website, Login Page, DNS Record, SSL Certificate, IP Block, Mobile Application, Technology, Cloud Buckets, Social Accounts, Source Code Repo.
Additional Fields Optional parameters to customize the query:
- Page Number The page number for paginated results (default 1).
- Page Limit The number of results per page (default 20).
- Sort By Field name to sort the results by.
- Sort Descending Boolean indicating whether to sort in descending order (default false).

Output

The output is a JSON array where each item corresponds to a digital asset retrieved from the SOCRadar API based on the input parameters. Each JSON object contains details about the specific asset type requested, such as domain names, IP addresses, or other asset-specific metadata.

If the node supports binary data output (not explicitly shown in the provided code), it would typically represent files or certificates related to the digital assets, but this is not evident here.

Dependencies

  • Requires an active SOCRadar API key credential configured in n8n.
  • The node makes HTTP requests to the SOCRadar API base URL using the provided API key.
  • No additional external dependencies are indicated beyond the bundled utility functions and node properties.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Incorrect or missing Company ID will result in errors or empty responses.
    • Requesting unsupported asset types or malformed parameters may lead to API errors.
    • Pagination parameters out of range could cause unexpected results or errors.

  • Error Handling:

    • The node captures API error messages and includes them in the output JSON under an error field along with any additional details if available.
    • If "Continue On Fail" is enabled, the node will continue processing subsequent items even if one fails, returning error details for failed items.
    • To resolve errors, verify credentials, ensure correct input parameters, and consult SOCRadar API documentation for valid values.

Links and References

Discussion