SentinelOne V2
Use the SentinelOne integration to send requests to your management server and get responses with data pulled from agents or from the management database.
Endpoint · SentinelOne
Details
| ID | SentinelOne V2 |
|---|---|
| Provider | SentinelOne |
| Category | Endpoint |
| From Version | 5.0.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix XSIAM |
README
Use the SentinelOne integration to send requests to your management server and get responses with data pulled from agents or from the management database.
This integration was integrated and tested with versions 2.0 and 2.1 of SentinelOne V2
Some changes have been made that might affect your existing content.
If you are upgrading from a previous version of this integration, see Breaking Changes.
Configure SentinelOne v2 in Cortex
| Parameter | Description | Required |
|---|---|---|
| Server URL (e.g., https://usea1.sentinelone.net) | True | |
| API Token | False | |
| API Version | True | |
| Fetch incidents | False | |
| Incident type | False | |
| Fetch incidents from type | False | |
| Fetch incidents from UAM Alert type | False | |
| First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year) | False | |
| Minimum risk score for importing incidents (0-10), where 0 is low risk and 10 is high risk. Relevant for API version 2.0. | False | |
| Defines Alert severity to fetch. Supported values: Low, Medium, High, Critical. | False | |
| Define which Alerts should be fetched. | False | |
| Define which Threats should be fetched. | False | |
| Fetch limit: The maximum number of threats or alerts to fetch | False | |
| Site IDs | Comma-separated list of site IDs to fetch incidents for. Leave blank to fetch all sites. | False |
| Block Site IDs | Comma-separated list of site IDs for where hashes should be blocked. If left blank all hashes will be blocked globally. If filled out with site ids all hashes will be no longer be blocked globally, they will now be blocked in the scope of those sites. | False |
| Trust any certificate (not secure) | False | |
| Use system proxy settings | False | |
| Incidents Fetch Interval | False | |
| Incident Mirroring Direction | Choose the direction to mirror the incident: Incoming (from SentinelOne to Cortex XSOAR), Outgoing (from Cortex XSOAR to SentinelOne), or Incoming and Outgoing (from/to Cortex XSOAR and SentinelOne). Cortex XSOAR only parameter. | False |
| Close Mirrored XSOAR Incident | When selected, closing the SentinelOne ticket is mirrored in Cortex XSOAR. | False |
Commands
You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.
sentinelone-list-agents
Returns all agents that match the specified criteria.
Base Command
sentinelone-list-agents
Input
| Argument Name | Description | Required |
|---|---|---|
| computer_name | The computer name by which to filter the results. It can match a partial computer name value (substring). | Optional |
| scan_status | A comma-separated list of scan statuses by which to filter the results, for example: “started,aborted”. Possible values are: started, none, finished, aborted. | Optional |
| os_type | Included operating system types, for example: “windows”. Possible values are: windows, windows_legacy, macos, linux. | Optional |
| created_at | Endpoint creation timestamp, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| min_active_threats | Minimum number of threats per agent. | Optional |
| limit | The maximum number of agents to return. Default is 10. | Optional |
| params | Query params field=value pairs delimited by comma (e.g., activeThreats=3,gatewayIp=1.2.3.4). Query params are OR’d. | Optional |
| columns | A comma-separated list of additionals fields to display. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agents.NetworkStatus | string | The agent network status. |
| SentinelOne.Agents.ID | string | The agent ID. |
| SentinelOne.Agents.AgentVersion | string | The agent software version. |
| SentinelOne.Agents.IsDecommissioned | boolean | Whether the agent is decommissioned. |
| SentinelOne.Agents.IsActive | boolean | Whether the agent is active. |
| SentinelOne.Agents.LastActiveDate | date | When was the agent last active. |
| SentinelOne.Agents.RegisteredAt | date | The registration date of the agent. |
| SentinelOne.Agents.ExternalIP | string | The agent IP address. |
| SentinelOne.Agents.ThreatCount | number | Number of active threats. |
| SentinelOne.Agents.EncryptedApplications | boolean | Whether disk encryption is enabled. |
| SentinelOne.Agents.OSName | string | Name of operating system. |
| SentinelOne.Agents.ComputerName | string | Name of agent computer. |
| SentinelOne.Agents.MachineType | string | Machine type. |
| SentinelOne.Agents.Domain | string | Domain name of the agent. |
| SentinelOne.Agents.CreatedAt | date | Creation time of the agent. |
| SentinelOne.Agents.SiteName | string | Site name associated with the agent. |
| SentinelOne.Agents.Tags | unknown | Tags associated with the agent. |
sentinelone-create-white-list-item
Creates an exclusion item that matches the specified input filter.
Base Command
sentinelone-create-white-list-item
Input
| Argument Name | Description | Required |
|---|---|---|
| exclusion_type | Exclusion item type. Possible values are: file_type, path, white_hash, certificate, browser. | Required |
| exclusion_value | Value of the exclusion item for the exclusion list. | Required |
| os_type | Operating system type. Required for hash exclusions. Possible values are: windows, windows_legacy, macos, linux. | Required |
| description | Description for adding the exclusion item. | Optional |
| exclusion_mode | Exclusion mode (path exclusion only). Possible values are: suppress, disable_in_process_monitor_deep, disable_in_process_monitor, disable_all_monitors, disable_all_monitors_deep. | Optional |
| path_exclusion_type | Excluded path for a path exclusion list. | Optional |
| group_ids | A comma-separated list of group IDs by which to filter. | Optional |
| site_ids | A comma-separated list of site IDs by which to filter. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Exclusions.ID | string | The entity ID on the allow list. |
| SentinelOne.Exclusions.Type | string | The item type on the allow list. |
| SentinelOne.Exclusions.CreatedAt | date | Time when the allow list item was created. |
sentinelone-get-white-list
Lists all exclusion items that match the specified input filter.
Base Command
sentinelone-get-white-list
Input
| Argument Name | Description | Required |
|---|---|---|
| item_ids | List of IDs by which to filter, for example: “225494730938493804,225494730938493915”. | Optional |
| os_types | A comma-separated list of operating system types by which to filter, for example: “windows, linux”. Possible values are: windows, windows_legacy, macos, linux. | Optional |
| exclusion_type | Exclusion type. Possible values are: file_type, path, white_hash, certificate, browser. | Optional |
| limit | The maximum number of items to return. Default is 10. | Optional |
| include_parent | Whether to include parent information of each item. Default value is false. Default is false. | Optional |
| include_children | Whether to include children information of each item. Default value is false. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Exclusions.ID | string | The exclusion item ID. |
| SentinelOne.Exclusions.Type | string | The exclusion item type. |
| SentinelOne.Exclusions.CreatedAt | date | Timestamp when the exclusion item was added. |
| SentinelOne.Exclusions.Value | string | Value of the exclusion item. |
| SentinelOne.Exclusions.Source | string | Source of the exclusion item. |
| SentinelOne.Exclusions.UserID | string | User ID of the user qho added the exclusion item. |
| SentinelOne.Exclusions.UpdatedAt | date | Timestamp when the exclusion item was updated. |
| SentinelOne.Exclusions.OsType | string | Operating system type of the exclusion item. |
| SentinelOne.Exclusions.UserName | string | User name of the user who added the exclusion item. |
| SentinelOne.Exclusions.Mode | string | A comma-separated list of modes by which to filter (path exclusions only), for example: “suppress”. |
sentinelone-get-hash
Gets the file reputation verdict by a SHA1 hash.
Base Command
sentinelone-get-hash
Input
| Argument Name | Description | Required |
|---|---|---|
| hash | The content hash. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Hash.Rank | Number | The hash reputation (1-10). |
| SentinelOne.Hash.Verdict | String | The hash reputation verdict. |
| SentinelOne.Hash.Hash | String | The content hash. |
sentinelone-get-threats
Returns threats according to the specified filters.
Base Command
sentinelone-get-threats
Input
| Argument Name | Description | Required |
|---|---|---|
| content_hash | A comma-separated list of content hashes of the threat. | Optional |
| mitigation_status | A comma-separated list of mitigation statuses. Possible values are: mitigated, active, blocked, suspicious, pending, suspicious_resolved. | Optional |
| created_before | Searches for threats created before this timestamp, for example: “2018-02-27T04:49:26.257525Z”, “10 days”, “5 months”, “2 hours”. | Optional |
| created_after | Searches for threats created after this timestamp, for example: “2018-02-27T04:49:26.257525Z”, “10 days”, “5 months”, “2 hours”. | Optional |
| created_until | Searches for threats created on or before this timestamp, for example: “2018-02-27T04:49:26.257525Z”, “10 days”, “5 months”, “2 hours”. | Optional |
| created_from | Search for threats created on or after this timestamp, for example: “2018-02-27T04:49:26.257525Z”, “10 days”, “5 months”, “2 hours”. | Optional |
| resolved | Whether to only return resolved threats. Possible values are: false, true. Default is false. | Optional |
| display_name | Threat display name. For API version 2.0 it can be a partial display name, doesn’t have to be an exact match. | Optional |
| limit | The maximum number of threats to return. Default is 20. | Optional |
| query | Full free-text search for fields. Can be “content_hash”, “file_display_name”, “file_path”, “computer_name”, or “uuid”. | Optional |
| threat_ids | A comma-separated list of threat IDs, for example: “225494730938493804,225494730938493915”. | Optional |
| classifications | A comma-separated list of threat classifications to search, for example: “Malware”, “Network”, “Benign”. Possible values are: Engine, Static, Cloud, Behavioral. | Optional |
| rank | Risk level threshold to retrieve (1-10). Relevant for API version 2.0 only. | Optional |
| site_ids | A comma-separated list of site IDs to search for threats, for example: “225494730938493804,225494730938493915”. | Optional |
| incident_statuses | Incident status. Example: “IN_PROGRESS, UNRESOLVED”. | Optional |
| include_resolved_param | Whether to include the resolved parameter in the query. Possible values are: false, true. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.AgentComputerName | String | The agent computer name. |
| SentinelOne.Threat.CreatedDate | Date | The threat creation date. |
| SentinelOne.Threat.SiteID | String | The site ID. |
| SentinelOne.Threat.Classification | string | The threat classification. |
| SentinelOne.Threat.ClassificationSource | string | Source of the threat classification. |
| SentinelOne.Threat.ConfidenceLevel | string | SentinelOne threat confidence level. |
| SentinelOne.Threat.FileSha256 | string | SHA256 hash of the file content. |
| SentinelOne.Threat.MitigationStatus | String | The agent mitigation status. |
| SentinelOne.Threat.AgentID | String | The threat agent ID. |
| SentinelOne.Threat.Rank | Number | The number representing the cloud reputation (1-10). |
| SentinelOne.Threat.MarkedAsBenign | Boolean | Whether the threat is marked as benign. Relevant for version 2.0 only. |
sentinelone-threat-summary
Returns a dashboard threat summary. Can only be used with API V2.1.
Base Command
sentinelone-threat-summary
Input
| Argument Name | Description | Required |
|---|---|---|
| group_ids | A comma-separated list of group IDs by which to filter, for example: “225494730938493804,225494730938493915”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.NotResolved | Number | Number of unresolved threats in the system. |
| SentinelOne.Threat.SuspiciousNotMitigatedNotResolved | Number | Number of unmitigated suspicious threats in the system. |
| SentinelOne.Threat.SuspiciousNotResolved | Number | Number of unresolved suspicious threats in the system. |
| SentinelOne.Threat.Resolved | Number | Number of resolved threats in the system. |
| SentinelOne.Threat.InProgress | Number | Number of active threats in the system. |
| SentinelOne.Threat.Total | Number | Total number of threats in the system. |
| SentinelOne.Threat.NotMitigated | Number | Number of unmitigated threats in the system. |
| SentinelOne.Threat.MaliciousNotResolved | Number | Number of unresolved malicious threats in the system. |
| SentinelOne.Threat.NotMitigatedNotResolved | Number | Number of unmitigated and unresolved threats in the system. |
sentinelone-mark-as-threat
Marks suspicious threats as threats. Can only be used with API V2.0.
Base Command
sentinelone-mark-as-threat
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_ids | A comma-separated list of threat IDs. | Optional |
| target_scope | Scope to use for exclusions. Possible values are: site, tenant. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.MarkedAsThreat | Boolean | Whether the suspicious threat was successfully marked as a threat. |
sentinelone-mitigate-threat
Applies a mitigation action to a group of threats that match the specified input filter.
Base Command
sentinelone-mitigate-threat
Input
| Argument Name | Description | Required |
|---|---|---|
| action | Mitigation action. Possible values are: kill, quarantine, un-quarantine, remediate, rollback-remediation. | Required |
| threat_ids | A comma-separated list of threat IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Mitigated | Boolean | Whether the threat was successfully mitigated. |
| SentinelOne.Threat.Mitigation.Action | String | The mitigation action performed. |
sentinelone-resolve-threat
Resolves threats using the threat ID. Can only be used with API V2.0.
Base Command
sentinelone-resolve-threat
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_ids | A comma-separated list of threat IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Resolved | Boolean | Whether the threat was successfully resolved. |
sentinelone-get-agent
Returns the details of an agent according to the agent ID.
Base Command
sentinelone-get-agent
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_id | A comma-separated string of agent IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.NetworkStatus | string | The agent network status. |
| SentinelOne.Agent.ID | string | The agent ID. |
| SentinelOne.Agent.AgentVersion | string | The agent software version. |
| SentinelOne.Agent.IsDecommissioned | boolean | Whether the agent is decommissioned. |
| SentinelOne.Agent.IsActive | boolean | Whether the agent is active. |
| SentinelOne.Agent.LastActiveDate | date | When was the agent last active. |
| SentinelOne.Agent.RegisteredAt | date | The registration date of the agent. |
| SentinelOne.Agent.ExternalIP | string | The agent IP address. |
| SentinelOne.Agent.ThreatCount | number | Number of active threats. |
| SentinelOne.Agent.EncryptedApplications | boolean | Whether disk encryption is enabled. |
| SentinelOne.Agent.OSName | string | Name of the operating system. |
| SentinelOne.Agent.ComputerName | string | Name of the agent computer. |
| SentinelOne.Agent.MachineType | string | Machine type. |
| SentinelOne.Agent.Domain | string | Domain name of the agent. |
| SentinelOne.Agent.CreatedAt | date | Agent creation time. |
| SentinelOne.Agent.SiteName | string | Site name associated with the agent. |
sentinelone-get-sites
Returns all sites that match the specified criteria.
Base Command
sentinelone-get-sites
Input
| Argument Name | Description | Required |
|---|---|---|
| updated_at | Timestamp of the last update, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| query | Full-text search for fields: name, account_name. | Optional |
| site_type | Site type. Possible values are: Trial, Paid, POC, DEV, NFR. | Optional |
| features | Returns sites that support the specified features. Possible values are: firewall-control, device-control, ioc. | Optional |
| state | Site state. Possible values are: active, deleted, expired. | Optional |
| suite | The suite of product features active for this site. Possible values are: Core, Complete. | Optional |
| admin_only | Sites for which the user has admin privileges. Possible values are: true, false. | Optional |
| account_id | Account ID, for example: “225494730938493804”. | Optional |
| site_name | Site name, for example: “My Site”. | Optional |
| created_at | Timestamp of the site creation, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| limit | Maximum number of results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Site.Creator | string | The site creator name. |
| SentinelOne.Site.Name | string | The site name. |
| SentinelOne.Site.Type | string | The site type. |
| SentinelOne.Site.AccountName | string | The site account name. |
| SentinelOne.Site.State | string | The site state. |
| SentinelOne.Site.HealthStatus | boolean | The health status of the site. |
| SentinelOne.Site.Suite | string | The suite to which the site belongs. |
| SentinelOne.Site.ActiveLicenses | number | Number of active licenses for the site. |
| SentinelOne.Site.ID | string | ID of the site. |
| SentinelOne.Site.TotalLicenses | number | Number of total licenses for the site. |
| SentinelOne.Site.CreatedAt | date | Timestamp when the site was created. |
| SentinelOne.Site.Expiration | string | Timestamp when the site will expire. |
| SentinelOne.Site.UnlimitedLicenses | boolean | Whether the site has unlimited licenses. |
sentinelone-get-site
Returns information about the site, according to the site ID.
Base Command
sentinelone-get-site
Input
| Argument Name | Description | Required |
|---|---|---|
| site_id | ID of the site. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Site.Creator | string | The site creator name. |
| SentinelOne.Site.Name | string | The site name. |
| SentinelOne.Site.Type | string | The site type. |
| SentinelOne.Site.AccountName | string | The site account name. |
| SentinelOne.Site.State | string | The site state. |
| SentinelOne.Site.HealthStatus | boolean | The health status of the site. |
| SentinelOne.Site.Suite | string | The suite to which the site belongs. |
| SentinelOne.Site.ActiveLicenses | number | Number of active licenses for the site. |
| SentinelOne.Site.ID | string | ID of the site. |
| SentinelOne.Site.TotalLicenses | number | Number of total licenses for the site. |
| SentinelOne.Site.CreatedAt | date | Timestamp when the site was created. |
| SentinelOne.Site.Expiration | string | Timestamp when the site will expire. |
| SentinelOne.Site.UnlimitedLicenses | boolean | Whether the site has unlimited licenses. |
| SentinelOne.Site.AccountID | string | Site account ID. |
| SentinelOne.Site.IsDefault | boolean | Whether the site is the default site. |
sentinelone-reactivate-site
Reactivates an expired site.
Base Command
sentinelone-reactivate-site
Input
| Argument Name | Description | Required |
|---|---|---|
| site_id | Site ID. For example: “225494730938493804”. | Required |
| unlimited | If false, an expiration should be supplied. | Optional |
| expiration | Expiration date in case unlimited is false, for example, “2019-08-03T04:49:26.257525Z”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Site.ID | string | Site ID. |
| SentinelOne.Site.Reactivated | boolean | Whether the site was reactivated. |
sentinelone-get-activities
Returns a list of activities.
Base Command
sentinelone-get-activities
Input
| Argument Name | Description | Required |
|---|---|---|
| created_after | Return activities created after this timestamp, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| user_emails | Email address of the user who invoked the activity (if applicable). | Optional |
| group_ids | List of group IDs by which to filter, for example: “225494730938493804,225494730938493915”. | Optional |
| created_until | Return activities created on or before this timestamp, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| include_hidden | Include internal activities hidden from display. Possible values are: true, false. | Optional |
| activities_ids | A comma-separated list of activity IDs by which to filter, for example: “225494730938493804,225494730938493915”. | Optional |
| created_before | Return activities created before this timestamp, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| threats_ids | A comma-separated list of threat IDs for which to return activities, for example: “225494730938493804,225494730938493915”. | Optional |
| activity_types | A comma-separated list of activity codes to return, for example: “52,53,71,72”. | Optional |
| user_ids | A comma-separated list of user IDs for users that invoked the activity (if applicable), for example: “225494730938493804,225494730938493915”. | Optional |
| created_from | Return activities created on or after this timestamp, for example: “2018-02-27T04:49:26.257525Z”. | Optional |
| created_between | Return activities created within this range (inclusive), for example: “1514978764288-1514978999999”. | Optional |
| agent_ids | Return activities related to specified agents. For example: “225494730938493804,225494730938493915”. | Optional |
| limit | Maximum number of items to return (1-100). | Optional |
| sort_by | Field to sort results by. Possible values are: activityType, createdAt, id. | Optional |
| sort_order | Order to sort by. Possible values are: asc, desc. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Activity.AgentID | String | Related agent (if applicable). |
| SentinelOne.Activity.AgentUpdatedVersion | String | Agent’s new version (if applicable). |
| SentinelOne.Activity.SiteID | String | Related site (if applicable). |
| SentinelOne.Activity.UserID | String | The user who invoked the activity (if applicable). |
| SentinelOne.Activity.SecondaryDescription | String | Secondary description. |
| SentinelOne.Activity.OsFamily | String | Agent’s operating system type (if applicable). Can be “linux”, “macos”, “windows”, or “windows_legacy”. |
| SentinelOne.Activity.ActivityType | Number | Activity type. |
| SentinelOne.Activity.data.SiteID | String | The site ID. |
| SentinelOne.Activity.data.SiteName | String | The site name. |
| SentinelOne.Activity.data.username | String | The name of the site creator. |
| SentinelOne.Activity.Hash | String | Threat file hash (if applicable). |
| SentinelOne.Activity.UpdatedAt | Date | Activity last updated time (UTC). |
| SentinelOne.Activity.Comments | String | Comments for the activity. |
| SentinelOne.Activity.ThreatID | String | Related threat (if applicable). |
| SentinelOne.Activity.PrimaryDescription | String | Primary description for the activity. |
| SentinelOne.Activity.GroupID | String | Related group (if applicable). |
| SentinelOne.Activity.ID | String | Activity ID. |
| SentinelOne.Activity.CreatedAt | Date | Activity creation time (UTC). |
| SentinelOne.Activity.Description | String | Extra activity information. |
sentinelone-get-groups
Returns data for the specified group.
Base Command
sentinelone-get-groups
Input
| Argument Name | Description | Required |
|---|---|---|
| group_type | Group type, for example: “static”. | Optional |
| group_ids | A comma-separated list of group IDs by which to filter, for example: “225494730938493804,225494730938493915”. | Optional |
| group_id | Group ID by which to filter, for example: “225494730938493804”. | Optional |
| is_default | Whether this is the default group. Possible values are: true, false. | Optional |
| name | The name of the group. | Optional |
| query | Free-text search. | Optional |
| rank | The priority of a dynamic group over others, for example, “1”, which is the highest priority. | Optional |
| limit | Maximum number of items to return (1-200). | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Group.siteId | String | The ID of the site of which this group is a member. |
| SentinelOne.Group.filterName | String | If the group is dynamic, the name of the filter which is used to associate agents. |
| SentinelOne.Group.creatorId | String | The ID of the user who created the group. |
| SentinelOne.Group.name | String | The name of the group. |
| SentinelOne.Group.creator | String | The user who created the group. |
| SentinelOne.Group.rank | Number | The rank, which sets the priority of a dynamic group over others. |
| SentinelOne.Group.updatedAt | Date | Timestamp of the last update. |
| SentinelOne.Group.totalAgents | Number | Number of agents in the group. |
| SentinelOne.Group.filterId | String | If the group is dynamic, the group ID of the filter that is used to associate agents. |
| SentinelOne.Group.isDefault | Boolean | Whether the groups is the default group of the site. |
| SentinelOne.Group.inherits | Boolean | Whether the policy is inherited from a site. “False” if the group has its own edited policy. |
| SentinelOne.Group.type | String | Group type. Can be static or dynamic |
| SentinelOne.Group.id | String | The ID of the group. |
| SentinelOne.Group.createdAt | Date | Timestamp of group creation. |
sentinelone-move-agent
Moves agents to a new group.
Base Command
sentinelone-move-agent
Input
| Argument Name | Description | Required |
|---|---|---|
| group_id | The ID of the group to move the agent to. | Required |
| agents_ids | Agents IDs. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.AgentsMoved | Number | The number of agents that were moved to another group. |
sentinelone-delete-group
Deletes a group, by the group ID.
Base Command
sentinelone-delete-group
Input
| Argument Name | Description | Required |
|---|---|---|
| group_id | The ID of the group to delete. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.DeleteGroup.Success | String | The status of the command. |
sentinelone-connect-agent
Connects agents to the network.
Base Command
sentinelone-connect-agent
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_id | A comma-separated list of agent IDs to connect to the network. Run the list-agents command to get a list of agent IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.AgentsAffected | Number | The number of affected agents. |
| SentinelOne.Agent.NetworkStatus | String | Agent network status. |
| SentinelOne.Agent.ID | String | Input agents’ IDs. |
sentinelone-disconnect-agent
Disconnects agents from the network.
Base Command
sentinelone-disconnect-agent
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_id | A comma-separated list of agent IDs to disconnect from the network. Run the list-agents command to get a list of agent IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.NetworkStatus | String | Agent network status. |
| SentinelOne.Agent.ID | String | Input agents’ IDs. |
sentinelone-broadcast-message
Broadcasts a message to all agents that match the input filters.
Base Command
sentinelone-broadcast-message
Input
| Argument Name | Description | Required |
|---|---|---|
| message | The message to broadcast to agents. | Required |
| active_agent | Whether to only include active agents. Default is “false”. Possible values are: true, false. | Optional |
| group_id | A comma-separated list of group IDs by which to filter the results. | Optional |
| agent_id | A comma-separated list of agent IDs by which to filter the results. | Optional |
| domain | A comma-separated of included network domains. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.BroadcastMessage.Affected | String | Number of affected endpoints. |
sentinelone-get-events
Returns all Deep Visibility events that match the query.
Base Command
sentinelone-get-events
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | Maximum number of items to return (1-100). Default is 50. | Optional |
| query_id | QueryId obtained when creating a query in the sentinelone-create-query command. Example: “q1xx2xx3”. | Required |
| cursor | Cursor pointer to get next page of results from query. | Optional |
| columns | A comma-separated list of additionals fields to display. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Event.ProcessUID | String | Process unique identifier. |
| SentinelOne.Event.SHA256 | String | SHA256 hash of the file. |
| SentinelOne.Event.AgentOS | String | Operating system type. Can be “windows”, “linux”, “macos”, or “windows_legac”. |
| SentinelOne.Event.ProcessID | Number | The process ID. |
| SentinelOne.Event.User | String | User assigned to the event. |
| SentinelOne.Event.Time | Date | Process start time. |
| SentinelOne.Event.Endpoint | String | The agent name. |
| SentinelOne.Event.SiteName | String | Site name. |
| SentinelOne.Event.EventType | String | Event type. Can be “events”, “file”, “ip”, “url”, “dns”, “process”, “registry”, “scheduled_task”, or “logins”. |
| SentinelOne.Event.ProcessName | String | The name of the process. |
| SentinelOne.Event.MD5 | String | MD5 hash of the file. |
| SentinelOne.Event.SourceIP | String | The source ip. |
| SentinelOne.Event.SourcePort | String | The source port. |
| SentinelOne.Event.DestinationIP | String | The destination IP. |
| SentinelOne.Event.DestinationPort | String | The destination port. |
| SentinelOne.Event.SourceProcessUser | String | The source process user. |
| SentinelOne.Event.SourceProcessCommandLine | String | The source process command line. |
| SentinelOne.Event.DNSRequest | String | The DNS Request. |
| SentinelOne.Event.FileFullName | String | The file full name. |
| SentinelOne.Event.EventTime | String | The event time. |
| Event.ID | String | Event process ID. |
| Event.Name | String | Event name. |
| Event.Type | String | Event type. |
| SentinelOne.Cursor.Event | String | cursor to recieve next page |
sentinelone-create-query
Runs a Deep Visibility query and returns the queryId. You can use the queryId for all other commands, such as the sentinelone-get-events command.
Base Command
sentinelone-create-query
Input
| Argument Name | Description | Required |
|---|---|---|
| query | The query string for which to return events. | Required |
| from_date | Query start date, for example, “2019-08-03T04:49:26.257525Z”. Limited to 93 days ago. | Required |
| to_date | Query end date, for example, “2019-08-03T04:49:26.257525Z”. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Query.FromDate | Date | Query start date. |
| SentinelOne.Query.Query | String | The search query string. |
| SentinelOne.Query.QueryID | String | The query ID. |
| SentinelOne.Query.ToDate | Date | Query end date. |
sentinelone-get-processes
Returns a list of Deep Visibility events from query by event type - process.
Base Command
sentinelone-get-processes
Input
| Argument Name | Description | Required |
|---|---|---|
| query_id | The queryId that is returned when creating a query under Create Query. Example: “q1xx2xx3”. Get the query_id from the “get-query-id” command. | Required |
| limit | Maximum number of items to return (1-100). Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Event.ParentProcessID | Number | Parent process ID. |
| SentinelOne.Event.ProcessUID | String | The process unique identifier. |
| SentinelOne.Event.SHA1 | String | SHA1 hash of the process image. |
| SentinelOne.Event.SubsystemType | String | Process sub-system. |
| SentinelOne.Event.ParentProcessStartTime | Date | The parent process start time. |
| SentinelOne.Event.ProcessID | Number | The process ID. |
| SentinelOne.Event.ParentProcessUID | String | Parent process unique identifier. |
| SentinelOne.Event.User | String | User assigned to the event. |
| SentinelOne.Event.Time | Date | Start time of the process. |
| SentinelOne.Event.ParentProcessName | String | Parent process name. |
| SentinelOne.Event.SiteName | String | Site name. |
| SentinelOne.Event.EventType | String | The event type. |
| SentinelOne.Event.Endpoint | String | The agent name (endpoint). |
| SentinelOne.Event.IntegrityLevel | String | Process integrity level. |
| SentinelOne.Event.CMD | String | Process CMD. |
| SentinelOne.Event.ProcessName | String | Process name. |
| SentinelOne.Event.ProcessDisplayName | String | Process display name. |
sentinelone-shutdown-agent
Sends a shutdown command to all agents that match the input filter.
Base Command
sentinelone-shutdown-agent
Input
| Argument Name | Description | Required |
|---|---|---|
| query | A free-text search term that will match applicable attributes (sub-string match). Note: A device’s physical addresses will only be matched if they start with the search term (not if they contain the search term). | Optional |
| agent_id | A comma-separated list of agents IDs to shutdown. | Optional |
| group_id | The ID of the network group. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.ID | String | The ID of the agent that was shutdown. |
sentinelone-uninstall-agent
Sends an uninstall command to all agents that match the input filter.
Base Command
sentinelone-uninstall-agent
Input
| Argument Name | Description | Required |
|---|---|---|
| query | A free-text search term that will match applicable attributes (sub-string match). Note: A device’s physical addresses will only be matched if they start with the search term (not if they contain the search term). | Optional |
| agent_id | A comma-separated list of agents IDs to shutdown. | Optional |
| group_id | The ID of the network group. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.uninstall.Affected | String | Number of affected agents. |
sentinelone-update-threats-verdict
Updates the analyst verdict to a group of threats that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-update-threats-verdict
Input
| Argument Name | Description | Required |
|---|---|---|
| verdict | Analyst verdict action. Possible values are: undefined, true_positive, false_positive, suspicious. | Required |
| threat_ids | A comma-separated list of threat IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Updated | Boolean | Whether the threat was successfully updated in the analyst verdict. |
| SentinelOne.Threat.Update.Action | String | Name of the analyst verdict action performed on the threats. |
sentinelone-update-alerts-verdict
Updates the analyst verdict to a group of alerts that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-update-alerts-verdict
Input
| Argument Name | Description | Required |
|---|---|---|
| verdict | Analyst verdict action. Possible values are: undefined, true_positive, false_positive, suspicious. | Required |
| alert_ids | A comma-separated list of alert IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Alert.ID | String | The alert ID. |
| SentinelOne.Alert.Updated | Boolean | Whether the alert was successfully updated in the analyst verdict. |
| SentinelOne.Alert.Update.Action | String | Name of the analyst verdict action performed on the alerts. |
sentinelone-create-star-rule
Creates a custom STAR rule. Relevant for API version 2.1.
Base Command
sentinelone-create-star-rule
Input
| Argument Name | Description | Required |
|---|---|---|
| name | The name of the STAR rule. | Required |
| rule_severity | The rule severity. Possible values are: Low, Medium, High, Critical. | Required |
| expiration_mode | Type of expiration mode. Possible values are: Permanent, Temporary. | Required |
| query_type | Type of the query. For now it’s “events”. Possible values are: events, processes. | Required |
| query | The query string for which to return events. | Required |
| description | The description of the STAR rule. | Optional |
| expiration_date | If expiration mode is “Temporary” then it should be supplied, for example, “2019-08-03T04:49:26.257525Z” . | Optional |
| site_ids | A comma-separated list of site IDs. | Optional |
| group_ids | A comma-separated list of Group IDs. | Optional |
| account_ids | A comma-separated list of Account IDs. | Optional |
| network_quarantine | Whether to enable the network quarantine of the STAR rule. Possible values are: true, false. | Required |
| treatAsThreat | The treatAsThreat type. Possible values are: Malicious, Suspicious, UNDEFINED. | Required |
| query_lang | The query language version. Supported values are “1.0” and “2.0”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.StarRule.ID | String | The STAR rule ID. |
| SentinelOne.StarRule.Name | String | The STAR rule name. |
| SentinelOne.StarRule.Status | String | The status of the STAR rule. |
| SentinelOne.StarRule.Severity | String | The severity of the STAR rule. |
| SentinelOne.StarRule.Description | String | The description of the STAR rule. |
| SentinelOne.StarRule.NetworkQuarantine | Boolean | The network quarantine of the STAR rule. |
| SentinelOne.StarRule.TreatAsThreat | String | The Treat As Threat of the STAR rule. |
| SentinelOne.StarRule.ExpirationMode | String | The expiration mode of the STAR rule. |
| SentinelOne.StarRule.ExpirationDate | String | The expiration date of the STAR rule. |
| SentinelOne.StarRule.ScopeHierarchy | String | The scope hierarchy of the STAR rule. |
| SentinelOne.StarRule.CreatedAt | String | The created time for the STAR rule. |
| SentinelOne.StarRule.UpdatedAt | String | The updated time for the STAR rule. |
| SentinelOne.StarRule.QueryLanguage | String | The Query language for the STAR rule. |
sentinelone-get-star-rules
Get a list of custom detection rules for a given scope. Relevant for API version 2.1.
Base Command
sentinelone-get-star-rules
Input
| Argument Name | Description | Required |
|---|---|---|
| status | A comma-separated list of the status of the STAR rule. Available options are: “Activating, Active, Deleted, Deleting, Disabled, Disabling and Draft”.Example: “Draft,Active”. | Optional |
| creator_contains | Free-text filter by rule creator (supports multiple values). Example: “Service Pack 1”. | Optional |
| queryType | Return rules with the filtered type. Example: “events”. Possible values are: events, processes. | Optional |
| query | Free-text filter by S1 query (supports multiple values). Example: “Service Pack 1”. | Optional |
| description_contains | Free-text filter by rule description (supports multiple values). Example: “Service Pack 1”. | Optional |
| ruleIds | A comma-separated list of Rules IDs. Example: “225494730938493804,225494730938493915”. | Optional |
| name_contains | Free-text filter by rule name (supports multiple values). Example: “Service Pack 1”. | Optional |
| accountIds | A comma-separated list of Account IDs to filter by. Example: “225494730938493804,225494730938493915”. | Optional |
| expirationMode | Return rules with the filtered expiration mode. Example: “Permanent”. Possible values are: Temporary, Permanent. | Optional |
| limit | Limit number of returned items (1-1000). Example: “10”. | Optional |
| siteIds | A comma-separated list of site IDs to filter by. Example: “225494730938493804,225494730938493915”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.StarRule.ID | Number | The STAR rule ID. |
| SentinelOne.StarRule.Creator | string | The STAR rule creator. |
| SentinelOne.StarRule.Name | string | The STAR rule name. |
| SentinelOne.StarRule.Status | string | The STAR rule status. |
| SentinelOne.StarRule.Severity | string | The STAR rule severity. |
| SentinelOne.StarRule.GeneratedAlerts | Number | The number of STAR rule generated alerts. |
| SentinelOne.StarRule.Description | string | The STAR rule description. |
| SentinelOne.StarRule.StatusReason | string | The STAR rule status reason. |
| SentinelOne.StarRule.ExpirationMode | string | The STAR rule expiration mode. |
| SentinelOne.StarRule.ExpirationDate | Date | The STAR rule expiration date. |
| SentinelOne.StarRule.Expired | Boolean | Whether the STAR rule expired. |
sentinelone-update-star-rule
Updates a custom STAR rule. Relevant for API version 2.1.
Base Command
sentinelone-update-star-rule
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_id | Rule ID Example: “225494730938493804”. | Required |
| name | The name of the STAR rule. | Required |
| rule_severity | The rule severity. Possible values are: Low, Medium, High, Critical. | Required |
| expiration_mode | Type of expiration mode. Possible values are: Permanent, Temporary. | Required |
| query_type | Type of the query. For now it’s “events”. Possible values are: events, processes. | Required |
| query | The query string for which to return events. | Required |
| description | The description of the STAR rule. | Optional |
| expiration_date | If expiration mode is “Temporary” then it should be supplied, for example, “2019-08-03T04:49:26.257525Z”. | Optional |
| site_ids | A comma-separated list of site IDs. | Optional |
| group_ids | A comma-separated list of group IDs. | Optional |
| account_ids | A comma-separated list of account IDs. | Optional |
| network_quarantine | Whether to enable the network quarantine of the STAR rule. Possible values are: true, false. | Required |
| treatAsThreat | The treatAsThreat. Possible values are: Malicious, Suspicious, UNDEFINED. | Required |
| query_lang | The query language version. Supported values are “1.0” and “2.0”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.StarRule.ID | String | The STAR rule ID. |
| SentinelOne.StarRule.Name | String | The STAR rule name. |
| SentinelOne.StarRule.Status | String | The status of the STAR rule. |
| SentinelOne.StarRule.Severity | String | The severity of the STAR rule. |
| SentinelOne.StarRule.Description | String | The description of the STAR rule. |
| SentinelOne.StarRule.NetworkQuarantine | Boolean | The network quarantine of the STAR rule. |
| SentinelOne.StarRule.TreatAsThreat | String | The Treat As Threat of the STAR rule. |
| SentinelOne.StarRule.ExpirationMode | String | The expiration mode of the STAR rule. |
| SentinelOne.StarRule.ExpirationDate | String | The expiration date of the STAR rule. |
| SentinelOne.StarRule.ScopeHierarchy | String | The scope hierarchy of the STAR rule. |
| SentinelOne.StarRule.CreatedAt | String | The created time for the STAR rule. |
| SentinelOne.StarRule.UpdatedAt | String | The updated time for the STAR rule. |
| SentinelOne.StarRule.QueryLanguage | String | The Query language for the STAR rule. |
sentinelone-enable-star-rules
Activate Custom Detection rules that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-enable-star-rules
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_ids | A comma-separated list of STAR rule IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.StarRule.ID | String | The Rule ID. |
| SentinelOne.StarRule.Enabled | Boolean | Whether the STAR rule was successfully enabled. |
sentinelone-disable-star-rules
Disable Custom Detection rules that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-disable-star-rules
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_ids | A comma-separated list of STAR rule IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.StarRule.ID | String | The Rule ID. |
| SentinelOne.StarRule.Disabled | Boolean | Whether the STAR rule was successfully disabled. |
sentinelone-delete-star-rule
Deletes Custom Detection Rules that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-delete-star-rule
Input
| Argument Name | Description | Required |
|---|---|---|
| rule_ids | A comma-separated list of STAR rule IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.StarRule.ID | String | The Rule ID. |
| SentinelOne.StarRule.Deleted | Boolean | Whether the STAR rule was successfully deleted. |
sentinelone-get-blocklist
Retrieve the blocklist (“blacklist” in SentinelOne documentation). You can filter by SHA1 or SHA256 hash. If the global flag is true, then group_ids, site_ids, and account_ids are ignored.
Base Command
sentinelone-get-blocklist
Input
| Argument Name | Description | Required |
|---|---|---|
| global | Whether the global list is accessible. (Same as tenant flag in API docs.). Possible values are: true, false. Default is true. |
Optional |
| group_ids | Comma-separated list of group IDs to filter by. | Optional |
| site_ids | Comma-separated list of site IDs to filter by. | Optional |
| account_ids | Comma-separated list of account IDs to filter by. | Optional |
| offset | The number of records to skip (for paging). Default is 0. | Optional |
| limit | The maximum number of records to return. Default is 1000. | Optional |
| hash | Hash to search for in the blocklist. | Optional |
| sha1 | SHA1 hash to search for in the blocklist. | Optional |
| sha256Value | SHA256 hash to search for in the blocklist. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Blocklist.UserId | String | User ID. |
| SentinelOne.Blocklist.UpdatedAt | String | When entry was most recently updated. |
| SentinelOne.Blocklist.Value | String | File hash. |
| SentinelOne.Blocklist.ScopePath | String | SentinelOne list scope. |
| SentinelOne.Blocklist.Type | String | Block list type. |
| SentinelOne.Blocklist.Source | String | Source of entry. |
| SentinelOne.Blocklist.ID | String | Entry ID. |
| SentinelOne.Blocklist.CreatedAt | String | Date entry was created. |
| SentinelOne.Blocklist.Description | String | Description of the blocklist. |
| SentinelOne.Blocklist.OSType | String | Operating system type block is enforced on. |
| SentinelOne.Blocklist.ScopeName | String | Name of the blocklist scope. |
sentinelone-add-hash-to-blocklist
Add a hash to the blocklist in SentinelOne.
If a scope is provided (site, account, or group), the hash will be added to that specific scope.
If no scope is provided, the hash will be added to the global blocklist.
Base Command
sentinelone-add-hash-to-blocklist
Input
| Argument Name | Description | Required |
|---|---|---|
| sha1 | SHA1 hash to add to the blocklist. | Optional |
| sha256Value | SHA256 hash to add to the blocklist. | Optional |
| source | String describing the source of the block. Default is XSOAR. | Optional |
| os_type | Type of operating system. Possible values are: windows, linux, macos. | Required |
| description | Note stored in SentinelOne about the block. Default is Blocked from XSOAR. | Optional |
| site_ids | Comma-separated string of site IDs to add the hash to. | Optional |
| account_ids | Comma-separated string of account IDs to add the hash to. | Optional |
| group_ids | Comma-separated string of group IDs to add the hash to. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.AddHashToBlocklist.hash | unknown | Hash of the file. |
| SentinelOne.AddHashToBlocklist.status | unknown | Status of the action to add a hash to the blocklist. |
sentinelone-remove-hash-from-blocklist
Remove a hash from the blocklist in SentinelOne.
If a scope is provided (site, account, or group), the hash will be removed from that specific scope.
If no scope is provided, the hash will be removed from the global blocklist.
Base Command
sentinelone-remove-hash-from-blocklist
Input
| Argument Name | Description | Required |
|---|---|---|
| sha1 | SHA1 hash to remove from the blocklist. | Optional |
| sha256Value | SHA256 hash to remove from the blocklist. | Optional |
| os_type | Optional operating system type. If not supplied, will remove the SHA1 hash across all platforms. Possible values are: windows, macos, linux. | Optional |
| site_ids | Comma-separated string of site IDs to remove the hash from. | Optional |
| account_ids | Comma-separated string of account IDs to remove the hash from. | Optional |
| group_ids | Comma-separated string of group IDs to remove the hash from. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.RemoveHashFromBlocklist.hash | unknown | Hash of the file. |
| SentinelOne.RemoveHashFromBlocklist.status | unknown | Status of the action to remove a hash from the blocklist. |
sentinelone-fetch-file
Invokes a fetch files command against an agent endpoint.
Base Command
sentinelone-fetch-file
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_id | Agent ID to retrieve the file from. | Required |
| file_path | File path to download the file from. | Required |
| password | Password to protect the zip file with. | Required |
Context Output
There is no context output for this command.
sentinelone-download-fetched-file
Download a file fetched using th sentinelone-fetch-file command to submit the request and the sentinelone-get-activities command to get the download path.
Base Command
sentinelone-download-fetched-file
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_id | SentinelOne agent ID. Default is Agent ID. | Required |
| activity_id | Activity ID in the get-activities command. | Required |
| password | Password used in the sentinelone-fetch-file command. | Required |
Context Output
There is no context output for this command.
sentinelone-write-threat-note
Add a threat note to one or more threats. Relevant for API version 2.1.
Base Command
sentinelone-write-threat-note
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_ids | A comma-separated list of threat IDs. | Required |
| note | Threat Note Text. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Note | String | The threat note. |
| SentinelOne.Threat.Status | String | Whether the note was added successfully. |
sentinelone-create-ioc
Add an IoC to the Threat Intelligence database. Relevant for API version 2.1.
Base Command
sentinelone-create-ioc
Input
| Argument Name | Description | Required |
|---|---|---|
| name | Threat Intelligence indicator name. | Required |
| source | The source of the identified Threat Intelligence indicator. | Required |
| type | The type of the Threat Intelligence indicator. Possible values are: DNS, IPV4, IPV6, MD5, SHA1, SHA256, URL. | Required |
| method | The comparison method used by SentinelOne to trigger the event. Possible values are: EQUALS. | Required |
| validUntil | Expiration date for the Threat Intelligence indicator. | Required |
| value | The value of the Threat Intelligence indicator. | Required |
| account_ids | List of account IDs to filter by. | Required |
| externalId | The unique identifier of the indicator as provided by the Threat Intelligence source. | Optional |
| description | Description of the Threat Intelligence indicator. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.IOC.UUID | String | The IOC UUID. |
| SentinelOne.IOC.Name | String | Threat Intelligence indicator name. |
| SentinelOne.IOC.Source | String | The source of the identified Threat Intelligence indicator. |
| SentinelOne.IOC.Type | String | The type of the Threat Intelligence indicator. |
| SentinelOne.IOC.BatchId | String | The IOC batch ID. |
| SentinelOne.IOC.Creator | String | The IOC creator. |
| SentinelOne.IOC.Scope | String | The IOC scope. |
| SentinelOne.IOC.ScopeId | String | The IOC scope ID. |
| SentinelOne.IOC.ValidUntil | String | Expiration date for the Threat Intelligence indicator. |
| SentinelOne.IOC.Description | String | Description of the Threat Intelligence indicator. |
| SentinelOne.IOC.ExternalId | String | The unique identifier of the indicator as provided by the Threat Intelligence source. |
sentinelone-delete-ioc
Delete an IOC from the Threat Intelligence database that matches a filter. Relevant for API version 2.1.
Base Command
sentinelone-delete-ioc
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | List of account IDs to filter by. | Required |
| uuids | UUID of Threat Intelligence indicator. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.IOC.UUID | String | The IOC UUID. |
| SentinelOne.IOC.Deleted | Boolean | Whether the Threat Intelligence indicator was deleted. |
sentinelone-get-iocs
Get the IOCs of a specified account that match the filter. Relevant for API version 2.1.
Base Command
sentinelone-get-iocs
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | List of account IDs to filter by. | Required |
| limit | Limit number of returned items (1-1000). Default is 1000. | Optional |
| upload_time_gte | The time (greater than or equal to) at which the Threat Intelligence indicator was uploaded to the SentinelOne database. Example: “2022-07-13T20:33:29.007906Z”. | Optional |
| upload_time_lte | The time (less than or equal to) at which the Threat Intelligence indicator was uploaded to the SentinelOne database. Example: “2022-07-13T20:33:29.007906Z”. | Optional |
| cursor | Cursor position returned by the last request. Should be used for iterating over more than 1000 items. Example: “YWdlbnRfaWQ6NTgwMjkzODE=”. | Optional |
| uuids | A list of unique IDs of the parent process of the indicator of compromise. Example: “2cffae871197f20d864fe8363eee6651”. | Optional |
| type | The type of the Threat Intelligence indicator. Possible values are: DNS, IPV4, IPV6, MD5, SHA1, SHA256, URL. | Optional |
| batch_id | Unique ID of the uploaded indicators batch. Example: “atmtn000000028a881bcf939dc6d92ab55443”. | Optional |
| source | List of the sources of the identified Threat Intelligence indicator. Example: “AlienVault”. | Optional |
| value | The value of the Threat Intelligence indicator. Example: “175.0.x.x”. | Optional |
| external_id | The unique identifier of the indicator as provided by the Threat Intelligence source. Example: “e277603e-1060-5ad4-9937-c26c97f1ca68”. | Optional |
| name_contains | A comma-separated list of free-text filtered by the indicator name. Example: “foo.dll”. | Optional |
| creator_contains | A comma-separated list of free-text filtered by the user who uploaded the Threat Intelligence indicator. Example: “admin@sentinelone.com”. | Optional |
| description_contains | A comma-separated list of free-text filtered by the description of the indicator. Example: “Malicious-activity”. | Optional |
| category_in | The categories of the Threat Intelligence indicator. Example: The malware type associated with the IOC. | Optional |
| updated_at_gte | The time (greater or equal to) at which the indicator was last updated in the SentinelOne database. Example: “2021-07-13T20:33:29.007906Z”. | Optional |
| updated_at_lte | The time (less than or equal to) at which the indicator was last updated in the SentinelOne database. Example: “2021-07-13T20:33:29.007906Z”. | Optional |
| creation_time_gte | Creation time (greater than or equal to) as set by the user. Example: “2021-07-13T20:33:29.007906Z”. | Optional |
| creation_time_lte | Creation time (less than or equal to) as set by the user. Example: “2021-07-13T20:33:29.007906Z”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.IOC.UUID | String | The IOC UUID. |
| SentinelOne.IOC.Creator | String | Threat Intelligence indicator creator. |
| SentinelOne.IOC.Name | String | Threat Intelligence indicator name. |
| SentinelOne.IOC.Value | String | Threat Intelligence indicator value. |
| SentinelOne.IOC.Description | String | Threat Intelligence indicator description. |
| SentinelOne.IOC.Type | String | Threat Intelligence indicator type. |
| SentinelOne.IOC.ExternalId | String | Threat Intelligence indicator external ID. |
| SentinelOne.IOC.Source | String | Threat Intelligence indicator source. |
| SentinelOne.IOC.UploadTime | String | Threat Intelligence indicator upload time. |
| SentinelOne.IOC.ValidUntil | String | Threat Intelligence indicator expiration time. |
sentinelone-create-power-query
Deprecated. Start a Deep Visibility Power query to get back status and potential results (ping afterwards using the queryId if query has not finished). Relevant for API version 2.1
Base Command
sentinelone-create-power-query
Input
| Argument Name | Description | Required |
|---|---|---|
| query | Events matching the query search term will be returned. | Required |
| from_date | Events created after this timestamp. | Required |
| to_date | Events created before or at this timestamp. | Required |
| limit | Limit number of returned items (1-100000). | Optional |
Context Output
There is no context output for this command.
sentinelone-ping-power-query
Deprecated. Ping a Deep Visibility Power query using the queryId argument if results have not returned from an initial Power query or a previous ping. Relevant for API version 2.1.
Base Command
sentinelone-ping-power-query
Input
| Argument Name | Description | Required |
|---|---|---|
| queryId | QueryId. | Required |
Context Output
There is no context output for this command.
sentinelone-update-threats-status
Updates the incident status to a group of threats that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-update-threats-status
Input
| Argument Name | Description | Required |
|---|---|---|
| status | Incident status. Possible values are: in_progress, resolved, unresolved. | Required |
| threat_ids | A comma-separated list of threat IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Updated | Boolean | Whether the threat was successfully updated. |
| SentinelOne.Threat.Status | String | Name of the status performed on the threats. |
sentinelone-update-alerts-status
Updates the incident status to a group of alerts that match the specified input filter. Relevant for API version 2.1.
Base Command
sentinelone-update-alerts-status
Input
| Argument Name | Description | Required |
|---|---|---|
| status | Incident status. Possible values are: in_progress, resolved, unresolved. | Required |
| alert_ids | A comma-separated list of alert IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Alert.ID | String | The alert ID. |
| SentinelOne.Alert.Updated | Boolean | Whether the alert was successfully updated. |
| SentinelOne.Alert.Status | String | The status performed on the alerts. |
sentinelone-expire-site
Expire the site of the given ID
Base Command
sentinelone-expire-site
Input
| Argument Name | Description | Required |
|---|---|---|
| site_id | A valid site ID. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Site.ID | String | The site ID. |
| SentinelOne.Site.Name | String | The site name. |
| SentinelOne.Site.State | String | The site state. |
| SentinelOne.Site.SKU | String | The SKU of product features active for this site. |
| SentinelOne.Site.SiteType | String | The site type. |
| SentinelOne.Site.Suite | String | The site suite. |
| SentinelOne.Site.TotalLicenses | String | The total licenses. |
| SentinelOne.Site.AccountID | String | The account ID. |
| SentinelOne.Site.Creator | String | Full name of the creating user. |
| SentinelOne.Site.CreatorID | String | ID of the creating user. |
| SentinelOne.Site.Description | String | Description of the site. |
| SentinelOne.Site.Expiration | String | Expiration date of the site. |
sentinelone-fetch-threat-file
Fetch a file associated with the threat that matches the filter.
Base Command
sentinelone-fetch-threat-file
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_id | Please provide the Valid Threat ID. Example: 14629133470822878. | Required |
| password | File encryption password. (At least 10 characters, three out of this list “uppercase”, “lowercase”, “digits” and “symbols” are mandatory. Maximum length is 256 characters.). | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Downloadable | Boolean | Whether the file is downloadable. |
| SentinelOne.Threat.ZippedFile | String | Details of the zipped folder. |
sentinelone-get-alerts
Get the list of alerts that matches the filter provided. Relevant for API version 2.1.
Base Command
sentinelone-get-alerts
Input
| Argument Name | Description | Required |
|---|---|---|
| created_from | Greater than or equal to the time created. Example: “2018-02-27T04:49:26.257525Z”, “10 days”, “2 hours”,”5 months”. | Required |
| created_until | Less than or equal to the time created. Example: “2018-02-27T04:49:26.257525Z”, “10 days”, “2 hours”,”5 months”. | Optional |
| ruleName | Free-text filter by rule name. Example: “rule1”. | Optional |
| incidentStatus | Incident status. Example: “IN_PROGRESS”. | Optional |
| analystVerdict | Analyst verdict. Example: “TRUE_POSITIVE”. | Optional |
| alert_ids | A comma-separated list of alert IDs. | Optional |
| limit | Limit number of returned items (1-1000). Default is 1000. | Optional |
| site_ids | A comma-separated list of site IDs to filter by. Example: “225494730938493804,225494730938493915”. | Optional |
| cursor | Cursor position returned by the last request. Should be used for iterating over more than 1000 items. Example: “YWdlbnRfaWQ6NTgwMjkzODE=”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Alert.EventType | String | Event type. |
| SentinelOne.Alert.RuleName | String | The rule name. |
| SentinelOne.Alert.SrcProcUser | String | Source process user. |
| SentinelOne.Alert.SrcProcName | String | Source process name. |
| SentinelOne.Alert.SrcProcPath | String | Source process file path. |
| SentinelOne.Alert.SrcProcCommandline | String | The command line |
| SentinelOne.Alert.SrcProcSHA1 | String | Source process SHA1 file hash. |
| SentinelOne.Alert.SrcProcStartTime | String | PID start time. |
| SentinelOne.Alert.SrcProcStorylineId | String | Source process story line ID. |
| SentinelOne.Alert.SrcParentProcName | String | Source parent process name. |
| SentinelOne.Alert.SrcParentProcPath | String | Source parent process file path. |
| SentinelOne.Alert.SrcParentProcCommandline | String | Source parent process command line. |
| SentinelOne.Alert.SrcParentProcStartTime | String | PID start time. |
| SentinelOne.Alert.SrcParentProcUser | String | Source parent process user. |
| SentinelOne.Alert.SrcParentProcSHA1 | String | Source parent process SHA1 file hash. |
| SentinelOne.Alert.SrcProcSignerIdentity | String | Source process file signer identity. |
| SentinelOne.Alert.SrcParentProcSignerIdentity | String | Source parent process file signer identity. |
| SentinelOne.Alert.AlertCreatedAt | String | The the alert was created. |
| SentinelOne.Alert.AlertId | String | Alert ID. |
| SentinelOne.Alert.AnalystVerdict | String | Analyst verdict. |
| SentinelOne.Alert.IncidentStatus | String | Incident status |
| SentinelOne.Alert.EndpointName | String | Endpoint name |
| SentinelOne.Alert.AgentId | String | Agent ID. |
| SentinelOne.Alert.AgentUUID | String | Agent UUID. |
| SentinelOne.Alert.dvEventId | String | Deep Visibility event ID. |
| SentinelOne.Alert.AgentOS | String | Agent operating system. |
| SentinelOne.Alert.AgentVersion | String | Agent version. |
| SentinelOne.Alert.SiteId | String | Site ID. |
| SentinelOne.Alert.RuleId | String | Rule ID. |
sentinelone-get-installed-applications
Get the installed applications for a specific agent.
Base Command
sentinelone-get-installed-applications
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_ids | A comma-separated list of agent IDs. Example: 14629133470822878,14627455454652878. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Application.Name | String | The application name. |
| SentinelOne.Application.Publisher | String | The publisher. |
| SentinelOne.Application.Size | String | The size of the application in bytes. |
| SentinelOne.Application.Version | String | The version of the application. |
| SentinelOne.Application.InstalledOn | String | The date the application was installed. |
sentinelone-initiate-endpoint-scan
Initiate the endpoint virus scan on provided agent IDs.
Base Command
sentinelone-initiate-endpoint-scan
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_ids | A comma-separated list of Agent IDs. Example: 14629133470822878,14627455454652878. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.AgentID | String | The Agent ID. |
| SentinelOne.Agent.Initiated | Boolean | Whether the scan was initiated. |
sentinelone-remove-item-from-whitelist
Remove an item from the SentinelOne exclusion list
Base Command
sentinelone-remove-item-from-whitelist
Input
| Argument Name | Description | Required |
|---|---|---|
| item | Value of the item to be removed from the exclusion list. | Required |
| os_type | OS type. Can be “windows”, “windows_legacy”, “macos”, or “linux”. Possible values are: windows, windows_legacy, macos, linux. | Optional |
| exclusion_type | Exclusion item type. The options are: file_type, path, white_hash, certificate, or browser. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.RemoveItemFromWhitelist.status | String | Status on if items were removed from whitelist or not found on whitelist. |
| SentinelOne.RemoveItemFromWhitelist.item | String | Item removed fom whitelist. |
sentinelone-run-remote-script
Run a remote script that was uploaded to the SentinelOne Script Library.
Base Command
sentinelone-run-remote-script
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | A comma-separated list of account IDs. | Required |
| output_destination | Output destination. Possible values: DataSetCloud/Local/None/SentinelCloud. Possible values are: DataSetCloud, Local, None, SentinelCloud. | Required |
| task_description | Task description. | Required |
| script_id | Script ID. | Required |
| output_directory | Output directory. | Optional |
| agent_ids | A comma-separated list of agent IDs on which the script should run. | Required |
| singularity_xdr_Keyword | Singularityxdr keyword. | Optional |
| singularity_xdr_Url | Singularityxdr keyword. | Optional |
| api_key | Api key. | Optional |
| input_params | Input params. | Optional |
| password | Password. | Optional |
| script_runtime_timeout_seconds | Script runtime timout in seconds for current execution. | Optional |
| requires_approval | If set to true, execution will require approval. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.RunRemoteScript.pendingExecutionId | string | ID of the created pending execution. Present only if pending flag is true. |
| SentinelOne.RunRemoteScript.pending | boolean | Flag indicating if the requested script execution requires approval and is created as a pending execution. |
| SentinelOne.RunRemoteScript.affected | number | Number of entities affected by the requested operation. |
| SentinelOne.RunRemoteScript.parentTaskId | string | The parent task ID of the script execution task. Null in case of pending execution. |
sentinelone-get-remote-script-task-status
Get remote script tasks using a variety of filters.
Base Command
sentinelone-get-remote-script-task-status
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | A comma-separated list of account IDs. Example: ‘225494730938493804,225494730938493915’. | Optional |
| computer_name_contains | Free-text filter by agent computer name (supports multiple values). | Optional |
| count_only | If true, only total number of items will be returned, without any of the actual objects. | Optional |
| created_at_gt | Created at greater than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| created_at_gte | Created at greater or equal than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| created_at_lt | Created at lesser than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| created_at_lte | Created at lesser or equal than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| cursor | Cursor position returned by the last request. Use to iterate over more than 1000 items. Example: ‘YWdlbnRfaWQ6NTgwMjkzODE=’. | Optional |
| description_contains | Only include tasks with specific description. | Optional |
| detailed_status_contains | Only include tasks with specific detailed status. | Optional |
| group_ids | Comma-separated list of Group IDs to filter by. Example: ‘225494730938493804,225494730938493915’. | Optional |
| ids | Comma-separated list of IDs to filter by. Example: ‘225494730938493804,225494730938493915’. | Optional |
| initiated_by_contains | Only include tasks from specific initiating user. | Optional |
| limit | Limit number of returned items (1-1000). Example: ‘10’. | Optional |
| parent_task_id | Parent task ID to fetch the status by. Example: ‘225494730938493804’. | Required |
| parent_task_id_in | Comma-separated list of IDs to filter by. | Optional |
| query | A free-text search term that will match applicable attributes (sub-string match). | Optional |
| site_ids | Comma-separated list of Site IDs to filter by. Example: ‘225494730938493804,225494730938493915’. | Optional |
| status | Status of the script task. Example: ‘created’. | Optional |
| tenant | A tenant scope request. | Optional |
| updated_at_gt | Updated at greater than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| updated_at_gte | Updated at greater or equal than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| updated_at_lt | Updated at lesser than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| updated_at_lte | Updated at lesser or equal than datetime. Example: ‘2018-02-27T04:49:26.257525Z’. | Optional |
| uuid_contains | Free-text filter by agent UUID (supports multiple values). | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.GetRemoteScript.id | string | ID of the task. |
| SentinelOne.GetRemoteScript.accountId | string | Account ID where this script is executed. |
| SentinelOne.GetRemoteScript.accountName | string | Account name where this script is executed. |
| SentinelOne.GetRemoteScript.agentId | string | Agent ID where this script is executed. |
| SentinelOne.GetRemoteScript.agentIsActive | boolean | The status of the agent. |
| SentinelOne.GetRemoteScript.agentMachineType | string | Agent machine type. |
| SentinelOne.GetRemoteScript.agentOsType | string | Agent operating system type. |
| SentinelOne.GetRemoteScript.agentUuid | string | Agent UUID. |
| SentinelOne.GetRemoteScript.createdAt | string | The script created at datetime. |
| SentinelOne.GetRemoteScript.description | string | The description of the remote script. |
| SentinelOne.GetRemoteScript.detailedStatus | string | The detailed status of the remote script. |
| SentinelOne.GetRemoteScript.groupId | string | Group ID where this script is executed. |
| SentinelOne.GetRemoteScript.groupName | string | Group name where this script is executed. |
| SentinelOne.GetRemoteScript.initiatedBy | string | Remote script initiate by. |
| SentinelOne.GetRemoteScript.initiatedById | string | ID of the remote script initiator. |
| SentinelOne.GetRemoteScript.parentTaskId | string | Parent task ID of the remote script. |
| SentinelOne.GetRemoteScript.siteId | string | Site ID where this script is executed. |
| SentinelOne.GetRemoteScript.siteName | string | Site name where this script is executed. |
| SentinelOne.GetRemoteScript.status | string | Status of the remote script. |
| SentinelOne.GetRemoteScript.statusCode | string | Status code of the remote script. |
| SentinelOne.GetRemoteScript.statusDescription | string | Status description of the remote script. |
| SentinelOne.GetRemoteScript.type | string | Type of remote script. |
| SentinelOne.GetRemoteScript.updateAt | string | Remote script upated at. |
sentinelone-get-remote-script-task-results
Get a script’s result download URL.
Base Command
sentinelone-get-remote-script-task-results
Input
| Argument Name | Description | Required |
|---|---|---|
| computer_names | A comma-separated list of partial or whole computer names, which ran scripts. | Optional |
| task_ids | A comma-separated list of task IDs to get a download link for. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.RemoteScriptResults.taskId | string | ID of the task. |
| SentinelOne.RemoteScriptResults.fileName | string | File name. |
| SentinelOne.RemoteScriptResults.downloadUrl | string | Download URL. |
sentinelone-remote-script-automate-results
Automate a remote script’s execution cycle and return the script’s results.
Base Command
sentinelone-remote-script-automate-results
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | A comma-separated list of account IDs. | Required |
| output_destination | Output destination. Possible values are: DataSetCloud, Local, None, SentinelCloud. | Required |
| task_description | Task description. | Required |
| script_id | Script ID. | Required |
| output_directory | Output directory. | Optional |
| agent_ids | A comma-separated list of agent IDs on which the script should run. | Required |
| singularity_xdr_Keyword | Singularity XDR keyword. | Optional |
| singularity_xdr_Url | Singularity XDR URL. | Optional |
| api_key | API key. | Optional |
| input_params | Input parameters. | Optional |
| password | Password. | Optional |
| script_runtime_timeout_seconds | Script runtime timeout in seconds for current execution. | Optional |
| requires_approval | If set to true, execution will require approval. | Optional |
| interval | Indicates how long to wait between command execution (in seconds) when ‘polling’ argument is true. Minimum value is 10 seconds. Default is 60. | Optional |
| timeout | Indicates the time in seconds until the polling sequence timeouts. Default is 600. | Optional |
| parent_task_id | Parent task ID to fetch the status by. Example: ‘225494730938493804’. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.RemoteScriptResults.taskId | string | ID of the task. |
| SentinelOne.RemoteScriptResults.fileName | string | File name. |
| SentinelOne.RemoteScriptResults.downloadUrl | string | Download URL. |
sentinelone-get-power-query-results
Automate a power query and return the query results. (The maximum timeout of 300 seconds is allowed.)
Base Command
sentinelone-get-power-query-results
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | A comma-separated list of account IDs. | Optional |
| site_ids | A comma-separated list of site IDs on which the query should run. | Optional |
| query | Events matching the query search term will be returned. | Required |
| from_date | Events created after this date. Example: ‘2018-02-27T04:49:26.257525Z’. | Required |
| to_date | Events created before or at this date. Example: ‘2018-02-27T04:49:26.257525Z’. | Required |
| limit | Limit number of returned items (1-100000). | Optional |
| interval | Indicates how long to wait between command execution (in seconds) when ‘polling’ argument is true. Minimum value is 10 seconds. | Optional |
| timeout | Indicates the time in seconds until the polling sequence timeouts. | Optional |
| query_id | QueryId. Example: pq3be5e2747f716cxxxxxxxxxxxxx20a0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.PowerQuery.ResultIndex | List | Result from the power query in list of objects format |
get-mapping-fields
Returns the list of fields for an incident type.
Base Command
get-mapping-fields
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
There is no context output for this command.
update-remote-system
Pushes local changes to the remote system.
Base Command
update-remote-system
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
There is no context output for this command.
get-remote-data
Get remote data from a remote incident. This method does not update the current incident, and should be used for debugging purposes.
Base Command
get-remote-data
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The ticket ID. | Required |
| lastUpdate | Retrieve entries that were created after lastUpdate. | Required |
Context Output
There is no context output for this command.
get-modified-remote-data
Gets the list of incidents that were modified since the last update time. Note that this method is here for debugging purposes. The get-modified-remote-data command is used as part of a Mirroring feature, which is available from version 6.1.
Base Command
get-modified-remote-data
Input
| Argument Name | Description | Required |
|---|---|---|
| last_update | Retrieve entries that were created after lastUpdate. | Optional |
Context Output
There is no context output for this command.
sentinelone-get-dv-query-status
Returns status of a Deep Visibility Query
Base Command
sentinelone-get-dv-query-status
Input
| Argument Name | Description | Required |
|---|---|---|
| query_id | The queryId that is returned when creating a query under Create Query. Example: “q1xx2xx3”. Get the query_id from the “get-query-id” command. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Query.Status.progressStatus | string | Progress Query Status |
| SentinelOne.Query.Status.queryModeInfo.lastActivatedAt | string | Last Activated At |
| SentinelOne.Query.Status.queryModeInfo.mode | string | Query Mode |
| SentinelOne.Query.Status.responseState | string | State of the Query |
| SentinelOne.Query.Status.warnings | string | Warnings during Query |
| SentinelOne.Query.Status.QueryId | string | QueryID From Request |
sentinelone-get-agent-mac
Returns network interface details for a given Agent ID. This includes MAC address details and interface description.
Base Command
sentinelone-get-agent-mac
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_id | AgentId of the System. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.MAC | string | Agent network interface details. |
| SentinelOne.MAC.agent_id | string | AgentID |
| SentinelOne.MAC.hostname | string | Hostname |
| SentinelOne.MAC.int_name | string | Interface Name |
| SentinelOne.MAC.ip | string | IP Address |
| SentinelOne.MAC.mac | string | MAC Address |
sentinelone-get-accounts
Returns details of accounts.
Base Command
sentinelone-get-accounts
Input
| Argument Name | Description | Required |
|---|---|---|
| account_id | Can filter on one account ID. Otherwise, it returns information from all accounts. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Accounts.AccountType | string | The account type. |
| SentinelOne.Accounts.ActiveAgents | number | The account number of active agents. |
| SentinelOne.Accounts.NumberOfSites | number | The account number of sites. |
| SentinelOne.Accounts.State | string | The account state. |
| SentinelOne.Accounts.CreatedAt | string | The account creation date. |
| SentinelOne.Accounts.Expiration | string | The account expiration date. |
| SentinelOne.Accounts.ID | string | The account ID. |
| SentinelOne.Accounts.Name | string | The account name. |
sentinelone-get-threat-notes
Returns threat notes.
Base Command
sentinelone-get-threat-notes
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_id | The ID of the threat. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Notes.CreatedAt | string | The note creation date. |
| SentinelOne.Notes.Creator | string | The note creator. |
| SentinelOne.Notes.CreatorID | string | The note creator ID. |
| SentinelOne.Notes.Edited | boolean | Whether the note was edited or not.. |
| SentinelOne.Notes.ID | string | The note ID. |
| SentinelOne.Notes.Text | string | The note text. |
| SentinelOne.Notes.UpdatedAt | string | The note updated time. |
sentinelone-list-installed-singularity-marketplace-applications
Returns all installed singularity marketplace applications that match the specified filter values.
Base Command
sentinelone-list-installed-singularity-marketplace-applications
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | A comma-separated list of account IDs. | Optional |
| application_catalog_id | Filter results by application catalog id. | Optional |
| creator_contains | Free-text filter by application creator. | Optional |
| ids | A comma-separated list of applications IDs. | Optional |
| name_contains | Free-text filter by application name | Optional |
| site_ids | A comma-separated list of site IDs. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.InstalledApps.ID | string | The application ID. |
| SentinelOne.InstalledApps.Account | string | The account name. |
| SentinelOne.InstalledApps.AccountId | string | The account ID. |
| SentinelOne.InstalledApps.ApplicationCatalogId | string | The application Catalog ID. |
| SentinelOne.InstalledApps.ApplicationCatalogName | string | The application Catalog name. |
| SentinelOne.InstalledApps.AlertMessage | string | The alert message. |
| SentinelOne.InstalledApps.CreatedAt | date | Application created at. |
| SentinelOne.InstalledApps.Creator | string | Application creator. |
| SentinelOne.InstalledApps.CreatorId | string | Application creator ID. |
| SentinelOne.InstalledApps.DesiredStatus | string | Application desired status. |
| SentinelOne.InstalledApps.HasAlert | boolean | Application has alert. |
| SentinelOne.InstalledApps.LastEntityCreatedAt | date | Application last entity created at. |
| SentinelOne.InstalledApps.Modifier | string | Modifier. |
| SentinelOne.InstalledApps.ModifierId | string | Modifier ID. |
| SentinelOne.InstalledApps.ScopeId | string | The scope ID. |
| SentinelOne.InstalledApps.ScopeLevel | string | The scope level. |
| SentinelOne.InstalledApps.Status | string | Status of application. |
| SentinelOne.InstalledApps.UpdatedAt | string | Application updated at. |
| SentinelOne.InstalledApps.ApplicationInstanceName | string | Application instance name. |
sentinelone-get-service-users
Returns all service users that match the specified filter values.
Base Command
sentinelone-get-service-users
Input
| Argument Name | Description | Required |
|---|---|---|
| account_ids | A comma-separated list of account IDs. | Optional |
| role_ids | A comma-separated list of rbac roles to filter by. | Optional |
| ids | A comma-separated list of service user IDs to filter by. | Optional |
| site_ids | A comma-separated list of site IDs. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.ServiceUsers.ID | string | The service user ID. |
| SentinelOne.ServiceUsers.ApiTokenCreatedAt | date | Api token created at. |
| SentinelOne.ServiceUsers.ApiTokenExpiresAt | date | Api token expires at. |
| SentinelOne.ServiceUsers.CreatedAt | date | Service user created at. |
| SentinelOne.ServiceUsers.CreatedById | string | The service user created by Id. |
| SentinelOne.ServiceUsers.CreatedByName | string | The service user created by name. |
| SentinelOne.ServiceUsers.Description | string | Service user description. |
| SentinelOne.ServiceUsers.LastActivation | date | Last activation date. |
| SentinelOne.ServiceUsers.Name | string | Service user name. |
| SentinelOne.ServiceUsers.Scope | string | Service user scope. |
| SentinelOne.ServiceUsers.UpdatedAt | date | Service user updated at. |
| SentinelOne.ServiceUsers.UpdatedById | string | Service user updated by Id. |
| SentinelOne.ServiceUsers.UpdatedByName | string | Service user updated by name. |
| SentinelOne.ServiceUsers.ScopeRolesRoleId | string | Scope roles role Id. |
| SentinelOne.ServiceUsers.ScopeRolesRoleName | string | Scope roles role name. |
| SentinelOne.ServiceUsers.ScopeRolesAccountName | string | Scope roles account name. |
| SentinelOne.ServiceUsers.ScopeRolesId | string | Scope roles Id. |
Incident Mirroring
You can enable incident mirroring between Cortex XSOAR incidents and SentinelOne v2 corresponding events (available from Cortex XSOAR version 6.0.0).
To set up the mirroring:
- Enable Fetching incidents in your instance configuration.
-
In the Mirroring Direction integration parameter, select in which direction the incidents should be mirrored:
Option Description None Turns off incident mirroring. Incoming Any changes in SentinelOne v2 events (mirroring incoming fields) will be reflected in Cortex XSOAR incidents. Outgoing Any changes in Cortex XSOAR incidents will be reflected in SentinelOne v2 events (outgoing mirrored fields). Incoming And Outgoing Changes in Cortex XSOAR incidents and SentinelOne v2 events will be reflected in both directions.
Newly fetched incidents will be mirrored in the chosen direction. However, this selection does not affect existing incidents.
Important Note: To ensure the mirroring works as expected, mappers are required, both for incoming and outgoing, to map the expected fields in Cortex XSOAR and SentinelOne v2.
sentinelone-threat-download-from-cloud
Download a file associated with the threat from the Cloud (BinaryVault).
Base Command
sentinelone-threat-download-from-cloud
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_id | Please provide the Valid Threat ID. Example: 14629133470822878. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.ID | String | The threat ID. |
| SentinelOne.Threat.Downloadable | Boolean | Whether the file is downloadable. |
| SentinelOne.Threat.ZippedFile | String | Details of the zipped folder. |
sentinelone-create-bulk-ioc
Adds a bulk list of IoCs to the Threat Intelligence database. To use this command, the user must upload a JSON file containing a list of IoC objects(each object represents a single IoC to be created) with the required attributes specified in the sentinelone-create-ioc command. Relevant for API version 2.1.
Base Command
sentinelone-create-bulk-ioc
Input
| Argument Name | Description | Required |
|---|---|---|
| entry_id | Entry ID of uploaded IOCs JSON file. | Required |
| account_ids | List of account IDs to filter by. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.IOC.UUID | String | The IOC UUID. |
| SentinelOne.IOC.Name | String | Threat Intelligence indicator name. |
| SentinelOne.IOC.Source | String | The source of the identified Threat Intelligence indicator. |
| SentinelOne.IOC.Type | String | The type of the Threat Intelligence indicator. |
| SentinelOne.IOC.BatchId | String | The IOC batch ID. |
| SentinelOne.IOC.Creator | String | The IOC creator. |
| SentinelOne.IOC.Scope | String | The IOC scope. |
| SentinelOne.IOC.ScopeId | String | The IOC scope ID. |
| SentinelOne.IOC.ValidUntil | String | Expiration date for the Threat Intelligence indicator. |
| SentinelOne.IOC.Description | String | Description of the Threat Intelligence indicator. |
| SentinelOne.IOC.ExternalId | String | The unique identifier of the indicator as provided by the Threat Intelligence source. |
sentinelone-run-powerquery
Run a PowerQuery, where you can pipe one or many search expressions into a set of commands to transform, manipulate, group, and summarize your data.
Base Command
sentinelone-run-powerquery
Input
| Argument Name | Description | Required |
|---|---|---|
| singularity_xdr_url | Singularity Data Lake XDR URL. | Required |
| singularity_xdr_api_key | A Log Read Access API key. | Required |
| query | The query, in PowerQuery syntax. | Required |
| start_time | Start time for your query. | Optional |
| end_time | End time for your query. | Optional |
| priority | Query execution priority (defaults to “low”). Default is low. | Optional |
| recurring | Optional (defaults to false). When set to true, a materialized view of your query is created. Possible values are: true, false. Default is false. | Optional |
| team_emails | Comma-separated list of account emails to query, enabling Cross Team Search. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.PowerQuery.Results.status | String | The status of the PowerQuery execution. |
| SentinelOne.PowerQuery.Results.matchingEvents | Number | Number of events that match the query’s initial filter. |
| SentinelOne.PowerQuery.Results.omittedEvents | Number | Number of events omitted from the final result due to memory limits. |
| SentinelOne.PowerQuery.Results.results | List | A list of result rows returned by the PowerQuery, where each object represents one row (column:value pairs). |
sentinelone-abort-endpoint-scan
Abort the endpoint virus scan on provided agent IDs.
Base Command
sentinelone-abort-endpoint-scan
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_ids | A comma-separated list of Agent IDs. Example: 14629133470822878,14627455454652878. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.AgentID | String | The Agent ID. |
| SentinelOne.Agent.Aborted | Boolean | Whether the scan was aborted. |
sentinelone-threat-analysis
Returns threat analysis. Can only be used with API V2.1.
Base Command
sentinelone-threat-analysis
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_id | Threat ID to get the analysis, for example: “2341398296147451190”. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Threat.AgentDetectionInfo | 18 | Agent detection time information. |
| SentinelOne.Threat.AgentRealtimeInfo | 18 | Agent realtime information. |
| SentinelOne.Threat.ThreatInfo | 18 | Threat information. |
sentinelone-endpoint-fetch-logs
Get the Agent and Endpoint logs from Agents for provided agent IDs
Base Command
sentinelone-endpoint-fetch-logs
Input
| Argument Name | Description | Required |
|---|---|---|
| agent_ids | A comma-separated list of Agent IDs. Example: 14629133470822878,14627455454652878. | Required |
| agents_logs | Fetch Agent logs. Possible values are: true, false. Default is true. | Required |
| customer_facing_logs | Fetch customer-facing logs. Possible values are: true, false. Default is false. | Required |
| platform_logs | Actively fetch logs from the relevant platform (Windows, macOS, or Linux). Possible values are: true, false. Default is false. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Agent.Affected | String | Number of affected endpoints. |
sentinelone-update-uam-alert-verdict
Updates the analyst verdict for a group of UAM alerts. Relevant for API version 2.1.
Base Command
sentinelone-update-uam-alert-verdict
Input
| Argument Name | Description | Required |
|---|---|---|
| analyst_verdict | UAM alert analyst verdict. Possible values are: False positive - Benign, False positive - Benign but suspicious, False positive - System error, False positive - Undefined, False positive - User error, True positive - Advanced persistent threat, True positive - Benign, True positive - Benign but suspicious, True positive - Data exfiltration, True positive - Denial of service, True positive - Exploitation tools, True positive - Insider threat, True positive - Malware, True positive - Phishing attack, True positive - Policy violation, True positive - PUA/Adware, True positive - Ransomware, True positive - Unauthorized access, True positive - Undefined, Undefined. | Required |
| alert_ids | A comma-separated list of UAM alert IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.UAMAlert.ID | String | The UAM alert ID. |
| SentinelOne.UAMAlert.Updated | Boolean | Whether the analyst verdict was successfully updated. |
| SentinelOne.UAMAlert.AnalystVerdict | String | Name of the analyst verdict performed on the alerts. |
sentinelone-update-uam-alert-status
Updates the status for a group of UAM alerts. Relevant for API version 2.1.
Base Command
sentinelone-update-uam-alert-status
Input
| Argument Name | Description | Required |
|---|---|---|
| status | UAM alert status. Possible values are: New, In progress, Resolved. | Required |
| alert_ids | A comma-separated list of UAM alert IDs. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.UAMAlert.ID | String | The UAM alert ID. |
| SentinelOne.UAMAlert.Updated | Boolean | Whether the status was successfully updated. |
| SentinelOne.UAMAlert.Status | String | Name of the status performed on the alerts. |
sentinelone-export-threat-events
Exports the threat’s events as a JSON File. Relevant for API version 2.1.
Base Command
sentinelone-export-threat-events
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_id | Please provide the Valid Threat ID. Example: 14629133470822878. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Export.Events.ThreatId | String | The threat ID. |
| SentinelOne.Export.Events.Filename | String | The name of the file containing the Events. |
sentinelone-export-full-threat-timeline
Exports the threat’s full timeline as a JSON File. Relevant for API version 2.1.
Base Command
sentinelone-export-full-threat-timeline
Input
| Argument Name | Description | Required |
|---|---|---|
| threat_id | Please provide the Valid Threat ID. Example: 14629133470822878. | Required |
| limit | The max number of timeline entries to return, default is 5000. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| SentinelOne.Export.Timeline.ThreatId | String | The threat ID. |
| SentinelOne.Export.Timeline.Filename | String | The name of the file containing the Timeline. |
Configuration parameters
url— Server URL (e.g., https://usea1.sentinelone.net) (required)credentials—api_version— API Version (required)isFetch— Fetch incidentsincidentType— Incident typefetch_type— Fetch incidents from typefetch_uam_alert_type— Fetch incidents from UAM Alert typefetch_time— First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year)fetch_threat_rank— Minimum risk score for importing incidents (0-10), where 0 is low risk and 10 is high risk. Relevant for API version 2.0.fetch_severity— Defines Alert severity to fetch.fetch_incidentStatus— Define which Alerts should be fetched.fetch_threat_incident_statuses— Define which Threats should be fetched.fetch_limit— Fetch limit: The maximum number of threats or alerts to fetchfetch_site_ids— Site IDsblock_site_ids— Block Site IDsinsecure— Trust any certificate (not secure)proxy— Use system proxy settingstoken— API Token (Deprecated)incidentFetchInterval— Incidents Fetch Intervalmirror_direction— Incident Mirroring Directionclose_xsoar_incident— Close Mirrored XSOAR Incident
Commands (78)
-
get-mapping-fieldsReturns the list of fields for an incident type.
-
get-modified-remote-dataGets the list of incidents that were modified since the last update time. Note that this method is here for debugging purposes. The get-modified-remote-data command is used as part of a Mirroring feature, which is available from version 6.1.
-
get-remote-dataGet remote data from a remote incident. This method does not update the current incident, and should be used for debugging purposes.
-
sentinelone-abort-endpoint-scanAbort the endpoint virus scan on provided agent IDs.
-
sentinelone-add-hash-to-blocklistAdd a hash to the blocklist in SentinelOne. Supports scoping by site, group, or account. If Scope not provided, the block will be global.
-
sentinelone-agent-processesDeprecatedDeprecated. Retrieves running processes for a specific agent.
-
sentinelone-broadcast-messageBroadcasts a message to all agents that match the input filters.
-
sentinelone-connect-agentConnects agents to the network.
-
sentinelone-create-bulk-iocAdd bulk list of IoCs to the Threat Intelligence database. Relevant for API version 2.1.
-
sentinelone-create-iocAdd an IoC to the Threat Intelligence database. Relevant for API version 2.1.
-
sentinelone-create-power-queryDeprecatedDeprecated. Use ***sentinelone-get-power-query-results*** instead. Start a Deep Visibility Power query to get back status and potential results (ping afterwards using the queryId if query has not finished). Relevant for API version 2.1.
-
sentinelone-create-queryRuns a Deep Visibility query and returns the queryId. You can use the queryId for all other commands, such as the sentinelone-get-events command.
-
sentinelone-create-star-ruleCreates a custom STAR rule. Relevant for API version 2.1.
-
sentinelone-create-white-list-itemCreates an exclusion item that matches the specified input filter.
-
sentinelone-delete-groupDeletes a group, by the group ID.
-
sentinelone-delete-iocDelete an IOC from the Threat Intelligence database that matches a filter. Relevant for API version 2.1.
-
sentinelone-delete-star-ruleDeletes Custom Detection Rules that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-disable-star-rulesDisable Custom Detection rules that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-disconnect-agentDisconnects agents from the network.
-
sentinelone-download-fetched-fileDownload a file fetched using th sentinelone-fetch-file command to submit the request and the sentinelone-get-activities command to get the download path.
-
sentinelone-enable-star-rulesActivate Custom Detection rules that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-endpoint-fetch-logsGet the Agent and Endpoint logs from Agents for provided agent IDs.
-
sentinelone-expire-siteExpire the site of the given ID.
-
sentinelone-export-full-threat-timelineExports the threat's full timeline as a JSON File. Relevant for API version 2.1.
-
sentinelone-export-threat-eventsExports the threat's events as a JSON File. Relevant for API version 2.1.
-
sentinelone-fetch-fileInvokes a fetch files command against an agent endpoint.
-
sentinelone-fetch-threat-fileFetch a file associated with the threat that matches the filter.
-
sentinelone-get-accountsReturns details of accounts.
-
sentinelone-get-activitiesReturns a list of activities.
-
sentinelone-get-agentReturns the details of an agent according to the agent ID.
-
sentinelone-get-agent-macReturns network interface details for a given Agent ID. This includes MAC address details and interface description.
-
sentinelone-get-alertsGet the list of alerts that matches the filter provided. Relevant for API version 2.1.
-
sentinelone-get-blocklistRetrieve the blocklist ("blacklist" in SentinelOne). You can filter by SHA1 or SHA256 hash. If the `global` flag is `true`, then group_ids, site_ids, and account_ids are ignored.
-
sentinelone-get-dv-query-statusReturns status of a Deep Visibility Query.
-
sentinelone-get-eventsReturns all Deep Visibility events that match the query.
-
sentinelone-get-groupsReturns data for the specified group.
-
sentinelone-get-hashGets the file reputation by a SHA1 hash.
-
sentinelone-get-installed-applicationsGet the installed applications for a specific agent.
-
sentinelone-get-iocsGet the IOCs of a specified account that match the filter. Relevant for API version 2.1.
-
sentinelone-get-power-query-resultsAutomate a power query and return the query results. (The maximum timeout of 300 seconds is allowed.)
-
sentinelone-get-processesReturns a list of Deep Visibility events from query by event type - process.
-
sentinelone-get-remote-script-task-resultsGet a script's result download URL.
-
sentinelone-get-remote-script-task-statusGet remote scripts tasks using a variety of filters.
-
sentinelone-get-service-usersReturns all service users that match the specified filter values.
-
sentinelone-get-siteReturns information about the site, according to the site ID.
-
sentinelone-get-sitesReturns all sites that match the specified criteria.
-
sentinelone-get-star-rulesGet a list of custom detection rules for a given scope. Relevant for API version 2.1.
-
sentinelone-get-threat-notesReturns threat notes.
-
sentinelone-get-threatsReturns threats according to the specified filters.
-
sentinelone-get-white-listLists all exclusion items that match the specified input filter.
-
sentinelone-initiate-endpoint-scanInitiate the endpoint virus scan on provided agent IDs.
-
sentinelone-list-agentsReturns all agents that match the specified criteria.
-
sentinelone-list-installed-singularity-marketplace-applicationsReturns all installed singularity marketplace applications that match the specified filter values.
-
sentinelone-mark-as-threatMarks suspicious threats as threats. Can only be used with API V2.0.
-
sentinelone-mitigate-threatApplies a mitigation action to a group of threats that match the specified input filter.
-
sentinelone-move-agentMoves agents to a new group.
-
sentinelone-ping-power-queryDeprecatedDeprecated. Use ***sentinelone-get-power-query-results*** instead. Ping a Deep Visibility Power query using the queryId argument if results have not returned from an initial Power query or a previous ping. Relevant for API version 2.1.
-
sentinelone-reactivate-siteReactivates an expired site.
-
sentinelone-remote-script-automate-resultsAutomate a remote script's execution cycle and return the script's results.
-
sentinelone-remove-hash-from-blocklistRemove a hash from the global blocklist in SentinelOne.
-
sentinelone-remove-item-from-whitelistRemove an item from the SentinelOne exclusion list.
-
sentinelone-resolve-threatResolves threats using the threat ID. Can only be used with API V2.0.
-
sentinelone-run-powerqueryRun a PowerQuery, where you can pipe one or many search expressions into a set of commands to transform, manipulate, group, and summarize your data.
-
sentinelone-run-remote-scriptRun a remote script that was uploaded to the SentinelOne Script Library.
-
sentinelone-shutdown-agentSends a shutdown command to all agents that match the input filter.
-
sentinelone-threat-analysisReturns threat analysis. Can only be used with API V2.1.
-
sentinelone-threat-download-from-cloudDownload a file associated with the threat from the Cloud (BinaryVault).
-
sentinelone-threat-summaryReturns a dashboard threat summary. Can only be used with API V2.1.
-
sentinelone-uninstall-agentSends an uninstall command to all agents that match the input filter.
-
sentinelone-update-alerts-statusUpdates the incident status to a group of alerts that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-update-alerts-verdictUpdates the analyst verdict to a group of alerts that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-update-star-ruleUpdates a custom STAR rule. Relevant for API version 2.1.
-
sentinelone-update-threats-statusUpdates the incident status to a group of threats that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-update-threats-verdictUpdates the analyst verdict to a group of threats that match the specified input filter. Relevant for API version 2.1.
-
sentinelone-update-uam-alert-statusUpdates the status for a group of UAM alerts. Relevant for API version 2.1.
-
sentinelone-update-uam-alert-verdictUpdates the analyst verdict for a group of UAM alerts. Relevant for API version 2.1.
-
sentinelone-write-threat-noteAdd a threat note to one or more threats. Relevant for API version 2.1.
-
update-remote-systemPushes local changes to the remote system.
category: Endpoint provider: SentinelOne sectionorder: - Connect - Collect commonfields: id: SentinelOne V2 version: -1 configuration: - name: url display: Server URL (e.g., https://usea1.sentinelone.net) required: true type: 0 section: Connect - name: credentials display: "" type: 9 section: Connect displaypassword: API Token hiddenusername: true required: false - name: api_version display: API Version required: true defaultvalue: "2.1" type: 15 section: Connect options: - "2.0" - "2.1" - display: Fetch incidents name: isFetch type: 8 section: Collect required: false - display: Incident type name: incidentType type: 13 section: Connect required: false - name: fetch_type display: Fetch incidents from type defaultvalue: Threats type: 15 section: Collect options: - Alerts - Threats - Both required: false - name: fetch_uam_alert_type display: Fetch incidents from UAM Alert type type: 15 section: Collect options: - ALL - CLOUD - CUSTOM_ALERTS - ENDPOINT - IDENTITY - STAR - THIRD_PARTY required: false - name: fetch_time display: First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days, 3 months, 1 year) defaultvalue: "3 days" type: 0 section: Collect required: false - name: fetch_threat_rank display: "Minimum risk score for importing incidents (0-10), where 0 is low risk and 10 is high risk. Relevant for API version 2.0." defaultvalue: '5' type: 0 section: Collect required: false - name: fetch_severity display: Defines Alert severity to fetch. type: 16 section: Collect options: - High - Medium - Low - Critical required: false - name: fetch_incidentStatus display: Define which Alerts should be fetched. type: 16 section: Collect defaultvalue: UNRESOLVED options: - RESOLVED - UNRESOLVED - IN_PROGRESS required: false - name: fetch_threat_incident_statuses display: 'Define which Threats should be fetched.' type: 16 section: Collect defaultvalue: UNRESOLVED required: false options: - RESOLVED - UNRESOLVED - IN_PROGRESS - name: fetch_limit display: 'Fetch limit: The maximum number of threats or alerts to fetch' type: 0 section: Collect required: false defaultvalue: '10' - name: fetch_site_ids display: Site IDs type: 0 section: Collect additionalinfo: Comma-separated list of site IDs to fetch incidents for. Leave blank to fetch all sites. required: false - name: block_site_ids display: Block Site IDs type: 0 section: Collect required: false additionalinfo: Comma-separated list of site IDs for where hashes should be blocked. If left blank all hashes will be blocked globally. If filled out with site ids all hashes will be no longer be blocked globally, they will now be blocked in the scope of those sites. - display: Trust any certificate (not secure) name: insecure type: 8 section: Connect required: false - display: Use system proxy settings name: proxy type: 8 section: Connect required: false - display: API Token (Deprecated) name: token type: 4 hidden: true section: Connect required: false additionalinfo: Use the "API Token (Recommended)" parameter instead. - defaultvalue: '1' display: Incidents Fetch Interval name: incidentFetchInterval type: 19 section: Collect required: false - additionalinfo: 'Choose the direction to mirror the incident: Incoming (from SentinelOne to Cortex XSOAR), Outgoing (from Cortex XSOAR to SentinelOne), or Incoming and Outgoing (from/to Cortex XSOAR and SentinelOne). Cortex XSOAR only parameter.' defaultvalue: None display: Incident Mirroring Direction name: mirror_direction type: 15 section: Collect required: false options: - None - Incoming - Outgoing - Incoming And Outgoing hidden: - marketplacev2 - platform - additionalinfo: When selected, closing the SentinelOne ticket is mirrored in Cortex XSOAR. defaultvalue: 'false' display: Close Mirrored XSOAR Incident name: close_xsoar_incident type: 8 section: Collect required: false description: Use the SentinelOne integration to send requests to your management server and get responses with data pulled from agents or from the management database. display: SentinelOne v2 name: SentinelOne V2 script: commands: - arguments: - description: The computer name by which to filter the results. It can match a partial computer name value (substring). name: computer_name - auto: PREDEFINED description: 'A comma-separated list of scan statuses by which to filter the results, for example: "started,aborted".' name: scan_status predefined: - started - none - finished - aborted - auto: PREDEFINED description: 'Included operating system types, for example: "windows".' isArray: true name: os_type predefined: - windows - windows_legacy - macos - linux - description: 'Endpoint creation timestamp, for example: "2018-02-27T04:49:26.257525Z".' name: created_at - description: Minimum number of threats per agent. name: min_active_threats - defaultValue: "10" description: The maximum number of agents to return. name: limit - description: Query params field=value pairs delimited by comma (e.g., activeThreats=3,gatewayIp=1.2.3.4). Query params are OR'd. name: params - description: A comma-separated list of additionals fields to display. name: columns isArray: true description: Returns all agents that match the specified criteria. name: sentinelone-list-agents outputs: - contextPath: SentinelOne.Agents.NetworkStatus description: The agent network status. type: string - contextPath: SentinelOne.Agents.ID description: The agent ID. type: string - contextPath: SentinelOne.Agents.AgentVersion description: The agent software version. type: string - contextPath: SentinelOne.Agents.IsDecommissioned description: Whether the agent is decommissioned. type: boolean - contextPath: SentinelOne.Agents.IsActive description: Whether the agent is active. type: boolean - contextPath: SentinelOne.Agents.LastActiveDate description: When was the agent last active. type: date - contextPath: SentinelOne.Agents.RegisteredAt description: The registration date of the agent. type: date - contextPath: SentinelOne.Agents.ExternalIP description: The agent IP address. type: string - contextPath: SentinelOne.Agents.ThreatCount description: Number of active threats. type: number - contextPath: SentinelOne.Agents.EncryptedApplications description: Whether disk encryption is enabled. type: boolean - contextPath: SentinelOne.Agents.OSName description: Name of operating system. type: string - contextPath: SentinelOne.Agents.ComputerName description: Name of agent computer. type: string - contextPath: SentinelOne.Agents.MachineType description: Machine type. type: string - contextPath: SentinelOne.Agents.Domain description: Domain name of the agent. type: string - contextPath: SentinelOne.Agents.CreatedAt description: Creation time of the agent. type: date - contextPath: SentinelOne.Agents.SiteName description: Site name associated with the agent. type: string - contextPath: SentinelOne.Agents.Tags description: Tags associated with the agent. type: unknown - arguments: - auto: PREDEFINED description: Exclusion item type. name: exclusion_type predefined: - file_type - path - white_hash - certificate - browser required: true - description: Value of the exclusion item for the exclusion list. name: exclusion_value required: true - auto: PREDEFINED description: Operating system type. Required for hash exclusions. name: os_type predefined: - windows - windows_legacy - macos - linux required: true - description: Description for adding the exclusion item. name: description - auto: PREDEFINED description: Exclusion mode (path exclusion only). name: exclusion_mode predefined: - suppress - disable_in_process_monitor_deep - disable_in_process_monitor - disable_all_monitors - disable_all_monitors_deep - description: Excluded path for a path exclusion list. name: path_exclusion_type - description: A comma-separated list of group IDs by which to filter. isArray: true name: group_ids - description: A comma-separated list of site IDs by which to filter. isArray: true name: site_ids description: Creates an exclusion item that matches the specified input filter. name: sentinelone-create-white-list-item outputs: - contextPath: SentinelOne.Exclusions.ID description: The entity ID on the allow list. type: string - contextPath: SentinelOne.Exclusions.Type description: The item type on the allow list. type: string - contextPath: SentinelOne.Exclusions.CreatedAt description: Time when the allow list item was created. type: date - arguments: - description: 'List of IDs by which to filter, for example: "225494730938493804,225494730938493915".' isArray: true name: item_ids - auto: PREDEFINED description: 'A comma-separated list of operating system types by which to filter, for example: "windows, linux".' isArray: true name: os_types predefined: - windows - windows_legacy - macos - linux - auto: PREDEFINED description: Exclusion type. name: exclusion_type predefined: - file_type - path - white_hash - certificate - browser - defaultValue: "10" description: The maximum number of items to return. name: limit - defaultValue: "false" description: Whether to include parent information of each item. Default value is false. name: include_parent - defaultValue: "false" description: Whether to include children information of each item. Default value is false. name: include_children description: Lists all exclusion items that match the specified input filter. name: sentinelone-get-white-list outputs: - contextPath: SentinelOne.Exclusions.ID description: The exclusion item ID. type: string - contextPath: SentinelOne.Exclusions.Type description: The exclusion item type. type: string - contextPath: SentinelOne.Exclusions.CreatedAt description: Timestamp when the exclusion item was added. type: date - contextPath: SentinelOne.Exclusions.Value description: Value of the exclusion item. type: string - contextPath: SentinelOne.Exclusions.Source description: Source of the exclusion item. type: string - contextPath: SentinelOne.Exclusions.UserID description: User ID of the user qho added the exclusion item. type: string - contextPath: SentinelOne.Exclusions.UpdatedAt description: Timestamp when the exclusion item was updated. type: date - contextPath: SentinelOne.Exclusions.OsType description: Operating system type of the exclusion item. type: string - contextPath: SentinelOne.Exclusions.UserName description: User name of the user who added the exclusion item. type: string - contextPath: SentinelOne.Exclusions.Mode description: 'A comma-separated list of modes by which to filter (path exclusions only), for example: "suppress".' type: string - arguments: - description: The content hash. name: hash required: true description: Gets the file reputation by a SHA1 hash. name: sentinelone-get-hash outputs: - contextPath: SentinelOne.Hash.Rank description: The hash reputation (1-10). type: Number - contextPath: SentinelOne.Hash.Verdict description: The verdict of a hash. type: String - contextPath: SentinelOne.Hash.Hash description: The content hash. type: String - arguments: - description: A comma-separated list of content hashes of the threat. isArray: true name: content_hash - auto: PREDEFINED description: A comma-separated list of mitigation statuses. isArray: true name: mitigation_status predefined: - mitigated - active - blocked - suspicious - pending - suspicious_resolved - description: 'Searches for threats created before this timestamp, for example: "2018-02-27T04:49:26.257525Z", "10 days", "5 months", "2 hours".' name: created_before - description: 'Searches for threats created after this timestamp, for example: "2018-02-27T04:49:26.257525Z", "10 days", "5 months", "2 hours".' name: created_after - description: 'Searches for threats created on or before this timestamp, for example: "2018-02-27T04:49:26.257525Z", "10 days", "5 months", "2 hours".' name: created_until - description: 'Search for threats created on or after this timestamp, for example: "2018-02-27T04:49:26.257525Z", "10 days", "5 months", "2 hours".' name: created_from - auto: PREDEFINED defaultValue: "false" description: Whether to only return resolved threats. name: resolved predefined: - "false" - "true" - description: Threat display name. For API version 2.0 it can be a partial display name, doesn't have to be an exact match. name: display_name - defaultValue: "20" description: The maximum number of threats to return. name: limit - description: Full free-text search for fields. Can be "content_hash", "file_display_name", "file_path", "computer_name", or "uuid". name: query - description: 'A comma-separated list of threat IDs, for example: "225494730938493804,225494730938493915".' isArray: true name: threat_ids - auto: PREDEFINED description: 'A comma-separated list of threat classifications to search, for example: "Malware", "Network", "Benign".' name: classifications predefined: - Engine - Static - Cloud - Behavioral - description: Risk level threshold to retrieve (1-10). Relevant for API version 2.0 only. name: rank - description: 'A comma-separated list of site IDs to search for threats, for example: "225494730938493804,225494730938493915".' isArray: true name: site_ids - description: 'Incident status. Example: "IN_PROGRESS, UNRESOLVED".' name: incident_statuses - auto: PREDEFINED defaultValue: "false" description: Whether to include the resolved parameter in the query. name: include_resolved_param predefined: - "false" - "true" description: Returns threats according to the specified filters. name: sentinelone-get-threats outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.AgentComputerName description: The agent computer name. type: String - contextPath: SentinelOne.Threat.CreatedDate description: The threat creation date. type: Date - contextPath: SentinelOne.Threat.SiteID description: The site ID. type: String - contextPath: SentinelOne.Threat.Classification description: The threat classification. type: string - contextPath: SentinelOne.Threat.ClassificationSource description: Source of the threat classification. type: string - contextPath: SentinelOne.Threat.ConfidenceLevel description: SentinelOne threat confidence level. type: string - contextPath: SentinelOne.Threat.FileSha256 description: SHA256 hash of the file content. type: string - contextPath: SentinelOne.Threat.MitigationStatus description: The agent mitigation status. type: String - contextPath: SentinelOne.Threat.AgentID description: The threat agent ID. type: String - contextPath: SentinelOne.Threat.Rank description: The number representing the cloud reputation (1-10). type: Number - contextPath: SentinelOne.Threat.MarkedAsBenign description: Whether the threat is marked as benign. Relevant for version 2.0 only. type: Boolean - arguments: - description: 'A comma-separated list of group IDs by which to filter, for example: "225494730938493804,225494730938493915".' isArray: true name: group_ids description: Returns a dashboard threat summary. Can only be used with API V2.1. name: sentinelone-threat-summary outputs: - contextPath: SentinelOne.Threat.NotResolved description: Number of unresolved threats in the system. type: Number - contextPath: SentinelOne.Threat.SuspiciousNotMitigatedNotResolved description: Number of unmitigated suspicious threats in the system. type: Number - contextPath: SentinelOne.Threat.SuspiciousNotResolved description: Number of unresolved suspicious threats in the system. type: Number - contextPath: SentinelOne.Threat.Resolved description: Number of resolved threats in the system. type: Number - contextPath: SentinelOne.Threat.InProgress description: Number of active threats in the system. type: Number - contextPath: SentinelOne.Threat.Total description: Total number of threats in the system. type: Number - contextPath: SentinelOne.Threat.NotMitigated description: Number of unmitigated threats in the system. type: Number - contextPath: SentinelOne.Threat.MaliciousNotResolved description: Number of unresolved malicious threats in the system. type: Number - contextPath: SentinelOne.Threat.NotMitigatedNotResolved description: Number of unmitigated and unresolved threats in the system. type: Number - arguments: - description: 'Threat ID to get the analysis, for example: "2341398296147451190".' name: threat_id required: true description: Returns threat analysis. Can only be used with API V2.1. name: sentinelone-threat-analysis outputs: - contextPath: SentinelOne.Threat.AgentDetectionInfo description: Agent detection time information. type: 18 - contextPath: SentinelOne.Threat.AgentRealtimeInfo description: Agent realtime information. type: 18 - contextPath: SentinelOne.Threat.ThreatInfo description: Threat information. type: 18 - arguments: - description: A comma-separated list of threat IDs. isArray: true name: threat_ids - auto: PREDEFINED description: Scope to use for exclusions. name: target_scope predefined: - site - tenant required: true description: Marks suspicious threats as threats. Can only be used with API V2.0. name: sentinelone-mark-as-threat outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.MarkedAsThreat description: Whether the suspicious threat was successfully marked as a threat. type: Boolean - arguments: - auto: PREDEFINED description: Mitigation action. name: action predefined: - kill - quarantine - un-quarantine - remediate - rollback-remediation required: true - description: A comma-separated list of threat IDs. isArray: true name: threat_ids required: true description: Applies a mitigation action to a group of threats that match the specified input filter. name: sentinelone-mitigate-threat outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Mitigated description: Whether the threat was successfully mitigated. type: Boolean - contextPath: SentinelOne.Threat.Mitigation.Action description: The mitigation action performed. type: String - arguments: - description: A comma-separated list of threat IDs. isArray: true name: threat_ids required: true description: Resolves threats using the threat ID. Can only be used with API V2.0. name: sentinelone-resolve-threat outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Resolved description: Whether the threat was successfully resolved. type: Boolean - arguments: - description: A comma-separated list of agent IDs. isArray: true name: agent_id required: true description: Returns the details of an agent according to the agent ID. name: sentinelone-get-agent outputs: - contextPath: SentinelOne.Agent.NetworkStatus description: The agent network status. type: string - contextPath: SentinelOne.Agent.ID description: The agent ID. type: string - contextPath: SentinelOne.Agent.AgentVersion description: The agent software version. type: string - contextPath: SentinelOne.Agent.IsDecommissioned description: Whether the agent is decommissioned. type: boolean - contextPath: SentinelOne.Agent.IsActive description: Whether the agent is active. type: boolean - contextPath: SentinelOne.Agent.LastActiveDate description: When was the agent last active. type: date - contextPath: SentinelOne.Agent.RegisteredAt description: The registration date of the agent. type: date - contextPath: SentinelOne.Agent.ExternalIP description: The agent IP address. type: string - contextPath: SentinelOne.Agent.ThreatCount description: Number of active threats. type: number - contextPath: SentinelOne.Agent.EncryptedApplications description: Whether disk encryption is enabled. type: boolean - contextPath: SentinelOne.Agent.OSName description: Name of the operating system. type: string - contextPath: SentinelOne.Agent.ComputerName description: Name of the agent computer. type: string - contextPath: SentinelOne.Agent.MachineType description: Machine type. type: string - contextPath: SentinelOne.Agent.Domain description: Domain name of the agent. type: string - contextPath: SentinelOne.Agent.CreatedAt description: Agent creation time. type: date - contextPath: SentinelOne.Agent.SiteName description: Site name associated with the agent. type: string - arguments: - description: 'Timestamp of the last update, for example: "2018-02-27T04:49:26.257525Z".' name: updated_at - description: "Full-text search for fields: name, account_name." name: query - auto: PREDEFINED description: Site type. name: site_type predefined: - Trial - Paid - POC - DEV - NFR - auto: PREDEFINED description: Returns sites that support the specified features. name: features predefined: - firewall-control - device-control - ioc - auto: PREDEFINED description: Site state. name: state predefined: - active - deleted - expired - auto: PREDEFINED description: The suite of product features active for this site. name: suite predefined: - Core - Complete - auto: PREDEFINED description: Sites for which the user has admin privileges. name: admin_only predefined: - "true" - "false" - description: 'Account ID, for example: "225494730938493804".' name: account_id - description: 'Site name, for example: "My Site".' name: site_name - description: 'Timestamp of the site creation, for example: "2018-02-27T04:49:26.257525Z".' name: created_at - defaultValue: "50" description: Maximum number of results to return. name: limit description: Returns all sites that match the specified criteria. name: sentinelone-get-sites outputs: - contextPath: SentinelOne.Site.Creator description: The site creator name. type: string - contextPath: SentinelOne.Site.Name description: The site name. type: string - contextPath: SentinelOne.Site.Type description: The site type. type: string - contextPath: SentinelOne.Site.AccountName description: The site account name. type: string - contextPath: SentinelOne.Site.State description: The site state. type: string - contextPath: SentinelOne.Site.HealthStatus description: The health status of the site. type: boolean - contextPath: SentinelOne.Site.Suite description: The suite to which the site belongs. type: string - contextPath: SentinelOne.Site.ActiveLicenses description: Number of active licenses for the site. type: number - contextPath: SentinelOne.Site.ID description: ID of the site. type: string - contextPath: SentinelOne.Site.TotalLicenses description: Number of total licenses for the site. type: number - contextPath: SentinelOne.Site.CreatedAt description: Timestamp when the site was created. type: date - contextPath: SentinelOne.Site.Expiration description: Timestamp when the site will expire. type: string - contextPath: SentinelOne.Site.UnlimitedLicenses description: Whether the site has unlimited licenses. type: boolean - arguments: - description: ID of the site. name: site_id required: true description: Returns information about the site, according to the site ID. name: sentinelone-get-site outputs: - contextPath: SentinelOne.Site.Creator description: The site creator name. type: string - contextPath: SentinelOne.Site.Name description: The site name. type: string - contextPath: SentinelOne.Site.Type description: The site type. type: string - contextPath: SentinelOne.Site.AccountName description: The site account name. type: string - contextPath: SentinelOne.Site.State description: The site state. type: string - contextPath: SentinelOne.Site.HealthStatus description: The health status of the site. type: boolean - contextPath: SentinelOne.Site.Suite description: The suite to which the site belongs. type: string - contextPath: SentinelOne.Site.ActiveLicenses description: Number of active licenses for the site. type: number - contextPath: SentinelOne.Site.ID description: ID of the site. type: string - contextPath: SentinelOne.Site.TotalLicenses description: Number of total licenses for the site. type: number - contextPath: SentinelOne.Site.CreatedAt description: Timestamp when the site was created. type: date - contextPath: SentinelOne.Site.Expiration description: Timestamp when the site will expire. type: string - contextPath: SentinelOne.Site.UnlimitedLicenses description: Whether the site has unlimited licenses. type: boolean - contextPath: SentinelOne.Site.AccountID description: Site account ID. type: string - contextPath: SentinelOne.Site.IsDefault description: Whether the site is the default site. type: boolean - arguments: - description: 'Site ID. For example: "225494730938493804".' name: site_id required: true - description: If false, an expiration should be supplied. name: unlimited - description: Expiration date in case unlimited is false, for example, "2019-08-03T04:49:26.257525Z". name: expiration description: Reactivates an expired site. name: sentinelone-reactivate-site outputs: - contextPath: SentinelOne.Site.ID description: Site ID. type: string - contextPath: SentinelOne.Site.Reactivated description: Whether the site was reactivated. type: boolean - arguments: - description: 'Return activities created after this timestamp, for example: "2018-02-27T04:49:26.257525Z".' name: created_after - description: Email address of the user who invoked the activity (if applicable). name: user_emails - description: 'List of group IDs by which to filter, for example: "225494730938493804,225494730938493915".' isArray: true name: group_ids - description: 'Return activities created on or before this timestamp, for example: "2018-02-27T04:49:26.257525Z".' name: created_until - auto: PREDEFINED description: Include internal activities hidden from display. name: include_hidden predefined: - "true" - "false" - description: 'A comma-separated list of activity IDs by which to filter, for example: "225494730938493804,225494730938493915".' isArray: true name: activities_ids - description: 'Return activities created before this timestamp, for example: "2018-02-27T04:49:26.257525Z".' name: created_before - description: 'A comma-separated list of threat IDs for which to return activities, for example: "225494730938493804,225494730938493915".' isArray: true name: threats_ids - description: 'A comma-separated list of activity codes to return, for example: "52,53,71,72".' isArray: true name: activity_types - description: 'A comma-separated list of user IDs for users that invoked the activity (if applicable), for example: "225494730938493804,225494730938493915".' isArray: true name: user_ids - description: 'Return activities created on or after this timestamp, for example: "2018-02-27T04:49:26.257525Z".' name: created_from - description: 'Return activities created within this range (inclusive), for example: "1514978764288-1514978999999".' name: created_between - description: 'Return activities related to specified agents. For example: "225494730938493804,225494730938493915".' isArray: true name: agent_ids - description: Maximum number of items to return (1-100). name: limit - name: sort_by auto: PREDEFINED predefined: - activityType - createdAt - id description: Field to sort results by. - name: sort_order auto: PREDEFINED predefined: - asc - desc description: Order to sort by. description: Returns a list of activities. name: sentinelone-get-activities outputs: - contextPath: SentinelOne.Activity.AgentID description: Related agent (if applicable). type: String - contextPath: SentinelOne.Activity.AgentUpdatedVersion description: Agent's new version (if applicable). type: String - contextPath: SentinelOne.Activity.SiteID description: Related site (if applicable). type: String - contextPath: SentinelOne.Activity.UserID description: The user who invoked the activity (if applicable). type: String - contextPath: SentinelOne.Activity.SecondaryDescription description: Secondary description. type: String - contextPath: SentinelOne.Activity.OsFamily description: Agent's operating system type (if applicable). Can be "linux", "macos", "windows", or "windows_legacy". type: String - contextPath: SentinelOne.Activity.ActivityType description: Activity type. type: Number - contextPath: SentinelOne.Activity.data.SiteID description: The site ID. type: String - contextPath: SentinelOne.Activity.data.SiteName description: The site name. type: String - contextPath: SentinelOne.Activity.data.username description: The name of the site creator. type: String - contextPath: SentinelOne.Activity.Hash description: Threat file hash (if applicable). type: String - contextPath: SentinelOne.Activity.UpdatedAt description: Activity last updated time (UTC). type: Date - contextPath: SentinelOne.Activity.Comments description: Comments for the activity. type: String - contextPath: SentinelOne.Activity.ThreatID description: Related threat (if applicable). type: String - contextPath: SentinelOne.Activity.PrimaryDescription description: Primary description for the activity. type: String - contextPath: SentinelOne.Activity.GroupID description: Related group (if applicable). type: String - contextPath: SentinelOne.Activity.ID description: Activity ID. type: String - contextPath: SentinelOne.Activity.CreatedAt description: Activity creation time (UTC). type: Date - contextPath: SentinelOne.Activity.Description description: Extra activity information. type: String - arguments: - description: 'Group type, for example: "static".' name: group_type - description: 'A comma-separated list of group IDs by which to filter, for example: "225494730938493804,225494730938493915".' isArray: true name: group_ids - description: 'Group ID by which to filter, for example: "225494730938493804".' name: group_id - auto: PREDEFINED description: Whether this is the default group. name: is_default predefined: - "true" - "false" - description: The name of the group. name: name - description: Free-text search. name: query - description: The priority of a dynamic group over others, for example, "1", which is the highest priority. name: rank - description: Maximum number of items to return (1-200). name: limit description: Returns data for the specified group. name: sentinelone-get-groups outputs: - contextPath: SentinelOne.Group.siteId description: The ID of the site of which this group is a member. type: String - contextPath: SentinelOne.Group.filterName description: If the group is dynamic, the name of the filter which is used to associate agents. type: String - contextPath: SentinelOne.Group.creatorId description: The ID of the user who created the group. type: String - contextPath: SentinelOne.Group.name description: The name of the group. type: String - contextPath: SentinelOne.Group.creator description: The user who created the group. type: String - contextPath: SentinelOne.Group.rank description: The rank, which sets the priority of a dynamic group over others. type: Number - contextPath: SentinelOne.Group.updatedAt description: Timestamp of the last update. type: Date - contextPath: SentinelOne.Group.totalAgents description: Number of agents in the group. type: Number - contextPath: SentinelOne.Group.filterId description: If the group is dynamic, the group ID of the filter that is used to associate agents. type: String - contextPath: SentinelOne.Group.isDefault description: Whether the groups is the default group of the site. type: Boolean - contextPath: SentinelOne.Group.inherits description: Whether the policy is inherited from a site. "False" if the group has its own edited policy. type: Boolean - contextPath: SentinelOne.Group.type description: Group type. Can be static or dynamic. type: String - contextPath: SentinelOne.Group.id description: The ID of the group. type: String - contextPath: SentinelOne.Group.createdAt description: Timestamp of group creation. type: Date - arguments: - description: The ID of the group to move the agent to. name: group_id required: true - description: Agents IDs. isArray: true name: agents_ids description: Moves agents to a new group. name: sentinelone-move-agent outputs: - contextPath: SentinelOne.Agent.AgentsMoved description: The number of agents that were moved to another group. type: Number - arguments: - description: The ID of the group to delete. name: group_id required: true description: Deletes a group, by the group ID. name: sentinelone-delete-group outputs: - contextPath: SentinelOne.DeleteGroup.Success description: The status of the command. type: String - arguments: - description: The ID of the agent from which to retrieve the processes. name: agents_ids required: true deprecated: true description: Deprecated. Retrieves running processes for a specific agent. name: sentinelone-agent-processes outputs: - contextPath: SentinelOne.Agent.memoryUsage description: Memory usage (MB). type: Number - contextPath: SentinelOne.Agent.startTime description: The process start time. type: Date - contextPath: SentinelOne.Agent.pid description: The process ID. type: Number - contextPath: SentinelOne.Agent.processName description: The name of the process. type: String - contextPath: SentinelOne.Agent.cpuUsage description: CPU usage (%). type: Number - contextPath: SentinelOne.Agent.executablePath description: Executable path. type: String - arguments: - description: A comma-separated list of agent IDs to connect to the network. Run the list-agents command to get a list of agent IDs. isArray: true name: agent_id required: true description: Connects agents to the network. name: sentinelone-connect-agent outputs: - contextPath: SentinelOne.Agent.AgentsAffected description: The number of affected agents. type: Number - contextPath: SentinelOne.Agent.NetworkStatus description: Agent network status. type: String - contextPath: SentinelOne.Agent.ID description: Input agents' IDs. type: String - arguments: - description: A comma-separated list of agent IDs to disconnect from the network. Run the list-agents command to get a list of agent IDs. isArray: true name: agent_id required: true description: Disconnects agents from the network. name: sentinelone-disconnect-agent outputs: - contextPath: SentinelOne.Agent.NetworkStatus description: Agent network status. type: String - contextPath: SentinelOne.Agent.ID description: Input agents' IDs. type: String compliantpolicies: - EndPoint Isolation - arguments: - description: The message to broadcast to agents. name: message required: true - auto: PREDEFINED description: Whether to only include active agents. Default is "false". name: active_agent predefined: - "true" - "false" - description: A comma-separated list of group IDs by which to filter the results. isArray: true name: group_id - description: A comma-separated list of agent IDs by which to filter the results. isArray: true name: agent_id - description: A comma-separated of included network domains. isArray: true name: domain description: Broadcasts a message to all agents that match the input filters. name: sentinelone-broadcast-message outputs: - contextPath: SentinelOne.BroadcastMessage.Affected description: Number of affected endpoints. type: String - arguments: - defaultValue: "50" description: Maximum number of items to return (1-100). name: limit - description: 'QueryId obtained when creating a query in the sentinelone-create-query command. Example: "q1xx2xx3".' name: query_id required: true - description: Cursor pointer to get next page of results from query. name: cursor - description: A comma-separated list of additionals fields to display. name: columns isArray: true description: Returns all Deep Visibility events that match the query. name: sentinelone-get-events outputs: - contextPath: SentinelOne.Event.ProcessUID description: Process unique identifier. type: String - contextPath: SentinelOne.Event.SHA256 description: SHA256 hash of the file. type: String - contextPath: SentinelOne.Event.AgentOS description: Operating system type. Can be "windows", "linux", "macos", or "windows_legac". type: String - contextPath: SentinelOne.Event.ProcessID description: The process ID. type: Number - contextPath: SentinelOne.Event.User description: User assigned to the event. type: String - contextPath: SentinelOne.Event.Time description: Process start time. type: Date - contextPath: SentinelOne.Event.Endpoint description: The agent name. type: String - contextPath: SentinelOne.Event.SiteName description: Site name. type: String - contextPath: SentinelOne.Event.EventType description: Event type. Can be "events", "file", "ip", "url", "dns", "process", "registry", "scheduled_task", or "logins". type: String - contextPath: SentinelOne.Event.ProcessName description: The name of the process. type: String - contextPath: SentinelOne.Event.MD5 description: MD5 hash of the file. type: String - contextPath: SentinelOne.Event.SourceIP description: The source ip. type: String - contextPath: SentinelOne.Event.SourcePort description: The source port. type: String - contextPath: SentinelOne.Event.DestinationIP description: The destination IP. type: String - contextPath: SentinelOne.Event.DestinationPort description: The destination port. type: String - contextPath: SentinelOne.Event.SourceProcessUser description: The source process user. type: String - contextPath: SentinelOne.Event.SourceProcessCommandLine description: The source process command line. type: String - contextPath: SentinelOne.Event.DNSRequest description: The DNS Request. type: String - contextPath: SentinelOne.Event.FileFullName description: The file full name. type: String - contextPath: SentinelOne.Event.EventTime description: The event time. type: String - contextPath: Event.ID description: Event process ID. type: String - contextPath: Event.Name description: Event name. type: String - contextPath: Event.Type description: Event type. type: String - contextPath: SentinelOne.Cursor.Event description: cursor to recieve next page. type: String - arguments: - description: The query string for which to return events. name: query required: true - description: Query start date, for example, "2019-08-03T04:49:26.257525Z". Limited to 93 days ago. name: from_date required: true - description: Query end date, for example, "2019-08-03T04:49:26.257525Z". name: to_date required: true description: Runs a Deep Visibility query and returns the queryId. You can use the queryId for all other commands, such as the sentinelone-get-events command. name: sentinelone-create-query outputs: - contextPath: SentinelOne.Query.FromDate description: Query start date. type: Date - contextPath: SentinelOne.Query.Query description: The search query string. type: String - contextPath: SentinelOne.Query.QueryID description: The query ID. type: String - contextPath: SentinelOne.Query.ToDate description: Query end date. type: Date - arguments: - description: 'The queryId that is returned when creating a query under Create Query. Example: "q1xx2xx3". Get the query_id from the "get-query-id" command.' name: query_id required: true - defaultValue: "50" description: Maximum number of items to return (1-100). name: limit description: Returns a list of Deep Visibility events from query by event type - process. name: sentinelone-get-processes outputs: - contextPath: SentinelOne.Event.ParentProcessID description: Parent process ID. type: Number - contextPath: SentinelOne.Event.ProcessUID description: The process unique identifier. type: String - contextPath: SentinelOne.Event.SHA1 description: SHA1 hash of the process image. type: String - contextPath: SentinelOne.Event.SubsystemType description: Process sub-system. type: String - contextPath: SentinelOne.Event.ParentProcessStartTime description: The parent process start time. type: Date - contextPath: SentinelOne.Event.ProcessID description: The process ID. type: Number - contextPath: SentinelOne.Event.ParentProcessUID description: Parent process unique identifier. type: String - contextPath: SentinelOne.Event.User description: User assigned to the event. type: String - contextPath: SentinelOne.Event.Time description: Start time of the process. type: Date - contextPath: SentinelOne.Event.ParentProcessName description: Parent process name. type: String - contextPath: SentinelOne.Event.SiteName description: Site name. type: String - contextPath: SentinelOne.Event.EventType description: The event type. type: String - contextPath: SentinelOne.Event.Endpoint description: The agent name (endpoint). type: String - contextPath: SentinelOne.Event.IntegrityLevel description: Process integrity level. type: String - contextPath: SentinelOne.Event.CMD description: Process CMD. type: String - contextPath: SentinelOne.Event.ProcessName description: Process name. type: String - contextPath: SentinelOne.Event.ProcessDisplayName description: Process display name. type: String - arguments: - description: "A free-text search term that will match applicable attributes (sub-string match). Note: A device's physical addresses will only be matched if they start with the search term (not if they contain the search term)." name: query - description: A comma-separated list of agents IDs to shutdown. isArray: true name: agent_id - description: The ID of the network group. name: group_id description: Sends a shutdown command to all agents that match the input filter. name: sentinelone-shutdown-agent outputs: - contextPath: SentinelOne.Agent.ID description: The ID of the agent that was shutdown. type: String - arguments: - description: "A free-text search term that will match applicable attributes (sub-string match). Note: A device's physical addresses will only be matched if they start with the search term (not if they contain the search term)." name: query - description: A comma-separated list of agents IDs to shutdown. name: agent_id - description: The ID of the network group. name: group_id description: Sends an uninstall command to all agents that match the input filter. name: sentinelone-uninstall-agent outputs: - contextPath: SentinelOne.uninstall.Affected description: Number of affected agents. type: String - arguments: - name: verdict required: true auto: PREDEFINED predefined: - undefined - true_positive - false_positive - suspicious description: Analyst verdict action. - name: threat_ids required: true description: A comma-separated list of threat IDs. isArray: true description: Updates the analyst verdict to a group of threats that match the specified input filter. Relevant for API version 2.1. name: sentinelone-update-threats-verdict outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Updated description: Whether the threat was successfully updated in the analyst verdict. type: Boolean - contextPath: SentinelOne.Threat.Update.Action description: Name of the analyst verdict action performed on the threats. type: String - arguments: - name: verdict required: true auto: PREDEFINED predefined: - undefined - true_positive - false_positive - suspicious description: Analyst verdict action. - name: alert_ids required: true description: A comma-separated list of alert IDs. isArray: true description: Updates the analyst verdict to a group of alerts that match the specified input filter. Relevant for API version 2.1. name: sentinelone-update-alerts-verdict outputs: - contextPath: SentinelOne.Alert.ID description: The alert ID. type: String - contextPath: SentinelOne.Alert.Updated description: Whether the alert was successfully updated in the analyst verdict. type: Boolean - contextPath: SentinelOne.Alert.Update.Action description: Name of the analyst verdict action performed on the alerts. type: String - arguments: - name: status required: true description: UAM alert status. auto: PREDEFINED predefined: - New - In progress - Resolved - name: alert_ids required: true description: A comma-separated list of UAM alert IDs. isArray: true description: Updates the status for a group of UAM alerts. Relevant for API version 2.1. name: sentinelone-update-uam-alert-status outputs: - contextPath: SentinelOne.UAMAlert.ID description: The UAM alert ID. type: String - contextPath: SentinelOne.UAMAlert.Updated description: Whether the status was successfully updated. type: Boolean - contextPath: SentinelOne.UAMAlert.Status description: Name of the status performed on the alerts. type: String - arguments: - name: analyst_verdict description: 'UAM alert analyst verdict.' required: true auto: PREDEFINED predefined: - False positive - Benign - False positive - Benign but suspicious - False positive - System error - False positive - Undefined - False positive - User error - True positive - Advanced persistent threat - True positive - Benign - True positive - Benign but suspicious - True positive - Data exfiltration - True positive - Denial of service - True positive - Exploitation tools - True positive - Insider threat - True positive - Malware - True positive - Phishing attack - True positive - Policy violation - True positive - PUA/Adware - True positive - Ransomware - True positive - Unauthorized access - True positive - Undefined - Undefined - name: alert_ids description: 'A comma-separated list of UAM alert IDs.' required: true isArray: true name: sentinelone-update-uam-alert-verdict description: Updates the analyst verdict for a group of UAM alerts. Relevant for API version 2.1. outputs: - contextPath: SentinelOne.UAMAlert.ID description: The UAM alert ID. type: String - contextPath: SentinelOne.UAMAlert.Updated description: Whether the analyst verdict was successfully updated. type: Boolean - contextPath: SentinelOne.UAMAlert.AnalystVerdict description: Name of the analyst verdict performed on the alerts. type: String - arguments: - name: name required: true description: 'The name of the STAR rule.' - name: rule_severity required: true description: The rule severity. auto: PREDEFINED predefined: - Low - Medium - High - Critical - name: expiration_mode required: true auto: PREDEFINED predefined: - Permanent - Temporary description: Type of expiration mode. - name: query_type required: true auto: PREDEFINED predefined: - events - processes description: Type of the query. For now it's "events". - name: query required: true description: The query string for which to return events. - name: description description: The description of the STAR rule. - name: expiration_date description: If expiration mode is "Temporary" then it should be supplied, for example, "2019-08-03T04:49:26.257525Z". - name: site_ids description: A comma-separated list of site IDs. isArray: true - name: group_ids description: A comma-separated list of Group IDs. isArray: true - name: account_ids description: A comma-separated list of Account IDs. isArray: true - name: network_quarantine description: Whether to enable the network quarantine of the STAR rule. required: true auto: PREDEFINED predefined: - "true" - "false" - name: treatAsThreat required: true auto: PREDEFINED predefined: - "Malicious" - "Suspicious" - UNDEFINED description: The treatAsThreat type. - name: query_lang auto: PREDEFINED predefined: - "1.0" - "2.0" description: The query language version. Supported values are "1.0" and "2.0". description: Creates a custom STAR rule. Relevant for API version 2.1. name: sentinelone-create-star-rule outputs: - contextPath: SentinelOne.StarRule.ID description: The STAR rule ID. type: String - contextPath: SentinelOne.StarRule.Name description: The STAR rule name. type: String - contextPath: SentinelOne.StarRule.Status description: The status of the STAR rule. type: String - contextPath: SentinelOne.StarRule.Severity description: The severity of the STAR rule. type: String - contextPath: SentinelOne.StarRule.Description description: The description of the STAR rule. type: String - contextPath: SentinelOne.StarRule.NetworkQuarantine description: The network quarantine of the STAR rule. type: Boolean - contextPath: SentinelOne.StarRule.TreatAsThreat description: The Treat As Threat of the STAR rule. type: String - contextPath: SentinelOne.StarRule.ExpirationMode description: The expiration mode of the STAR rule. type: String - contextPath: SentinelOne.StarRule.ExpirationDate description: The expiration date of the STAR rule. type: String - contextPath: SentinelOne.StarRule.ScopeHierarchy description: The scope hierarchy of the STAR rule. type: String - contextPath: SentinelOne.StarRule.CreatedAt description: The created time for the STAR rule. type: String - contextPath: SentinelOne.StarRule.UpdatedAt description: The updated time for the STAR rule. type: String - contextPath: SentinelOne.StarRule.QueryLanguage description: The query language version for the STAR rule. type: String - arguments: - name: status description: 'A comma-separated list of the status of the STAR rule. Available options are: "Activating, Active, Deleted, Deleting, Disabled, Disabling and Draft".Example: "Draft,Active".' - name: creator_contains description: 'Free-text filter by rule creator (supports multiple values). Example: "Service Pack 1".' - name: queryType auto: PREDEFINED predefined: - events - processes description: 'Return rules with the filtered type. Example: "events".' - name: query description: 'Free-text filter by S1 query (supports multiple values). Example: "Service Pack 1".' - name: description_contains description: 'Free-text filter by rule description (supports multiple values). Example: "Service Pack 1".' - name: ruleIds description: 'A comma-separated list of Rules IDs. Example: "225494730938493804,225494730938493915".' - name: name_contains description: 'Free-text filter by rule name (supports multiple values). Example: "Service Pack 1".' - name: accountIds description: 'A comma-separated list of Account IDs to filter by. Example: "225494730938493804,225494730938493915".' - name: expirationMode auto: PREDEFINED predefined: - Temporary - Permanent description: 'Return rules with the filtered expiration mode. Example: "Permanent".' - name: limit description: 'Limit number of returned items (1-1000). Example: "10".' - name: siteIds description: 'A comma-separated list of site IDs to filter by. Example: "225494730938493804,225494730938493915".' description: Get a list of custom detection rules for a given scope. Relevant for API version 2.1. name: sentinelone-get-star-rules outputs: - contextPath: SentinelOne.StarRule.ID description: The STAR rule ID. type: Number - contextPath: SentinelOne.StarRule.Creator description: The STAR rule creator. type: string - contextPath: SentinelOne.StarRule.Name description: The STAR rule name. type: string - contextPath: SentinelOne.StarRule.Status description: The STAR rule status. type: string - contextPath: SentinelOne.StarRule.Severity description: The STAR rule severity. type: string - contextPath: SentinelOne.StarRule.GeneratedAlerts description: The number of STAR rule generated alerts. type: Number - contextPath: SentinelOne.StarRule.Description description: The STAR rule description. type: string - contextPath: SentinelOne.StarRule.StatusReason description: The STAR rule status reason. type: string - contextPath: SentinelOne.StarRule.ExpirationMode description: The STAR rule expiration mode. type: string - contextPath: SentinelOne.StarRule.ExpirationDate description: The STAR rule expiration date. type: Date - contextPath: SentinelOne.StarRule.Expired description: Whether the STAR rule expired. type: Boolean - arguments: - name: rule_id required: true description: 'Rule ID Example: "225494730938493804".' - name: name required: true description: The name of the STAR rule. - name: rule_severity required: true auto: PREDEFINED predefined: - Low - Medium - High - Critical description: The rule severity. - name: expiration_mode required: true auto: PREDEFINED predefined: - Permanent - Temporary description: Type of expiration mode. - name: query_type required: true auto: PREDEFINED predefined: - events - processes description: Type of the query. For now it's "events". - name: query required: true description: The query string for which to return events. - name: description description: The description of the STAR rule. - name: expiration_date description: If expiration mode is "Temporary" then it should be supplied, for example, "2019-08-03T04:49:26.257525Z". - name: site_ids description: A comma-separated list of site IDs. isArray: true - name: group_ids description: A comma-separated list of group IDs. isArray: true - name: account_ids description: A comma-separated list of account IDs. isArray: true - name: network_quarantine required: true auto: PREDEFINED predefined: - "true" - "false" description: Whether to enable the network quarantine of the STAR rule. - name: treatAsThreat required: true auto: PREDEFINED predefined: - Malicious - Suspicious - UNDEFINED description: The treatAsThreat. - name: query_lang auto: PREDEFINED predefined: - "1.0" - "2.0" description: The query language version. Supported values are "1.0" and "2.0". description: Updates a custom STAR rule. Relevant for API version 2.1. name: sentinelone-update-star-rule outputs: - contextPath: SentinelOne.StarRule.ID description: The STAR rule ID. type: String - contextPath: SentinelOne.StarRule.Name description: The STAR rule name. type: String - contextPath: SentinelOne.StarRule.Status description: The status of the STAR rule. type: String - contextPath: SentinelOne.StarRule.Severity description: The severity of the STAR rule. type: String - contextPath: SentinelOne.StarRule.Description description: The description of the STAR rule. type: String - contextPath: SentinelOne.StarRule.NetworkQuarantine description: The network quarantine of the STAR rule. type: Boolean - contextPath: SentinelOne.StarRule.TreatAsThreat description: The Treat As Threat of the STAR rule. type: String - contextPath: SentinelOne.StarRule.ExpirationMode description: The expiration mode of the STAR rule. type: String - contextPath: SentinelOne.StarRule.ExpirationDate description: The expiration date of the STAR rule. type: String - contextPath: SentinelOne.StarRule.ScopeHierarchy description: The scope hierarchy of the STAR rule. type: String - contextPath: SentinelOne.StarRule.CreatedAt description: The created time for the STAR rule. type: String - contextPath: SentinelOne.StarRule.UpdatedAt description: The updated time for the STAR rule. type: String - contextPath: SentinelOne.StarRule.QueryLanguage description: The query language version for the STAR rule. type: String - arguments: - name: rule_ids required: true description: A comma-separated list of STAR rule IDs. isArray: true description: Activate Custom Detection rules that match the specified input filter. Relevant for API version 2.1. name: sentinelone-enable-star-rules outputs: - contextPath: SentinelOne.StarRule.ID description: The Rule ID. type: String - contextPath: SentinelOne.StarRule.Enabled description: Whether the STAR rule was successfully enabled. type: Boolean - arguments: - description: A comma-separated list of STAR rule IDs. name: rule_ids required: true isArray: true description: Disable Custom Detection rules that match the specified input filter. Relevant for API version 2.1. name: sentinelone-disable-star-rules outputs: - contextPath: SentinelOne.StarRule.ID description: The Rule ID. type: String - contextPath: SentinelOne.StarRule.Disabled description: Whether the STAR rule was successfully disabled. type: Boolean - arguments: - description: A comma-separated list of STAR rule IDs. name: rule_ids required: true isArray: true name: sentinelone-delete-star-rule description: Deletes Custom Detection Rules that match the specified input filter. Relevant for API version 2.1. outputs: - contextPath: SentinelOne.StarRule.ID description: The Rule ID. type: String - contextPath: SentinelOne.StarRule.Deleted description: Whether the STAR rule was successfully deleted. type: Boolean - arguments: - description: Whether the global list is accessible. (Same as `tenant` flag in API docs.). name: global auto: PREDEFINED defaultValue: "true" predefined: - "true" - "false" - description: Comma-separated list of group IDs to filter by. name: group_ids - description: Comma-separated list of site IDs to filter by. name: site_ids - description: Comma-separated list of account IDs to filter by. name: account_ids - description: The number of records to skip (for paging). name: offset defaultValue: "0" - description: The maximum number of records to return. name: limit defaultValue: "1000" - description: SHA1 or SHA256 hash to search for in the blocklist. name: hash - description: SHA1 hash to search for in the blocklist. name: sha1 - description: SHA256 hash to search for in the blocklist. name: sha256Value description: Retrieve the blocklist ("blacklist" in SentinelOne). You can filter by SHA1 or SHA256 hash. If the `global` flag is `true`, then group_ids, site_ids, and account_ids are ignored. name: sentinelone-get-blocklist outputs: - contextPath: SentinelOne.Blocklist.UserId description: User ID. type: String - contextPath: SentinelOne.Blocklist.UpdatedAt description: When entry was most recently updated. type: String - contextPath: SentinelOne.Blocklist.Value description: File hash (SHA1 or SHA256). type: String - contextPath: SentinelOne.Blocklist.ScopePath description: SentinelOne list scope. type: String - contextPath: SentinelOne.Blocklist.Type description: Block list type. type: String - contextPath: SentinelOne.Blocklist.Source description: Source of entry. type: String - contextPath: SentinelOne.Blocklist.ID description: Entry ID. type: String - contextPath: SentinelOne.Blocklist.CreatedAt description: Date entry was created. type: String - contextPath: SentinelOne.Blocklist.Description description: Description of the blocklist. type: String - contextPath: SentinelOne.Blocklist.OSType description: Operating system type block is enforced on. type: String - contextPath: SentinelOne.Blocklist.ScopeName description: Name of the blocklist scope. type: String - arguments: - description: SHA1 hash to add to the blocklist. name: sha1 - description: SHA256 hash to add to the blocklist. name: sha256Value - description: String describing the source of the block. name: source defaultValue: XSOAR - auto: PREDEFINED name: os_type predefined: - windows - linux - macos required: true description: Type of operating system. - defaultValue: Blocked from XSOAR description: Note stored in SentinelOne about the block. name: description - description: Comma-separated string of site IDs to scope the blocklist. name: site_ids - description: Comma-separated string of group IDs to scope the blocklist. name: group_ids - description: Comma-separated string of account IDs to scope the blocklist. name: account_ids description: Add a hash to the blocklist in SentinelOne. Supports scoping by site, group, or account. If Scope not provided, the block will be global. name: sentinelone-add-hash-to-blocklist outputs: - contextPath: SentinelOne.AddHashToBlocklist.hash description: Hash of the file. - contextPath: SentinelOne.AddHashToBlocklist.status description: Status of the action to add a hash to the blocklist. - arguments: - description: SHA1 hash to remove from the global blocklist. name: sha1 - description: SHA256 hash to remove from the global blocklist. name: sha256Value - description: Optional operating system type. If not supplied, will remove the SHA1 hash across all platforms. name: os_type auto: PREDEFINED predefined: - windows - macos - linux - description: Comma-separated string of site IDs to scope the blocklist. name: site_ids - description: Comma-separated string of group IDs to scope the blocklist. name: group_ids - description: Comma-separated string of account IDs to scope the blocklist. name: account_ids description: Remove a hash from the global blocklist in SentinelOne. name: sentinelone-remove-hash-from-blocklist outputs: - contextPath: SentinelOne.RemoveHashFromBlocklist.hash description: Hash of the file. - contextPath: SentinelOne.RemoveHashFromBlocklist.status description: Status of the action to remove a hash from the blocklist. - arguments: - name: agent_id required: true description: Agent ID to retrieve the file from. - name: file_path required: true description: File path to download the file from. - description: Password to protect the zip file with. name: password required: true description: Invokes a fetch files command against an agent endpoint. name: sentinelone-fetch-file - arguments: - name: agent_id required: true description: SentinelOne agent ID. defaultValue: Agent ID - name: activity_id required: true description: Activity ID in the get-activities command. - name: password required: true description: Password used in the sentinelone-fetch-file command. description: Download a file fetched using th sentinelone-fetch-file command to submit the request and the sentinelone-get-activities command to get the download path. name: sentinelone-download-fetched-file - arguments: - name: threat_ids required: true description: A comma-separated list of threat IDs. isArray: true - name: note required: true description: Threat Note Text. description: Add a threat note to one or more threats. Relevant for API version 2.1. name: sentinelone-write-threat-note outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Note description: The threat note. type: String - contextPath: SentinelOne.Threat.Status description: Whether the note was added successfully. type: String - arguments: - name: name required: true description: Threat Intelligence indicator name. - name: source required: true description: The source of the identified Threat Intelligence indicator. - name: type required: true description: The type of the Threat Intelligence indicator. auto: PREDEFINED predefined: - DNS - IPV4 - IPV6 - MD5 - SHA1 - SHA256 - URL - name: method required: true description: The comparison method used by SentinelOne to trigger the event. auto: PREDEFINED predefined: - EQUALS - name: validUntil required: true description: Expiration date for the Threat Intelligence indicator. - name: value required: true description: The value of the Threat Intelligence indicator. - name: account_ids required: true description: List of account IDs to filter by. isArray: true - name: externalId description: The unique identifier of the indicator as provided by the Threat Intelligence source. - name: description description: Description of the Threat Intelligence indicator. description: Add an IoC to the Threat Intelligence database. Relevant for API version 2.1. name: sentinelone-create-ioc outputs: - contextPath: SentinelOne.IOC.UUID description: The IOC UUID. type: String - contextPath: SentinelOne.IOC.Name description: Threat Intelligence indicator name. type: String - contextPath: SentinelOne.IOC.Source description: The source of the identified Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.Type description: The type of the Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.BatchId description: The IOC batch ID. type: String - contextPath: SentinelOne.IOC.Creator description: The IOC creator. type: String - contextPath: SentinelOne.IOC.Scope description: The IOC scope. type: String - contextPath: SentinelOne.IOC.ScopeId description: The IOC scope ID. type: String - contextPath: SentinelOne.IOC.ValidUntil description: Expiration date for the Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.Description description: Description of the Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.ExternalId description: The unique identifier of the indicator as provided by the Threat Intelligence source. type: String compliantpolicies: - Domain Blockage - IP Blockage - arguments: - name: entry_id required: true description: Entry ID of uploaded IOCs JSON file. - name: account_ids required: true description: A comma-separated list of account IDs to filter by. isArray: true description: Add bulk list of IoCs to the Threat Intelligence database. Relevant for API version 2.1. name: sentinelone-create-bulk-ioc outputs: - contextPath: SentinelOne.IOC.UUID description: The IOC UUID. type: String - contextPath: SentinelOne.IOC.Name description: Threat Intelligence indicator name. type: String - contextPath: SentinelOne.IOC.Source description: The source of the identified Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.Type description: The type of the Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.BatchId description: The IOC batch ID. type: String - contextPath: SentinelOne.IOC.Creator description: The IOC creator. type: String - contextPath: SentinelOne.IOC.Scope description: The IOC scope. type: String - contextPath: SentinelOne.IOC.ScopeId description: The IOC scope ID. type: String - contextPath: SentinelOne.IOC.ValidUntil description: Expiration date for the Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.Description description: Description of the Threat Intelligence indicator. type: String - contextPath: SentinelOne.IOC.ExternalId description: The unique identifier of the indicator as provided by the Threat Intelligence source. type: String compliantpolicies: - Domain Blockage - IP Blockage - arguments: - name: singularity_xdr_url required: true description: Singularity Data Lake XDR URL. - name: singularity_xdr_api_key description: A Log Read Access API key. required: true - name: query description: 'The query, in PowerQuery syntax.' required: true - name: start_time description: 'Start time for your query.' required: false - name: end_time description: 'End time for your query.' required: false - name: priority description: 'Query execution priority (defaults to "low").' required: false defaultValue: low - name: recurring auto: PREDEFINED predefined: - "true" - "false" description: Optional (defaults to false). When set to true, a materialized view of your query is created. required: false defaultValue: "false" - name: team_emails description: 'Comma-separated list of account emails to query, enabling Cross Team Search.' isArray: true required: false description: Run a PowerQuery, where you can pipe one or many search expressions into a set of commands to transform, manipulate, group, and summarize your data. name: sentinelone-run-powerquery outputs: - contextPath: SentinelOne.PowerQuery.Results.status description: The status of the PowerQuery execution. type: String - contextPath: SentinelOne.PowerQuery.Results.matchingEvents description: Number of events that match the query's initial filter. type: Number - contextPath: SentinelOne.PowerQuery.Results.omittedEvents description: Number of events omitted from the final result due to memory limits. type: Number - contextPath: SentinelOne.PowerQuery.Results.results description: A list of result rows returned by the PowerQuery, where each object represents one row (column:value pairs). type: List - arguments: - name: account_ids required: true description: List of account IDs to filter by. isArray: true - name: uuids required: true description: UUID of Threat Intelligence indicator. description: Delete an IOC from the Threat Intelligence database that matches a filter. Relevant for API version 2.1. name: sentinelone-delete-ioc outputs: - contextPath: SentinelOne.IOC.UUID description: The IOC UUID. type: String - contextPath: SentinelOne.IOC.Deleted description: Whether the Threat Intelligence indicator was deleted. type: Boolean - arguments: - name: account_ids required: true description: List of account IDs to filter by. isArray: true - name: limit description: Limit number of returned items (1-1000). Default is 1000. - name: upload_time_gte description: 'The time (greater than or equal to) at which the Threat Intelligence indicator was uploaded to the SentinelOne database. Example: "2022-07-13T20:33:29.007906Z".' - name: upload_time_lte description: 'The time (less than or equal to) at which the Threat Intelligence indicator was uploaded to the SentinelOne database. Example: "2022-07-13T20:33:29.007906Z".' - name: cursor description: 'Cursor position returned by the last request. Should be used for iterating over more than 1000 items. Example: "YWdlbnRfaWQ6NTgwMjkzODE=".' - name: uuids description: 'A list of unique IDs of the parent process of the indicator of compromise. Example: "2cffae871197f20d864fe8363eee6651".' - name: type auto: PREDEFINED predefined: - DNS - IPV4 - IPV6 - MD5 - SHA1 - SHA256 - URL description: The type of the Threat Intelligence indicator. - name: batch_id description: 'Unique ID of the uploaded indicators batch. Example: "atmtn000000028a881bcf939dc6d92ab55443".' - name: source description: 'List of the sources of the identified Threat Intelligence indicator. Example: "AlienVault".' - name: value description: 'The value of the Threat Intelligence indicator. Example: "175.0.x.x".' - name: external_id description: 'The unique identifier of the indicator as provided by the Threat Intelligence source. Example: "e277603e-1060-5ad4-9937-c26c97f1ca68".' - name: name_contains description: 'A comma-separated list of free-text filtered by the indicator name. Example: "foo.dll".' - name: creator_contains description: 'A comma-separated list of free-text filtered by the user who uploaded the Threat Intelligence indicator. Example: "admin@sentinelone.com".' - name: category_in description: "The categories of the Threat Intelligence indicator. Example: The malware type associated with the IOC." - name: description_contains description: 'A comma-separated list of free-text filtered by the description of the indicator. Example: "Malicious-activity".' - name: updated_at_gte description: 'The time (greater or equal to) at which the indicator was last updated in the SentinelOne database. Example: "2021-07-13T20:33:29.007906Z".' - name: updated_at_lte description: 'The time (less than or equal to) at which the indicator was last updated in the SentinelOne database. Example: "2021-07-13T20:33:29.007906Z".' - name: creation_time_gte description: 'Creation time (greater than or equal to) as set by the user. Example: "2021-07-13T20:33:29.007906Z".' - name: creation_time_lte description: 'Creation time (less than or equal to) as set by the user. Example: "2021-07-13T20:33:29.007906Z".' description: Get the IOCs of a specified account that match the filter. Relevant for API version 2.1. name: sentinelone-get-iocs outputs: - contextPath: SentinelOne.IOC.UUID description: The IOC UUID. type: String - contextPath: SentinelOne.IOC.Creator description: Threat Intelligence indicator creator. type: String - contextPath: SentinelOne.IOC.Name description: Threat Intelligence indicator name. type: String - contextPath: SentinelOne.IOC.Value description: Threat Intelligence indicator value. type: String - contextPath: SentinelOne.IOC.Description description: Threat Intelligence indicator description. type: String - contextPath: SentinelOne.IOC.Type description: Threat Intelligence indicator type. type: String - contextPath: SentinelOne.IOC.ExternalId description: Threat Intelligence indicator external ID. type: String - contextPath: SentinelOne.IOC.Source description: Threat Intelligence indicator source. type: String - contextPath: SentinelOne.IOC.UploadTime description: Threat Intelligence indicator upload time. type: String - contextPath: SentinelOne.IOC.ValidUntil description: Threat Intelligence indicator expiration time. type: String - arguments: - name: query required: true description: Events matching the query search term will be returned. - name: from_date required: true description: Events created after this timestamp. - name: to_date required: true description: Events created before or at this timestamp. - name: limit description: Limit number of returned items (1-100000). description: Deprecated. Use ***sentinelone-get-power-query-results*** instead. Start a Deep Visibility Power query to get back status and potential results (ping afterwards using the queryId if query has not finished). Relevant for API version 2.1. name: sentinelone-create-power-query deprecated: true - arguments: - name: queryId required: true description: QueryId. description: Deprecated. Use ***sentinelone-get-power-query-results*** instead. Ping a Deep Visibility Power query using the queryId argument if results have not returned from an initial Power query or a previous ping. Relevant for API version 2.1. name: sentinelone-ping-power-query deprecated: true - arguments: - name: status required: true description: Incident status. auto: PREDEFINED predefined: - in_progress - resolved - unresolved - name: threat_ids required: true description: A comma-separated list of threat IDs. isArray: true description: Updates the incident status to a group of threats that match the specified input filter. Relevant for API version 2.1. name: sentinelone-update-threats-status outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Updated description: Whether the threat was successfully updated. type: Boolean - contextPath: SentinelOne.Threat.Status description: Name of the status performed on the threats. type: String - arguments: - name: status required: true description: "Incident status." auto: PREDEFINED predefined: - in_progress - resolved - unresolved - name: alert_ids required: true description: A comma-separated list of alert IDs. isArray: true name: sentinelone-update-alerts-status description: Updates the incident status to a group of alerts that match the specified input filter. Relevant for API version 2.1. outputs: - contextPath: SentinelOne.Alert.ID description: The alert ID. type: String - contextPath: SentinelOne.Alert.Updated description: Whether the alert was successfully updated. type: Boolean - contextPath: SentinelOne.Alert.Status description: The status performed on the alerts. type: String - arguments: - name: site_id required: true description: 'A valid site ID.' name: sentinelone-expire-site description: Expire the site of the given ID. outputs: - contextPath: SentinelOne.Site.ID description: The site ID. type: String - contextPath: SentinelOne.Site.Name description: The site name. type: String - contextPath: SentinelOne.Site.State description: The site state. type: String - contextPath: SentinelOne.Site.SKU description: The SKU of product features active for this site. type: String - contextPath: SentinelOne.Site.SiteType description: The site type. type: String - contextPath: SentinelOne.Site.Suite description: The site suite. type: String - contextPath: SentinelOne.Site.TotalLicenses description: The total licenses. type: String - contextPath: SentinelOne.Site.AccountID description: The account ID. type: String - contextPath: SentinelOne.Site.Creator description: Full name of the creating user. type: String - contextPath: SentinelOne.Site.CreatorID description: ID of the creating user. type: String - contextPath: SentinelOne.Site.Description description: Description of the site. type: String - contextPath: SentinelOne.Site.Expiration description: Expiration date of the site. type: String - arguments: - name: threat_id required: true description: "Please provide the Valid Threat ID. Example: 14629133470822878." - name: password required: true description: File encryption password. (At least 10 characters, three out of this list "uppercase", "lowercase", "digits" and "symbols" are mandatory. Maximum length is 256 characters.). name: sentinelone-fetch-threat-file description: Fetch a file associated with the threat that matches the filter. outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Downloadable description: Whether the file is downloadable. type: Boolean - contextPath: SentinelOne.Threat.ZippedFile description: Details of the zipped folder. type: String - arguments: - name: created_from required: true description: 'Greater than or equal to the time created. Example: "2018-02-27T04:49:26.257525Z", "10 days", "2 hours","5 months".' - name: created_until description: 'Less than or equal to the time created. Example: "2018-02-27T04:49:26.257525Z", "10 days", "2 hours","5 months".' - name: ruleName description: 'Free-text filter by rule name. Example: "rule1".' - name: incidentStatus description: 'Incident status. Example: "IN_PROGRESS".' - name: analystVerdict description: 'Analyst verdict. Example: "TRUE_POSITIVE".' - name: alert_ids description: A comma-separated list of alert IDs. - name: limit description: Limit number of returned items (1-1000). Default is 1000. - name: site_ids description: 'A comma-separated list of site IDs to filter by. Example: "225494730938493804,225494730938493915".' - name: cursor description: 'Cursor position returned by the last request. Should be used for iterating over more than 1000 items. Example: "YWdlbnRfaWQ6NTgwMjkzODE=".' name: sentinelone-get-alerts description: Get the list of alerts that matches the filter provided. Relevant for API version 2.1. outputs: - contextPath: SentinelOne.Alert.EventType description: Event type. type: String - contextPath: SentinelOne.Alert.RuleName description: The rule name. type: String - contextPath: SentinelOne.Alert.SrcProcUser description: Source process user. type: String - contextPath: SentinelOne.Alert.SrcProcName description: Source process name. type: String - contextPath: SentinelOne.Alert.SrcProcPath description: Source process file path. type: String - contextPath: SentinelOne.Alert.SrcProcCommandline description: The command line. type: String - contextPath: SentinelOne.Alert.SrcProcSHA1 description: Source process SHA1 file hash. type: String - contextPath: SentinelOne.Alert.SrcProcStartTime description: PID start time. type: String - contextPath: SentinelOne.Alert.SrcProcStorylineId description: Source process story line ID. type: String - contextPath: SentinelOne.Alert.SrcParentProcName description: Source parent process name. type: String - contextPath: SentinelOne.Alert.SrcParentProcPath description: Source parent process file path. type: String - contextPath: SentinelOne.Alert.SrcParentProcCommandline description: Source parent process command line. type: String - contextPath: SentinelOne.Alert.SrcParentProcStartTime description: PID start time. type: String - contextPath: SentinelOne.Alert.SrcParentProcUser description: Source parent process user. type: String - contextPath: SentinelOne.Alert.SrcParentProcSHA1 description: Source parent process SHA1 file hash. type: String - contextPath: SentinelOne.Alert.SrcProcSignerIdentity description: Source process file signer identity. type: String - contextPath: SentinelOne.Alert.SrcParentProcSignerIdentity description: Source parent process file signer identity. type: String - contextPath: SentinelOne.Alert.AlertCreatedAt description: The the alert was created. type: String - contextPath: SentinelOne.Alert.AlertId description: Alert ID. type: String - contextPath: SentinelOne.Alert.AnalystVerdict description: Analyst verdict. type: String - contextPath: SentinelOne.Alert.IncidentStatus description: Incident status. type: String - contextPath: SentinelOne.Alert.EndpointName description: Endpoint name. type: String - contextPath: SentinelOne.Alert.AgentId description: Agent ID. type: String - contextPath: SentinelOne.Alert.AgentUUID description: Agent UUID. type: String - contextPath: SentinelOne.Alert.dvEventId description: Deep Visibility event ID. type: String - contextPath: SentinelOne.Alert.AgentOS description: Agent operating system. type: String - contextPath: SentinelOne.Alert.AgentVersion description: Agent version. type: String - contextPath: SentinelOne.Alert.SiteId description: Site ID. type: String - contextPath: SentinelOne.Alert.RuleId description: Rule ID. type: String - arguments: - name: agent_ids required: true description: "A comma-separated list of agent IDs. Example: 14629133470822878,14627455454652878." name: sentinelone-get-installed-applications description: Get the installed applications for a specific agent. outputs: - contextPath: SentinelOne.Application.Name description: The application name. type: String - contextPath: SentinelOne.Application.Publisher description: The publisher. type: String - contextPath: SentinelOne.Application.Size description: The size of the application in bytes. type: String - contextPath: SentinelOne.Application.Version description: The version of the application. type: String - contextPath: SentinelOne.Application.InstalledOn description: The date the application was installed. type: String - arguments: - name: agent_ids required: true description: "A comma-separated list of Agent IDs. Example: 14629133470822878,14627455454652878." name: sentinelone-initiate-endpoint-scan description: Initiate the endpoint virus scan on provided agent IDs. outputs: - contextPath: SentinelOne.Agent.AgentID description: The Agent ID. type: String - contextPath: SentinelOne.Agent.Initiated description: Whether the scan was initiated. type: Boolean - arguments: - description: "A comma-separated list of Agent IDs. Example: 14629133470822878,14627455454652878." name: agent_ids required: true description: Abort the endpoint virus scan on provided agent IDs. name: sentinelone-abort-endpoint-scan outputs: - contextPath: SentinelOne.Agent.AgentID description: The Agent ID. type: String - contextPath: SentinelOne.Agent.Aborted description: Whether the scan was aborted. type: Boolean - arguments: - name: agent_ids required: true description: "A comma-separated list of Agent IDs. Example: 14629133470822878,14627455454652878." - name: agents_logs required: true auto: PREDEFINED predefined: - "true" - "false" description: 'Fetch Agent logs.' defaultValue: "true" - name: customer_facing_logs required: true description: Fetch customer-facing logs. auto: PREDEFINED predefined: - "true" - "false" defaultValue: "false" - name: platform_logs required: true description: Actively fetch logs from the relevant platform (Windows, macOS, or Linux). auto: PREDEFINED predefined: - "true" - "false" defaultValue: "false" outputs: - contextPath: SentinelOne.Agent.Affected description: Number of affected endpoints. type: String description: Get the Agent and Endpoint logs from Agents for provided agent IDs. name: sentinelone-endpoint-fetch-logs - arguments: - name: item description: "Value of the item to be removed from the exclusion list." required: true - name: os_type description: OS type. Can be "windows", "windows_legacy", "macos", or "linux". auto: PREDEFINED predefined: - windows - windows_legacy - macos - linux - name: exclusion_type description: "Exclusion item type. The options are: file_type, path, white_hash, certificate, or browser." outputs: - contextPath: SentinelOne.RemoveItemFromWhitelist.status description: Status on if items were removed from whitelist or not found on whitelist. type: String - contextPath: SentinelOne.RemoveItemFromWhitelist.item description: Item removed fom whitelist. type: String description: Remove an item from the SentinelOne exclusion list. name: sentinelone-remove-item-from-whitelist - arguments: - name: account_ids isArray: true description: A comma-separated list of account IDs. required: true - name: output_destination required: true description: 'Output destination. Possible values: DataSetCloud/Local/None/SentinelCloud.' auto: PREDEFINED predefined: - DataSetCloud - Local - None - SentinelCloud - name: task_description required: true description: Task description. - name: script_id required: true description: Script ID. - name: output_directory description: Output directory. - name: agent_ids required: true description: A comma-separated list of agent IDs on which the script should run. isArray: true - name: singularity_xdr_Keyword description: Singularityxdr keyword. - name: singularity_xdr_Url description: Singularityxdr url. - name: api_key description: Api key. - name: input_params description: Input params. - name: password description: Password. - name: script_runtime_timeout_seconds description: Script runtime timout in seconds for current execution. - auto: PREDEFINED defaultValue: "false" description: If set to true, execution will require approval. name: requires_approval predefined: - "false" - "true" outputs: - contextPath: SentinelOne.RunRemoteScript.pendingExecutionId description: ID of the created pending execution. Present only if pending flag is true. type: string - contextPath: SentinelOne.RunRemoteScript.pending description: Flag indicating if the requested script execution requires approval and is created as a pending execution. type: boolean - contextPath: SentinelOne.RunRemoteScript.affected description: Number of entities affected by the requested operation. type: number - contextPath: SentinelOne.RunRemoteScript.parentTaskId description: The parent task ID of the script execution task. Null in case of pending execution. type: string description: Run a remote script that was uploaded to the SentinelOne Script Library. name: sentinelone-run-remote-script - arguments: - name: account_ids description: "A comma-separated list of account IDs. Example: '225494730938493804,225494730938493915'." isArray: true - name: computer_name_contains description: Free-text filter by agent computer name (supports multiple values). - name: count_only description: If true, only total number of items will be returned, without any of the actual objects. auto: PREDEFINED predefined: - "false" - "true" - name: created_at_gt description: "Created at greater than timedate. Example: '2018-02-27T04:49:26.257525Z'." - name: created_at_gte description: "Created at greater or equal than timedate. Example: '2018-02-27T04:49:26.257525Z'." - name: created_at_lt description: "Created at lesser than timedate. Example: '2018-02-27T04:49:26.257525Z'." - name: created_at_lte description: "Created at lesser or equal than timedate. Example: '2018-02-27T04:49:26.257525Z'." - name: cursor description: "Cursor position returned by the last request. Use to iterate over more than 1000 items. Example: 'YWdlbnRfaWQ6NTgwMjkzODE='." - name: description_contains description: Only include tasks with specific description. - name: detailed_status_contains description: Only include tasks with specific detailed status. isArray: true - name: group_ids description: "Comma-separated list of Group IDs to filter by. Example: '225494730938493804,225494730938493915'." isArray: true - name: ids description: "Comma-separated list of IDs to filter by. Example: '225494730938493804,225494730938493915'." isArray: true - description: Only include tasks from specific initiating user. name: initiated_by_contains isArray: true - description: "Limit number of returned items (1-1000). Example: '10'." name: limit - description: "Parent task ID to fetch the status by. Example: '225494730938493804'." name: parent_task_id required: true - description: "List of IDs to filter by." name: parent_task_id_in isArray: true - name: query description: Query. - name: site_ids isArray: true description: "List of site IDs to filter by. Example: '225494730938493804,225494730938493915'." - name: status description: "Status of the script task. Example: 'created'." - name: tenant auto: PREDEFINED predefined: - "false" - "true" description: Indicates a tenant scope request. - name: updated_at_gt description: "Updated at greater than datetime. Example: '2018-02-27T04:49:26.257525Z'." - name: updated_at_gte description: "Updated at greater or equal than datetime. Example: '2018-02-27T04:49:26.257525Z'." - name: updated_at_lt description: "Updated at lesser than datetime. Example: '2018-02-27T04:49:26.257525Z'." - name: updated_at_lte description: "Updated at lesser or equal than datetime. Example: '2018-02-27T04:49:26.257525Z'." - name: uuid_contains description: Free-text filter by agent UUID (supports multiple values). description: Get remote scripts tasks using a variety of filters. name: sentinelone-get-remote-script-task-status outputs: - contextPath: SentinelOne.GetRemoteScript.id description: ID of the task. type: string - contextPath: SentinelOne.GetRemoteScript.accountId description: Account ID where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.accountName description: Account name where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.agentId description: Agent ID where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.agentIsActive description: The status of the agent. type: boolean - contextPath: SentinelOne.GetRemoteScript.agentMachineType description: Agent machine yype. type: string - contextPath: SentinelOne.GetRemoteScript.agentOsType description: Agent operating system type. type: string - contextPath: SentinelOne.GetRemoteScript.agentUuid description: Agent UUID. type: string - contextPath: SentinelOne.GetRemoteScript.createdAt description: The script created At datetime. type: string - contextPath: SentinelOne.GetRemoteScript.description description: The description of the remote script. type: string - contextPath: SentinelOne.GetRemoteScript.detailedStatus description: The detailed status of the remote script. type: string - contextPath: SentinelOne.GetRemoteScript.groupId description: Group ID where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.groupName description: Group Name where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.initiatedBy description: Remote script initiate by. type: string - contextPath: SentinelOne.GetRemoteScript.initiatedById description: ID of the remote script initiator. type: string - contextPath: SentinelOne.GetRemoteScript.parentTaskId description: Parent task ID of the remote script. type: string - contextPath: SentinelOne.GetRemoteScript.siteId description: Site ID where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.siteName description: Site name where this script is executed. type: string - contextPath: SentinelOne.GetRemoteScript.status description: Status of the remote script. type: string - contextPath: SentinelOne.GetRemoteScript.statusCode description: Status code of the remote script. type: string - contextPath: SentinelOne.GetRemoteScript.statusDescription description: Status description of the remote script. type: string - contextPath: SentinelOne.GetRemoteScript.type description: Type of remote script. type: string - contextPath: SentinelOne.GetRemoteScript.updateAt description: Remote script upated at. type: string - arguments: - name: computer_names description: A comma-separated list of partial or whole computer names, which ran scripts, to get a download link for. isArray: true - name: task_ids description: A comma-separated list of task IDs to get a download link for. isArray: true required: true description: Get a script's result download URL. name: sentinelone-get-remote-script-task-results outputs: - contextPath: SentinelOne.RemoteScriptResults.taskId description: ID of the task. type: string - contextPath: SentinelOne.RemoteScriptResults.fileName description: File name. type: string - contextPath: SentinelOne.RemoteScriptResults.downloadUrl description: Download URL. type: string - arguments: - name: account_ids required: true description: A comma-separated list of account IDs. isArray: true - name: output_destination required: true auto: PREDEFINED predefined: - DataSetCloud - Local - None - SentinelCloud description: Output destination. - name: task_description required: true description: Task description. - name: script_id required: true description: Script ID. - name: output_directory description: Output directory. - name: agent_ids required: true description: A comma-separated list of agent IDs on which the script should run. isArray: true - name: singularity_xdr_Keyword description: Singularity XDR keyword. - name: singularity_xdr_Url description: Singularity XDR URL. - name: api_key description: API key. - name: input_params description: Input parameters. - name: password description: Password. - name: script_runtime_timeout_seconds description: Script runtime timout in seconds for current execution. - auto: PREDEFINED defaultValue: "false" description: If set to true, execution will require approval. name: requires_approval predefined: - "false" - "true" - defaultValue: '60' description: Indicates how long to wait between command execution (in seconds) when 'polling' argument is true. Minimum value is 10 seconds. name: interval - defaultValue: '600' description: Indicates the time in seconds until the polling sequence timeouts. name: timeout - description: "Parent task ID to fetch the status by. Example: '225494730938493804'." name: parent_task_id description: Automate a remote script's execution cycle and return the script's results. name: sentinelone-remote-script-automate-results outputs: - contextPath: SentinelOne.RemoteScriptResults.taskId description: ID of the task. type: string - contextPath: SentinelOne.RemoteScriptResults.fileName description: File name. type: string - contextPath: SentinelOne.RemoteScriptResults.downloadUrl description: Download URL. type: string polling: true - arguments: - name: account_ids description: A comma-separated list of account IDs. isArray: true - name: site_ids description: A comma-separated list of site IDs on which the query should run. isArray: true - name: query required: true description: Events matching the query search term will be returned. - name: from_date required: true description: "Events created after this date. Example: '2018-02-27T04:49:26.257525Z'." - name: to_date required: true description: "Events created before or at this date. Example: '2018-02-27T04:49:26.257525Z'." - name: limit description: Limit number of returned items (1-100000). - defaultValue: '10' description: Indicates how long to wait between command execution (in seconds) when 'polling' argument is true. Minimum value is 10 seconds. name: interval - defaultValue: '300' description: Indicates the time in seconds until the polling sequence timeouts. name: timeout - name: query_id description: "QueryId. Example: pq3be5e2747f716cxxxxxxxxxxxxx20a0." description: Automate a power query and return the query results. (The maximum timeout of 300 seconds is allowed.) name: sentinelone-get-power-query-results outputs: - contextPath: SentinelOne.PowerQuery.ResultIndex description: Result from the power query in list of objects format. type: List polling: true - arguments: [] description: Returns the list of fields for an incident type. name: get-mapping-fields - arguments: [] description: Pushes local changes to the remote system. name: update-remote-system - arguments: - description: 'The ticket ID.' name: id required: true - description: Retrieve entries that were created after lastUpdate. name: lastUpdate required: true description: Get remote data from a remote incident. This method does not update the current incident, and should be used for debugging purposes. name: get-remote-data - arguments: - description: Retrieve entries that were created after lastUpdate. name: last_update description: Gets the list of incidents that were modified since the last update time. Note that this method is here for debugging purposes. The get-modified-remote-data command is used as part of a Mirroring feature, which is available from version 6.1. name: get-modified-remote-data - arguments: - description: 'The queryId that is returned when creating a query under Create Query. Example: "q1xx2xx3". Get the query_id from the "get-query-id" command.' name: query_id required: true description: Returns status of a Deep Visibility Query. name: sentinelone-get-dv-query-status outputs: - contextPath: SentinelOne.Query.Status.progressStatus description: Progress Query Status. - contextPath: SentinelOne.Query.Status.queryModeInfo.lastActivatedAt description: Last Activated At. - contextPath: SentinelOne.Query.Status.queryModeInfo.mode description: Query Mode. - contextPath: SentinelOne.Query.Status.responseState description: State of the Query. - contextPath: SentinelOne.Query.Status.warnings description: Warnings during Query. - contextPath: SentinelOne.Query.Status.QueryId description: QueryID From Request. - arguments: - name: agent_id description: AgentId of the System. required: true description: Returns network interface details for a given Agent ID. This includes MAC address details and interface description. name: sentinelone-get-agent-mac outputs: - contextPath: SentinelOne.MAC description: Agent network interface details. - contextPath: SentinelOne.MAC.agent_id description: AgentID. - contextPath: SentinelOne.MAC.hostname description: Hostname. - contextPath: SentinelOne.MAC.int_name description: Interface Name. - contextPath: SentinelOne.MAC.ip description: IP Address. - contextPath: SentinelOne.MAC.mac description: MAC Address. - arguments: - name: account_id description: Can filter on one account ID. Otherwise, it returns information from all accounts. required: false description: Returns details of accounts. name: sentinelone-get-accounts outputs: - contextPath: SentinelOne.Accounts.AccountType description: The account type. type: string - contextPath: SentinelOne.Accounts.ActiveAgents description: The account number of active agents. type: number - contextPath: SentinelOne.Accounts.NumberOfSites description: The account number of sites. type: number - contextPath: SentinelOne.Accounts.State description: The account state. type: string - contextPath: SentinelOne.Accounts.CreatedAt description: The account creation date. type: string - contextPath: SentinelOne.Accounts.Expiration description: The account expiration date. type: string - contextPath: SentinelOne.Accounts.ID description: The account ID. type: string - contextPath: SentinelOne.Accounts.Name description: The account name. type: string - arguments: - description: A comma-separated list of account IDs. name: account_ids isArray: true - name: application_catalog_id description: Filter results by application catalog id. - name: creator_contains description: Free-text filter by application creator. - name: ids description: A comma-separated list of applications IDs. isArray: true - name: name_contains description: Free-text filter by application name. - name: site_ids description: A comma-separated list of site IDs. isArray: true description: Returns all installed singularity marketplace applications that match the specified filter values. name: sentinelone-list-installed-singularity-marketplace-applications outputs: - contextPath: SentinelOne.InstalledApps.ID description: The application ID. type: string - contextPath: SentinelOne.InstalledApps.Account description: The account name. type: string - contextPath: SentinelOne.InstalledApps.AccountId description: The account ID. type: string - contextPath: SentinelOne.InstalledApps.ApplicationCatalogId description: The application Catalog ID. type: string - contextPath: SentinelOne.InstalledApps.ApplicationCatalogName description: The application Catalog name. type: string - contextPath: SentinelOne.InstalledApps.AlertMessage description: The alert message. type: string - contextPath: SentinelOne.InstalledApps.CreatedAt description: Application created at. type: date - contextPath: SentinelOne.InstalledApps.Creator description: Application creator. type: string - contextPath: SentinelOne.InstalledApps.CreatorId description: Application creator ID. type: string - contextPath: SentinelOne.InstalledApps.DesiredStatus description: Application desired status. type: string - contextPath: SentinelOne.InstalledApps.HasAlert description: Application has alert. type: boolean - contextPath: SentinelOne.InstalledApps.LastEntityCreatedAt description: Application last entity created at. type: date - contextPath: SentinelOne.InstalledApps.Modifier description: Modifier. type: string - contextPath: SentinelOne.InstalledApps.ModifierId description: Modifier ID. type: string - contextPath: SentinelOne.InstalledApps.ScopeId description: The scope ID. type: string - contextPath: SentinelOne.InstalledApps.ScopeLevel description: The scope level. type: string - contextPath: SentinelOne.InstalledApps.Status description: Status of application. type: string - contextPath: SentinelOne.InstalledApps.UpdatedAt description: Application updated at. type: string - contextPath: SentinelOne.InstalledApps.ApplicationInstanceName description: Application instance name. type: string - arguments: - name: account_ids description: "A comma-separated list of account IDs." isArray: true - name: role_ids description: A comma-separated list of rbac roles to filter by. isArray: true - name: ids description: A comma-separated list of service user IDs to filter by. isArray: true - name: site_ids description: A comma-separated list of site IDs. isArray: true name: sentinelone-get-service-users description: Returns all service users that match the specified filter values. outputs: - contextPath: SentinelOne.ServiceUsers.ID description: The service user ID. type: string - contextPath: SentinelOne.ServiceUsers.ApiTokenCreatedAt description: Api token created at. type: date - contextPath: SentinelOne.ServiceUsers.ApiTokenExpiresAt description: Api token expires at. type: date - contextPath: SentinelOne.ServiceUsers.CreatedAt description: Service user created at. type: date - contextPath: SentinelOne.ServiceUsers.CreatedById description: The service user created by Id. type: string - contextPath: SentinelOne.ServiceUsers.CreatedByName description: The service user created by name. type: string - contextPath: SentinelOne.ServiceUsers.Description description: Service user description. type: string - contextPath: SentinelOne.ServiceUsers.LastActivation description: Last activation date. type: date - contextPath: SentinelOne.ServiceUsers.Name description: Service user name. type: string - contextPath: SentinelOne.ServiceUsers.Scope description: Service user scope. type: string - contextPath: SentinelOne.ServiceUsers.UpdatedAt description: Service user updated at. type: date - contextPath: SentinelOne.ServiceUsers.UpdatedById description: Service user updated by Id. type: string - contextPath: SentinelOne.ServiceUsers.UpdatedByName description: Service user updated by name. type: string - contextPath: SentinelOne.ServiceUsers.ScopeRolesRoleId description: Scope roles role Id. type: string - contextPath: SentinelOne.ServiceUsers.ScopeRolesRoleName description: Scope roles role name. type: string - contextPath: SentinelOne.ServiceUsers.ScopeRolesAccountName description: Scope roles account name. type: string - contextPath: SentinelOne.ServiceUsers.ScopeRolesId description: Scope roles Id. type: string - arguments: - description: The ID of the threat. name: threat_id required: true description: Returns threat notes. name: sentinelone-get-threat-notes outputs: - contextPath: SentinelOne.Notes.CreatedAt description: The note creation date. type: string - contextPath: SentinelOne.Notes.Creator description: The note creator. type: string - contextPath: SentinelOne.Notes.CreatorID description: The note creator ID. type: string - contextPath: SentinelOne.Notes.Edited description: Whether the note was edited or not. type: boolean - contextPath: SentinelOne.Notes.ID description: The note ID. type: string - contextPath: SentinelOne.Notes.Text description: The note text. type: string - contextPath: SentinelOne.Notes.UpdatedAt description: The note updated time. type: string - arguments: - name: threat_id required: true description: "Please provide the Valid Threat ID. Example: 14629133470822878." name: sentinelone-threat-download-from-cloud description: Download a file associated with the threat from the Cloud (BinaryVault). outputs: - contextPath: SentinelOne.Threat.ID description: The threat ID. type: String - contextPath: SentinelOne.Threat.Downloadable description: Whether the file is downloadable. type: Boolean - contextPath: SentinelOne.Threat.ZippedFile description: Details of the zipped folder. type: String - arguments: - name: threat_id required: true description: "Please provide the Valid Threat ID. Example: 14629133470822878." - name: limit required: false description: "The max number of timeline entries to return, default is 5000." name: sentinelone-export-full-threat-timeline description: Exports the threat's full timeline as a JSON File. Relevant for API version 2.1. outputs: - contextPath: SentinelOne.Export.Timeline.ThreatId description: The threat ID. type: String - contextPath: SentinelOne.Export.Timeline.Filename description: The name of the file containing the Timeline. type: Boolean - arguments: - name: threat_id required: true description: "Please provide the Valid Threat ID. Example: 14629133470822878." name: sentinelone-export-threat-events description: Exports the threat's events as a JSON File. Relevant for API version 2.1. outputs: - contextPath: SentinelOne.Export.Events.ThreatId description: The threat ID. type: String - contextPath: SentinelOne.Export.Events.Filename description: The name of the file containing the Timeline. type: Boolean dockerimage: demisto/python3:3.12.13.10116658 isfetch: true ismappable: true isremotesyncin: true isremotesyncout: true script: "" type: python subtype: python3 tests: - SentinelOne V2.1 - Test - SentinelOne V2.0 - Test fromversion: 5.0.0 defaultclassifier: SentinelOne Classifier defaultmapperin: SentinelOne Incoming Mapper defaultmapperout: SentinelOne - Outgoing Mapper