Skip to main content

Check Point Harmony Endpoint

This Integration is part of the Check Point Harmony Endpoint Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.10.0 and later.

Checkpoint Harmony Endpoint provides a complete endpoint security solution built to protect organizations and the remote workforce from today's complex threat landscape. This integration was integrated and tested with version 1 of CheckPointHarmonyEndpoint.

Configure Check Point Harmony Endpoint on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for Check Point Harmony Endpoint.

  3. Click Add instance to create and configure a new integration instance.

    ParameterRequired
    Base URLTrue
    Client IDTrue
    Secret KeyTrue
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR 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.

harmony-ep-job-status-get#


Retrieves the status and result (if any) of a given asynchronous operation. A job is a way to monitor the progress of an asynchronous operation while avoiding issues that may manifest during long synchronous waits.

Base Command#

harmony-ep-job-status-get

Input#

Argument NameDescriptionRequired
job_idThe ID of the operation to query the status of. Job ID will returned from most of the commands in this integration. It can be found in the context path.Required

Context Output#

PathTypeDescription
HarmonyEP.Job.dataStringThe job data.
HarmonyEP.Job.statusStringThe job status.

Command example#

!harmony-ep-job-status-get23

Context Example#

{
"HarmonyEP": {
"Job": {
"data": {
"data": [
{
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"response": null,
"status": "DA_NOT_INSTALLED"
}
},
{
"machine": {
"id": "2",
"name": "DESKTOP-2"
},
"operation": {
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
],
"metadata": {
"count": 2,
"from": 0,
"to": 100
}
},
"status": "DONE",
"statusCode": 200,
"statusType": 2
}
}
}

Human Readable Output#

Results#

datastatusstatusCodestatusType
data: {'machine': {'id': '1', 'name': 'DESKTOP-1'}, 'operation': {'response': None, 'status': 'DA_NOT_INSTALLED'}},
{'machine': {'id': '2', 'name': 'DESKTOP-2'}, 'operation': {'response': None, 'status': 'DA_NOT_INSTALLED'}}
metadata: {"from": 0, "to": 100, "count": 2}
DONE2002

harmony-ep-ioc-list#


Gets a list of all Indicators of Compromise. Use the filter parameters to fetch specific IOCs.

Base Command#

harmony-ep-ioc-list

Input#

Argument NameDescriptionRequired
filterThe indicator value or comment to search for. The filter is case-insensitive. For example, filter 'efg will match IoCs 'abcdEFG', 'efGGG', and 'yEfG'.Optional
fieldThe Indicator of Compromise field to search by. Possible values are: iocValue, iocComment. Default is iocValue.Optional
sort_directionThe way to sort the results. Possible values are: ASC, DESC. Default is DESC.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional

Context Output#

PathTypeDescription
HarmonyEP.IOC.commentStringThe IOC comment.
HarmonyEP.IOC.modifiedOnNumberThe time the IOC was modified.
HarmonyEP.IOC.valueStringThe IOC value.
HarmonyEP.IOC.typeStringThe IOC type.
HarmonyEP.IOC.idStringThe IOC ID.

Command example#

!harmony-ep-ioc-list

Context Example#

{
"HarmonyEP": {
"IOC": [
{
"comment": "test",
"id": "3",
"modifiedOn": "2024-04-03T09:15:04.182Z",
"type": "Domain",
"value": "test2.com"
},
{
"comment": "comment",
"id": "4",
"modifiedOn": "2024-05-20T13:14:28.290Z",
"type": "Domain",
"value": "test1.com"
}
]
}
}

Human Readable Output#

IOC List:#

Showing page 1. Current page size: 50. |Id|Type|Value|Comment|Modifiedon| |---|---|---|---|---| | 3 | Domain | test2.com | test | 2024-04-03T09:15:04.182Z | | 4 | Domain | test1.com | comment | 2024-05-20T13:14:28.290Z |

harmony-ep-ioc-update#


Updates the given Indicators of Compromise with the given parameters.

Base Command#

harmony-ep-ioc-update

Input#

Argument NameDescriptionRequired
ioc_idThe ID of the IOC to update. Use harmony-ep-ioc-list command to get all IOC IDs.Required
commentThe IOC comment to update.Required
valueThe IOC value to update.Required
typeThe IOC type to update. Possible values are: Domain, IP, URL, MD5, SHA1.Required

Context Output#

PathTypeDescription
HarmonyEP.IOC.commentStringThe IOC comment.
HarmonyEP.IOC.modifiedOnNumberThe time the IOC was modified.
HarmonyEP.IOC.valueStringThe IOC value.
HarmonyEP.IOC.typeStringThe IOC type.
HarmonyEP.IOC.idStringThe IOC ID.

Command example#

!harmony-ep-ioc-update ioc_id=8 comment=test value=8.8.8.8 type=IP

Context Example#

{
"HarmonyEP": {
"IOC": {
"comment": "test",
"id": "8",
"modifiedOn": "2024-06-24T06:44:49.214Z",
"type": "IP",
"value": "8.8.8.8"
}
}
}

Human Readable Output#

IOC 8 was updated successfully.#

IdTypeValueCommentModifiedon
8IP8.8.8.8test2024-06-24T06:44:49.214Z

harmony-ep-ioc-create#


Creates new Indicators of Compromise using the given parameters.

Base Command#

harmony-ep-ioc-create

Input#

Argument NameDescriptionRequired
commentThe IOC comment.Required
valueThe IOC value. For example, 8.8.8.8 for IP or example.com for Domain.Required
typeThe IOC type. Possible values are: Domain, IP, URL, MD5, SHA1.Required

Context Output#

There is no context output for this command.

Command example#

!harmony-ep-ioc-create comment=test value=1.1.1.2 type=IP

Human Readable Output#

IOC was created successfully.

harmony-ep-ioc-delete#


Deletes the given Indicators of Compromise by their ID.

Base Command#

harmony-ep-ioc-delete

Input#

Argument NameDescriptionRequired
idsA A comma-separated list of list of IOC IDs to delete. Use harmony-ep-ioc-list command to get all IOC IDs.Optional
delete_allWhether to delete all IOCs. This action permanently deletes all Indicators of Compromise and cannot be undone. Possible values are: true, false. Default is false.Optional

Context Output#

There is no context output for this command.

Command example#

!harmony-ep-ioc-delete ids=7

Human Readable Output#

IOCs 7 was deleted successfully.

harmony-ep-policy-rule-assignments-get#


Gets all entities directly assigned to the given rule.

Base Command#

harmony-ep-policy-rule-assignments-get

Input#

Argument NameDescriptionRequired
rule_idThe ID of the rule to get the assignments. Use harmony-ep-rule-metadata-list command to get all rule IDs.Required

Context Output#

PathTypeDescription
HarmonyEP.Rule.Assignments.typeStringThe rule assignment type.
HarmonyEP.Rule.Assignments.nameStringThe rule assignment name.
HarmonyEP.Rule.Assignments.idStringThe rule assignment ID.

Command example#

!harmony-ep-policy-rule-assignments-get rule_id=1a2b

Context Example#

{
"HarmonyEP": {
"Rule": {
"assignments": [
{
"id": "456",
"name": "ChromeOsLaptops",
"type": "VIRTUAL_GROUP"
}
],
"id": "1a2b"
}
}
}

Human Readable Output#

Rule 1a2b assignments:#

IdNameType
456ChromeOsLaptopsVIRTUAL_GROUP

harmony-ep-policy-rule-assignments-add#


Assigns the specified entities to the given rule. Specified IDs that are already assigned to the rule are ignored.

Base Command#

harmony-ep-policy-rule-assignments-add

Input#

Argument NameDescriptionRequired
rule_idThe ID of the rule to add assignments to. Use harmony-ep-rule-metadata-list command to get all rule IDs.Required
entities_idsThe entity IDs to assign.Required

Context Output#

There is no context output for this command.

Command example#

!harmony-ep-policy-rule-assignments-add rule_id=1a2b entities_ids=000

Human Readable Output#

Entities ['000'] were assigned to rule 1a2b successfully.

harmony-ep-policy-rule-assignments-remove#


Removes the specified entities from the given rule's assignments. Specified IDs that are not assigned to the rule are ignored.

Base Command#

harmony-ep-policy-rule-assignments-remove

Input#

Argument NameDescriptionRequired
rule_idThe ID of the rule to remove assignments from. Use harmony-ep-rule-metadata-list command to get all rule IDs.Required
entities_idsThe entity IDs to remove.Required

Context Output#

There is no context output for this command.

Command example#

!harmony-ep-policy-rule-assignments-remove rule_id=1a2b entities_ids=000

Human Readable Output#

Entities ['000'] were removed from rule 1a2b successfully.

harmony-ep-policy-rule-install#


Installs all policies.

Base Command#

harmony-ep-policy-rule-install

Input#

Argument NameDescriptionRequired
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.PolicyRuleInstall.job_idStringThe job ID of the policy installation.

Command example#

!harmony-ep-policy-rule-install job_id=976

Context Example#

{
"HarmonyEP": {
"PolicyRuleInstall": {
"job_id": "976"
}
}
}

Human Readable Output#

Policy was installed successfully.#

Job ID: 976 No entries.

harmony-ep-policy-rule-modifications-get#


Gets information on modifications to a given rule. (Modifications are the additions or removal of assignments on a rule since it was last installed).

Base Command#

harmony-ep-policy-rule-modifications-get

Input#

Argument NameDescriptionRequired
rule_idThe ID of the rule to get the modifications of. Use harmony-ep-rule-metadata-list command to get all rule IDs.Required
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.Rule.job_idStringThe job ID of the remediation operation.
HarmonyEP.Rule.orderNumberRule order.
HarmonyEP.Rule.isDefaultRuleBooleanWhether or not the rule is the default.
HarmonyEP.Rule.familyStringA family in the rule-base (legacy and unified).
HarmonyEP.Rule.connectionStateStringRule connection state.
HarmonyEP.Rule.commentStringRule comment.
HarmonyEP.Rule.assignments.typeStringRule assignments type.
HarmonyEP.Rule.assignments.nameStringRule assignments name.
HarmonyEP.Rule.assignments.idStringRule assignments ID.
HarmonyEP.Rule.nameStringRule name.
HarmonyEP.Rule.idStringRule ID.
HarmonyEP.Rule.orientationStringRule policy orientation.

Command example#

!harmony-ep-policy-rule-modifications-get rule_id=1a2b job_id=999

Context Example#

{
"HarmonyEP": {
"Rule": {
"connectionState": "CONNECTED",
"family": "Access",
"id": "1a2b",
"job_id": "999",
"lastModifiedBy": "talg",
"lastModifiedOn": {
"iso-8601": "2024-06-24T09:04:43.000Z",
"posix": 1719219883000
},
"modified": {
"assignments": {
"modified": false
},
"order": {
"modified": false
},
"settings": {
"modified": true
}
},
"name": "New Rule 1"
}
}
}

Human Readable Output#

Rule 1a2b modification:#

Job ID: 999 |Id|Name|Family|Connectionstate|Lastmodifiedby|Job Id| |---|---|---|---|---|---| | 1a2b | New Rule 1 | Access | CONNECTED | talg | 999 |

harmony-ep-policy-rule-metadata-list#


Gets the metadata of all rules or the given rule's metadata. (Metadata refers to all information relating to the rule except it's actual settings).

