Cybereason

Endpoint detection and response to manage and query malops, connections and processes.

Endpoint · Cybereason

Details

IDCybereason
ProviderLevelBlue
CategoryEndpoint
From Version5.0.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM EDR Cortex Cloud Cloud Runtime Security

README

Endpoint detection and response to manage and query malops, connections and processes.
This integration was integrated and tested with version 21.2 of Cybereason

Configure Cybereason in Cortex

Parameter Required
Server URL (e.g. https://192.168.0.1) True
Credentials False
Password False
Trust any certificate (not secure) False
Use system proxy settings False
Fetch incidents False
Incident type False
First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year) False
Fetch by “MALOP UPDATE TIME” (Fetching by Malop creation time is no longer supported) False

Cybereason MalOp to XSOAR Incident Map

This involves the mapping of response fields to XSOAR incidents, enhancing the ability to manage and track security incidents effectively.

Overview

  1. Incident Mapping: The integration maps specific response fields to corresponding incident fields within XSOAR, ensuring that all relevant information is captured accurately.
  2. Custom Fields: In addition to standard incident fields, custom fields have been introduced to accommodate unique data requirements specific to our workflow. These fields provide flexibility and enhance the granularity of the incident information.
  • malopcreationtime
  • malopupdatetime
  • maloprootcauseelementname
  • maloprootcauseelementtype
  • malopseverity
  • malopdetectiontype
  • malopedr
  • malopurl
  • malopgroup

These custom fields provide flexibility and enhance the granularity of the incident information.

Usage

  1. Configure Custom Fields: Ensure that all custom fields are properly set up in XSOAR before running the fetch function.
  2. Enable Fetch Incidents: Functionality responsible to fetch Malops.
  3. Monitor Incidents: Once the MalOps are converted, they will appear as incidents in XSOAR, allowing for effective incident management.

Cybereason MalOp to XSOAR Incident Map

This involves the mapping of response fields to XSOAR incidents, enhancing the ability to manage and track security incidents effectively.

Overview

  1. Incident Mapping: The integration maps specific response fields to corresponding incident fields within XSOAR, ensuring that all relevant information is captured accurately.
  2. Custom Fields: In addition to standard incident fields, custom fields have been introduced to accommodate unique data requirements specific to our workflow. These fields provide flexibility and enhance the granularity of the incident information.
  • malopcreationtime
  • malopupdatetime
  • maloprootcauseelementname
  • maloprootcauseelementtype
  • malopseverity
  • malopdetectiontype
  • malopedr
  • malopurl
  • malopgroup

These custom fields provide flexibility and enhance the granularity of the incident information.

Fetchin MalOps

The functionality for fetching MalOps is implemented through the fetch_incidents function. This function is responsible for retrieving MalOps and subsequently converting them into XSOAR incidents.

  • Conversion Process: The conversion from MalOps to incidents is handled by the malop_to_incident function. This function processes MalOps one by one, ensuring each is correctly mapped to its corresponding incident structure.

Usage

  1. Configure Custom Fields: Ensure that all custom fields are properly set up in XSOAR before running the fetch function.
  2. Run Fetch Incidents: Execute the fetch_incidents function to initiate the retrieval and conversion process.
  3. Monitor Incidents: Once the MalOps are converted, they will appear as incidents in XSOAR, allowing for effective incident management.

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.

cybereason-query-processes


Searches for processes with various filters.

Base Command

cybereason-query-processes

Input

Argument Name Description Required
machine The hostname of the machine. Optional
onlySuspicious Show only suspicious processes. Possible values are: true, false. Default is false. Optional
limit Maximum number of results to retrieve. Default is 10000. Optional
processName Process name to filter by. Optional
saveToContext If true, save the result to the context. Possible values are: true, false. Default is false. Optional
hasIncomingConnection Filter only processes with incoming connections. Possible values are: true, false. Default is false. Optional
hasOutgoingConnection Filter only processes with outgoing connections. Possible values are: true, false. Default is false. Optional
hasExternalConnection If process has external connection. Possible values are: true, false. Optional
unsignedUnknownReputation If process is not known to reputation services and its image file is unsigned. Possible values are: true, false. Optional
fromTemporaryFolder If process is running from temporary folder. Possible values are: true, false. Optional
privilegesEscalation If process was identified elevating its privileges to local system user. Possible values are: true, false. Optional
maliciousPsExec If the process was executed by PsExec service and is suspicious as being executed maliciously. Possible values are: true, false. Optional

Context Output

Path Type Description
Cybereason.Process.Name Unknown The process name
Cybereason.Process.Malicious Unknown Malicious status of the process
Cybereason.Process.CreationTime Unknown The process creation time
Cybereason.Process.EndTime Unknown The process end time
Cybereason.Process.CommandLine Unknown The command line of the process
Cybereason.Process.SignedAndVerified Unknown Is the process signed and verified
Cybereason.Process.ProductType Unknown The product type
Cybereason.Process.Children Unknown Children of the process
Cybereason.Process.Parent Unknown The parent process
Cybereason.Process.OwnerMachine Unknown The machine’s hostname
Cybereason.Process.User Unknown The user who ran the process
Cybereason.Process.ImageFile Unknown Image file of the process
Cybereason.Process.SHA1 Unknown SHA1 of the process file
Cybereason.Process.MD5 Unknown MD5 of the process file
Cybereason.Process.CompanyName Unknown The company’s name
Cybereason.Process.ProductName Unknown The product’s name

Command example

!cybereason-query-processes machine=machine-name hasOutgoingConnection=true hasIncomingConnection=true

Context Example

{
    "Process": [
        {
            "Children": null,
            "CommandLine": "C:\\WINDOWS\\system32\\svchost.exe -k LocalService -s W32Time",
            "CompanyName": "Microsoft Corporation",
            "CreationTime": "2022-05-06T04:15:33.939000",
            "EndTime": "",
            "ImageFile": "svchost.exe",
            "MD5": "<md5>",
            "Malicious": "indifferent",
            "Name": "svchost.exe",
            "OwnerMachine": "<machine-name>",
            "Parent": "services.exe",
            "ProductName": "Microsoft\u00ae Windows\u00ae Operating System",
            "ProductType": "SVCHOST",
            "SHA1": "<sha1>",
            "SignedandVerified": "true",
            "User": "machine-name\\local service"
        }
    ]
}

Human Readable Output

Cybereason Processes

Name Malicious Creation Time End Time Command Line Signed and Verified Product Type Children Parent Owner Machine User Image File SHA1 MD5 Company Name Product Name
svchost.exe indifferent 2022-05-06T04:15:33.939000   C:\WINDOWS\system32\svchost.exe -k LocalService -s W32Time true SVCHOST   services.exe machine-name machine-name\local service svchost.exe wxyz1234 abc123 Microsoft Corporation Microsoft® Windows® Operating System

cybereason-is-probe-connected


Checks if the machine is currently connected to the Cybereason server

Base Command

cybereason-is-probe-connected

Input

Argument Name Description Required
machine The hostname of the machine to check. Required

Context Output

Path Type Description
Cybereason.Machine.isConnected boolean true if machine is connected, else false
Cybereason.Machine.Name string Machine name

Command example

!cybereason-is-probe-connected machine=machine-name

Context Example

{
    "Cybereason": {
        "Machine": {
            "Name": "<machine-name>",
            "isConnected": true
        }
    }
}

Human Readable Output

true

cybereason-query-connections


Searches for connections.

Base Command

cybereason-query-connections

Input

Argument Name Description Required
ip Filter connections which contain this IP (in or out). Optional
machine Filter connections on the given machine. Optional
saveToContext If true, save the result to the context. Possible values are: true, false. Default is false. Optional

Context Output

Path Type Description
Cybereason.Connection.Name Unknown The connection’s name
Cybereason.Connection.Direction Unknown OUTGOING/INCOMING
Cybereason.Connection.ServerAddress Unknown Address of the Cybereason machine
Cybereason.Connection.ServerPort Unknown Port of the Cybereason machine
Cybereason.Connection.PortType Unknown Type of the connection
Cybereason.Connection.ReceivedBytes Unknown Received bytes count
Cybereason.Connection.TransmittedBytes Unknown Transmitted bytes count
Cybereason.Connection.RemoteCountry Unknown The connection’s remote country
Cybereason.Connection.OwnerMachine Unknown The machine’s hostname
Cybereason.Connection.OwnerProcess Unknown The process which performed the connection
Cybereason.Connection.CreationTime Unknown Creation time of the connection
Cybereason.Connection.EndTime Unknown End time of the connection

