# Integrate SentinelOne with Google SecOps

This document explains how to configure and integrate SentinelOne with
Google Security Operations (Google SecOps).

## Use cases

1. **Automated threat response**: use Google SecOps capabilities
   to automatically respond to threats detected by SentinelOne, reducing the
   time and effort required for security operations.

2. **Enriched incident context**: use Google SecOps capabilities
   to provide security analysts with more context around security incidents and
   make more informed decisions. For example, you can automatically enrich
   incident data with information about the affected endpoints and threats.

3. **Orchestrated remediation actions**: use Google SecOps
   capabilities to automatically execute playbooks that combine SentinelOne
   actions with other security tools, such as network firewalls or identity
   management systems, ensuring a coordinated response to threats and
   minimizing their impact.

## Integration parameters

The SentinelOne integration requires the following parameters:

| Parameter | Description |
|---|---|
| `Api root` | Required. The SentinelOne API root. The default value is `https://{server}.sentinelone.net/`. |
| `Username` | Required. The username to authenticate with. |
| `Password` | Required. The password to authenticate with. |


For instructions about how to configure an integration in
Google SecOps, see [Configure
integrations](https://docs.cloud.google.com/chronicle/docs/soar/respond/integrations-setup/configure-integrations).

You can make changes at a later stage, if needed. After you configure an
integration instance, you can use it in playbooks. For more information about
how to configure and support multiple instances, see [Supporting
multiple instances](https://docs.cloud.google.com/chronicle/docs/soar/respond/integrations-setup/supporting-multiple-instances).

<br />

## Actions


For more information about actions, see [Respond to pending actions from your workdesk](https://docs.cloud.google.com/chronicle/docs/soar/overview-and-introduction/your-workdesk/respond-to-pending-actions-from-workdesk) and [Run a
manual action in your case](https://docs.cloud.google.com/chronicle/docs/soar/investigate/working-with-cases/what-actions-can-you-take-on-a-case#run-manual-action).

### Disconnect Agent From Network

Use the **Disconnect Agent From Network** action to disconnect an agent from the
network connection.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Disconnect Agent From Network** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Disconnect Agent From Network** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Enrich Endpoint

Use the **Enrich Endpoint** action to enrich an endpoint entity with information
from the system.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Enrich Endpoint** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Enrich Endpoint** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get Agent Status

Use the **Get Agent Status** action to retrieve the status of an agent.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Get Agent Status** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Get Agent Status** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get Application List for Endpoint

Use the **Get Application List for Endpoint** action to obtain a list of
applications used on an endpoint.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Get Application List for Endpoint** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Get Application List for Endpoint** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get Events for Endpoint by Time

Use the **Get Events for Endpoint by Time** action to retrieve all events that
are related to an endpoint.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

The **Get Events for Endpoint by Time** action requires the following
parameters:

| Parameter | Description |
|---|---|
| `Hours Back` | Optional. The number of hours prior to the current time to retrieve events. |
| `Events Amount Limit` | Optional. The number of events to retrieve for every action run. |

#### Action outputs

The **Get Events for Endpoint by Time** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Get Events for Endpoint by Time** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get Hash Reputation

Use the **Get Hash Reputation** action to obtain the reputation of a SHA-1 hash.

This action runs on the Google SecOps `Filehash` entity.

#### Action inputs

None.

#### Action outputs

The **Get Hash Reputation** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Get Hash Reputation** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get Process List for Endpoint

Use the **Get Process List for Endpoint** action to retrieve the process list
for an endpoint.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Get Process List for Endpoint** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Get Process List for Endpoint** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get System Status

Use the **Get System Status** action to get the SentinelOne system health
status.

This action runs on all Google SecOps entities.

#### Action inputs

None.

#### Action outputs

The **Get System Status** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using the
**Get System Status** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Get System Version

Use the **Get System Version** action to get the SentinelOne system version.

This action runs on all Google SecOps entities.

#### Action inputs

None.

#### Action outputs

The **Get System Version** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using the
**Get System Version** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Initiate Full Scan

Use the **Initiate Full Scan** action to initiate a full disk scan on an
endpoint.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Initiate Full Scan** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using the
**Initiate Full Scan** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Ping

Use the **Ping** action to test the connectivity to SentinelOne.

This action runs on all Google SecOps entities.

#### Action inputs

None.

#### Action outputs

The **Ping** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using the
**Ping** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Reconnect Agent to the Network

Use the **Reconnect Agent to the Network** action to reconnect a disconnected
agent to the network.

<br />

This action runs on the following
Google SecOps entities:

- `IP Address`
- `Hostname`

<br />

#### Action inputs

None.

#### Action outputs

The **Reconnect Agent to the Network** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Reconnect Agent to the Network** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

### Update Exclusion List Add Path

Use the **Update Exclusion List Add Path** action to add a path to an existing
exclusion list.

This action supports the following operating systems: Windows, OSX, Linux, and
Android.

This action runs on all Google SecOps entities.

#### Action inputs

The **Update Exclusion List Add Path** action requires the following parameters:

| Parameter | Description |
|---|---|
| `List Name` | Required. The exclusion list name. |
| `Path` | Required. The path to add to the list. |
| `Operation System` | Required. The operating system. The possible values are as follows: - `windows` - `osx` - `linux` - `android` |

#### Action outputs

The **Update Exclusion List Add Path** action provides the following outputs:


| Action output type | Availability |
|---|---|
| Case wall attachment | Not available |
| Case wall link | Not available |
| Case wall table | Not available |
| Enrichment table | Not available |
| JSON result | Not available |
| Script result | Available |

<br />

##### Script result

The following table lists the value for the script result output when using
the **Update Exclusion List Add Path** action:


| Script result name | Value |
|---|---|
| `is_success` | `True` or `False` |

<br />

**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/)