Base Command#

harmony-ep-policy-rule-metadata-list

Input#

Argument NameDescriptionRequired
rule_idThe ID of the rule to get the metadata.Optional
rule_familyAn optional 'Rule Family' filter. Used to filter the results to only the selected rule family (e.g., only 'Threat Prevention'). Possible values are: General Settings, Threat Prevention, Data Protection, OneCheck, Deployment, Remote Access VPN, Capsule Docs, Access, Agent Settings.Optional
connection_stateAn optional 'Connection State' filter. Used to filter the results to only the selected Connection State (e.g., only rules pertaining to policies for connected clients). Possible values are: CONNECTED, DISCONNECTED, RESTRICTED.Optional
limitThe maximum number of IP lists to return. Default is 50.Optional
all_resultsWhether to return all of the results or not. Possible values are: true, false. Default is false.Optional

Context Output#

PathTypeDescription
HarmonyEP.Rule.orderNumberRule order.
HarmonyEP.Rule.isDefaultRuleBooleanWhether or not the rule is the default.
HarmonyEP.Rule.familyStringA family in the rule-base (legacy and unified).
HarmonyEP.Rule.connectionStateStringRule connection state.
HarmonyEP.Rule.commentStringRule comment.
HarmonyEP.Rule.assignments.typeStringRule assignments type.
HarmonyEP.Rule.assignments.nameStringRule assignments name.
HarmonyEP.Rule.assignments.idStringRule assignments ID.
HarmonyEP.Rule.nameStringRule name.
HarmonyEP.Rule.idStringRule ID.
HarmonyEP.Rule.orientationStringRule policy orientation.