Command example

!cybereason-query-connections ip=<host>

Context Example

{
    "Connection": [
        {
            "CreationTime": "2021-04-20T00:00:00.00000",
            "Direction": "OUTGOING",
            "EndTime": "2021-04-20T00:00:00.000000",
            "Name": "<connection_ip_addresses>",
            "OwnerMachine": "simplify-cyber",
            "OwnerProcess": "nbtscan.exe",
            "PortType": "SERVICE_WINDOWS",
            "ReceivedBytes": "0",
            "RemoteCountry": null,
            "ServerAddress": "<server_address>",
            "ServerPort": "137",
            "TransmittedBytes": "50"
        }
    ]
}

Human Readable Output

Cybereason Connections for: 192.168.1.103

Creation Time Direction End Time Name Owner Machine Owner Process Port Type Received Bytes Remote Country Server Address Server Port Transmitted Bytes
2021-04-20T00:00:00.000000 OUTGOING 2021-04-20T00:00:00.000000 connection_ip_addresses simplify-cyber test.exe SERVICE_WINDOWS 0   192.168.1.103 137 50

cybereason-isolate-machine


Isolates a machine that has been infected from the rest of the network

Base Command

cybereason-isolate-machine

Input

Argument Name Description Required
machine Machine name to be isolated. Required

Context Output

Path Type Description
Cybereason.Machine string Machine name
Cybereason.IsIsolated boolean Is the machine isolated

Command example

!cybereason-isolate-machine machine=machine-name

Context Example

{
    "Cybereason": {
        "IsIsolated": true,
        "Machine": "<machine-name>"
    }
}

Human Readable Output

Machine was isolated successfully.

cybereason-unisolate-machine


Stops isolation of a machine

Base Command

cybereason-unisolate-machine

Input

Argument Name Description Required
machine Machine name to be un-isolated. Required

Context Output

Path Type Description
Cybereason.Machine string Machine name
Cybereason.IsIsolated boolean Is the machine isolated

Command example

!cybereason-unisolate-machine machine=machine-name

Context Example

{
    "Cybereason": {
        "IsIsolated": false,
        "Machine": "<machine-name>"
    }
}

Human Readable Output

Machine was un-isolated successfully.

cybereason-query-malops


Returns a list of all Malops and details on the Malops.

Base Command

cybereason-query-malops

Input

Argument Name Description Required
filters Filter to filter response by, given in Cybereason API syntax. Optional
totalResultLimit The total number of results to return for your Server. Ensure you make the limit a reasonable number to maximize Server performance and not to overload the system. Optional
perGroupLimit The number of items to return per Malop group. Optional
templateContext The level of detail to provide in the response. Possible values include: SPECIFIC: References value contain only the count in the ElementValues class. The Suspicions map is calculated for each results, with the suspicion name and the first time the suspicion appeared. The Evidence map is not calculated for the results. CUSTOM: Reference values contain the specific Elements, up to the limit defined in the perFeatureLimit parameter. The Suspicions map is not calculated for the results. The Evidence map is not calculated for the results. DETAILS: Reference values contain the specific Elements, up to the limit defined in the perFeatureLimit parameter. The Suspicions map is calculated for each result, containing the suspicion name and the first time the suspicion appeared. The Evidence map is not calculated for the results. Possible values are: MALOP, SPECIFIC, CUSTOM, DETAILS, OVERVIEW. Default is MALOP. Optional
withinLastDays Return all the malops within the last days. Optional
malopGuid Malop GUIDs to filter by (Comma separated values supported, e.g. 11.123456789,11.9874563210). Optional

Context Output

Path Type Description
Cybereason.Malops.GUID string The unique globally unique identifier (guid) for the Malop.
Cybereason.Malops.CreationTime string The time reported as when the malicious behavior began on the system. This is not the time that the Malop was first detected by Cybereason.
Cybereason.Malops.DecisionFeature string The reason that Cybereason has raised the Malop.
Cybereason.Malops.Link string Link to the Malop on Cybereason.
Cybereason.Malops.Suspects string Malop suspect type and name
Cybereason.Malops.LastUpdatedTime string Last updated time of malop
Cybereason.Malops.AffectedMachine string List of machines affected by this Malop
Cybereason.Malops.InvolvedHash string List of file hashes involved in this Malop
Cybereason.Malops.Status string Malop managemant status

Command example


#### Context Example

