CTM360_HackerView

External Attack Surface Management platform, which combines automated asset discovery, issue identification / management, remediation guidelines, security ratings and third party risk management.

Network Security · CTM360

Details

IDCTM360_HackerView
ProviderCTM360
CategoryNetwork Security
From Version6.10.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

External Attack Surface Management platform, which combines automated asset discovery, issue identification / management, remediation guidelines, security ratings and third party risk management.

Use Module To Use to select which HackerView data source this instance fetches:

  • Light Scan — external attack surface findings from the standard HackerView light scan module.
  • Deep Scan — deeper vulnerability and exposure findings from the HackerView Deep Scan module, including additional fields such as CVSS, evidence, and asset context.

This integration was integrated and tested with version 1.0.0 of CTM360_HackerView.

Configure CTM360 HackerView in Cortex

Parameter Description Required
Incident Mirroring Direction Choose the direction to mirror the incident: Incoming (from HackerView to Cortex XSOAR), Outgoing (from Cortex XSOAR to HackerView), or Incoming and Outgoing (from/to Cortex XSOAR and HackerView). False
Module To Use The module to use: Light Scan or Deep Scan. False
First fetch (<number> <time unit>, e.g., 12 hours) The time the incidents should be fetched starting from. False
API Key The CTM360 HackerView API Key to use for fetching data. True
Maximum Number of Incidents per Fetch The maximum number of incidents to fetch per run. Maximum is 200. True
Fetch incidents   False
Trust any certificate (not secure)   False
Use system proxy settings   False
Incident type   False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

ctm360-hv-incident-list


Get the list of incidents from HV.

Base Command

ctm360-hv-incident-list

Input

Argument Name Description Required
dateFrom Select “From” date to fetch incidents starting from it. Optional
dateTo Select “To” date to fetch incidents up to it. Optional
maxHits Set number of results to fetch. Optional
order Set the order of the results. Optional

Context Output

Path Type Description
HackerView.IncidentList unknown List of all HV incidents.

ctm360-hv-incident-status-change


Change status of a HV incident and optionally add a comment.

Base Command

ctm360-hv-incident-status-change

Input

Argument Name Description Required
ticketId “ID” of the incident to change status. Required
ticketStatus New “Status” of incident. Required
comment “Comment” to accompany the status change (Optional). Optional

Context Output

There is no context output for this command.

get-mapping-fields


Returns the list of fields for an incident type.

Base Command

get-mapping-fields

Input

| Argument Name | Description | Required |
| — | — | — |

Context Output

There is no context output for this command.

ctm360-hv-incident-details


Fetch details of a single incident from the HackerView platform.

Base Command

ctm360-hv-incident-details

Input

Argument Name Description Required
ticketId “Ticket ID” of the incident to fetch. Required

Context Output

Path Type Description
HackerView.RemoteIncident.id unknown The symbolic incident ID.
HackerView.RemoteIncident.timestamp unknown The database timestamp.
HackerView.RemoteIncident.confidence unknown The confidence of the report.
HackerView.RemoteIncident.cve_id unknown The associated CVE identifier(s).
HackerView.RemoteIncident.cwe unknown The list of associated CWEs.
HackerView.RemoteIncident.issue_category unknown The category of the incident.
HackerView.RemoteIncident.issue_name unknown The name of the incident.
HackerView.RemoteIncident.potential_attack_type unknown The potential attack type that can make use of the incident.
HackerView.RemoteIncident.potential_impact unknown The potential impact of the incident.
HackerView.RemoteIncident.status unknown The active status of the incident.
HackerView.RemoteIncident.progress_status unknown The progress of incident response.
HackerView.RemoteIncident.severity unknown The severity of the incident.
HackerView.RemoteIncident.resolved_ip unknown The IP resolved on the affected asset.
HackerView.RemoteIncident.first_seen unknown The incident creation date.
HackerView.RemoteIncident.last_seen unknown The last discovery date for the incident.
HackerView.RemoteIncident.last_updated unknown The last update date for the incident.
HackerView.RemoteIncident.environments unknown The environments associated with the incident.
HackerView.RemoteIncident.ticket_id unknown The ticket ID.
HackerView.RemoteIncident.technologies unknown The technologies on the affected asset.
HackerView.RemoteIncident.domain unknown The domain of the affected asset.
HackerView.RemoteIncident.host unknown The host of the affected asset.
HackerView.RemoteIncident.asset_type unknown The affected asset type.
HackerView.RemoteIncident.asset unknown The affected asset.
HackerView.RemoteIncident.brand unknown The organization brand the incident belongs to.
HackerView.RemoteIncident.ip unknown The IP address associated with the finding.
HackerView.RemoteIncident.port unknown The network port associated with the finding.
HackerView.RemoteIncident.uri unknown The URI path or resource related to the finding.
HackerView.RemoteIncident.url unknown The base URL of the affected asset or service.
HackerView.RemoteIncident.issue_type unknown The type or classification of the issue.
HackerView.RemoteIncident.issue_description unknown The detailed description of the issue.
HackerView.RemoteIncident.cpe unknown The Common Platform Enumeration (CPE) identifier if applicable.
HackerView.RemoteIncident.cvss_metrics unknown The CVSS vector or metric string for the vulnerability.
HackerView.RemoteIncident.cvss_score unknown The CVSS base score for the vulnerability.
HackerView.RemoteIncident.epss_score unknown The Exploit Prediction Scoring System (EPSS) score.
HackerView.RemoteIncident.known_exploited unknown The indicator of whether the vulnerability is known to be exploited.
HackerView.RemoteIncident.hackerview_link unknown The link to the issue in the HackerView platform.
HackerView.RemoteIncident.evidence unknown The request/response evidence for the finding (e.g. request, response, curl_command).