Command example#

!harmony-ep-policy-rule-metadata-list rule_id=1a2b

Context Example#

{
"HarmonyEP": {
"Rule": {
"assignments": [
{
"id": "000",
"name": "Entire Organization",
"type": "ORGANIZATION_ROOT"
},
{
"id": "456",
"name": "ChromeOsLaptops",
"type": "VIRTUAL_GROUP"
}
],
"comment": "",
"connectionState": "CONNECTED",
"family": "Threat Prevention",
"id": "1a2b",
"isDefaultRule": true,
"name": "TalTest",
"order": 2,
"orientation": "DEVICE"
}
}
}

Human Readable Output#

Rule 1a2b metadata:#

IdNameFamilyCommentOrientationConnectionstateAssignments
1a2bTalTestThreat PreventionDEVICECONNECTED{'id': '000', 'name': 'Entire Organization', 'type': 'ORGANIZATION_ROOT'},
{'id': '456', 'name': 'ChromeOsLaptops', 'type': 'VIRTUAL_GROUP'}

harmony-ep-push-operation-status-list#


Gets the current statuses of all remediation operations or if a specific ID is specified, retrieve the current status of the given remediation operation.

Base Command#

harmony-ep-push-operation-status-list

Input#

Argument NameDescriptionRequired
remediation_operation_idRemediation operations ID.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.PushOperation.adminNameStringThe name of the administrator who initiated the operation.
HarmonyEP.PushOperation.abortedBooleanIndicated whether the operation was aborted by an administrator.
HarmonyEP.PushOperation.remainingTimeoutSecondsNumberThe amount of time, in seconds, the operation will remain active. When elapsed, no more entities will be affected.
HarmonyEP.PushOperation.createdOnDateThe date and time the operation was created.
HarmonyEP.PushOperation.typeStringRemediation operation type.
HarmonyEP.PushOperation.commentStringA comment that was provided during the operation's creation.
HarmonyEP.PushOperation.idStringThe operation's ID.
HarmonyEP.PushOperation.overallStatusStringRemediation operation status.
HarmonyEP.PushOperation.numberOfAffectedEntitiesNumberThe total number of entities affected by the operation.

Command example#

!harmony-ep-push-operation-status-list remediation_operation_id=4d

Context Example#

{
"HarmonyEP": {
"PushOperation": {
"aborted": true,
"adminName": "talg",
"createdOn": "2024-06-20T10:58:19.407Z",
"id": "d45",
"job_id": "3",
"numberOfAffectedEntities": 6,
"operationParameters": {
"allowPostpone": false,
"informUser": true,
"originalTimeoutSeconds": 86400,
"schedulingType": "IMMEDIATE"
},
"overallStatus": "ABORTED",
"remainingTimeoutSeconds": 0,
"type": "AM_SCAN"
}
}
}

Human Readable Output#

Push operations status list:#

Job ID: 3 |Id|Type|Createdon|Overallstatus| |---|---|---|---| | d45 | AM_SCAN | 2024-06-20T10:58:19.407Z | ABORTED |