```json
{
    "Cybereason": {
        "Malops": [
            {
                "AffectedMachine": [
                    "win10-cybereaso",
                    "marketing"
                ],
                "CreationTime": "2021-07-12T00:00:00.000000",
                "DecisionFailure": "blackListedFileHash",
                "GUID": "<malop_id>",
                "InvolvedHash": [
                    1
                ],
                "LastUpdateTime": "2021-08-28T00:00:00.000000",
                "Link": "<malop_link>",
                "Status": "OPEN",
                "Suspects": "Process: test.exe"
            }
        ]
    }
}

Human Readable Output

Cybereason Malops

GUID Link CreationTime Status LastUpdateTime DecisionFailure Suspects AffectedMachine InvolvedHash
https://test.server.net:0000/#/malop/11.1234567890 2021-07-12T00:00:00.000000 OPEN 2021-08-28T00:00:00.000000 blackListedFileHash Process: test.exe affected_machine_name 1

cybereason-malop-processes


Returns a list of malops

Base Command

cybereason-malop-processes

Input

Argument Name Description Required
malopGuids Array of malop GUIDs separated by comma. (Malop GUID can be retrieved with the command cybereason-query-malops command). Required
machineName Machine names which were affected by malop. Comma separated values supported (e.g., machine1,machine2). Optional
dateTime Starting Date and Time to filter the Processes based on their creation date. The format for the input is (“YYYY/MM/DD HH:MM:SS”). Optional

Context Output

Path Type Description
Cybereason.Process.Name string The process name
Cybereason.Process.Malicious Unknown Malicious status of the process
Cybereason.Process.CreationTime date The process creation time
Cybereason.Process.EndTime date The process end time
Cybereason.Process.CommandLine string The command line of the process
Cybereason.Process.SignedAndVerified Unknown Is the process signed and verified
Cybereason.Process.ProductType Unknown The product type
Cybereason.Process.Children Unknown Children of the process
Cybereason.Process.Parent Unknown The parent process
Cybereason.Process.OwnerMachine Unknown The machine’s hostname
Cybereason.Process.User string The user who ran the process
Cybereason.Process.ImageFile Unknown Image file of the process
Cybereason.Process.SHA1 string SHA1 of the process file
Cybereason.Process.MD5 string MD5 of the process file
Cybereason.Process.CompanyName string The company’s name
Cybereason.Process.ProductName string The product’s name

Command example

!cybereason-malop-processes malopGuids=<malop_id>

Context Example

{
    "Process": [
        {
            "Children": null,
            "CommandLine": "\"C:\\Users\\user\\winrar-x64-602.pdf.exe\"",
            "CompanyName": "Hello World",
            "CreationTime": "2022-03-14T00:00:00.000000",
            "EndTime": "2022-03-14T00:00:00.000000",
            "ImageFile": "<image_file_name>",
            "MD5": "<md5>",
            "Malicious": "indifferent",
            "Name": "<file_name>",
            "OwnerMachine": "<machine-name>",
            "Parent": "explorer.exe",
            "ProductName": "WinRAR",
            "ProductType": null,
            "SHA1": "<sha1>",
            "SignedandVerified": null,
            "User": "machine-name\\user"
        }
    ]
}

Human Readable Output

Cybereason Malop Processes

Name Malicious Creation Time End Time Command Line Parent Owner Machine User Image File SHA1 MD5 Company Name Product Name
winrar-x64-602.exe indifferent 2022-03-14T00:00:00.000000 2022-03-14T00:00:00.000000 “C:\Users\user\winrar-x64-602.exe” explorer.exe machine-name machine-name\user winrar-x64-602.exe 1234sajklfshljjvhlsdfhilh23 md5_hash Hello World WinRAR

cybereason-add-comment


Add new comment to malop

Base Command

cybereason-add-comment

Input

Argument Name Description Required
comment Comment to add to the malop. Required
malopGuid Malop GUID to add comment to. (Malop GUID can be retrieved with the command cybereason-query-malops command). Required

Context Output

There is no context output for this command.

Command example

!cybereason-add-comment comment=NewComment malopGuid=<malop_id>

Human Readable Output

Comment added successfully

cybereason-update-malop-status


Updates malop status

Base Command

cybereason-update-malop-status

Input

Argument Name Description Required
malopGuid Malop GUID to update its status. Required
status Status to update. Possible values are: To Review, Unread, Remediated, Not Relevant, Open. Required

Context Output

Path Type Description
Cybereason.Malops.GUID string Malop GUID
Cybereason.Malops.Status string Malop status: To Review,Unread,Remediated,Not Relevant

Command example

!cybereason-update-malop-status malopGuid=<malop_id> status="To Review"

Context Example

{
    "Cybereason": {
        "Malops": {
            "GUID": "<malop_id>",
            "Status": "To Review"
        }
    }
}

Human Readable Output

Successfully updated malop to status To Review

cybereason-prevent-file


Prevent malop process file

Base Command

cybereason-prevent-file

Input

Argument Name Description Required
md5 Malop process file MD5 to prevent. Required

Context Output

Path Type Description
Cybereason.Process.MD5 string Process file MD5
Cybereason.Process.Prevent boolean True if process file is prevented, else false

Command example

!cybereason-prevent-file md5=MD5

Context Example

{
    "Process": {
        "MD5": "<md5>",
        "Prevent": true
    }
}

Human Readable Output

File was prevented successfully

cybereason-unprevent-file


Unprevent malop process file

Base Command

cybereason-unprevent-file

Input

Argument Name Description Required
md5 Malop process file MD5 to unprevent. Required

Context Output

Path Type Description
Cybereason.Process.MD5 string Process file MD5
Cybereason.Process.Prevent boolean True if process file is prevented, else false

Command example

!cybereason-unprevent-file md5=MD5

Context Example

{
    "Process": {
        "MD5": "MD5",
        "Prevent": false
    }
}

Human Readable Output

File was unprevented successfully

cybereason-query-file


Query files as part of investigation

Base Command

cybereason-query-file

Input

Argument Name Description Required
file_hash File hash (SHA-1 and MD5 supported). Required

Context Output

Path Type Description
Cybereason.File.Path string File path
Cybereason.File.SHA1 string File SHA-1 hash
Cybereason.File.Machine string Machine name on which file is located
Cybereason.File.SuspicionsCount number File suspicions count
Cybereason.File.Name string File name
Cybereason.File.CreationTime date File creation time
Cybereason.File.Suspicion string File suspicions object of suspicion as key and detected date as value
Cybereason.File.OSVersion string Machine OS version on which file is located
Cybereason.File.ModifiedTime date File modified date
Cybereason.File.Malicious boolean Is file malicious
Cybereason.File.Company string Company name
Cybereason.File.MD5 string File MD5 hash
Cybereason.File.IsConnected boolean Is machine connected to Cybereason
Cybereason.File.Signed boolean Is file signed
Cybereason.File.Evidence string File evidences

Command example

!cybereason-query-file file_hash=<file_hash>

Context Example

{
    "Cybereason": {
        "File": {
            "Company": "Hello World",
            "CreationTime": "2022-02-28T00:00:00.000Z",
            "Evidence": [],
            "IsConnected": false,
            "MD5": "<md5>",
            "Machine": "<machine-name>",
            "Malicious": false,
            "ModifiedTime": "2022-05-09T00:00:00.000Z",
            "Name": "<file_name>",
            "OSVersion": null,
            "Path": "c:\\users\\user\\winrar-x64-602.exe",
            "SHA1": "<sha1>",
            "Signed": true,
            "Suspicion": {},
            "SuspicionsCount": null
        }
    }
}

Human Readable Output

Cybereason file query results for the file hash: 77ab1e20c685e716b82c7c90b373316fc84cde23

Company CreationTime IsConnected MD5 Machine Malicious ModifiedTime Name Path SHA1 Signed
Hello World 2022-02-28T00:00:00.000Z false MD5 machine-name false 2022-05-09T00:00:00.000Z winrar-x64-602.pdf.exe c:\users\test\winrar-x64-602.pdf.exe 1245sedecthebdfkjkgjljldl2348 true

cybereason-query-domain


Query domains as part of investigation

Base Command

cybereason-query-domain

Input

Argument Name Description Required
domain Domain to query. Required

Context Output

Path Type Description
Cybereason.Domain.Name string Domain name
Cybereason.Domain.Malicious boolean Is domain malicious
Cybereason.Domain.IsInternalDomain boolean Is domain internal
Cybereason.Domain.Reputation string Domain reputation
Cybereason.Domain.SuspicionsCount number Domain suspicions count
Cybereason.Domain.WasEverResolved boolean Was domain ever resolved
Cybereason.Domain.WasEverResolvedAsASecondLevelDomain boolean Was domain ever resolved as a second level domain

Command example

!cybereason-query-domain domain=www2.bing.com

Context Example

{
    "Cybereason": {
        "Domain": {
            "IsInternalDomain": false,
            "Malicious": false,
            "Name": "www2.bing.com",
            "Reputation": null,
            "SuspicionsCount": 0,
            "WasEverResolved": false,
            "WasEverResolvedAsASecondLevelDomain": true
        }
    }
}

Human Readable Output

Cybereason domain query results for the domain: www2.bing.com

Name Reputation IsInternalDomain WasEverResolved WasEverResolvedAsASecondLevelDomain Malicious SuspicionsCount
www2.bing.com indifferent false false true false 0
www2.bing.com   false false true false 0

cybereason-query-user


Query users as part of investigation

Base Command

cybereason-query-user

Input

Argument Name Description Required
username Username to query. Required

Context Output

Path Type Description
Cybereason.User.Username string User name
Cybereason.User.Domain string User domain
Cybereason.User.LastMachineLoggedInTo string Last machine which user logged in to
Cybereason.User.LocalSystem boolean Is local system
Cybereason.User.Organization string User organization

Command example

!cybereason-query-user username="user-name"

Context Example

{
    "Cybereason": {
        "User": {
            "Domain": "<machine-name>",
            "LastMachineLoggedInTo": "<machine-name>",
            "LocalSystem": false,
            "Organization": "INTEGRATION",
            "Username": "user-name"
        }
    }
}

Human Readable Output

Cybereason user query results for the username: machine-name\prase

Username Domain LastMachineLoggedInTo Organization LocalSystem
machine-name\prase machine-name machine-name INTEGRATION false

cybereason-archive-sensor


Archives a Sensor.

Base Command

cybereason-archive-sensor

Input

Argument Name Description Required
sensorID Sensor ID of Cybereason Sensor. Required
archiveReason Reason for Archiving Cybereason Sensor. Required

Context Output

There is no context output for this command.

Command example

!cybereason-archive-sensor sensorID=SENSOR_ID archiveReason="Archive this Sensor"

Human Readable Output

Sensor archive status: Failed Actions: 0. Succeeded Actions: 1

cybereason-unarchive-sensor


Unarchives a Sensor.

Base Command

cybereason-unarchive-sensor

Input

Argument Name Description Required
sensorID Sensor ID of Cybereason Sensor. Required
unarchiveReason Reason for Unarchiving Cybereason Sensor. Required

Context Output

There is no context output for this command.

Command example

!cybereason-unarchive-sensor sensorID=SENSOR_ID unarchiveReason="Unarchive this Sensor"

Human Readable Output

Sensor unarchive status: Failed Actions: 0. Succeeded Actions: 1

cybereason-delete-sensor


Deletes a Sensor.

Base Command

cybereason-delete-sensor

Input

Argument Name Description Required
sensorID Sensor ID of Cybereason Sensor. Required

Context Output

There is no context output for this command.

Command example

!cybereason-delete-sensor sensorID=SENSOR_ID

Human Readable Output

Sensor deleted successfully.

cybereason-start-fetchfile


Start fetching the file to download

Base Command

cybereason-start-fetchfile

Input

Argument Name Description Required
malopGUID Malop GUID for fetching a file from a sensor to download. Required
userName The complete Cybereason user name string for the user performing the request. Required

Context Output

There is no context output for this command.

Command example

!cybereason-start-fetchfile malopGUID=<malop_id> userName=<user_name>

Human Readable Output

Successfully started fetching file for the given malop

cybereason-fetchfile-progress


Return a batch id for files waiting for download

Base Command

cybereason-fetchfile-progress

Input

Argument Name Description Required
malopGuid Malop GUID to know the progress for downloading a file. Required

Context Output

Path Type Description
Cybereason.Download.Progress.fileName unknown Filename for tha given malop
Cybereason.Download.Progress.status unknown Status for batch ID
Cybereason.Download.Progress.batchID unknown Unique batch id

Command example

!cybereason-fetchfile-progress malopGuid=<malop_id>

Context Example

{
    "Download": {
        "progress": {
            "MalopID": "<malop_id>",
            "batchID": [
                -1234
            ],
            "fileName": [
                "<file_name>"
            ],
            "status": [
                true
            ]
        }
    }
}

Human Readable Output

Filename: [‘winrar-x64-602.exe’] Status: [True] Batch ID: [-1234]

cybereason-download-file


Downloads the actual file to the machine

Base Command

cybereason-download-file

Input

Argument Name Description Required
batchID The batch id for the file download operation. Required

Context Output

There is no context output for this command.

Command example

!cybereason-download-file batchID=-1234

Context Example

{
    "File": {
        "EntryID": "<entry_id>",
        "Extension": "zip",
        "Info": "application/zip",
        "MD5": "<md5>",
        "Name": "download.zip",
        "SHA1": "<sha1>",
        "SHA256": "<SHA256>",
        "SHA512": "<SHA512>",
        "SSDeep": "<SSDeep_value>",
        "Size": 3168792,
        "Type": "Zip archive data, at least v2.0 to extract"
    }
}

Human Readable Output

Integration log: Downloading the file with this Batch ID: -1234

cybereason-close-file-batch-id


Aborts a file download operation that is in progress

Base Command

cybereason-close-file-batch-id

Input

Argument Name Description Required
batchID The batch id to abort a file download operation. Required

Context Output

There is no context output for this command.

Command example

!cybereason-close-file-batch-id batchID=-1234

Human Readable Output

Successfully aborts a file download operation that is in progress.

cybereason-available-remediation-actions


Get all remediation action details whatever available for that malop

Base Command

cybereason-available-remediation-actions

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required

Context Output

There is no context output for this command.

Command example

!cybereason-available-remediation-actions malopGuid=<malop_id>

Human Readable Output

{
   "data": [
       {
           "machineConnected": false,
           "machineId": "machine_id",
           "machineName": "<machine-name>",
           "machinesCount": 1,
           "malopId": "<malop_id>",
           "malopType": "MalopProcess",
           "remediationType": "BLOCK_FILE",
           "targetId": "<target_id>",
           "targetName": "<target_name>",
           "uniqueId": "<unique_id>"
       },
       {
           "machineConnected": false,
           "machineId": "<machine_id>",
           "machineName": "<machine-name>",
           "machinesCount": 1,
           "malopId": "<malop_id>",
           "malopType": "MalopProcess",
           "remediationType": "UNQUARANTINE_FILE",
           "targetId": "<target_id>",
           "targetName": "<target_name>",
           "uniqueId": "<unique_id>"
       }
   ],
   "errorMessage": "",
   "status": "SUCCESS"
}

cybereason-kill-process


Kill a processes for the malicious file. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-kill-process

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name to kill the process. Required
targetId Target ID to kill the process. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-kill-process machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Kill the Process"

Human Readable Output

Kill process remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-quarantine-file


Quarantine the detected malicious file in a secure location. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-quarantine-file

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name to quarantine a file. Required
targetId Target ID to quarantine a file. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-quarantine-file machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Quarantine the File"

Human Readable Output

Quarantine file remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-unquarantine-file


Unquarantine the detected malicious file in a secure location. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-unquarantine-file

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name to unquarantine a file. Required
targetId Target ID to unquarantine a file. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-unquarantine-file machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Unquarantine the File"

Human Readable Output

Unquarantine file remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-block-file


Block a file only in particular machine. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-block-file

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name whose files needs to be blocked. Required
targetId Target ID of file to be blocked. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-block-file machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Block a File"

Human Readable Output

Block file remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-delete-registry-key


Delete a registry entry associated with a malicious process. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-delete-registry-key

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name to delete the registry key. Required
targetId Target ID to delete the registry key. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-delete-registry-key machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Remove the registry key"

Human Readable Output

Delete registry key remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-kill-prevent-unsuspend


Prevent detected ransomware from running on the machine. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-kill-prevent-unsuspend

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name to prevent detected ransomware from running on the machine. Required
targetId Target ID to prevent detected ransomware from running on the machine. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-kill-prevent-unsuspend machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Kill Prevent"

Human Readable Output

Kill prevent unsuspend remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-unsuspend-process


Prevent a file associated with ransomware. (User will get inputs by executing the ‘cybereason-available-remediation-actions’ command if this remediation action is available for that Malop)

Base Command

cybereason-unsuspend-process

Input

Argument Name Description Required
malopGuid The unique ID assigned by the Cybereason platform for the Malop. Required
machine Machine name to prevent a file associated with ransomware. Required
targetId Target ID to prevent a file associated with ransomware. Required
userName The complete Cybereason user name string for the user performing the request. Required
comment Comment to add to the malop. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-unsuspend-process machine=machine-name malopGuid=<malop_id> targetId=<target_id> userName=<user_name> comment="Unsuspend Process"

Human Readable Output

Unsuspend process remediation action status is: SUCCESS
Remediation ID: REMEDIATION_ID

cybereason-malware-query


Malware query with options and values to filter

Base Command

cybereason-malware-query

Input

Argument Name Description Required
needsAttention Filter for Fetching Malwares by Malware needsAttention. Possible values are: True, False. Optional
type Filter for Fetching Malwares by Malware Type. (Possible filter values for Type are “KnownMalware,UnknownMalware,FilelessMalware,ApplicationControlMalware,RansomwareMalware”). Optional
status Filter for Fetching Malwares by Malware Status. (Possible filter values for Status are “Done,Excluded,Detected,Prevented,Remediated,DeleteOnRestart,Quarantined”). Optional
timestamp Filter for Fetching Malwares by Timestamp. Enter the time (in epoch). Optional
limit Filter for Fetching Malwares by Malware Limit. Required

Context Output

There is no context output for this command.

Command example

!cybereason-malware-query limit=5 needsAttention=True status=Done type=KnownMalware timestamp=1582206286000

Human Readable Output

{
   "data": {
       "hasMoreResults": false,
       "malwares": [],
       "totalResults": 0
   },
   "expectedResults": 0,
   "failedServersInfo": null,
   "failures": 0,
   "hidePartialSuccess": false,
   "message": "",
   "status": "SUCCESS"
}

cybereason-start-host-scan


Start or stop a full or quick scan for a host.

Base Command

cybereason-start-host-scan

Input

Argument Name Description Required
sensorID Sensor ID of a sensor. (Comma separated values supported.). Required
scanType Select a method/type to scan a host. Possible values are: FULL, QUICK, STOP. Required

Context Output

There is no context output for this command.

Command example

!cybereason-start-host-scan sensorID=SENSOR_ID scanType=FULL

Human Readable Output

Batch ID: -11156

cybereason-fetch-scan-status


Get the results for host scanning.

Base Command

cybereason-fetch-scan-status

Input

Argument Name Description Required
batchID The batch ID obtained after initiating the scan. Required

Context Output

There is no context output for this command.

Command example

!cybereason-fetch-scan-status batchID=-11156

Human Readable Output

{
   "abortHttpStatusCode": null,
   "abortTime": 0,
   "abortTimeout": false,
   "aborterUser": null,
   "actionArguments": [
       "ScheduleScanAction",
       "FULL"
   ],
   "actionType": "SchedulerScan",
   "batchId": -11156,
   "creatorUser": "<user_name>",
   "finalState": true,
   "globalStats": {
       "stats": {
           "AbortTimeout": 0,
           "Aborted": 0,
           "Aborting": 0,
           "AlreadyUpdated": 0,
           "BadArgument": 0,
           "ChunksRequired": 0,
           "Disconnected": 0,
           "EndedWithInvalidParam": 0,
           "EndedWithNoValidFolder": 0,
           "EndedWithSensorTimeout": 0,
           "EndedWithTooManyResults": 0,
           "EndedWithTooManySearches": 0,
           "EndedWithUnknownError": 0,
           "EndedWithUnsupportedFilter": 0,
           "EndedWithYaraCompileError": 0,
           "Failed": 0,
           "FailedSending": 0,
           "FailedSendingToServer": 0,
           "GettingChunks": 0,
           "InProgress": 0,
           "InvalidState": 0,
           "MsiFileCorrupted": 0,
           "MsiSendFail": 0,
           "NewerInstalled": 0,
           "None": 0,
           "NotSupported": 0,
           "Pending": 0,
           "Primed": 0,
           "ProbeRemoved": 0,
           "SendingMsi": 0,
           "SendingPlatform": 0,
           "Started": 0,
           "Succeeded": 1,
           "Timeout": 0,
           "TimeoutSending": 0,
           "UnauthorizedUser": 0,
           "UnknownProbe": 0,
           "partialResponse": 0
       }
   },
   "initiatorUser": "<user_name>",
   "startTime": 1652279731232,
   "totalNumberOfProbes": 1
}

cybereason-get-sensor-id


Get the Sensor ID of a machine.

Base Command

cybereason-get-sensor-id

Input

Argument Name Description Required
machineName The hostname of the machine. Optional

Context Output

There is no context output for this command.

Command example

!cybereason-get-sensor-id machineName=machine-name

Human Readable Output

Sensor ID for the machine ‘machine-id’ is: SENSOR_ID

cybereason-get-machine-details


Get the results related to machines.

Base Command

cybereason-get-machine-details

Input

Argument Name Description Required
machineName The hostname of the machine. Required
page The page number of machine records to retrieve (used for pagination) starting from 1. The page size is defined by the “pageSize” argument. Optional
pageSize The number of machine records per page to retrieve (used for pagination). The page number is defined by the “page” argument. Optional
limit The maximum number of records to retrieve. If “pageSize” is defined, this argument is ignored. Default is 50. Optional

Context Output

Path Type Description
Cybereason.Sensor.MachineID string Sensor ID of machine
Cybereason.Sensor.MachineName string Host name of machine
Cybereason.Sensor.MachineFQDN string FQDN of machine
Cybereason.Sensor.GroupID string Group ID of machine
Cybereason.Sensor.GroupName string Group Name of machine

Command example

!cybereason-get-machine-details machineName=xyz-1

Context Example

{
    "MachineID": "example-machine-id",
    "MachineName": "example-machine-name",
    "MachineFQDN": "example-machine-fqdn",
    "GroupID": "example-group-id",
    "GroupName": "example-group-name"
}

Base Command

cybereason-query-malop-management

Input

Argument Name Description Required
malopGuid malopGuid of the Cybereason Malop. Required

Context Output

Path Type Description
Cybereason.Malops.GUID string The unique globally unique identifier (guid) for the Malop.
Cybereason.Malops.CreationTime string The time reported as when the malicious behavior began on the system. This is not the time that the Malop was first detected by Cybereason.
Cybereason.Malops.Link string Link to the Malop on Cybereason.
Cybereason.Malops.LastUpdatedTime string Last updated time of malop
Cybereason.Malops.InvolvedHash string List of file hashes involved in this Malop
Cybereason.Malops.Status string Malop managemant status
Cybereason.Malops.MalopCloserName string List of Malop Closer Name involved in this Malop
Cybereason.Malops.Machines string List of Machines involved in this Malop
Cybereason.Malops.Severity string Severity of Malop
Cybereason.Malops.MitreTechniques string List of Mitre Techniques involved in this Malop
Cybereason.Malops.Users string List of Users involved in this Malop
Cybereason.Malops.DetectionTypes string List of Detection Types involved in this Malop
Cybereason.Malops.DecisionStatuses string List of Decision Statuses involved in this Malop
Cybereason.Malops.DetectionEngines string List of Detection Engines involved in this Malop

Command example

!cybereason-query-malop-management malopGuid=<malop-guid>

Context Example

{
    "GUID": "malop-guid",
    "Link": "malop-url",
    "CreationTime": 1686720403740,
    "LastUpdateTime": 1686720403743,
    "Status": "Pending",
    "InvolvedHash": "involed-hash"
}

Base Command

cybereason_process_attack_tree_command

Input

Argument Name Description Required
malopGuid malopGuid of the Cybereason Malop Required

Context Output

Path Type Description
Cybereason.Process.ProcessID string Cybereason Process ID
Cybereason.Process.URL string Attack tree url for a given Process

Command example

!cybereason-process-attack-tree processGuid=<process-guid>

Context Example

{
    "Process": [
        {
        "ProcessID": "<process-id>",
        "URL": "<url>"
        },
        {
        "ProcessID": "<process-id>",
        "URL": "<url>"
        } 
    ]
}

cybereason-update-malop-investigation-status


Updates malop investigation status.

Base Command

cybereason-update-malop-investigation-status

Input

Argument Name Description Required
malopGuid Malop GUID to update its investigation status. Required
investigationStatus Investigation status to update. Possible values are: Pending, Reopened, Under Investigation, On Hold, Closed. Required

Context Output

Path Type Description
Cybereason.Malops.GUID string Malop GUID.
Cybereason.Malops.InvestigationStatus string Malop investigation status: Pending, Reopened, Under Investigation, On Hold, Closed.

Command example

!cybereason-update-malop-investigation-status malopGuid=<malop_guid> investigationStatus="Under Investigation"

Context Example

{
    "Cybereason": {
        "Malops": {
            "GUID": "<malop_guid>",
            "InvestigationStatus": "Under Investigation"
        }
    }
}

Human Readable Output

Successfully updated malop to investigation status "Under Investigation"!

Configuration parameters

  • server — Server URL (e.g. https://192.168.0.1) (required)
  • credentials — Credentials
  • unsecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • isFetch — Fetch incidents
  • incidentType — Incident type
  • incidentFetchInterval — Incidents Fetch Interval
  • fetch_time — First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year)
  • fetch_by — Fetch by "MALOP UPDATE TIME" (Fetching by Malop creation time is no longer supported)
  • enable_epp_poll — Check this box to Enable Polling for Cybereason EPP Malops.

Commands (37)

  • cybereason-add-comment

    Add new comment to malop.

  • cybereason-archive-sensor

    Archives a Sensor.

  • cybereason-available-remediation-actions

    Get all remediation action details whatever available for that malop.

  • cybereason-block-file

    Block a file only in particular machine. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-close-file-batch-id

    Aborts a file download operation that is in progress.

  • cybereason-delete-registry-key

    Delete a registry entry associated with a malicious process. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-delete-sensor

    Deletes a Sensor.

  • cybereason-download-file

    Downloads the actual file to the machine.

  • cybereason-fetch-scan-status

    Get the results for host scanning.

  • cybereason-fetchfile-progress

    Return a batch id for files waiting for download.

  • cybereason-get-machine-details

    Get the Machine FQDN and Machine Group Details.

  • cybereason-get-sensor-id

    Get the Sensor ID of a machine.

  • cybereason-is-probe-connected

    Checks if the machine is currently connected to the Cybereason server.

  • cybereason-isolate-machine

    Isolates a machine that has been infected from the rest of the network.

  • cybereason-kill-prevent-unsuspend

    Prevent detected ransomware from running on the machine. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-kill-process

    Kill a processes for the malicious file. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-malop-processes

    Returns a list of malops.

  • cybereason-malware-query

    Malware query with options and values to filter.

  • cybereason-prevent-file

    Prevent malop process file.

  • cybereason-process-attack-tree

    Get Process Attack Tree URL.

  • cybereason-quarantine-file

    Quarantine the detected malicious file in a secure location. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-query-connections

    Searches for connections.

  • cybereason-query-domain

    Query domains as part of investigation.

  • cybereason-query-file

    Query files as part of investigation.

  • cybereason-query-malop-management

    Get Management Malop details.

  • cybereason-query-malops

    Returns a list of all Malops and details on the Malops.

  • cybereason-query-processes

    Searches for processes with various filters.

  • cybereason-query-user

    Query users as part of investigation.

  • cybereason-start-fetchfile

    Start fetching the file to download.

  • cybereason-start-host-scan

    Start or stop a full or quick scan for a host.

  • cybereason-unarchive-sensor

    Unarchives a Sensor.

  • cybereason-unisolate-machine

    Stops isolation of a machine.

  • cybereason-unprevent-file

    Unprevent malop process file.

  • cybereason-unquarantine-file

    Unquarantine the detected malicious file in a secure location. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-unsuspend-process

    Prevent a file associated with ransomware. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).

  • cybereason-update-malop-investigation-status

    Updates malop investigation status.

  • cybereason-update-malop-status

    Updates malop status.

category: Endpoint
provider: LevelBlue
commonfields:
  id: Cybereason
  version: -1
configuration:
- display: Server URL (e.g. https://192.168.0.1)
  name: server
  required: true
  type: 0
  section: Connect
- display: Credentials
  name: credentials
  type: 9
  required: false
  section: Connect
- display: Trust any certificate (not secure)
  name: unsecure
  type: 8
  required: false
  section: Connect
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
  section: Connect
- display: Fetch incidents
  name: isFetch
  type: 8
  required: false
  section: Collect
  supportedModules:
  - agentix
  - xsiam
- display: Incident type
  name: incidentType
  type: 13
  required: false
  section: Collect
  supportedModules:
  - agentix
  - xsiam
- display: Incidents Fetch Interval
  name: incidentFetchInterval
  defaultvalue: '1'
  required: false
  type: 19
  section: Collect
  advanced: true
  supportedModules:
  - agentix
  - xsiam
- defaultvalue: 3 days
  display: First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year)
  name: fetch_time
  type: 0
  required: false
  section: Collect
- defaultvalue: MALOP UPDATE TIME
  display: Fetch by "MALOP UPDATE TIME" (Fetching by Malop creation time is no longer supported)
  name: fetch_by
  type: 0
  required: false
  section: Collect
- defaultvalue: "false"
  display: Check this box to Enable Polling for Cybereason EPP Malops.
  name: enable_epp_poll
  type: 8
  required: false
  section: Collect
description: Endpoint detection and response to manage and query malops, connections and processes.
display: Cybereason
name: Cybereason
script:
  commands:
  - arguments:
    - description: The hostname of the machine.
      name: machineName
      required: true
    - name: page
      description: The page number of machine records to retrieve (used for pagination) starting from 1. The page size is defined by the "pageSize" argument.
    - name: pageSize
      description: The number of machine records per page to retrieve (used for pagination). The page number is defined by the "page" argument.
    - name: limit
      description: The maximum number of records to retrieve. If "pageSize" is defined, this argument is ignored.
      defaultValue: '50'
    description: Get the Machine FQDN and Machine Group Details.
    name: cybereason-get-machine-details
    outputs:
    - contextPath: Cybereason.Sensor.MachineID
      description: Sensor ID of machine.
      type: string
    - contextPath: Cybereason.Sensor.MachineName
      description: Host name of machine.
      type: string
    - contextPath: Cybereason.Sensor.MachineFQDN
      description: FQDN of machine.
      type: string
    - contextPath: Cybereason.Sensor.GroupID
      description: Group ID of machine.
      type: string
    - contextPath: Cybereason.Sensor.GroupName
      description: Group Name of machine.
      type: string
  - arguments:
    - description: Sensor ID of Cybereason Sensor.
      name: sensorID
      required: true
    - description: Reason for Archiving Cybereason Sensor.
      name: archiveReason
      required: true
    description: Archives a Sensor.
    name: cybereason-archive-sensor
  - arguments:
    - description: Sensor ID of Cybereason Sensor.
      name: sensorID
      required: true
    - description: Reason for Unarchiving Cybereason Sensor.
      name: unarchiveReason
      required: true
    description: Unarchives a Sensor.
    name: cybereason-unarchive-sensor
  - arguments:
    - description: Sensor ID of Cybereason Sensor.
      name: sensorID
      required: true
    description: Deletes a Sensor.
    name: cybereason-delete-sensor
  - arguments:
    - description: The hostname of the machine.
      name: machine
    - auto: PREDEFINED
      defaultValue: "false"
      description: Show only suspicious processes.
      name: onlySuspicious
      predefined:
      - "true"
      - "false"
    - defaultValue: "10000"
      description: Maximum number of results to retrieve.
      name: limit
    - description: Process name to filter by.
      name: processName
    - auto: PREDEFINED
      defaultValue: "false"
      description: If true, save the result to the context.
      name: saveToContext
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      defaultValue: "false"
      description: Filter only processes with incoming connections.
      name: hasIncomingConnection
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      defaultValue: "false"
      description: Filter only processes with outgoing connections.
      name: hasOutgoingConnection
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      description: If process has external connection.
      name: hasExternalConnection
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      description: If process is not known to reputation services and its image file is unsigned.
      name: unsignedUnknownReputation
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      description: If process is running from temporary folder.
      name: fromTemporaryFolder
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      description: If process was identified elevating its privileges to local system user.
      name: privilegesEscalation
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      description: If the process was executed by PsExec service and is suspicious as being executed maliciously.
      name: maliciousPsExec
      predefined:
      - "true"
      - "false"
    description: Searches for processes with various filters.
    name: cybereason-query-processes
    outputs:
    - contextPath: Cybereason.Process.Name
      description: The process name.
      type: Unknown
    - contextPath: Cybereason.Process.Malicious
      description: Malicious status of the process.
      type: Unknown
    - contextPath: Cybereason.Process.CreationTime
      description: The process creation time.
      type: Unknown
    - contextPath: Cybereason.Process.EndTime
      description: The process end time.
      type: Unknown
    - contextPath: Cybereason.Process.CommandLine
      description: The command line of the process.
      type: Unknown
    - contextPath: Cybereason.Process.SignedAndVerified
      description: Is the process signed and verified.
      type: Unknown
    - contextPath: Cybereason.Process.ProductType
      description: The product type.
      type: Unknown
    - contextPath: Cybereason.Process.Children
      description: Children of the process.
      type: Unknown
    - contextPath: Cybereason.Process.Parent
      description: The parent process.
      type: Unknown
    - contextPath: Cybereason.Process.OwnerMachine
      description: The machine's hostname.
      type: Unknown
    - contextPath: Cybereason.Process.User
      description: The user who ran the process.
      type: Unknown
    - contextPath: Cybereason.Process.ImageFile
      description: Image file of the process.
      type: Unknown
    - contextPath: Cybereason.Process.SHA1
      description: SHA1 of the process file.
      type: Unknown
    - contextPath: Cybereason.Process.MD5
      description: MD5 of the process file.
      type: Unknown
    - contextPath: Cybereason.Process.CompanyName
      description: The company's name.
      type: Unknown
    - contextPath: Cybereason.Process.ProductName
      description: The product's name.
      type: Unknown
  - arguments:
    - description: The hostname of the machine to check.
      name: machine
      required: true
    description: Checks if the machine is currently connected to the Cybereason server.
    name: cybereason-is-probe-connected
    outputs:
    - contextPath: Cybereason.Machine.isConnected
      description: true if machine is connected, else false.
      type: boolean
    - contextPath: Cybereason.Machine.Name
      description: Machine name.
      type: string
  - arguments:
    - description: Filter connections which contain this IP (in or out).
      name: ip
    - description: Filter connections on the given machine.
      name: machine
    - description: If true, save the result to the context.
      name: saveToContext
      auto: PREDEFINED
      defaultValue: "false"
      predefined:
      - "true"
      - "false"
    description: Searches for connections.
    name: cybereason-query-connections
    outputs:
    - contextPath: Cybereason.Connection.Name
      description: The connection's name.
      type: Unknown
    - contextPath: Cybereason.Connection.Direction
      description: OUTGOING/INCOMING.
      type: Unknown
    - contextPath: Cybereason.Connection.ServerAddress
      description: Address of the Cybereason machine.
      type: Unknown
    - contextPath: Cybereason.Connection.ServerPort
      description: Port of the Cybereason machine.
      type: Unknown
    - contextPath: Cybereason.Connection.PortType
      description: Type of the connection.
      type: Unknown
    - contextPath: Cybereason.Connection.ReceivedBytes
      description: Received bytes count.
      type: Unknown
    - contextPath: Cybereason.Connection.TransmittedBytes
      description: Transmitted bytes count.
      type: Unknown
    - contextPath: Cybereason.Connection.RemoteCountry
      description: The connection's remote country.
      type: Unknown
    - contextPath: Cybereason.Connection.OwnerMachine
      description: The machine's hostname.
      type: Unknown
    - contextPath: Cybereason.Connection.OwnerProcess
      description: The process which performed the connection.
      type: Unknown
    - contextPath: Cybereason.Connection.CreationTime
      description: Creation time of the connection.
      type: Unknown
    - contextPath: Cybereason.Connection.EndTime
      description: End time of the connection.
      type: Unknown
  - arguments:
    - default: true
      description: Machine name to be isolated.
      name: machine
      required: true
    description: Isolates a machine that has been infected from the rest of the network.
    execution: true
    name: cybereason-isolate-machine
    outputs:
    - contextPath: Cybereason.Machine
      description: Machine name.
      type: string
    - contextPath: Cybereason.IsIsolated
      description: Is the machine isolated.
      type: boolean
  - arguments:
    - description: Machine name to be un-isolated.
      name: machine
      default: true
      required: true
    description: Stops isolation of a machine.
    name: cybereason-unisolate-machine
    outputs:
    - contextPath: Cybereason.Machine
      description: Machine name.
      type: string
    - contextPath: Cybereason.IsIsolated
      description: Is the machine isolated.
      type: boolean
    execution: true
  - arguments:
    - description: Filter to filter response by, given in Cybereason API syntax.
      name: filters
    - description: The total number of results to return for your Server. Ensure you make the limit a reasonable number to maximize Server performance and not to overload the system.
      name: totalResultLimit
    - description: The number of items to return per Malop group.
      name: perGroupLimit
    - auto: PREDEFINED
      defaultValue: MALOP
      description: "The level of detail to provide in the response. Possible values include:  SPECIFIC:  References value contain only the count in the ElementValues class. The Suspicions map is calculated for each results, with the suspicion name and the first time the suspicion appeared. The Evidence map is not calculated for the results. CUSTOM:  Reference values contain the specific Elements, up to the limit defined in the perFeatureLimit parameter. The Suspicions map is not calculated for the results. The Evidence map is not calculated for the results. DETAILS:  Reference values contain the specific Elements, up to the limit defined in the perFeatureLimit parameter. The Suspicions map is calculated for each result, containing the suspicion name and the first time the suspicion appeared. The Evidence map is not calculated for the results."
      name: templateContext
      predefined:
      - MALOP
      - SPECIFIC
      - CUSTOM
      - DETAILS
      - OVERVIEW
    - description: Return all the malops within the last days.
      name: withinLastDays
    - description: Malop GUIDs to filter by (Comma separated values supported, e.g. 11.5681864988155542407,11.1773255057963879999).
      name: malopGuid
    description: Returns a list of all Malops and details on the Malops.
    name: cybereason-query-malops
    outputs:
    - contextPath: Cybereason.Malops.GUID
      description: The unique globally unique identifier (guid) for the Malop.
      type: string
    - contextPath: Cybereason.Malops.CreationTime
      description: The time reported as when the malicious behavior began on the system. This is not the time that the Malop was first detected by Cybereason.
      type: string
    - contextPath: Cybereason.Malops.DecisionFeature
      description: The reason that Cybereason has raised the Malop.
      type: string
    - contextPath: Cybereason.Malops.Link
      description: Link to the Malop on Cybereason.
      type: string
    - contextPath: Cybereason.Malops.Suspects
      description: Malop suspect type and name.
      type: string
    - contextPath: Cybereason.Malops.LastUpdatedTime
      description: Last updated time of malop.
      type: string
    - contextPath: Cybereason.Malops.AffectedMachine
      description: List of machines affected by this Malop.
      type: string
    - contextPath: Cybereason.Malops.InvolvedHash
      description: List of file hashes involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.Status
      description: Malop managemant status.
      type: string
  - arguments:
    - description: malopGuid of the Cybereason Malop.
      name: malopGuid
      required: true
    description: Get Management Malop details.
    name: cybereason-query-malop-management
    outputs:
    - contextPath: Cybereason.Malops.GUID
      description: The unique globally unique identifier (guid) for the Malop.
      type: string
    - contextPath: Cybereason.Malops.CreationTime
      description: The time reported as when the malicious behavior began on the system. This is not the time that the Malop was first detected by Cybereason.
      type: string
    - contextPath: Cybereason.Malops.Link
      description: Link to the Malop on Cybereason.
      type: string
    - contextPath: Cybereason.Malops.LastUpdatedTime
      description: Last updated time of malop.
      type: string
    - contextPath: Cybereason.Malops.InvolvedHash
      description: List of file hashes involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.Status
      description: Malop managemant status.
      type: string
    - contextPath: Cybereason.Malops.Severity
      description: Severity of Malop.
      type: string
    - contextPath: Cybereason.Malops.Machines
      description: List of Machines involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.Users
      description: List of Users involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.DecisionStatuses
      description: List of Decision Statuses involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.DetectionTypes
      description: List of Detection Types involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.DetectionEngines
      description: List of Detection Engines involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.MitreTechniques
      description: List of Mitre Techniques involved in this Malop.
      type: string
    - contextPath: Cybereason.Malops.MalopCloserName
      description: List of Malop Closer Name involved in this Malop.
      type: string
  - arguments:
    - description: processGuid of the Cybereason Malop (can accept multiple guids separated by comma).
      name: processGuid
      required: true
    description: Get Process Attack Tree URL.
    name: cybereason-process-attack-tree
    outputs:
    - contextPath: Cybereason.Process.ProcessID
      description: Cybereason Process ID.
      type: string
    - contextPath: Cybereason.Process.URL
      description: Attack tree url for a given Process.
      type: string
  - arguments:
    - description: Array of malop GUIDs separated by comma. (Malop GUID can be retrieved with the command cybereason-query-malops command).
      name: malopGuids
      required: true
    - description: Machine names which were affected by malop. Comma separated values supported (e.g., machine1,machine2).
      name: machineName
    - description: Starting Date and Time to filter the Processes based on their creation date. The format for the input is ("YYYY/MM/DD HH:MM:SS").
      name: dateTime
    description: Returns a list of malops.
    name: cybereason-malop-processes
    outputs:
    - contextPath: Cybereason.Process.Name
      description: The process name.
      type: string
    - contextPath: Cybereason.Process.Malicious
      description: Malicious status of the process.
      type: Unknown
    - contextPath: Cybereason.Process.CreationTime
      description: The process creation time.
      type: date
    - contextPath: Cybereason.Process.EndTime
      description: The process end time.
      type: date
    - contextPath: Cybereason.Process.CommandLine
      description: The command line of the process.
      type: string
    - contextPath: Cybereason.Process.SignedAndVerified
      description: Is the process signed and verified.
      type: Unknown
    - contextPath: Cybereason.Process.ProductType
      description: The product type.
      type: Unknown
    - contextPath: Cybereason.Process.Children
      description: Children of the process.
      type: Unknown
    - contextPath: Cybereason.Process.Parent
      description: The parent process.
      type: Unknown
    - contextPath: Cybereason.Process.OwnerMachine
      description: The machine's hostname.
      type: Unknown
    - contextPath: Cybereason.Process.User
      description: The user who ran the process.
      type: string
    - contextPath: Cybereason.Process.ImageFile
      description: Image file of the process.
      type: Unknown
    - contextPath: Cybereason.Process.SHA1
      description: SHA1 of the process file.
      type: string
    - contextPath: Cybereason.Process.MD5
      description: MD5 of the process file.
      type: string
    - contextPath: Cybereason.Process.CompanyName
      description: The company's name.
      type: string
    - contextPath: Cybereason.Process.ProductName
      description: The product's name.
      type: string
  - arguments:
    - description: Comment to add to the malop.
      name: comment
      required: true
    - description: Malop GUID to add comment to. (Malop GUID can be retrieved with the command cybereason-query-malops command).
      name: malopGuid
      required: true
    description: Add new comment to malop.
    name: cybereason-add-comment
  - arguments:
    - description: Malop GUID to update its status.
      name: malopGuid
      required: true
    - auto: PREDEFINED
      description: Status to update.
      name: status
      predefined:
      - To Review
      - Unread
      - Remediated
      - Not Relevant
      - Open
      required: true
    description: Updates malop status.
    name: cybereason-update-malop-status
    outputs:
    - contextPath: Cybereason.Malops.GUID
      description: Malop GUID.
      type: string
    - contextPath: Cybereason.Malops.Status
      description: "Malop status: To Review,Unread,Remediated,Not Relevant."
      type: string
  - arguments:
    - description: Malop GUID to update its investigation status.
      name: malopGuid
      required: true
    - auto: PREDEFINED
      description: Investigation status to update.
      name: investigationStatus
      predefined:
      - Pending
      - Reopened
      - Under Investigation
      - On Hold
      - Closed
      required: true
    description: Updates malop investigation status.
    name: cybereason-update-malop-investigation-status
    outputs:
    - contextPath: Cybereason.Malops.GUID
      description: Malop GUID.
      type: string
    - contextPath: Cybereason.Malops.InvestigationStatus
      description: "Malop investigation status: Pending, Reopened, Under Investigation, On Hold, Closed."
      type: string
  - arguments:
    - default: true
      description: Malop process file MD5 to prevent.
      name: md5
      required: true
    description: Prevent malop process file.
    name: cybereason-prevent-file
    outputs:
    - contextPath: Cybereason.Process.MD5
      description: Process file MD5.
      type: string
    - contextPath: Cybereason.Process.Prevent
      description: True if process file is prevented, else false.
      type: boolean
  - arguments:
    - default: true
      description: Malop process file MD5 to unprevent.
      name: md5
      required: true
    description: Unprevent malop process file.
    name: cybereason-unprevent-file
    outputs:
    - contextPath: Cybereason.Process.MD5
      description: Process file MD5.
      type: string
    - contextPath: Cybereason.Process.Prevent
      description: True if process file is prevented, else false.
      type: boolean
  - arguments:
    - default: true
      description: File hash (SHA-1 and MD5 supported).
      name: file_hash
      required: true
    description: Query files as part of investigation.
    name: cybereason-query-file
    outputs:
    - contextPath: Cybereason.File.Path
      description: File path.
      type: string
    - contextPath: Cybereason.File.SHA1
      description: File SHA-1 hash.
      type: string
    - contextPath: Cybereason.File.Machine
      description: Machine name on which file is located.
      type: string
    - contextPath: Cybereason.File.SuspicionsCount
      description: File suspicions count.
      type: number
    - contextPath: Cybereason.File.Name
      description: File name.
      type: string
    - contextPath: Cybereason.File.CreationTime
      description: File creation time.
      type: date
    - contextPath: Cybereason.File.Suspicion
      description: File suspicions object of suspicion as key and detected date as value.
      type: string
    - contextPath: Cybereason.File.OSVersion
      description: Machine OS version on which file is located.
      type: string
    - contextPath: Cybereason.File.ModifiedTime
      description: File modified date.
      type: date
    - contextPath: Cybereason.File.Malicious
      description: Is file malicious.
      type: boolean
    - contextPath: Cybereason.File.Company
      description: Company name.
      type: string
    - contextPath: Cybereason.File.MD5
      description: File MD5 hash.
      type: string
    - contextPath: Cybereason.File.IsConnected
      description: Is machine connected to Cybereason.
      type: boolean
    - contextPath: Cybereason.File.Signed
      description: Is file signed.
      type: boolean
    - contextPath: Cybereason.File.Evidence
      description: File evidences.
      type: string
  - arguments:
    - description: Domain to query.
      name: domain
      required: true
      default: true
    description: Query domains as part of investigation.
    name: cybereason-query-domain
    outputs:
    - contextPath: Cybereason.Domain.Name
      description: Domain name.
      type: string
    - contextPath: Cybereason.Domain.Malicious
      description: Is domain malicious.
      type: boolean
    - contextPath: Cybereason.Domain.IsInternalDomain
      description: Is domain internal.
      type: boolean
    - contextPath: Cybereason.Domain.Reputation
      description: Domain reputation.
      type: string
    - contextPath: Cybereason.Domain.SuspicionsCount
      description: Domain suspicions count.
      type: number
    - contextPath: Cybereason.Domain.WasEverResolved
      description: Was domain ever resolved.
      type: boolean
    - contextPath: Cybereason.Domain.WasEverResolvedAsASecondLevelDomain
      description: Was domain ever resolved as a second level domain.
      type: boolean
  - arguments:
    - description: Username to query.
      name: username
      required: true
      default: true
    description: Query users as part of investigation.
    name: cybereason-query-user
    outputs:
    - contextPath: Cybereason.User.Username
      description: User name.
      type: string
    - contextPath: Cybereason.User.Domain
      description: User domain.
      type: string
    - contextPath: Cybereason.User.LastMachineLoggedInTo
      description: Last machine which user logged in to.
      type: string
    - contextPath: Cybereason.User.LocalSystem
      description: Is local system.
      type: boolean
    - contextPath: Cybereason.User.Organization
      description: User organization.
      type: string
  - arguments:
    - description: Malop GUID for fetching a file from a sensor to download.
      name: malopGUID
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    description: Start fetching the file to download.
    name: cybereason-start-fetchfile
  - arguments:
    - default: true
      description: Malop GUID to know the progress for downloading a file.
      name: malopGuid
      required: true
    description: Return a batch id for files waiting for download.
    name: cybereason-fetchfile-progress
    outputs:
    - contextPath: Cybereason.Download.Progress.fileName
      description: Filename for tha given malop.
      type: string
    - contextPath: Cybereason.Download.Progress.status
      description: Status for batch ID.
      type: boolean
    - contextPath: Cybereason.Download.Progress.batchID
      description: Unique batch id.
      type: Unknown
  - arguments:
    - description: The batch id for the file download operation.
      name: batchID
      required: true
      default: true
    description: Downloads the actual file to the machine.
    name: cybereason-download-file
  - arguments:
    - description: The batch id to abort a file download operation.
      name: batchID
      required: true
      default: true
    description: Aborts a file download operation that is in progress.
    name: cybereason-close-file-batch-id
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    description: Get all remediation action details whatever available for that malop.
    name: cybereason-available-remediation-actions
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name to kill the process.
      name: machine
      required: true
    - description: Target ID to kill the process.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Kill a processes for the malicious file. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-kill-process
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name to quarantine a file.
      name: machine
      required: true
    - description: Target ID to quarantine a file.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Quarantine the detected malicious file in a secure location. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-quarantine-file
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name to unquarantine a file.
      name: machine
      required: true
    - description: Target ID to unquarantine a file.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Unquarantine the detected malicious file in a secure location. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-unquarantine-file
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name whose files needs to be blocked.
      name: machine
      required: true
    - description: Target ID of file to be blocked.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Block a file only in particular machine. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-block-file
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name to delete the registry key.
      name: machine
      required: true
    - description: Target ID to delete the registry key.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Delete a registry entry associated with a malicious process. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-delete-registry-key
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name to prevent detected ransomware from running on the machine.
      name: machine
      required: true
    - description: Target ID to prevent detected ransomware from running on the machine.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Prevent detected ransomware from running on the machine. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-kill-prevent-unsuspend
  - arguments:
    - description: The unique ID assigned by the Cybereason platform for the Malop.
      name: malopGuid
      required: true
    - description: Machine name to prevent a file associated with ransomware.
      name: machine
      required: true
    - description: Target ID to prevent a file associated with ransomware.
      name: targetId
      required: true
    - description: The complete Cybereason user name string for the user performing the request.
      name: userName
      required: true
    - description: Comment to add to the malop.
      name: comment
    description: Prevent a file associated with ransomware. (User will get inputs by executing the 'cybereason-available-remediation-actions' command if this remediation action is available for that Malop).
    name: cybereason-unsuspend-process
  - arguments:
    - description: Filter for Fetching Malwares by Malware needsAttention.
      name: needsAttention
      auto: PREDEFINED
      predefined:
      - "True"
      - "False"
    - description: Filter for Fetching Malwares by Malware Type. (Possible filter values for Type are "KnownMalware,UnknownMalware,FilelessMalware,ApplicationControlMalware,RansomwareMalware").
      name: type
    - description: Filter for Fetching Malwares by Malware Status. (Possible filter values for Status are "Done,Excluded,Detected,Prevented,Remediated,DeleteOnRestart,Quarantined").
      name: status
    - description: Filter for Fetching Malwares by Timestamp. Enter the time (in epoch).
      name: timestamp
    - description: Filter for Fetching Malwares by Malware Limit.
      name: limit
      required: true
    description: Malware query with options and values to filter.
    name: cybereason-malware-query
  - arguments:
    - description: Sensor ID of a sensor. (Comma separated values supported.)
      name: sensorID
      required: true
    - description: Select a method/type to scan a host.
      name: scanType
      required: true
      auto: PREDEFINED
      predefined:
      - FULL
      - QUICK
      - STOP
    description: Start or stop a full or quick scan for a host.
    name: cybereason-start-host-scan
  - arguments:
    - description: The batch ID obtained after initiating the scan.
      name: batchID
      default: true
      required: true
    description: Get the results for host scanning.
    name: cybereason-fetch-scan-status
  - arguments:
    - description: The hostname of the machine.
      name: machineName
    description: Get the Sensor ID of a machine.
    name: cybereason-get-sensor-id
  isfetch: true
  script: '-'
  type: python
  subtype: python3
  dockerimage: demisto/python3:3.12.13.10116658
tests:
- Cybereason Test
fromversion: 5.0.0
sectionorder:
- Connect
- Collect