get-remote-data


Gets remote data from a remote incident. This method does not update the current incident, and should be used for debugging purposes.

Base Command

get-remote-data

Input

Argument Name Description Required
id The incident ID. Required
lastUpdate Retrieves entries that were created after lastUpdate. Required

Context Output

There is no context output for this command.

get-modified-remote-data


Gets the list of incidents that were modified since the last update time. Note that this method is here for debugging purposes. The get-modified-remote-data command is used as part of a Mirroring feature, which is available in Cortex XSOAR from version 6.1.

Base Command

get-modified-remote-data

Input

Argument Name Description Required
lastUpdate A date string in local time representing the last time the incident was updated. The incident is only returned if it was modified after the last update time. Required

Context Output

There is no context output for this command.

update-remote-system


Updates the remote system with local changes.

Base Command

update-remote-system

Input

Argument Name Description Required
remoteId Remote ID of incident to update in the remote system. Required

Context Output

There is no context output for this command.

Incident Mirroring

You can enable incident mirroring between Cortex XSOAR incidents and CTM360 HackerView corresponding events (available from Cortex XSOAR version 6.0.0).
To set up the mirroring:

  1. Enable Fetching incidents in your instance configuration.
  2. In the Mirroring Direction integration parameter, select in which direction the incidents should be mirrored:

    Option Description
    None Turns off incident mirroring.
    Incoming Any changes in CTM360 HackerView events (mirroring incoming fields) will be reflected in Cortex XSOAR incidents.
    Outgoing Any changes in Cortex XSOAR incidents will be reflected in CTM360 HackerView events (outgoing mirrored fields).
    Incoming And Outgoing Changes in Cortex XSOAR incidents and CTM360 HackerView events will be reflected in both directions.

Newly fetched incidents will be mirrored in the chosen direction. However, this selection does not affect existing incidents.
Important Note: To ensure the mirroring works as expected, mappers are required, both for incoming and outgoing, to map the expected fields in Cortex XSOAR and CTM360 HackerView.

Configuration parameters

  • mirror_direction — Incident Mirroring Direction
  • module_to_use — Module To Use
  • first_fetch — First fetch (<number> <time unit>, e.g., 12 hours)
  • api_key — (required)
  • max_fetch — Maximum Number of Incidents per Fetch (required)
  • isFetch — Fetch incidents
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • incidentType — Incident type
  • incidentFetchInterval — Incidents Fetch Interval

Commands (7)

  • ctm360-hv-incident-details

    Fetch details of a single incident from the HackerView platform.

  • ctm360-hv-incident-list

    Get the list of incidents from HV.

  • ctm360-hv-incident-status-change

    Change status of a HV incident and optionally add a comment.

  • get-mapping-fields

    Returns the list of fields for an incident type.

  • get-modified-remote-data

    Gets the list of incidents that were modified since the last update time. Note that this method is here for debugging purposes. The get-modified-remote-data command is used as part of a Mirroring feature, which is available in Cortex XSOAR from version 6.1.

  • get-remote-data

    Gets remote data from a remote incident. This method does not update the current incident, and should be used for debugging purposes.

  • update-remote-system

    Updates the remote system with local changes.

1. Login to your account on [HackerView](https://platform.ctm360.com/hackerview)
2. Head over to Configuration > Integrations.
3. Here select the appropriate integration type, then type a name for your API key and hit the "Create" button. This will generate a new API key.
4. Make sure to save this key, as the full key will not be visible in the portal shortly.