harmony-ep-push-operation-get#


Gets the results of a given Remediation Operation. Remediation Operations may produce results such a Forensics Report or yield status updates such as an anti-malware scan progress.

Base Command#

harmony-ep-push-operation-get

Input#

Argument NameDescriptionRequired
remediation_operation_idRemediation operation ID. Use the harmony-ep-remediation-status-list command to get all remediation operation IDs.Required
filter_textOptional free text search in any of the potential response fields excluding "id". Can be used to search for specific results, devices or IPs, for example.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.PushOperation.response.statusStringPush operation response status.
HarmonyEP.PushOperation.response.outputStringPush operation response output.
HarmonyEP.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-push-operation-get remediation_operation_id=4d

Context Example#

{
"HarmonyEP": {
"PushOperation": [
{
"job_id": "6",
"machine": {
"id": "5s",
"name": "DESKTOP-M4OAKII"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}

Human Readable Output#

Push operations:#

Job ID: 6

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 5s | DESKTOP-M4OAKII | DA_NOT_INSTALLED |

harmony-ep-push-operation-abort#


Aborts the given remediation operation. Aborting an operation prevents it from being sent to further Harmony Endpoint Clients. Clients that have already received the operation are not affected.

Base Command#

harmony-ep-push-operation-abort

Input#

Argument NameDescriptionRequired
remediation_operation_idRemediation operation ID. Use the harmony-ep-remediation-status-list command to get all remediation operation IDs.Required
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.PushOperationAbort.job_idStringThe job ID of the remediation operation.

Command example#

!harmony-ep-push-operation-abort remediation_operation_id=93 job_id=976

Context Example#

{
"HarmonyEP": {
"PushOperationAbort": {
"job_id": "976"
}
}
}

Human Readable Output#

Remediation operation abort was added to the push operation list successfully.#

Job ID: 976 No entries.

harmony-ep-anti-malware-scan#


Performs an anti-malware scan on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-anti-malware-scan

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.AntiMalwareScan.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.AntiMalwareScan.PushOperation.idStringThe remediation operation ID.
HarmonyEP.AntiMalwareScan.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.AntiMalwareScan.PushOperation.response.statusStringPush operation response status.
HarmonyEP.AntiMalwareScan.PushOperation.response.outputStringPush operation response output.
HarmonyEP.AntiMalwareScan.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.AntiMalwareScan.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.AntiMalwareScan.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-anti-malware-scan computer_ids=1

Context Example#

{
"HarmonyEP": {
"AntiMalwareScan": {
"PushOperation": [
{
"job_id": "13",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Anti-Malware scan was added to the push operation list successfully.#

Job ID: 13

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-anti-malware-update#


Updates the anti-malware Signature Database on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-anti-malware-update

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
update_from_ep_serverDetermines whether to update from the EP server. Possible values are: true, false. Default is false.Optional
update_from_cp_serverDetermines whether to update from the CP server. Possible values are: true, false. Default is false.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.AntiMalwareUpdate.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.AntiMalwareUpdate.PushOperation.idStringThe remediation operation ID.
HarmonyEP.AntiMalwareUpdate.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.AntiMalwareUpdate.PushOperation.response.statusStringPush operation response status.
HarmonyEP.AntiMalwareUpdate.PushOperation.response.outputStringPush operation response output.
HarmonyEP.AntiMalwareUpdate.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.AntiMalwareUpdate.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.AntiMalwareUpdate.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-anti-malware-update computer_ids=1

Context Example#

{
"HarmonyEP": {
"AntiMalwareUpdate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Anti-Malware Signature Database update was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-anti-malware-restore#


Restores a file that was previously quarantined by the Harmony Endpoint Client's anti-malware capability. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-anti-malware-restore

Input#

Argument NameDescriptionRequired
filesA list of file paths to restore.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.AntiMalwareRestore.PushOperation.idStringThe remediation operation ID.
HarmonyEP.AntiMalwareRestore.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.AntiMalwareRestore.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.AntiMalwareRestore.PushOperation.response.statusStringPush operation response status.
HarmonyEP.AntiMalwareRestore.PushOperation.response.outputStringPush operation response output.
HarmonyEP.AntiMalwareRestore.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.AntiMalwareRestore.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.AntiMalwareRestore.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-anti-malware-restore files=test computer_ids=1

Context Example#

{
"HarmonyEP": {
"AntiMalwareRestore": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

File restore was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-forensics-indicator-analyze#


Collects forensics data whenever a computer that matches the given query accesses or executes the given IP, URL, filename, MD5 or path. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-forensics-indicator-analyze

Input#

Argument NameDescriptionRequired
indicator_typeThe indictor type to analyze. Possible values are: IP, URL, File, MD5, Path.Required
indicator_valueA URL, IP, Path, File or MD5 that when accessed or executed will trigger a forensics report.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
generate_activity_logsDetermines whether to generate detailed activity logs. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.IndicatorAnalyze.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.IndicatorAnalyze.PushOperation.idStringThe remediation operation ID.
HarmonyEP.IndicatorAnalyze.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.IndicatorAnalyze.PushOperation.response.statusStringPush operation response status.
HarmonyEP.IndicatorAnalyze.PushOperation.response.outputStringPush operation response output.
HarmonyEP.IndicatorAnalyze.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.IndicatorAnalyze.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.IndicatorAnalyze.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-forensics-indicator-analyze indicator_type=IP indicator_value=8.8.8.8 computer_ids=1

Context Example#

{
"HarmonyEP": {
"IndicatorAnalyze": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

IOC analyze was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-forensics-file-quarantine#


Quarantines files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-forensics-file-quarantine

Input#

Argument NameDescriptionRequired
file_typeThe forensics quarantine item type. Possible values are: PATH, INCIDENT_ID, MD5.Required
file_valueThe forensics quarantine item value.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.FileQuarantine.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.FileQuarantine.PushOperation.idStringThe remediation operation ID.
HarmonyEP.FileQuarantine.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.FileQuarantine.PushOperation.response.statusStringPush operation response status.
HarmonyEP.FileQuarantine.PushOperation.response.outputStringPush operation response output.
HarmonyEP.FileQuarantine.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.FileQuarantine.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.FileQuarantine.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-forensics-file-quarantine file_type=PATH file_value=test computer_ids=1

Context Example#

{
"HarmonyEP": {
"FileQuarantine": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

File quarantine was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-forensics-file-restore#


Restores previously quarantined files given by path or MD5 or detections relating to a forensic incident. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-forensics-file-restore

Input#

Argument NameDescriptionRequired
file_typeThe forensics quarantine item type. Possible values are: PATH, INCIDENT_ID, MD5.Required
file_valueThe forensics quarantine item value.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.FileRestore.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.FileRestore.PushOperation.idStringThe remediation operation ID.
HarmonyEP.FileRestore.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.FileRestore.PushOperation.response.statusStringPush operation response status.
HarmonyEP.FileRestore.PushOperation.response.outputStringPush operation response output.
HarmonyEP.FileRestore.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.FileRestore.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.FileRestore.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-forensics-file-restore file_type=PATH file_value=test computer_ids=1

Context Example#

{
"HarmonyEP": {
"FileRestore": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

File restore was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-remediation-computer-isolate#


Isolates the computers matching the given query. Isolation is the act of denying all network access from a given computer. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-remediation-computer-isolate

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ComputerIsolate.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ComputerIsolate.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ComputerIsolate.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ComputerIsolate.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ComputerIsolate.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ComputerIsolate.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ComputerIsolate.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ComputerIsolate.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-remediation-computer-isolate computer_ids=1

Context Example#

{
"HarmonyEP": {
"ComputerIsolate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Remediation isolate was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-remediation-computer-deisolate#


De-Isolates the computers matching the given query. De-isolating a computer restores its access to network resources. Affects only isolated computers. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-remediation-computer-deisolate

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ComputerDeisolate.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ComputerDeisolate.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ComputerDeisolate.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ComputerDeisolate.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ComputerDeisolate.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ComputerDeisolate.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ComputerDeisolate.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ComputerDeisolate.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-remediation-computer-deisolate computer_ids=1

Context Example#

{
"HarmonyEP": {
"ComputerDeisolate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Remediation de-isolate was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-computer-restart#


Restarts computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-computer-restart

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
force_apps_shutdownDetermines whether to force applications shutdown. Possible values are: true, false. Default is false.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ComputerRestart.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ComputerRestart.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ComputerRestart.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ComputerRestart.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ComputerRestart.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ComputerRestart.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ComputerRestart.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ComputerRestart.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-computer-restart computer_ids=1

Context Example#

{
"HarmonyEP": {
"ComputerReset": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Computer reset restore was added to the push operation list successfully.#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-computer-shutdown#


Shuts-down computers match the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-computer-shutdown

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
force_apps_shutdownDetermines whether to force applications shutdown. Possible values are: true, false. Default is false.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ComputerShutdown.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ComputerShutdown.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ComputerShutdown.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ComputerShutdown.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ComputerShutdown.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ComputerShutdown.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ComputerShutdown.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ComputerShutdown.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-computer-shutdown computer_ids=1

Context Example#

{
"HarmonyEP": {
"ComputerShutdown": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Computer shutdown was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-computer-repair#


Repairs the Harmony Endpoint Client installation on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-computer-repair

Input#

Argument NameDescriptionRequired
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ComputerRepair.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ComputerRepair.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ComputerRepair.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ComputerRepair.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ComputerRepair.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ComputerRepair.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ComputerRepair.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ComputerRepair.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-computer-repair computer_ids=1

Context Example#

{
"HarmonyEP": {
"ComputerRepair": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Computer repair was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-computer-list#


Gets a list of computers matching the given filters. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-computer-list

Input#

Argument NameDescriptionRequired
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.Computer.job_idStringThe job ID of the remediation operation.
HarmonyEP.Computer.CapabilitiesInstalledStringA list of all installed capabilities.
HarmonyEP.Computer.InstalledAndRunningStringA list of installed and running capabilities.
HarmonyEP.Computer.ClientVersionStringThe computer client version.
HarmonyEP.Computer.DeployTimeStringThe computer deploy time.
HarmonyEP.Computer.GroupsStringThe computer groups.
HarmonyEP.Computer.typeStringThe computer type.
HarmonyEP.Computer.userNameStringThe computer user name.
HarmonyEP.Computer.domainNameStringThe computer domain name.
HarmonyEP.Computer.isolationStatusStringThe computer isolation status.
HarmonyEP.Computer.ClientVersionStringThe computer client veraion.
HarmonyEP.Computer.LastLoggedInUserStringThe computer last login user.
HarmonyEP.Computer.osNameStringThe computer operating system name.
HarmonyEP.Computer.osVersionStringThe computer operating system version.
HarmonyEP.Computer.ipStringThe computer IP address.
HarmonyEP.Computer.DeploymentStatusStringThe computer deployment status.
HarmonyEP.Computer.nameStringThe computer name.
HarmonyEP.Computer.idStringThe computer's unique ID.

Command example#

!harmony-ep-computer-list computer_ids=1 job_id=845

Context Example#

{
"HarmonyEP": {
"Computer": {
"Computer": [
{
"client_version": "87.62.2002",
"deployment_status": "Completed",
"domain_name": ".WORKGROUP",
"groups": [
{
"id": "666",
"name": "Desktops"
},
{
"id": "222",
"name": "WinDesktops"
}
],
"id": "888",
"ip": "1.1.1.1",
"isolation_status": "Not Isolated",
"last_logged_in_user": "ntlocal",
"name": "DESKTOP-E7V07D5",
"os_name": "Microsoft Windows 10 Pro",
"os_version": "10.0-19045-SP0.0-SMP",
"type": "Desktop",
"user_name": "ntlocal"
}
],
"job_id": "845"
}
}
}

Human Readable Output#

Computer list:#

Job ID: 845

Showing page 1. Current page size: 50. |Id|Name|Ip|Type|Groups|User Name|Client Version| |---|---|---|---|---|---|---| | 888 | DESKTOP-E7V07D5 | 1.1.1.1 | Desktop | {'id': '666', 'name': 'Desktops'},
{'id': '222', 'name': 'WinDesktops'} | ntlocal | 87.62.2002 |

harmony-ep-agent-process-information-get#


Collects information about processes on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-process-information-get

Input#

Argument NameDescriptionRequired
process_nameThe name of the process to collect information on. If not provided, all running processes will be collected.Optional
additional_fieldsAdditional process properties to collect. If not provided, only the process's name and ID will be collected. Possible values are: SI, Handles, VM, WS, PM, NPM, Path, CPU, ExitCode, ExitTime, Handle, HandleCount, HasExited, Id, MachineName, MainModule, MainWindowHandle, MainWindowTitle, MaxWorkingSet, MinWorkingSet, Modules, NonpagedSystemMemorySize, NonpagedSystemMemorySize64, PagedMemorySize, PagedMemorySize64, PagedSystemMemorySize, PagedSystemMemorySize64, PeakPagedMemorySize, PeakPagedMemorySize64, PeakVirtualMemorySize, PeakVirtualMemorySize64, PeakWorkingSet, PeakWorkingSet64, PriorityBoostEnabled, PriorityClass, PrivateMemorySize, PrivateMemorySize64, PrivilegedProcessorTime, ProcessName, ProcessorAffinity, Responding, SafeHandle, SessionId, StandardError, StandardInput, StandardOutput, StartInfo, StartTime, SynchronizingObject, Threads, TotalProcessorTime, UserProcessorTime, VirtualMemorySize, VirtualMemorySize64, WorkingSet, WorkingSet64.Optional
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ProcessInformation.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ProcessInformation.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ProcessInformation.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ProcessInformation.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ProcessInformation.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ProcessInformation.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ProcessInformation.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ProcessInformation.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-process-information-get computer_ids=1

Context Example#

{
"HarmonyEP": {
"ProcessInformation": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Process information fetch was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-process-terminate#


Terminates the given process on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-process-terminate

Input#

Argument NameDescriptionRequired
terminate_all_instancesIndicates whether to terminate all processes matching the given name. If set to true while a non-zero PID is given, only a single process with the given name AND PID may be matched. If set to false or not provided, will terminate only the first matching process. Possible values are: true, false. Default is false.Optional
nameThe name of the process to terminate.Required
pidThe ID (PID) of the process to terminate. When used in conjunction with the name field, the PID must match the named process. If both name and PID are provided but the process matching the PID does not match the provided name, the operation will be ignored by the agent. If set to 0 or not provided, the agent will seek to terminate the process or processes as indicated by the name field.Optional
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.ProcessTerminate.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.ProcessTerminate.PushOperation.idStringThe remediation operation ID.
HarmonyEP.ProcessTerminate.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.ProcessTerminate.PushOperation.response.statusStringPush operation response status.
HarmonyEP.ProcessTerminate.PushOperation.response.outputStringPush operation response output.
HarmonyEP.ProcessTerminate.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.ProcessTerminate.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.ProcessTerminate.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-process-terminate name=test computer_ids=1

Context Example#

{
"HarmonyEP": {
"ProcessTerminate": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

Process terminate was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-registry-key-add#


Adds a given registry key and/or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-registry-key-add

Input#

Argument NameDescriptionRequired
is_redirectedDetermines if the key should reside under WOW6432Node. Keys intended for 64bit versions of Windows may target 32bit versions by setting this value to 'true, thus specifying that the registry key/value be added under the WOW6432Node. Possible values are: true, false.Optional
value_dataThe actual value to be added the the specified registry key.Required
value_typeA registry value's type. Possible values are: DWORD (REG_DWORD), STRING (REG_GZ).Required
value_nameThe name of the value to be added to the specified registry key.Required
keyThe full path path of the key to create or add a value to. For example, 'SOFTWARE\Node.js\Components'.Required
hiveDefines known Windows Registry Hives. For more information, see https://docs.microsoft.com/en-us/windows/win32/sysinfo/predefined-keys. Possible values are: HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_USERS, HKEY_CURRENT_CONFIG.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.RegistryKeyAdd.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.RegistryKeyAdd.PushOperation.idStringThe remediation operation ID.
HarmonyEP.RegistryKeyAdd.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.RegistryKeyAdd.PushOperation.response.statusStringPush operation response status.
HarmonyEP.RegistryKeyAdd.PushOperation.response.outputStringPush operation response output.
HarmonyEP.RegistryKeyAdd.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.RegistryKeyAdd.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.RegistryKeyAdd.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-registry-key-add value_data=test value_type="STRING (REG_GZ)" value_name=test key=test hive=HKEY_USERS computer_ids=1

Context Example#

{
"HarmonyEP": {
"RegistryKeyAdd": {
"PushOperation": {
"job_id": "54",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "88",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}

Human Readable Output#

Registry key add was added to the push operation list successfully..#

Job ID: 54

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-registry-key-delete#


Removes the given registry key or value to the registry of computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-registry-key-delete

Input#

Argument NameDescriptionRequired
is_redirectedDetermines if the key should be removed from under WOW6432Node. Keys intended for 64bit versions of Windows may target 32bit versions by setting this value to 'true', thus specifying that the registry key/value be removed under the WOW6432Node. Possible values are: true, false.Optional
value_nameThe value to remove from the key. If not provided, the entire key will be deleted.Optional
keyThe full path path of the key to delete or remove a value from. For example, 'SOFTWARE\Node.js\Components'.Required
hiveDefines known Windows Registry Hives. For more information, see https://docs.microsoft.com/en-us/windows/win32/sysinfo/predefined-keys. Possible values are: HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_USERS, HKEY_CURRENT_CONFIG.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.RegistryKeyDelete.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.RegistryKeyDelete.PushOperation.idStringThe remediation operation ID.
HarmonyEP.RegistryKeyDelete.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.RegistryKeyDelete.PushOperation.response.statusStringPush operation response status.
HarmonyEP.RegistryKeyDelete.PushOperation.response.outputStringPush operation response output.
HarmonyEP.RegistryKeyDelete.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.RegistryKeyDelete.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.RegistryKeyDelete.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-registry-key-delete value_name='test' key='test' hive=HKEY_USERS computer_ids=1

Context Example#

{
"HarmonyEP": {
"RegistryKeyDelete": {
"PushOperation": {
"job_id": "54",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "88",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}

Human Readable Output#

Registry key delete was added to the push operation list successfully..#

Job ID: 54

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-file-copy#


Copies the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-file-copy

Input#

Argument NameDescriptionRequired
destination_absolute_pathThe absolute, full destination path. The provided path must include the target file's name (e.g., c:\backup\backup1.txt).Required
source_absolute_pathThe absolute, full source path (e.g., c:\backup\backup1.txt).Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.FileCopy.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.FileCopy.PushOperation.idStringThe remediation operation ID.
HarmonyEP.FileCopy.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.FileCopy.PushOperation.response.statusStringPush operation response status.
HarmonyEP.FileCopy.PushOperation.response.outputStringPush operation response output.
HarmonyEP.FileCopy.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.FileCopy.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.FileCopy.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-file-copy destination_absolute_path='test.txt' source_absolute_path='test.txt' computer_ids=1

Context Example#

{
"HarmonyEP": {
"FileCopy": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

File copy was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-file-move#


Moves the given file from the given source to the given destination on computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-file-move

Input#

Argument NameDescriptionRequired
destination_absolute_pathThe absolute, full destination path. The provided path must include the target file's name (e.g., c:\backup\backup1.txt).Required
source_absolute_pathThe absolute, full source path (e.g., c:\backup\backup1.txt).Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.FileMove.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.FileMove.PushOperation.idStringThe remediation operation ID.
HarmonyEP.FileMove.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.FileMove.PushOperation.response.statusStringPush operation response status.
HarmonyEP.FileMove.PushOperation.response.outputStringPush operation response output.
HarmonyEP.FileMove.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.FileMove.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.FileMove.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-file-move destination_absolute_path='test.txt' source_absolute_path='test.txt' computer_ids=1

Context Example#

{
"HarmonyEP": {
"FileMove": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}

Human Readable Output#

File move was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-file-delete#


Deletes the given file from the given source on computers matching the given query. This operation is risky! Use with caution as it allows you to change Harmony Endpoint protected files or registry entries that are in use by your operating system. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-file-delete

Input#

Argument NameDescriptionRequired
target_absolute_pathThe absolute, full path of the file to remove.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.FileDelete.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.FileDelete.PushOperation.idStringThe remediation operation ID.
HarmonyEP.FileDelete.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.FileDelete.PushOperation.response.statusStringPush operation response status.
HarmonyEP.FileDelete.PushOperation.response.outputStringPush operation response output.
HarmonyEP.FileDelete.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.FileDelete.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.FileDelete.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-file-delete target_absolute_path='test.txt' computer_ids=1

Context Example#

{
"HarmonyEP": {
"FileDelete": {
"PushOperation": [
{
"job_id": "16",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": null,
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
]
}
}
}

Human Readable Output#

File delete was added to the push operation list successfully..#

Job ID: 16

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-vpn-site-add#


Adds the given VPN site's configuration to computers matching the given query. Adding a VPN site allows Harmony Endpoint Clients to connect to it. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-vpn-site-add

Input#

Argument NameDescriptionRequired
remote_access_gateway_nameThe remote gateway's name.Required
fingerprintThe remote gateway's certificate fingerprint. Fingerprints are used to verify the authenticity of the gateway.Required
authentication_methodAuthentication methods used in conjunction with VPN site standard login. Possible values are: CERTIFICATE, P12_CERTIFICATE, USERNAME_PASSWORD, SECURID_KEY_FOB, SECURID_PIN_PAD, SOFTID, CHALLENGE_RESPONSE.Required
display_nameThe VPN site's display name.Optional
hostThe target site's host name or IP address.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.idStringThe remediation operation ID.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.response.statusStringPush operation response status.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.response.outputStringPush operation response output.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.VPNsiteConfigurationAdd.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-vpn-site-add remote_access_gateway_name='test' fingerprint='test' authentication_method=CERTIFICATE host='test' computer_ids=1

Context Example#

{
"HarmonyEP": {
"VPNsiteConfigurationAdd": {
"PushOperation": {
"job_id": "67",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "23",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}

Human Readable Output#

VPN site configuration remove was added to the push operation list successfully..#

Job ID: 67

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |

harmony-ep-agent-vpn-site-remove#


Removes the given VPN site's configuration to computers matching the given query. Note that you must specify at least one of the following filter arguments: computer_ids, computer_names, computer_ips, computer_group_names, computer_types, computer_deployment_status, computer_last_connection, or filter.

Base Command#

harmony-ep-agent-vpn-site-remove

Input#

Argument NameDescriptionRequired
display_nameThe display name of the VPN site to remove. If a display name was not provided during the site's creation, the host name/IP should be used instead.Required
commentOperation comment.Optional
scheduling_date_timeStart the operation on a given date and time. If not specified, defaults to 'Now' (i.e. immediate execution). For example, โ€œ2024-04-12 03:59โ€.Optional
expiration_secondsThe amount of time, in seconds, the operation will be valid for. When the specified time has elapsed, the operation will expire and will not be pushed to any more clients. If not specified, defaults to 86400 seconds (24 hours). Minimum value is 1.Optional
computer_idsA comma-separated list of computer IDs to include in the operation.Optional
computer_namesA comma-separated list of computer names to include in the operation.Optional
computer_ipsA comma-separated list of computer IPs to include in the operation.Optional
computer_typesA comma-separated list of computer types to include in the operation. Possible values are: Desktop, Laptop, N/A, Domain Controller, Server.Optional
computer_deployment_statusesA comma-separated list of computer deployment statuses to include in the operation. Possible values are: Retrying, Error, Scheduled, Downloading, Deploying, Completed, Failed, Uninstalling, Not Scheduled, Not Installed, N/A.Optional
computer_last_connectionComputer last connection range time (start time, end time) to include in the operation. For example, "2024-01-01 07:58, 2024-04-02 02:00โ€.Optional
filterA comma-separated list of list of search filters according to the following template: "column_name operator 'values_list' ". For example, the query "computerId Contains '1,2,3,4' , computerIP Exact '1.1.1.1' " will refer to computers contains '1', '2', '3', and '4' in their ID and that their IP is '1.1.1.1'. For more optional 'column_name' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/ComputerColumnNames. For more optional 'operator' values, see https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production/1.9.179#/FilterType .Optional
groups_ids_to_excludeA comma-separated list of group IDs to exclude from the operation.Optional
computers_ids_to_excludeA comma-separated list of computer IDs to exclude from the operation.Optional
computers_ids_to_includeA comma-separated list of computer IDs to include in the operation.Optional
inform_userDetermines whether to inform the user, via a UserCheck (popup) message, that the operation is taking place. Possible values are: true, false. Default is true.Optional
allow_postponeDetermines whether to allow the user to postpone the operation. Possible values are: true, false. Default is true.Optional
pagePage number of paginated results. Minimum value: 1.Optional
page_sizeThe number of items per page.Optional
limitThe maximum number of records to retrieve. Default is 50.Optional
intervalThe interval between each poll in seconds. Minimum value is 10. Default is 30.Optional
timeoutThe timeout for the polling in seconds. Default is 600.Optional
job_idThe job ID to fetch data for. Hidden argument.Optional

Context Output#

PathTypeDescription
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.job_idStringThe job ID of the remediation operation.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.idStringThe remediation operation ID.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.statusStringDescribes possible states in which a push operation may be in regards to a specific device.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.response.statusStringPush operation response status.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.response.outputStringPush operation response output.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.ipAddressStringThe client device's IPv4 address.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.nameStringThe client device's name.
HarmonyEP.VPNsiteConfigurationRemove.PushOperation.machine.idStringThe client device's unique ID.

Command example#

!harmony-ep-agent-vpn-site-remove display_name='test' computer_ids=1

Context Example#

{
"HarmonyEP": {
"VPNsiteConfigurationRemove": {
"PushOperation": {
"job_id": "67",
"machine": {
"id": "1",
"name": "DESKTOP-1"
},
"operation": {
"id": "23",
"response": null,
"status": "DA_NOT_INSTALLED"
}
}
}
}
}

Human Readable Output#

VPN site configuration remove was added to the push operation list successfully..#

Job ID: 67

Showing page 1. Current page size: 50. |Machine Id|Machine Name|Operation Status| |---|---|---| | 1 | DESKTOP-1 | DA_NOT_INSTALLED |