Integra SentinelOne v2 en Google SecOps
En este documento, se explica cómo configurar e integrar SentinelOne v2 con Google Security Operations.
Esta integración admite la versión 2.0 y posteriores de la API de SentinelOne.
Esta integración usa uno o más componentes de código abierto. Puedes descargar una copia comprimida del código fuente completo de esta integración desde el bucket de Cloud Storage.
Casos de uso
La integración de SentinelOne puede ayudarte a resolver los siguientes casos de uso:
Contener los extremos infectados: Usa las funciones de Google SecOps para aislar un host infectado y evitar el movimiento lateral y el robo de datos.
Recupera información detallada de los extremos: Usa las capacidades de Google SecOps para enriquecer los datos de incidentes con un análisis detallado de los hosts para obtener un mejor contexto y tomar decisiones. Puedes consultar automáticamente SentinelOne para obtener información detallada sobre un extremo involucrado en una alerta, incluida la versión del agente, el sistema operativo y las interfaces de red.
Inicia análisis de Deep Visibility: Usa las capacidades de Google SecOps para buscar amenazas y malware oculto en máquinas sospechosas y, cuando se detecte actividad sospechosa, como modificaciones de archivos o cambios de registro inusuales, inicia un análisis de disco completo con SentinelOne.
Investiga amenazas con inteligencia contra amenazas: Usa las capacidades de Google SecOps para mejorar la precisión correlacionando las alertas de SentinelOne con los datos de inteligencia contra amenazas, reenviar hashes sospechosos, rutas de archivos o direcciones IP que se encuentran en las alertas de SentinelOne a las plataformas de inteligencia contra amenazas.
Clasifica el software malicioso: Usa las funciones de Google SecOps para clasificar automáticamente el software malicioso con herramientas de análisis estático para una respuesta ante incidentes optimizada. Puedes extraer muestras de endpoints infectados, activar el análisis dentro de tu entorno y recibir una clasificación para el malware según el análisis estático.
Antes de comenzar
Para autenticar la conexión entre Google SecOps y tu instancia de SentinelOne, debes proporcionar un token de API de SentinelOne válido.
Puedes generar un token de API personal en la consola de administración de SentinelOne.
Para obtener instrucciones detalladas sobre cómo generar y administrar tokens, consulta el Portal del cliente de SentinelOne.
Parámetros de integración
La integración de SentinelOne v2 requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
API root |
Obligatorio. Es la raíz de la API de SentinelOne. El valor predeterminado es |
API Token |
Obligatorio. Es el token de la API de SentinelOne. Para obtener más información sobre cómo generar el token de API para la integración, consulta Antes de comenzar. La política de seguridad de SentinelOne requiere que crees un token de API nuevo cada seis meses. |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Sentinel. Habilitada de forma predeterminada. |
Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.
Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.
Acciones
Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.
Agregar nota de amenaza
Usa la acción Agregar nota de amenaza para agregar una nota a la amenaza en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Agregar nota de amenaza requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Threat ID |
Obligatorio. Es el ID de la amenaza a la que se agregará una nota. |
Note |
Obligatorio. Es una nota que se agregará a la amenaza. |
Resultados de la acción
La acción Agregar nota de amenaza proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Agregar nota de amenaza puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Add Threat Note". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Agregar nota de amenaza:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Crea una regla de control de dispositivos
Usa la acción Crear regla de control de dispositivos para crear una regla de control de dispositivos en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Create Device Control Rule requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Rule JSON |
Obligatorio. Es el objeto JSON que representa la configuración de la regla de control de dispositivos. El valor predeterminado es el siguiente: { "ruleName": "String", "interface": "String", "ruleType": "String", "action": "String", "accessPermission": "String", "deviceClass": "String", "status": "String" } |
Scope JSON |
Obligatorio. Es el objeto JSON que representa la configuración de la regla de alcance. El valor predeterminado es el siguiente: { "accountIds": "String", "groupIds": "String", "siteIds": "String" } |
Resultados de la acción
La acción Create Device Control Rule proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Crear regla de control de dispositivos:
{
"data": {
"accessPermission": "Read-Write",
"action": "Allow",
"bluetoothAddress": null,
"createdAt": "2024-01-01T00:00:00.000000Z",
"creator": "[USERNAME] ([EMAIL_ADDRESS])",
"creatorId": "[CREATOR_ID]",
"deviceClass": "FFh",
"deviceClassName": "FF Vendor Specific",
"deviceId": null,
"deviceInformationServiceInfoKey": null,
"deviceInformationServiceInfoValue": null,
"deviceName": null,
"editable": true,
"gattService": null,
"id": "[RULE_ID]",
"interface": "USB",
"manufacturerName": null,
"minorClasses": null,
"order": 1,
"productId": null,
"ruleName": "Test",
"ruleType": "class",
"scope": "account",
"scopeId": "[SCOPE_ID]",
"scopeName": "[SCOPE_NAME]",
"status": "Disabled",
"uid": null,
"updatedAt": "2024-01-01T00:00:00.000000Z",
"vendorId": null,
"version": null
}
}
Mensajes de salida
La acción Crear regla de control de dispositivos puede devolver los siguientes mensajes de resultado:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Create Device Control Rule". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Crear regla de control de dispositivos:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Crear registro de lista de hashes bloqueados
Usa la acción Create Hash Black List Record para agregar hashes a una lista de entidades bloqueadas en SentinelOne.
Esta acción solo admite hashes SHA-1.
Esta acción se ejecuta en la entidad Hash de Google SecOps.
Entradas de acción
La acción Crear registro de lista de hashes bloqueados requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Operating System |
Obligatorio. Un sistema operativo para el hash. Los valores posibles son los siguientes:
El valor predeterminado es |
Site IDs |
Es opcional. Es una lista separada por comas de los IDs de sitios que se enviarán a la lista de entidades bloqueadas. |
Group IDs |
Es opcional. Es una lista separada por comas de los IDs de grupos que se enviarán a la lista de entidades bloqueadas. |
Account IDs |
Es opcional. Es una lista separada por comas de los IDs de cuenta que se enviarán a la lista de entidades bloqueadas. |
Description |
Es opcional. Información adicional relacionada con un hash. El valor predeterminado es |
Add to global blocklist |
Obligatorio. Si se selecciona, la acción agrega un hash a una lista de entidades bloqueadas global. Si seleccionas este parámetro, la acción ignorará los parámetros
|
Resultados de la acción
La acción Create Hash Black List Record proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Create Hash Black List Record:
[
{
"Entity": "ENTITY_ID",
"EntityResult": [{
"userName": "user",
"description": "Created by user.",
"userId": "USER_ID",
"scopeName": "Test Group",
"value": "36F9CA40B3CE96FCEE1CF1D4A7222935536FD25A",
"source": "user",
"updatedAt": "2020-07-02T14:41:20.678280Z",
"osType": "windows",
"scope": {
"groupIds": ["GROUP_ID"]
},
"type": "white_hash",
"id": "ENTITY_ID",
"createdAt": "2020-07-02T14:41:20.678690Z"
}, {
"userName": "user",
"description": "Created by user.",
"userId": "USER_ID",
"scopeName": "Test Group 2",
"value": "36F9CA40B3CE96FCEE1CF1D4A7222935536FD25A",
"source": "user",
"updatedAt": "2020-07-02T14:41:20.683858Z",
"osType": "windows",
"scope": {
"groupIds": ["GROUP_ID"]
},
"type": "white_hash",
"id": "ENTITY_ID",
"createdAt": "2020-07-02T14:41:20.684677Z"
}]
}
]
Mensajes de salida
La acción Create Hash Black List Record puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Create Hash Black List Record". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Create Hash Black List Record:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Crea un registro de exclusión de hash
Usa la acción Create Hash Exclusion Record para agregar un hash a la lista de exclusión en SentinelOne.
Esta acción solo admite hashes SHA-1.
Esta acción se ejecuta en la entidad Hash de Google SecOps.
Entradas de acción
La acción Crear registro de exclusión de hash requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Operation System |
Obligatorio. Un sistema operativo (SO) para el hash. Los valores posibles son los siguientes:
El valor predeterminado es |
Site IDs |
Es opcional. Es una lista separada por comas de los IDs de sitio para enviar el hash a la lista de exclusión. La acción requiere al menos un valor válido. |
Group IDs |
Es opcional. Es una lista separada por comas de los IDs de grupo para enviar el hash a la lista de exclusión. La acción requiere al menos un valor válido. |
Account IDs |
Es opcional. Es una lista separada por comas de los IDs de cuenta para enviar el hash a la lista de exclusión. |
Description |
Es opcional. Información adicional relacionada con el hash. |
Add to global exclusion list |
Es opcional. Si se selecciona, la acción agrega un hash a la lista de exclusión global. Si seleccionas este parámetro, la acción ignorará los parámetros |
Resultados de la acción
La acción Create Hash Exclusion Record proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Crear registro de exclusión de hash:
[
{
"ENTITY_ID":
{
"ID": "ALLOWLISTED_ENTITY_ID",
"Created Time": "ITEM_CREATION_TIME",
"Scope ID": "SITE_OR_GROUP_ID",
"Scope Name": "example_scope"
}
}
]
Mensajes de salida
La acción Create Hash Exclusion Record puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Create Hash Exclusion Record". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Crear registro de exclusión de hash:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Crea un registro de exclusión de ruta de acceso
Usa la acción Create Path Exclusion Record para agregar una ruta de acceso a la lista de exclusión en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Crear registro de exclusión de ruta requiere los siguientes parámetros:
El valor predeterminado es Suppress Alerts.
| Parámetro | Descripción |
|---|---|
Path |
Obligatorio. Es una ruta de acceso para agregar a la lista de exclusión. |
Operation System |
Obligatorio. Un sistema operativo (SO) para el hash. Los valores posibles son los siguientes:
El valor predeterminado es |
Site IDs |
Es opcional. Es una lista separada por comas de los IDs de sitio para enviar el hash a la lista de exclusión. La acción requiere al menos un valor válido. |
Group IDs |
Es opcional. Es una lista separada por comas de los IDs de grupo para enviar el hash a la lista de exclusión. La acción requiere al menos un valor válido. |
Account IDs |
Es opcional. Es una lista separada por comas de los IDs de cuenta para enviar el hash a la lista de exclusión. |
Description |
Es opcional. Información adicional relacionada con el hash. |
Add to global exclusion list |
Es opcional. Si se selecciona, la acción agrega un hash a la lista de exclusión global. Si seleccionas este parámetro, la acción ignorará los parámetros |
Include Subfolders |
Es opcional. Si se selecciona, la acción incluye subcarpetas para la ruta de acceso proporcionada. Este parámetro solo se aplica si configuras una ruta de acceso de carpeta en el
parámetro |
Mode |
Es opcional. Es un modo que se usará para la ruta excluida. Los valores posibles son los siguientes:
|
Resultados de la acción
La acción Create Path Exclusion Record proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Crear registro de exclusión de ruta de acceso:
[
{
"ENTITY_ID":
{
"ID": "ALLOWLISTED_ENTITY_ID",
"Created Time": "ITEM_CREATION_TIME",
"Scope ID": "SITE_OR_GROUP_ID",
"Scope Name": "example_scope"
}
}
]
Mensajes de salida
La acción Crear registro de exclusión de ruta de acceso puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Create Path Exclusion Record". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Crear registro de exclusión de ruta de acceso:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Borrar regla de control de dispositivos
Usa la acción Borrar regla de control de dispositivos para borrar una regla de control de dispositivos en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Borrar regla de control de dispositivos requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Rule ID |
Obligatorio. Es el ID de la regla que se borrará. |
Scope Type |
Es opcional. Es el nivel de la organización en el que la alerta es visible o aplicable. Los valores posibles son los siguientes:
El valor predeterminado es |
Scope ID |
Obligatorio. Es el ID del permiso. |
Resultados de la acción
La acción Borrar regla de control de dispositivos proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Borrar regla de control de dispositivos puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Delete Device Control Rule". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Borrar regla de control de dispositivos:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Borrar registro de lista negra de hashes
Usa la acción Borrar registro de lista de entidades bloqueadas de hash para borrar hashes de una lista de entidades bloqueadas en SentinelOne.
Esta acción solo admite los hashes SHA-1.
Esta acción se ejecuta en la entidad Hash de Google SecOps.
Entradas de acción
La acción Borrar registro de lista negra de hash requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Site IDs |
Es opcional. Es una lista separada por comas de los IDs de sitio de los que se quitará el hash. |
Group IDs |
Es opcional. Es una lista separada por comas de los IDs de grupo de los que se quitará el hash. |
Account IDs |
Es opcional. Es una lista separada por comas de los IDs de cuenta de los que se quitará el hash. |
Remove from global black list |
Es opcional. Si se selecciona, la acción quita el hash de la lista de entidades bloqueadas global. Si seleccionas este parámetro, la acción ignorará los parámetros
|
Resultados de la acción
La acción Borrar registro de lista de hashes bloqueados proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Borrar registro de lista de hashes bloqueados puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Delete Hash Blacklist Record". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Borrar registro de lista de hashes bloqueados:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Desconectar el agente de la red
Usa la acción Desconectar agente de la red para desconectar un agente de una red con el nombre de host o la dirección IP del agente.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
Ninguno
Resultados de la acción
La acción Desconectar el agente de la red proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | No disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Desconectar el agente de la red:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Descargar archivo de amenazas
Usa la acción Descargar archivo de amenaza para descargar un archivo relacionado con una amenaza en SentinelOne.
Para recuperar archivos de amenazas en SentinelOne, necesitas cualquiera de los siguientes roles:
AdminIR TeamSOC
Esta acción no se ejecuta en las entidades de Google SecOps.
Limitaciones de acciones
La acción Descargar archivo de amenazas puede alcanzar el tiempo de espera cuando SentinelOne recupera un archivo, pero no proporciona una URL de descarga.
Para investigar la causa del tiempo de espera, ve a la cronología de amenazas.
Entradas de acción
La acción Descargar archivo de amenazas requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Threat ID |
Obligatorio. Es el ID de la amenaza para descargar un archivo. |
Password |
Obligatorio. Es una contraseña para la carpeta comprimida que contiene el archivo de amenaza. Los requisitos de la contraseña son los siguientes:
La longitud máxima de la contraseña es de 256 caracteres. |
Download Folder Path |
Obligatorio. Es una ruta de acceso a una carpeta para almacenar el archivo de amenazas. |
Overwrite |
Obligatorio. Si se selecciona, la acción reemplaza un archivo con el mismo nombre. No se selecciona de forma predeterminada. |
Resultados de la acción
La acción Descargar archivo de amenazas proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado en formato JSON que se recibe cuando se usa la acción Descargar archivo de amenazas:
{
"absolute_path": "ABSOLUTE_PATH"
}
Mensajes de salida
La acción Descargar archivo de amenaza puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Download Threat File". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Descargar archivo de amenazas:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Enriquece los extremos
Usa la acción Enrich Endpoints para enriquecer la información sobre el extremo con la dirección IP o el nombre de host.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
La acción Enrich Endpoints requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Create Insight |
Es opcional. Si se selecciona, la acción crea una estadística con información sobre los extremos. |
Only Infected Endpoints Insights |
Es opcional. Si se selecciona, la acción solo crea estadísticas para los extremos infectados. |
Resultados de la acción
La acción Enrich Endpoints proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Enrich Endpoints:
{
"accountId": "ACCOUNT_ID",
"accountName": "SentinelOne",
"activeDirectory": {
"computerDistinguishedName": "CN=LP-EXAMPLE,CN=Computers,DC=EXAMPLE,DC=LOCAL",
"computerMemberOf": [],
"lastUserDistinguishedName": "CN=Example,OU=Users,OU=PS,OU=IL,OU=Operations,OU=EXAMPLE,DC=EXAMPLE,DC=LOCAL",
"lastUserMemberOf": [
"CN=esx.cs,OU=ESX,OU=GROUPS,OU=IL,OU=IT,OU=EXAMPLE,DC=EXAMPLE,DC=LOCAL",
"CN=Backup Operators,CN=Builtin,DC=EXAMPLE,DC=LOCAL",
"CN=esx.product,OU=ESX,OU=GROUPS,OU=IL,OU=IT,OU=EXAMPLE,DC=EXAMPLE,DC=LOCAL",
"CN=EXAMPLE_Admins,OU=QA,OU=IL,OU=IT,OU=EXAMPLE,DC=EXAMPLE,DC=LOCAL",
"CN=Local Admin,OU=GROUPS,OU=IL,OU=IT,OU=EXAMPLE,DC=EXAMPLE,DC=LOCAL",
"CN=CSM,OU=Operations,OU=EXAMPLE,DC=EXAMPLE,DC=LOCAL",
"CN=Event Log Readers,CN=Builtin,DC=EXAMPLE,DC=LOCAL"
]
},
"activeThreats": 0,
"agentVersion": "4.1.4.82",
"allowRemoteShell": false,
"appsVulnerabilityStatus": "patch_required",
"computerName": "LP-EXAMPLE",
"consoleMigrationStatus": "N/A",
"coreCount": 8,
"cpuCount": 8,
"cpuId": "Intel(R) Core(TM) i7-8650U CPU @ 1.90GHz",
"createdAt": "2020-05-31T07:22:14.695136Z",
"domain": "EXAMPLE",
"encryptedApplications": false,
"externalId": "",
"externalIp": "192.0.2.91",
"groupId": "863712577864500060",
"groupIp": "192.0.2.0",
"groupName": "Test Group",
"id": "ID",
"inRemoteShellSession": false,
"infected": false,
"installerType": ".msi",
"isActive": false,
"isDecommissioned": false,
"isPendingUninstall": false,
"isUninstalled": false,
"isUpToDate": true,
"lastActiveDate": "2021-01-12T12:59:43.143066Z",
"lastIpToMgmt": "192.0.2.20",
"lastLoggedInUserName": "EXAMPLE",
"licenseKey": "",
"locationType": "fallback",
"locations": [
{
"id": "ID",
"name": "Fallback",
"scope": "global"
}
],
"machineType": "laptop",
"mitigationMode": "protect",
"mitigationModeSuspicious": "protect",
"modelName": "Dell Inc. - Latitude 7490",
"networkInterfaces": [
{
"id": "ID",
"inet": [
"192.0.2.20"
],
"inet6": [
"2001:db8:1:1:1:1:1:1",
"2001:db8:2:2:2:2:2:2",
"2001:db8:ffff:ffff:ffff:ffff:ffff:ffff"
],
"name": "Wi-Fi",
"physical": "MAC_ADDRESS"
},
{
"id": "ID",
"inet": [
"192.168.193.193"
],
"inet6": [
"2001:db8:ffff:ffff:ffff:ffff:ffff:ffff"
],
"name": "vEthernet (Default Switch)",
"physical": "MAC_ADDRESS"
},
{
"id": "ID",
"inet": [
"201.0.113.1"
],
"inet6": [
"2001:db8:1:1:1:1:1:1",
"2001:db8:2:2:2:2:2:2"
],
"name": "vEthernet (DockerNAT)",
"physical": "MAC_ADDRESS"
}
],
"networkStatus": "connecting",
"osArch": "64 bit",
"osName": "Windows 10 Pro",
"osRevision": "18363",
"osStartTime": "2021-01-03T15:38:32Z",
"osType": "windows",
"osUsername": null,
"rangerStatus": "NotApplicable",
"rangerVersion": null,
"registeredAt": "2020-05-31T07:22:14.691561Z",
"scanAbortedAt": null,
"scanFinishedAt": "2020-05-31T09:28:53.867014Z",
"scanStartedAt": "2020-05-31T07:25:37.814972Z",
"scanStatus": "finished",
"siteId": "SITE_ID",
"siteName": "example.com",
"threatRebootRequired": false,
"totalMemory": 16263,
"updatedAt": "2021-01-18T13:33:43.834618Z",
"userActionsNeeded": [],
"uuid": "UUID"
}
Mensajes de salida
La acción Enrich Endpoints puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Enrich Endpoints". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Enrich Endpoints:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtén el estado del agente
Usa la acción Obtener estado del agente para recuperar información sobre el estado de los agentes en los extremos según la entidad proporcionada.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
Ninguno
Resultados de la acción
La acción Get Agent Status proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener estado del agente:
{
"status": "Not active"
}
Mensajes de salida
La acción Obtener estado del agente puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Agent Status". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener estado del agente:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener la lista de aplicaciones para el extremo
Usa la acción Obtener lista de aplicaciones para el extremo para recuperar información sobre las aplicaciones disponibles en un extremo con las entidades proporcionadas.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
La acción Obtener lista de aplicaciones para el extremo requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Max Applications To Return |
Es opcional. Es la cantidad máxima de aplicaciones que se devolverán. Si no estableces un número, la acción devolverá todas las aplicaciones disponibles. |
Resultados de la acción
La acción Get Application List for Endpoint proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener la lista de aplicaciones para el extremo:
{
"data": [
{
"installedDate": "2021-01-06T08:55:56.762000Z",
"name": "Mozilla Firefox 84.0.1 (x64 en-US)",
"publisher": "Mozilla",
"size": 211562,
"version": "84.0.1"
}
]
}
Mensajes de salida
La acción Obtener la lista de aplicaciones para el extremo puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Application List for Endpoint".
Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener la lista de aplicaciones para el extremo:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener lista de bloqueo
Usa la acción Obtener lista de entidades bloqueadas para obtener una lista de todos los elementos disponibles en la lista de entidades bloqueadas en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Obtener lista de bloqueo requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Hash |
Es opcional. Es una lista separada por comas de hashes que se deben verificar en la lista de entidades bloqueadas. La acción solo devuelve los hashes que se encontraron. Si
estableces |
Site IDs |
Es opcional. Es una lista separada por comas de IDs de sitios para devolver elementos de la lista de entidades bloqueadas. |
Group IDs |
Es opcional. Es una lista separada por comas de los IDs de grupo para devolver los elementos de la lista de entidades bloqueadas. |
Account Ids |
Es opcional. Es una lista separada por comas de los IDs de cuenta para los que se deben devolver los elementos de la lista de entidades bloqueadas. |
Limit |
Es opcional. Es la cantidad de elementos de la lista de entidades bloqueadas que se devolverán. Si
estableces el parámetro El valor máximo es El valor predeterminado es |
Query |
Es opcional. Es una consulta para filtrar los resultados. |
Use Global Blacklist |
Es opcional. Si se selecciona, la acción devuelve hashes de una lista de entidades bloqueadas global. No se selecciona de forma predeterminada. |
Resultados de la acción
La acción Obtener lista de bloqueo proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | Disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Tabla del muro de casos
La acción Get Blacklist puede devolver la siguiente tabla:
Nombre de la tabla: Blocklist Hashes
Columnas de la tabla:
- Hash
- Permiso
- Descripción
- SO
- Usuario
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener lista de bloqueo:
[
{
"userName": "Example",
"description": "test",
"userId": "USER_ID",
"scopeName": "Example.com",
"value": "cf23df2207d99a74fbe169e3eba035e633bxxxxx",
"source": "user",
"updatedAt": "2020-02-27T15:02:54.686991Z",
"osType": "windows",
"scope": {
"siteIds": ["SITE_ID"]
},
"type": "black_hash",
"id": "8353960925573xxxxx",
"createdAt": "2020-02-27T15:02:54.687675Z"
}, {
"description": "Detected by SentinelOne Cloud",
"userId": null,
"scopeName": "Example.com",
"value": "3395856ce81f2b7382dee72602f798b642fxxxxx",
"source": "cloud",
"updatedAt": "2020-03-18T14:42:02.730095Z",
"osType": "linux",
"scope": {
"siteIds": ["SITE_ID"]
},
"type": "black_hash",
"id": "ENTITY_ID",
"createdAt": "2020-03-18T14:42:02.730449Z"
}, {
"description": "Detected by SentinelOne Cloud",
"userId": null,
"scopeName": "Example.com",
"value": "df531d66173235167ac502b867f3cae2170xxxxx",
"source": "cloud",
"updatedAt": "2020-04-08T07:27:35.686775Z",
"osType": "linux",
"scope": {
"siteIds": ["SITE_ID"]
},
"type": "black_hash",
"id": "ENTITY_ID",
"createdAt": "2020-04-08T07:27:35.687168Z"
}
]
Mensajes de salida
La acción Get Blacklist puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Blacklist". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener lista de bloqueo:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtén el resultado de la consulta de Deep Visibility
Usa la acción Obtener el resultado de la consulta de Deep Visibility para recuperar información sobre los resultados de la consulta de Deep Visibility.
Ejecuta esta acción junto con la acción Iniciar consulta de Deep Visibility.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Get Deep Visibility Query Result requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Query ID |
Obligatorio. Es el ID de la consulta para la que se devolverán los resultados. El valor del ID
está disponible en el resultado JSON de la acción Iniciar consulta de Deep Visibility
como el parámetro |
Limit |
Es opcional. Es la cantidad de eventos que se devolverán. El valor máximo es El valor predeterminado es |
Resultados de la acción
La acción Get Deep Visibility Query Result proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | Disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Tabla del muro de casos
La acción Get Deep Visibility Query Result puede devolver la siguiente tabla:
Nombre de la tabla: SentinelOne Events
Columnas de la tabla:
- Tipo de evento
- Nombre del sitio
- Hora
- SO del agente
- ID de proceso
- UID del proceso
- Nombre del proceso
- MD5
- SHA256
Mensajes de salida
La acción Get Deep Visibility Query Result puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully found events for query: QUERY_ID. |
La acción se realizó correctamente. |
Error executing action "Get Deep Visibility Query Result". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener el resultado de la consulta de visibilidad profunda:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener eventos para el extremo de horas atrás
Usa la acción Obtener eventos de horas anteriores para el extremo para recuperar información sobre los eventos más recientes en un extremo.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
La acción Get Events for Endpoint Hours Back requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Hours Back |
Obligatorio. Es la cantidad de horas previas al momento actual para recuperar eventos. |
Events Amount Limit |
Es opcional. Es la cantidad máxima de eventos que se devolverán para cada tipo de evento. El valor predeterminado es |
Include File Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre los eventos de |
Include Indicator Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre los eventos de |
Include DNS Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre
los eventos de |
Include Network Actions Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre los eventos de |
Include URL Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre los eventos de |
Include Registry Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre
los eventos de |
Include Scheduled Task Events Information |
Es opcional. Si se selecciona, la acción consulta información sobre
los eventos de |
Resultados de la acción
La acción Obtener eventos de horas anteriores del extremo proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener eventos de un extremo de horas atrás:
{
"data": [
{
"activeContentFileId": null,
"activeContentHash": null,
"activeContentPath": null,
"activeContentSignedStatus": null,
"activeContentType": null,
"agentDomain": "",
"agentGroupId": "GROUP_ID",
"agentId": "ID",
"agentInfected": false,
"agentIp": "192.0.2.160",
"agentIsActive": true,
"agentIsDecommissioned": false,
"agentMachineType": "server",
"agentName": "ip-203-0-113-205",
"agentNetworkStatus": "connected",
"agentOs": "linux",
"agentTimestamp": "2020-03-19T08:17:01.575Z",
"agentUuid": "UUID",
"agentVersion": "3.3.1.14",
"attributes": [
{
"display": "Created At",
"display_attribute": false,
"field_id": "agentTimestamp",
"priority": 3,
"queryable": false,
"section": "Main Attributes",
"value": "2020-03-19T08:17:01.575Z"
},{
"display": "Site ID",
"display_attribute": false,
"field_id": "siteId",
"priority": 7,
"queryable": true,
"section": "Endpoint Info",
"value": null
}
],
"containerId": null,
"containerImage": null,
"containerLabels": null,
"containerName": null,
"createdAt": "2020-03-19T08:17:01.575000Z",
"eventType": "Process Creation",
"hasParent": true,
"id": "ID",
"k8sCluame": null,
"k8sControllerLabels": null,
"k8sControllerName": null,
"k8sControllerType": null,
"k8sNamespace": null,
"k8sNamespaceLabels": null,
"k8sNode": null,
"k8sPodLabels": null,
"k8sPodName": null,
"md5": null,
"objectType": "process",
"parentPid": "32461",
"parentProcessName": "dash",
"parentProcessStartTime": "2020-03-19T08:17:01.785Z",
"parentProcessUniqueKey": "KEY",
"pid": "32462",
"processCmd": " run-parts --report /etc/cron.hourly",
"processDisplayName": null,
"processGroupId": "GROUP_ID",
"processImagePath": "/bin/run-parts",
"processImageSha1Hash": "66df74a1f7cc3509c87d6a190ff90ac86caf440d",
"processIntegrityLevel": "INTEGRITY_LEVEL_UNKNOWN",
"processIsRedirectedCommandProcessor": "False",
"processIsWow64": "False",
"processName": "run-parts",
"processRoot": "False",
"processSessionId": "0",
"processStartTime": "2020-03-19T08:17:01.787Z",
"processSubSystem": "SUBSYSTEM_UNKNOWN",
"processUniqueKey": "KEY",
"publisher": null,
"relatedToThreat": "False",
"sha256": null,
"signatureSignedInvalidReason": null,
"signedStatus": "unsigned",
"siteName": "example.com",
"trueContext": "c98a4557-94b5-da31-5074-fe6360f17228",
"user": "unknown",
"verifiedStatus": null
}
],
"pagination": {
"nextCursor": "VALUE",
"totalItems": 632
}
}
Mensajes de salida
La acción Obtener eventos para horas de extremo anteriores puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Events for Endpoint Hours Back".
Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener eventos para el extremo de horas atrás:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtén detalles del grupo
Usa la acción Obtener detalles del grupo para recuperar información detallada sobre los grupos proporcionados.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Obtener detalles del grupo requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Group Names |
Obligatorio. Nombres de los grupos de los que se recuperarán los detalles. Este parámetro acepta varios valores como una lista separada por comas. |
Resultados de la acción
La acción Obtener detalles del grupo proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | Disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Tabla del muro de casos
La acción Get Group Details puede devolver la siguiente tabla:
Nombre de la tabla: SentinelOne Groups
Columnas de la tabla:
- ID
- Nombre
- Tipo
- Clasificación
- Creador
- Hora de creación
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado en JSON que se recibe cuando se usa la acción Obtener detalles del grupo:
[
{
"GROUP_NAME":"UNEDITABLE_VARIABLERESPONSE_DATA"
}
]
Mensajes de salida
La acción Obtener detalles del grupo puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Group Details". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener detalles del grupo:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener reputación de hash
(Obsoleto) Usa la acción Obtener reputación de hash para recuperar información sobre los hashes de SentinelOne.
Esta acción se ejecuta en la entidad Hash de Google SecOps.
Entradas de acción
La acción Get Hash Reputation requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Reputation Threshold |
Es opcional. Es un umbral de reputación para marcar la entidad como sospechosa. Si no estableces un valor, la acción no marcará ninguna entidad como sospechosa. El valor máximo es El valor predeterminado es |
Create Insight |
Es opcional. Si se selecciona, la acción crea una estadística que contiene información sobre la reputación. |
Only Suspicious Hashes Insight |
Es opcional. Si se selecciona, la acción solo crea una estadística para
los hashes con una reputación que supere o iguale el valor de |
Resultados de la acción
La acción Get Hash Reputation proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | Disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | No disponible |
| Resultado de secuencia de comandos | Disponible |
Tabla de enriquecimiento
La acción Obtener reputación de hash puede enriquecer los siguientes campos:
| Nombre del campo de enriquecimiento | Aplicabilidad |
|---|---|
SENO_reputation |
Se devuelve si existe en el resultado JSON. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener reputación de hash:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener la lista de procesos para el extremo (obsoleto)
Obtener agentes del sitio
Usa la acción Obtener agentes del sitio para recuperar información asociada con un sitio específico en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Get Site Agents requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Site Name |
Obligatorio. Es el ID de la alerta que se devolverá. |
Max Agents To Return |
Obligatorio. Es la cantidad máxima de agentes que se devolverán. El valor máximo es El valor predeterminado es |
Resultados de la acción
La acción Get Site Agents proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener agentes del sitio:
[
{
"accountId": "0000000000000000000",
"accountName": "Customer_Company_Name",
"activeDirectory": {
"computerDistinguishedName": null,
"computerMemberOf": [],
"lastUserDistinguishedName": null,
"lastUserMemberOf": [],
"userPrincipalName": null
},
"activeProtection": [
"edr"
],
"activeThreats": 27,
"agentVersion": "XX.X.X.X",
"allowRemoteShell": true,
"appsVulnerabilityStatus": "not_applicable",
"cloudProviders": {
"Google Cloud": {
"cloudAccount": "customer-edr-agents-yyyy",
"cloudImage": "debian-image-name-vYYYYMMDD",
"cloudInstanceId": "0000000000000000000",
"cloudInstanceSize": "e2-medium",
"cloudLocation": "us-region-x",
"cloudNetwork": "private-network-name",
"cloudTags": [
"corelight-ingress",
"Endpoint does not have sufficient permissions to fetch labels"
],
"gcpServiceAccount": "000000000000-compute@developer.gserviceaccount.com"
}
},
"computerName": "virtual-machine-name-1",
"consoleMigrationStatus": "N/A",
"containerizedWorkloadCounts": null,
"coreCount": 2,
"cpuCount": 1,
"cpuId": "Intel(R) Xeon(R) CPU @ X.XGHz",
"createdAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"detectionState": null,
"domain": "us-region-x.c.customer-edr-agents-yyyy.internal",
"encryptedApplications": false,
"externalId": "",
"externalIp": "000.000.000.000",
"firewallEnabled": false,
"firstFullModeTime": null,
"fullDiskScanLastUpdatedAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"groupId": "0000000000000000000",
"groupIp": "000.000.000.0",
"groupName": "Default Group",
"hasContainerizedWorkload": false,
"id": "0000000000000000000",
"inRemoteShellSession": false,
"infected": true,
"installerType": ".deb",
"isActive": true,
"isAdConnector": false,
"isDecommissioned": false,
"isHyperAutomate": null,
"isPendingUninstall": false,
"isUninstalled": false,
"isUpToDate": true,
"lastActiveDate": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"lastIpToMgmt": "000.000.000.000",
"lastLoggedInUserName": "",
"lastSuccessfulScanDate": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"licenseKey": "",
"locationEnabled": false,
"locationType": "not_supported",
"locations": null,
"machineSid": null,
"machineType": "server",
"missingPermissions": [],
"mitigationMode": "detect",
"mitigationModeSuspicious": "detect",
"modelName": "Google Google Compute Engine",
"networkInterfaces": [
{
"gatewayIp": "000.000.000.000",
"gatewayMacAddress": "XX:XX:XX:XX:XX:XX",
"id": "0000000000000000000",
"inet": [
"000.000.000.000"
],
"inet6": [
"fe80::0000:0000:0000:0"
],
"name": "ens4",
"physical": "XX:XX:XX:XX:XX:XX"
},
{
"gatewayIp": null,
"gatewayMacAddress": null,
"id": "0000000000000000000",
"inet": [
"172.17.0.1"
],
"inet6": [],
"name": "docker0",
"physical": "XX:XX:XX:XX:XX:XX"
}
],
"networkQuarantineEnabled": false,
"networkStatus": "connected",
"operationalState": "na",
"operationalStateExpiration": null,
"osArch": "64 bit",
"osName": "Linux",
"osRevision": "Debian GNU/11 (bullseye) X.X.X.X-cloud-amd64",
"osStartTime": "YYYY-MM-DDTHH:MM:SSZ",
"osType": "linux",
"osUsername": "user",
"proxyStates": null,
"rangerStatus": "Disabled",
"rangerVersion": null,
"registeredAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"remoteProfilingState": "disabled",
"remoteProfilingStateExpiration": null,
"scanAbortedAt": null,
"scanFinishedAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"scanStartedAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"scanStatus": "finished",
"serialNumber": null,
"showAlertIcon": false,
"siteId": "0000000000000000000",
"siteName": "SITE_NAME",
"storageName": null,
"storageType": null,
"tags": {
"sentinelone": [
{
"assignedAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"assignedBy": "anon.user@google.com",
"assignedById": "0000000000000000000",
"id": "0000000000000000000",
"key": "MD_Containment_Allowlist",
"value": "No Value"
}
]
},
"threatRebootRequired": false,
"totalMemory": 3930,
"updatedAt": "YYYY-MM-DDTHH:MM:SS.SSSSSSZ",
"userActionsNeeded": [],
"uuid": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
}
]
Mensajes de salida
La acción Obtener agentes del sitio puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Site Agents". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener agentes del sitio:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtén el estado del sistema
Usa la acción Obtener estado del sistema para recuperar el estado de un sistema.
Esta acción se ejecuta en todas las entidades de Google SecOps.
Entradas de acción
Ninguno
Resultados de la acción
La acción Obtener estado del sistema proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | No disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener estado del sistema:
{
"system_status": {
"data": {
"health": "ok"
}},
"db_status": {
"data": {
"health": "ok"
}},
"cache_status": {
"data": {
"health": "ok"
}
}
}
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener estado del sistema:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener la versión del sistema
Usa la acción Obtener versión del sistema para recuperar la versión de un sistema.
Esta acción se ejecuta en todas las entidades de Google SecOps.
Entradas de acción
Ninguno
Resultados de la acción
La acción Get System Version proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | No disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener versión del sistema:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Obtener amenazas
Usa la acción Obtener amenazas para recuperar información sobre las amenazas en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Obtener amenazas requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Mitigation Status |
Es opcional. Es una lista separada por comas de los estados de las amenazas. La acción solo devuelve las amenazas que coinciden con los estados configurados. Los valores posibles son los siguientes:
|
Created until |
Es opcional. Es la hora de finalización de las amenazas, como
|
Created from |
Es opcional. Es la hora de inicio de las amenazas, como
|
Resolved Threats |
Es opcional. Si se selecciona, la acción solo devuelve las amenazas resueltas. |
Threat Display Name |
Es opcional. Es un nombre visible de la amenaza que se mostrará. |
Limit |
Es opcional. Es la cantidad de amenazas que se devolverán. El valor predeterminado es |
API Version |
Es opcional. La versión de la API que se usará para la acción. La versión de la API afecta la estructura de los resultados en JSON. Te recomendamos que uses la versión más reciente de la API compatible con tu entorno. El valor predeterminado es |
Resultados de la acción
La acción Obtener amenazas proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener amenazas:
{
"accountId": "ACCOUNT_ID",
"accountName": "ACCOUNT_NAME",
"agentComputerName": "desktop-example",
"agentDomain": "WORKGROUP",
"agentId": "AGENT_ID",
"agentInfected": false,
"agentIp": "192.0.2.176",
"agentIsActive": false,
"agentIsDecommissioned": false,
"agentMachineType": "desktop",
"agentNetworkStatus": "connected",
"agentOsType": "windows",
"agentVersion": "3.6.6.104",
"annotation": null,
"automaticallyResolved": false,
"browserType": null,
"certId": "",
"classification": "generic.heuristic",
"classificationSource": "Cloud",
"classifierName": "MANUAL",
"cloudVerdict": "provider_unknown",
"collectionId": "838490132723152335",
"commandId": "835975626369402963",
"createdAt": "2020-03-02T21:30:13.014874Z",
"createdDate": "2020-03-02T21:30:12.748000Z",
"description": "malware detected - not mitigated yet",
"engines": [
"manual"
],
"external_ticket_id": null,
"fileContentHash": "fc5a9b5e806f35a7b285e012ef8df3f06f399492",
"fileCreatedDate": null,
"fileDisplayName": "example.exe",
"fileExtensionType": "Executable",
"fileIsDotNet": null,
"fileIsExecutable": true,
"fileIsSystem": false,
"fileMaliciousContent": null,
"fileObjectId": "99FF941D82E382D1",
"filePath": "\\Device\\HarddiskVolume3\\Program Files\\example.exe",
"fileSha256": null,
"fileVerificationType": "NotSigned",
"fromCloud": false,
"fromScan": false,
"id": "THREAT_ID",
"indicators": [],
"initiatedBy": "dvCommand",
"initiatedByDescription": "Deep Visibility Command",
"initiatingUserId": "INITIATING_USER_ID",
"isCertValid": false,
"isInteractiveSession": false,
"isPartialStory": false,
"maliciousGroupId": "0BB46E119EF0AE51",
"maliciousProcessArguments": "-ServerName:App.Example.mca",
"markedAsBenign": true,
"mitigationMode": "protect",
"mitigationReport": {
"kill": {
"status": "success"
},
"network_quarantine": {
"status": null
},
"quarantine": {
"status": "success"
},
"remediate": {
"status": null
},
"rollback": {
"status": null
},
"unquarantine": {
"status": "sent"
}
},
"mitigationStatus": "mitigated",
"publisher": "",
"rank": 2,
"resolved": true,
"siteId": "SITE_ID",
"siteName": "Example.com",
"threatAgentVersion": "3.6.6.104",
"threatName": "example.exe",
"updatedAt": "2020-07-07T17:19:48.260119Z",
"username": "DESKTOP-example\\ddiserens",
"whiteningOptions": []
}
Mensajes de salida
La acción Obtener amenazas puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Get Threats". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener amenazas:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Inicia una consulta de Deep Visibility
Usa la acción Iniciar consulta de Deep Visibility para iniciar una búsqueda de consulta de Deep Visibility.
Esta acción devuelve el valor del ID de consulta que requiere la acción Get Deep Visibility Query Result.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Iniciar consulta de Deep Visibility requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Query |
Obligatorio. Es una consulta para la búsqueda. Para obtener más información sobre la sintaxis de la consulta, consulta la hoja de referencia de SentinelOne Deep Visibility. |
Start Date |
Es opcional. Es la fecha de inicio de la búsqueda. Si no estableces un valor, la acción recupera los eventos de los 30 días anteriores de forma predeterminada. |
End Date |
Es opcional. Una fecha de finalización para la búsqueda Si no estableces un valor, la acción usa la hora actual. |
Resultados de la acción
La acción Iniciar consulta de visibilidad profunda proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Iniciar consulta de visibilidad profunda:
[
{
"query_id": "QUERY_ID"
}
]
Mensajes de salida
La acción Iniciar consulta de Deep Visibility puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Initiate Deep Visibility Query". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Iniciar consulta de Deep Visibility:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Iniciar análisis completo
Usa la acción Iniciar análisis completo para iniciar un análisis completo del disco en un extremo en SentinelOne.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
Ninguno
Resultados de la acción
La acción Iniciar análisis completo proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Iniciar análisis completo puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Initiate Full Scan". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Iniciar análisis completo:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Enumera sitios
Usa la acción List Sites para enumerar los sitios disponibles en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción List Sites requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Filter Key |
Es opcional. Es la clave para filtrar sitios. Los valores posibles son los siguientes:
El valor predeterminado es |
Filter Logic |
Es opcional. Es la lógica de filtro que se aplicará. La lógica de filtro
usa el valor establecido en el parámetro Los valores posibles son los siguientes:
El valor predeterminado es |
Filter Value |
Es opcional. Es el valor que se usará en el filtro. La lógica de filtro
usa el valor establecido en el parámetro Si
seleccionas Si seleccionas
Si no estableces un valor, la acción ignorará el filtro. |
Max Records To Return |
Es opcional. Es la cantidad de registros que se devolverán. El valor predeterminado es |
Resultados de la acción
La acción List Sites proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | Disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Tabla del muro de casos
La acción List Sites puede devolver la siguiente tabla:
Nombre de la tabla: Available Sites
Columnas de la tabla:
- Nombre
- ID
- Creador
- Vencimiento
- Tipo
- Estado
Mensajes de salida
La acción List Sites puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "List Sites". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción List Sites:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Marcar como amenaza
Usa la acción Marcar como amenaza para marcar las amenazas sospechosas como amenazas de verdadero positivo en SentinelOne.
Para marcar amenazas en SentinelOne, necesitas cualquiera de los siguientes roles:
AdminIR TeamSOC
Solo puedes marcar como amenazas las detecciones sospechosas.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Marcar como amenaza requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Threat IDs |
Obligatorio. Es una lista separada por comas de los IDs de detección que se deben marcar como amenazas. |
Resultados de la acción
La acción Marcar como amenaza proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Marcar como amenaza:
[
{
"ID": "DETECTION_ID",
"marked_as_threat": "true"
}
]
Mensajes de salida
La acción Marcar como amenaza puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Mark as Threat". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Marcar como amenaza:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Mitigar la amenaza
Usa la acción Mitigar amenaza para ejecutar acciones de mitigación en las amenazas en SentinelOne.
Para mitigar las amenazas en SentinelOne, necesitas cualquiera de los siguientes roles:
AdminIR TeamSOC
La reversión solo se aplica a Windows. La solución de amenazas solo se aplica a macOS y Windows.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Mitigar amenaza requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Mitigation action |
Obligatorio. Una acción de mitigación para las amenazas detectadas. Los valores posibles son los siguientes:
El valor predeterminado es |
Threat IDs |
Obligatorio. Es una lista separada por comas de los IDs de amenazas que se deben mitigar. |
Resultados de la acción
La acción Mitigar amenaza proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Mitigar amenaza:
[
{
"mitigated": true,
"mitigation_action": "quarantine",
"Threat_ID": "THREAT_ID"
}
]
Mensajes de salida
La acción Mitigar amenaza puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Mitigate Threat". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Mitigar amenaza:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Mueve agentes
Usa la acción Mover agentes para mover agentes al grupo proporcionado desde el mismo sitio.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
La acción Mover agentes requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Group ID |
Es opcional. Es el ID del grupo al que se moverán los agentes. |
Group Name |
Es opcional. Es el nombre del grupo al que se moverán los agentes. Si configuras
los parámetros |
Resultados de la acción
La acción Mover agentes proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Mover agentes puede devolver los siguientes mensajes de resultado:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Move Agents". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Mover agentes:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Ping
Usa la acción Ping para probar la conectividad.
Esta acción se ejecuta en todas las entidades de Google SecOps.
Entradas de acción
Ninguno
Resultados de la acción
La acción Ping proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | No disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Vuelve a conectar el agente a la red
Usa la acción Volver a conectar el agente a la red para volver a conectar un extremo desconectado a una red.
Esta acción se ejecuta en las siguientes entidades de Google SecOps:
IP AddressHostname
Entradas de acción
Ninguno
Resultados de la acción
La acción Vuelve a conectar el agente a la red proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | No disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Vuelve a conectar el agente a la red:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Resolver amenaza
Usa la acción Resolver amenaza para resolver amenazas en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Resolver amenaza requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Threat IDs |
Obligatorio. Es una lista separada por comas de los IDs de amenazas que se deben resolver. |
Annotation |
Es opcional. Una justificación para resolver la amenaza. |
Resultados de la acción
La acción Resolve Threat proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Resolver amenaza:
[
{
"resolved": false,
"Threat_ID": "THREAT_ID"
}
]
Mensajes de salida
La acción Resolver amenaza puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Resolve Threat". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Resolver amenaza:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Actualizar alerta
Usa la acción Actualizar alerta para actualizar la alerta de la amenaza en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Actualizar alerta requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Alert ID |
Obligatorio. Es el ID de la alerta que se actualizará. |
Status |
Es opcional. Es el estado de la alerta. Los valores posibles son los siguientes:
|
Verdict |
Es opcional. Es el veredicto de la alerta. Los valores posibles son los siguientes:
|
Resultados de la acción
La acción Actualizar alerta proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Actualizar alerta:
{
"agentDetectionInfo": {
"accountId": "1727154225040260868",
"machineType": "server",
"name": "windows-server-20230913",
"osFamily": "windows",
"osName": "Windows Server 2019 Datacenter",
"osRevision": "17763",
"siteId": "1727154229628829519",
"uuid": "da943d26318e46a8b3f6fc480c02636d",
"version": "23.1.2.400"
},
"agentRealtimeInfo": {
"id": "1896661984701699721",
"infected": true,
"isActive": true,
"isDecommissioned": false,
"machineType": "server",
"name": "windows-server-20230913",
"os": "windows",
"uuid": "da943d26318e46a8b3f6fc480c02636d"
},
"alertInfo": {
"alertId": "1947486263439640318",
"analystVerdict": "Undefined",
"createdAt": "2024-05-11T00:27:23.135000Z",
"dnsRequest": null,
"dnsResponse": null,
"dstIp": null,
"dstPort": null,
"dvEventId": "01HXJGR13VFVQAHW6TPDZ78WSX_35",
"eventType": "REGVALUEMODIFIED",
"hitType": "Events",
"incidentStatus": "Unresolved",
"indicatorCategory": null,
"indicatorDescription": null,
"indicatorName": null,
"isEdr": true,
"loginAccountDomain": null,
"loginAccountSid": null,
"loginIsAdministratorEquivalent": null,
"loginIsSuccessful": null,
"loginType": null,
"loginsUserName": null,
"modulePath": null,
"moduleSha1": null,
"netEventDirection": null,
"registryKeyPath": "MACHINE\\SYSTEM\\ControlSet001\\Services\\CSAgent\\Sim\\NT",
"registryOldValue": "0060030100000000",
"registryOldValueType": "BINARY",
"registryPath": "MACHINE\\SYSTEM\\ControlSet001\\Services\\CSAgent\\Sim\\NT",
"registryValue": "0070030100000000",
"reportedAt": "2024-05-11T00:27:33.873767Z",
"source": "STAR",
"srcIp": null,
"srcMachineIp": null,
"srcPort": null,
"tiIndicatorComparisonMethod": null,
"tiIndicatorSource": null,
"tiIndicatorType": null,
"tiIndicatorValue": null,
"updatedAt": "2025-05-12T18:41:08.366615Z"
},
"containerInfo": {
"id": null,
"image": null,
"labels": null,
"name": null
},
"kubernetesInfo": {
"cluster": null,
"controllerKind": null,
"controllerLabels": null,
"controllerName": null,
"namespace": null,
"namespaceLabels": null,
"node": null,
"pod": null,
"podLabels": null
},
"ruleInfo": {
"description": null,
"id": "1763599692710649014",
"name": "Registry Value Modified",
"queryLang": "1.0",
"queryType": "events",
"s1ql": "EventType = \"Registry Value Modified\"",
"scopeLevel": "account",
"severity": "Critical",
"treatAsThreat": "UNDEFINED"
},
"sourceParentProcessInfo": {
"commandline": "C:\\Windows\\system32\\services.exe",
"effectiveUser": null,
"fileHashMd5": "0d464c4bf9d85412d6ef15eea3a91e72",
"fileHashSha1": "582a7cbf0bf13889080900cd7bea368bf77f8faf",
"fileHashSha256": "243e370c279b3b8062e5dd81d8df539705397cc68472168251ed54134b13d70b",
"filePath": "C:\\Windows\\System32\\services.exe",
"fileSignerIdentity": "MICROSOFT WINDOWS PUBLISHER",
"integrityLevel": "system",
"loginUser": null,
"name": "services.exe",
"pid": "896",
"pidStarttime": "2024-04-26T17:33:41.962000Z",
"realUser": null,
"storyline": "DD880F57CA4DC0BB",
"subsystem": "sys_win32",
"uniqueId": "DC880F57CA4DC0BB",
"user": "NT AUTHORITY\\SYSTEM"
},
"sourceProcessInfo": {
"commandline": "\"C:\\Program Files\\Palo Alto Networks\\Traps\\cyserver.exe\"",
"effectiveUser": null,
"fileHashMd5": "1d6ec27dc8bbf1509a4ebf81b9ea6c26",
"fileHashSha1": "dca4478ce7db9f98b930b12096205be8a587620e",
"fileHashSha256": "c043dfeafb79b60018f3098f5908eb57b2fe84dbdfde0c83e613b4b42d7255c6",
"filePath": "C:\\Program Files\\Palo Alto Networks\\Traps\\cyserver.exe",
"fileSignerIdentity": "PALO ALTO NETWORKS (NETHERLANDS) B.V.",
"integrityLevel": "system",
"loginUser": null,
"name": "cyserver.exe",
"pid": "3204",
"pidStarttime": "2024-04-26T17:34:17.273000Z",
"realUser": null,
"storyline": "74890F57CA4DC0BB",
"subsystem": "sys_win32",
"uniqueId": "73890F57CA4DC0BB",
"user": "NT AUTHORITY\\SYSTEM"
},
"targetProcessInfo": {
"tgtFileCreatedAt": "1970-01-01T00:00:00Z",
"tgtFileHashSha1": null,
"tgtFileHashSha256": null,
"tgtFileId": null,
"tgtFileIsSigned": "signed",
"tgtFileModifiedAt": "1970-01-01T00:00:00Z",
"tgtFileOldPath": null,
"tgtFilePath": null,
"tgtProcCmdLine": null,
"tgtProcImagePath": null,
"tgtProcIntegrityLevel": "unknown",
"tgtProcName": null,
"tgtProcPid": null,
"tgtProcSignedStatus": null,
"tgtProcStorylineId": null,
"tgtProcUid": null,
"tgtProcessStartTime": "1970-01-01T00:00:00Z"
}
}
Mensajes de salida
La acción Actualizar alerta puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully updated alert with ID
ALERT_ID in SentinelOne. |
La acción se realizó correctamente. |
Error executing action "Update Alert". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Actualizar alerta:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Actualiza el veredicto del analista
Usa la acción Actualizar veredicto del analista para actualizar el veredicto del analista de la amenaza en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Actualizar veredicto del analista requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Threat ID |
Obligatorio. Es una lista separada por comas de los IDs de amenazas para actualizar el veredicto del analista. |
Analyst Verdict |
Obligatorio. Es un veredicto del analista. Los valores posibles son los siguientes:
El valor predeterminado es |
Resultados de la acción
La acción Update Analyst Verdict proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Actualizar veredicto del analista puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Update Analyst Verdict". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Actualizar veredicto del analista:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Actualizar regla de control de dispositivos
Usa la acción Actualizar regla de control de dispositivos para actualizar una regla de control de dispositivos en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Actualizar regla de control de dispositivos requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Rule ID |
Obligatorio. Es el ID de la regla que se actualizará. |
Rule JSON |
Obligatorio. Es el objeto JSON que representa la configuración de la regla de control de dispositivos. El valor predeterminado es el siguiente: { "ruleName": "String", "interface": "String", "ruleType": "String", "action": "String", "accessPermission": "String", "deviceClass": "String", "status": "String" } |
Resultados de la acción
La acción Actualizar regla de control de dispositivos proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Actualizar regla de control de dispositivos:
{
"data": {
"accessPermission": "Read-Write",
"action": "Allow",
"bluetoothAddress": null,
"createdAt": "2024-01-01T00:00:00.000000Z",
"creator": "[USERNAME] ([EMAIL_ADDRESS])",
"creatorId": "[CREATOR_ID]",
"deviceClass": "FFh",
"deviceClassName": "FF Vendor Specific",
"deviceId": null,
"deviceInformationServiceInfoKey": null,
"deviceInformationServiceInfoValue": null,
"deviceName": null,
"editable": true,
"gattService": null,
"id": "[RULE_ID]",
"interface": "USB",
"manufacturerName": null,
"minorClasses": null,
"order": 1,
"productId": null,
"ruleName": "Test",
"ruleType": "class",
"scope": "account",
"scopeId": "[SCOPE_ID]",
"scopeName": "[SCOPE_NAME]",
"status": "Disabled",
"uid": null,
"updatedAt": "2024-01-01T00:00:00.000000Z",
"vendorId": null,
"version": null
}
}
Mensajes de salida
La acción Actualizar regla de control de dispositivos puede devolver los siguientes mensajes de resultado:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Update Device Control Rule". Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Actualizar regla de control de dispositivos:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Actualiza el estado del incidente
Usa la acción Actualizar el estado del incidente para actualizar el estado del incidente de amenaza en SentinelOne.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Actualizar estado del incidente requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Threat ID |
Obligatorio. Es una lista separada por comas de los IDs de amenazas para actualizar el estado del incidente. |
Status |
Obligatorio. Es el estado de un incidente. Los valores posibles son los siguientes:
El valor predeterminado es |
Resultados de la acción
La acción Actualizar estado del incidente proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Actualizar estado del incidente puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Update Incident Status". Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Actualizar estado del incidente:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
True o False |
Conectores
Para obtener más información sobre cómo configurar conectores en Google SecOps, consulta Transferir tus datos (conectores).
SentinelOne: Conector de alertas
Usa el conector de SentinelOne - Alerts para transferir alertas de SentinelOne.
El conector te permite filtrar alertas con una lista dinámica basada en el
parámetro ruleInfo.name. El comportamiento de esta lista depende del parámetro Use dynamic list as a blocklist.
Si no seleccionas
Use dynamic list as a blocklist, haz lo siguiente:La lista dinámica funciona como una lista de entidades permitidas. El conector solo transfiere las alertas cuyo
ruleInfo.namecoincide con un valor de la lista. Si la lista está vacía, no se transfieren alertas.Si seleccionas
Use dynamic list as a blocklist, ocurrirá lo siguiente:La lista dinámica funciona como una lista de entidades bloqueadas. El conector transfiere todas las alertas, excepto aquellas cuyo
ruleInfo.namecoincida con un valor de la lista. Si la lista está vacía, se transfieren todas las alertas.
Parámetros del conector
El conector de SentinelOne - Alerts requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Product Field Name |
Obligatorio. Es el nombre del campo en el que se almacena el nombre del producto. El nombre del producto afecta principalmente la asignación. Para optimizar y mejorar el proceso de asignación del conector, el valor predeterminado se resuelve en un valor de resguardo al que se hace referencia desde el código. Cualquier entrada no válida para este parámetro se resuelve en un valor de resguardo de forma predeterminada. El valor predeterminado es |
Event Field Name |
Obligatorio. Es el nombre del campo que determina el nombre del evento (subtipo). El valor predeterminado es |
Environment Field Name |
Es opcional. Es el nombre del campo en el que se almacena el nombre del entorno. Si falta el campo environment, el conector usa el valor predeterminado. El valor predeterminado es |
Environment Regex Pattern |
Es opcional. Es un patrón de expresión regular que se ejecuta en el valor que se encuentra en el campo Usa el valor predeterminado Si el patrón de expresión regular es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno es el entorno predeterminado. El valor predeterminado es |
PythonProcessTimeout |
Obligatorio. Es el límite de tiempo de espera, en segundos, para el proceso de Python que ejecuta la secuencia de comandos actual. El valor predeterminado es |
API Root |
Obligatorio. La raíz de la API de la instancia de SentinelOne. |
API Token |
Obligatorio. Es el token de la API de SentinelOne. |
Status Filter |
Es opcional. Es una lista separada por comas de los estados de las alertas que se transferirán. Los valores posibles son los siguientes:
Si no se proporciona ningún valor, el conector recupera las alertas con los estados
|
Case Name Template |
Es opcional. Es una plantilla para definir un nombre de caso personalizado. El conector agrega una
clave Puedes usar marcadores de posición en el formato FIELD_NAME, que se completan a partir de los valores de cadena del primer evento. Ejemplo: |
Alert Name Template |
Es opcional. Es una plantilla para definir el nombre de la alerta. Puedes usar marcadores de posición en el formato FIELD_NAME, que se completan a partir de los valores de cadena del primer evento. Ejemplo: Si no se proporciona un valor o la plantilla no es válida, el conector usa un nombre de alerta predeterminado. |
Lowest Severity To Fetch |
Es opcional. Es la gravedad más baja de las alertas que se recuperarán. Si no configuras este parámetro, el conector transferirá alertas con todos los niveles de gravedad. Los valores posibles son los siguientes:
Si no se proporciona ningún valor, se transfieren todos los niveles de gravedad. |
Max Hours Backwards |
Obligatorio. Es la cantidad de horas antes de la hora actual para recuperar alertas. El valor predeterminado es |
Max Alerts To Fetch |
Obligatorio. Es la cantidad máxima de alertas que se procesarán en cada iteración del conector. El valor máximo es El valor predeterminado es |
Use dynamic list as a blocklist |
Obligatorio. Si se selecciona, el conector usa la lista dinámica como una lista de entidades bloqueadas. No está habilitada de forma predeterminada. |
Disable Overflow |
Es opcional. Si se selecciona, el conector ignora el mecanismo de desbordamiento de Google SecOps. No está habilitada de forma predeterminada. |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de SentinelOne. Habilitada de forma predeterminada. |
Proxy Server Address |
Es opcional. Es la dirección del servidor proxy que se usará. |
Proxy Username |
Es opcional. Es el nombre de usuario del proxy con el que se autenticará. |
Proxy Password |
Es opcional. Es la contraseña del proxy con la que se realizará la autenticación. |
Reglas del conector
El conector admite proxies.
Estructura de las alertas
En la siguiente tabla, se describe la asignación de los campos de alerta de SentinelOne a los campos de alerta de Google SecOps:
| Campo de alerta de Siemplify | Campo de alerta de SentinelOne (clave JSON de la API) |
|---|---|
SourceSystemName |
Lo completa el framework. |
TicketId |
alertInfo.alertId |
DisplayId |
SentinelOne_Alert_{alertInfo.alertId} |
Name |
SentinelOne Alert: {ruleInfo.name} |
Reason |
ruleInfo.s1q1 |
Description |
ruleInfo.description |
DeviceVendor |
Codificado: SentinelOne |
DeviceProduct |
Valor de resguardo: Alerts |
Priority |
Asignado desde ruleInfo.severity |
RuleGenerator |
SentinelOne Alert: {ruleInfo.name} |
SourceGroupingIdentifier |
ruleInfo.name |
Severity |
Asignado desde ruleInfo.severity |
Risk Score |
Representación de la gravedad con números enteros |
StartTime |
Se convirtió de alertInfo.createdAt |
EndTime |
Se convirtió de alertInfo.createdAt |
Siemplify Alert - Extensions |
N/A |
Siemplify Alert - Attachments |
N/A |
Eventos del conector
A continuación, se muestra un ejemplo de un evento de conector:
{
"agentDetectionInfo": {
"accountId": "1727154225040260868",
"machineType": "server",
"name": "windows-server-20230913",
"osFamily": "windows",
"osName": "Windows Server 2019 Datacenter",
"osRevision": "17763",
"siteId": "1727154229628829519",
"uuid": "da943d26318e46a8b3f6fc480c02636d",
"version": "23.1.2.400"
},
"agentRealtimeInfo": {
"id": "1896661984701699721",
"infected": true,
"isActive": true,
"isDecommissioned": false,
"machineType": "server",
"name": "windows-server-20230913",
"os": "windows",
"uuid": "da943d26318e46a8b3f6fc480c02636d"
},
"alertInfo": {
"alertId": "1947486263439640318",
"analystVerdict": "Undefined",
"createdAt": "2024-05-11T00:27:23.135000Z",
"dnsRequest": null,
"dnsResponse": null,
"dstIp": null,
"dstPort": null,
"dvEventId": "01HXJGR13VFVQAHW6TPDZ78WSX_35",
"eventType": "REGVALUEMODIFIED",
"hitType": "Events",
"incidentStatus": "Unresolved",
"indicatorCategory": null,
"indicatorDescription": null,
"indicatorName": null,
"isEdr": true,
"loginAccountDomain": null,
"loginAccountSid": null,
"loginIsAdministratorEquivalent": null,
"loginIsSuccessful": null,
"loginType": null,
"loginsUserName": null,
"modulePath": null,
"moduleSha1": null,
"netEventDirection": null,
"registryKeyPath": "MACHINE\\SYSTEM\\ControlSet001\\Services\\CSAgent\\Sim\\NT",
"registryOldValue": "0060030100000000",
"registryOldValueType": "BINARY",
"registryPath": "MACHINE\\SYSTEM\\ControlSet001\\Services\\CSAgent\\Sim\\NT",
"registryValue": "0070030100000000",
"reportedAt": "2024-05-11T00:27:33.873767Z",
"source": "STAR",
"srcIp": null,
"srcMachineIp": null,
"srcPort": null,
"tiIndicatorComparisonMethod": null,
"tiIndicatorSource": null,
"tiIndicatorType": null,
"tiIndicatorValue": null,
"updatedAt": "2025-05-12T18:41:08.366615Z"
},
"containerInfo": {
"id": null,
"image": null,
"labels": null,
"name": null
},
"kubernetesInfo": {
"cluster": null,
"controllerKind": null,
"controllerLabels": null,
"controllerName": null,
"namespace": null,
"namespaceLabels": null,
"node": null,
"pod": null,
"podLabels": null
},
"ruleInfo": {
"description": null,
"id": "1763599692710649014",
"name": "Registry Value Modified",
"queryLang": "1.0",
"queryType": "events",
"s1ql": "EventType = \"Registry Value Modified\"",
"scopeLevel": "account",
"severity": "Critical",
"treatAsThreat": "UNDEFINED"
},
"sourceParentProcessInfo": {
"commandline": "C:\\Windows\\system32\\services.exe",
"effectiveUser": null,
"fileHashMd5": "0d464c4bf9d85412d6ef15eea3a91e72",
"fileHashSha1": "582a7cbf0bf13889080900cd7bea368bf77f8faf",
"fileHashSha256": "243e370c279b3b8062e5dd81d8df539705397cc68472168251ed54134b13d70b",
"filePath": "C:\\Windows\\System32\\services.exe",
"fileSignerIdentity": "MICROSOFT WINDOWS PUBLISHER",
"integrityLevel": "system",
"loginUser": null,
"name": "services.exe",
"pid": "896",
"pidStarttime": "2024-04-26T17:33:41.962000Z",
"realUser": null,
"storyline": "DD880F57CA4DC0BB",
"subsystem": "sys_win32",
"uniqueId": "DC880F57CA4DC0BB",
"user": "NT AUTHORITY\\SYSTEM"
},
"sourceProcessInfo": {
"commandline": "\"C:\\Program Files\\Palo Alto Networks\\Traps\\cyserver.exe\"",
"effectiveUser": null,
"fileHashMd5": "1d6ec27dc8bbf1509a4ebf81b9ea6c26",
"fileHashSha1": "dca4478ce7db9f98b930b12096205be8a587620e",
"fileHashSha256": "c043dfeafb79b60018f3098f5908eb57b2fe84dbdfde0c83e613b4b42d7255c6",
"filePath": "C:\\Program Files\\Palo Alto Networks\\Traps\\cyserver.exe",
"fileSignerIdentity": "PALO ALTO NETWORKS (NETHERLANDS) B.V.",
"integrityLevel": "system",
"loginUser": null,
"name": "cyserver.exe",
"pid": "3204",
"pidStarttime": "2024-04-26T17:34:17.273000Z",
"realUser": null,
"storyline": "74890F57CA4DC0BB",
"subsystem": "sys_win32",
"uniqueId": "73890F57CA4DC0BB",
"user": "NT AUTHORITY\\SYSTEM"
},
"targetProcessInfo": {
"tgtFileCreatedAt": "1970-01-01T00:00:00Z",
"tgtFileHashSha1": null,
"tgtFileHashSha256": null,
"tgtFileId": null,
"tgtFileIsSigned": "signed",
"tgtFileModifiedAt": "1970-01-01T00:00:00Z",
"tgtFileOldPath": null,
"tgtFilePath": null,
"tgtProcCmdLine": null,
"tgtProcImagePath": null,
"tgtProcIntegrityLevel": "unknown",
"tgtProcName": null,
"tgtProcPid": null,
"tgtProcSignedStatus": null,
"tgtProcStorylineId": null,
"tgtProcUid": null,
"tgtProcessStartTime": "1970-01-01T00:00:00Z"
}
}
SentinelOne: Conector de amenazas
Usa el conector de SentinelOne - Threats para transferir amenazas de SentinelOne.
El conector te permite filtrar alertas según listas dinámicas.
El conector de SentinelOne - Threats filtra las alertas con el parámetro alert_name.
Si seleccionas el parámetro Use whitelist as a blacklist, el conector
solo transferirá las alertas cuyo alert_name no coincida con ningún valor de la lista
dinámica.
Si no configuras los valores de alert_name en la lista dinámica, el conector
transferirá todas las alertas.
Si no seleccionas el parámetro Use whitelist as a blacklist, el conector
solo transferirá las alertas cuyo alert_name coincida con un valor de la lista dinámica.
Entradas del conector
El conector de SentinelOne - Threats requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Product Field Name |
Obligatorio. Es el nombre del campo en el que se almacena el nombre del producto. El
nombre del producto afecta principalmente la asignación. Para optimizar y mejorar el
proceso de asignación del conector, el valor predeterminado
El valor predeterminado es |
Event Field Name |
Obligatorio. Es el nombre del campo que determina el nombre del evento (subtipo). El valor predeterminado es |
Environment Field Name |
Es opcional. Es el nombre del campo en el que se almacena el nombre del entorno. Si falta el campo environment, el conector usa el valor predeterminado. El valor predeterminado es |
Environment Regex Pattern |
Es opcional. Es un patrón de expresión regular que se ejecuta en el valor que se encuentra en el campo Usa el valor predeterminado Si el patrón de expresión regular es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno es el entorno predeterminado. |
Script Timeout |
Obligatorio. Es el límite de tiempo de espera, en segundos, para el proceso de Python que ejecuta la secuencia de comandos actual. El valor predeterminado es |
API Root |
Obligatorio. Es la raíz de la API de SentinelOne. El valor predeterminado es |
API Token |
Obligatorio. Es el token de la API de SentinelOne. |
API Version |
Es opcional. La versión de la API de SentinelOne que usará el conector. El valor predeterminado es |
Fetch Max Days Backwards |
Es opcional. Es la cantidad de días anteriores al momento actual para recuperar las alertas. Este parámetro se puede aplicar a la iteración inicial del conector después de que lo habilites por primera vez o al valor de resguardo de una marca de tiempo de conector vencida. El valor predeterminado es |
Max Alerts Per Cycle |
Es opcional. Es la cantidad máxima de alertas que se procesarán en cada iteración del conector. El valor predeterminado es |
Disable Overflow |
Es opcional. Si se selecciona, el conector ignora el mecanismo de desbordamiento de Google SecOps. No se selecciona de forma predeterminada. |
Use whitelist as a blacklist |
Obligatorio. Si se selecciona, el conector usa la lista dinámica como una lista de entidades bloqueadas. No se selecciona de forma predeterminada. |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de SentinelOne. Se selecciona de forma predeterminada. |
Proxy Server Address |
Es opcional. Es la dirección del servidor proxy que se usará. |
Proxy Username |
Es opcional. Es el nombre de usuario del proxy con el que se autenticará. |
Proxy Password |
Es opcional. Es la contraseña del proxy con la que se realizará la autenticación. |
Event Object Type Filter |
Es opcional. Es una lista separada por comas de los objetos de evento que se devolverán con la información de la amenaza. El conector usa este parámetro como un
filtro para mostrar solo ciertos objetos, como Si no estableces un valor, el conector transferirá todos los tipos de objetos de evento. |
Event Type Filter |
Es opcional. Es una lista separada por comas de los tipos de eventos que se devolverán con la información de amenazas. El conector usa este parámetro como un filtro
para mostrar solo ciertos tipos de eventos, como |
Max Events To Return |
Es opcional. Es la cantidad de eventos que se devolverán para cada amenaza. El valor máximo es El valor predeterminado es |
Reglas del conector
El conector admite proxies.
El conector admite listas de entidades permitidas y bloqueadas.
Eventos de conectores
El ejemplo del evento del conector es el siguiente:
{
"data": [
{
"accountId": "ACCOUNT_ID",
"accountName": "SentinelOne",
"agentComputerName": "desktop-example",
"agentDomain": "WORKGROUP",
"agentId": "AGENT_ID",
"agentInfected": false,
"agentIp": "203.0.113.180",
"agentIsActive": false,
"agentIsDecommissioned": true,
"agentMachineType": "desktop",
"agentNetworkStatus": "connecting",
"agentOsType": "windows",
"agentVersion": "3.6.6.104",
"annotation": null,
"annotationUrl": null,
"automaticallyResolved": false,
"browserType": null,
"certId": "",
"classification": "generic.heuristic",
"classificationSource": "Cloud",
"classifierName": "MANUAL",
"cloudVerdict": "provider_unknown",
"collectionId": "COLLECTION_ID",
"commandId": "835975626369402963",
"createdAt": "2020-03-02T21:30:13.014874Z",
"createdDate": "2020-03-02T21:30:12.748000Z",
"description": "malware detected - not mitigated yet",
"engines": [
"manual"
],
"fileContentHash": "fc5a9b5e806f35a7b285e012ef8df3f06f399492",
"fileCreatedDate": null,
"fileDisplayName": "example.exe",
"fileExtensionType": "Executable",
"fileIsDotNet": null,
"fileIsExecutable": true,
"fileIsSystem": false,
"fileMaliciousContent": null,
"fileObjectId": "99FF941D82E382D1",
"filePath": "\\Device\\HarddiskVolume3\\Program Files\\example.exe",
"fileSha256": null,
"fileVerificationType": "NotSigned",
"fromCloud": false,
"fromScan": false,
"id": "ID",
"indicators": [],
"initiatedBy": "dvCommand",
"initiatedByDescription": "Deep Visibility Command",
"initiatingUserId": "INITIATING_USER_ID",
"isCertValid": false,
"isInteractiveSession": false,
"isPartialStory": false,
"maliciousGroupId": "MALICED_GROUP_ID",
"maliciousProcessArguments": "-ServerName:App.Example.mca",
"markedAsBenign": false,
"mitigationMode": "protect",
"mitigationReport": {
"kill": {
"status": "success"
},
"network_quarantine": {
"status": null
},
"quarantine": {
"status": "success"
},
"remediate": {
"status": null
},
"rollback": {
"status": null
},
"unquarantine": {
"status": null
}
},
"mitigationStatus": "mitigated",
"publisher": "",
"rank": 2,
"resolved": true,
"siteId": "SITE_ID",
"siteName": "Example.com",
"threatAgentVersion": "3.6.6.104",
"threatName": "example.exe",
"updatedAt": "2020-04-02T14:51:21.901754Z",
"username": "DESKTOP-example\\username",
"whiteningOptions": [
"hash"
]
}
],
"pagination": {
"nextCursor": "VALUE",
"totalItems": 161
}
}
Trabajos
Para obtener más información sobre los trabajos, consulta Configura un trabajo nuevo y Programación avanzada.
SentinelOneV2: Alertas de sincronización
Usa el trabajo SentinelOneV2 - Sync Alerts para sincronizar los estados de las alertas y los veredictos de los analistas de forma bidireccional entre Google SecOps y SentinelOne.
Requisitos laborales
Para garantizar que el trabajo identifique y sincronice los datos correctos, se deben cumplir las siguientes condiciones:
El caso de Google SecOps debe contener la etiqueta
SentinelOne Alert.Si la alerta no se originó en el SentinelOne - Alerts Connector, debes agregar un valor de contexto
Alert_IDa la alerta para que el trabajo identifique el registro correcto de SentinelOne.
Lógica operativa
El trabajo realiza la sincronización en dos etapas. Primero, de Google SecOps a SentinelOne y, luego, de SentinelOne a Google SecOps.
Se aplica la siguiente lógica cuando se cierran casos en SentinelOne:
Si el Motivo de cierre de Google SecOps es
Malicious, el Veredicto de SentinelOne se establece enTrue Positive.Si el Motivo de cierre de Google SecOps es
Not Malicious, el Veredicto de SentinelOne se establece enFalse Positive.Para todos los demás motivos de cierre, la alerta se marca como
Resolveden SentinelOne sin que se establezca un veredicto.Si una alerta de SentinelOne se marca como
undefined, el caso de Google SecOps correspondiente se cierra con el motivoInconclusive.
Parámetros del trabajo
El trabajo SentinelOne V2 - Sync Alerts requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Environment Name |
Es opcional. Es el nombre del entorno desde el que se sincronizarán las alertas. El valor predeterminado es |
API Root |
Obligatorio. La raíz de la API de la instancia de SentinelOne. |
API Token |
Obligatorio. Es el token de la API que se usa para la autenticación con SentinelOne. |
Max Hours Backwards |
Obligatorio. Es la cantidad de horas previas a la hora actual para sincronizar las alertas durante la primera iteración del trabajo. El valor predeterminado es |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de SentinelOne. Habilitada de forma predeterminada. |
SentinelOneV2 - Sync Threats
Usa el trabajo SentinelOneV2 - Sync Threats para sincronizar comentarios y estados de forma bidireccional entre las alertas de Google SecOps y las amenazas de SentinelOne.
Requisitos laborales
Para garantizar que el trabajo identifique y sincronice los datos correctos, se deben cumplir las siguientes condiciones:
El caso de Google SecOps debe contener la etiqueta
SentinelOne Threat.Si la alerta no se originó en el SentinelOne - Threats Connector, debes agregar un valor de contexto
Threat_IDa la alerta para que el trabajo identifique el registro correcto de SentinelOne.
Lógica operativa
El trabajo sincroniza los datos en dos etapas. En la primera etapa, se sincronizan los datos de amenazas de SentinelOne con las alertas de Google SecOps. La segunda etapa sincroniza los datos de alertas de Google SecOps con las amenazas de SentinelOne.
El trabajo usa Max Hours Backwards para la iteración inicial. Para todas las solicitudes
posteriores, el trabajo usa el start_time de la última alerta procesada.
Lógica de sincronización de comentarios
El trabajo usa last_update_time para filtrar comentarios y evitar entradas
duplicadas. Los comentarios sincronizados usan las siguientes estructuras:
- Enviado desde SentinelOne:
SentinelOne {threat_id}: {comment} - Se envió desde Google SecOps:
Google SecOps {case_id}: {comment}
Asignación de estados y veredictos
Cuando se cierra una alerta en Google SecOps, el trabajo actualiza la amenaza de SentinelOne según la siguiente asignación:
Si el Motivo del cierre es
Malicious, el estado de SentinelOne se establece enResolvedy el Veredicto se establece enTrue Positive.Si el Motivo del cierre es
Not Malicious, el estado de SentinelOne se establece enResolvedy el Veredicto se establece enFalse Positive.Para todos los demás motivos de cierre, el estado de SentinelOne se establece en
Resolvedsin un veredicto.
Parámetros del trabajo
El trabajo SentinelOneV2 - Sync Threats requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Environment Name |
Obligatorio. Es el nombre del entorno en el que el trabajo busca amenazas. El valor predeterminado es |
API Root |
Obligatorio. La raíz de la API de la instancia de SentinelOne. |
API Token |
Obligatorio. Es el token de la API que se usa para la autenticación con SentinelOne. |
Max Hours Backwards |
Obligatorio. Es la cantidad de horas anteriores a la hora actual para sincronizar las amenazas durante la primera iteración del trabajo. El valor predeterminado es |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de SentinelOne. Habilitada de forma predeterminada. |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.