Harmony Mobile

Versión de integración: 4.0

Casos prácticos

  1. Enriquecer entidades
  2. Ingestión de alertas

Cómo generar un ID de cliente y un secreto de cliente

  1. Ve a la sección "Harmony Endpoint".
  2. Ve a "Configuración global".
  3. Ve a la sección "Claves de API".
  4. Pulsa el botón "Nuevo".
  5. Seleccione el servicio "Harmony Mobile" y el rol "Solo lectura".
  6. Copia los valores de "Client ID" (ID de cliente) y "Client Secret" (Secreto de cliente). Incluye esos parámetros en la configuración de la integración.

Configurar la integración de Harmony Mobile en Google Security Operations

Para obtener instrucciones detalladas sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API Cadena https://cloudinfra-gw.portal.checkpoint.com Sí Raíz de la API de la instancia de Harmony Mobile.
ID de cliente Cadena N/A Sí ID de cliente de la cuenta de Harmony Mobile.
Secreto de cliente Contraseña N/A Sí Secreto de cliente de la cuenta de Harmony Mobile.
Verificar SSL Casilla Marcada Sí Si está habilitada, verifica que el certificado SSL de la conexión con el servidor de Harmony Mobile sea válido.

Acciones

Ping

Descripción

Prueba la conectividad con Harmony Mobile con los parámetros proporcionados en la página de configuración de la integración de la pestaña Google Security Operations Marketplace.

Parámetros

N/A

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si se realiza correctamente: "Successfully connected to the Harmony Mobile server with the provided connection parameters!" (Se ha conectado correctamente al servidor de Harmony Mobile con los parámetros de conexión proporcionados).

La acción debería fallar y detener la ejecución de un libro de jugadas:
si no se realiza correctamente: "Failed to connect to the Harmony Mobile server! Error: {0}".format(exception.stacktrace)

 General

Enriquecer entidades

Descripción

Enriquece las entidades con información de Harmony Mobile. Entidades admitidas: Nombre de host.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Crear estadística Casilla Marcada No Si se habilita, la acción creará una estadística que contenga toda la información recuperada sobre la entidad.

Fecha de ejecución

Esta acción se ejecuta en la entidad Hostname.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de JSON
{
    "client_version": "3.8.6.4637",
    "device_type": "Android",
    "email": "dana@example.com",
    "internal_id": 1,
    "last_connection": "Wed, 14 Jul 2021 05:26:09 +0000",
    "mail_sent": true,
    "mdm": null,
    "model": "HUAWEI / HUAWEI GRA-L09",
    "name": "Dana Doe",
    "number": "+11",
    "os_type": "Android_4_x",
    "os_version": "6.0",
    "risk": "No Risk",
    "status": "Active"
}
Enriquecimiento de entidades
Nombre del campo de enriquecimiento Lógica: cuándo se aplica
client_version Cuando esté disponible en JSON
device_type Cuando esté disponible en JSON
correo electrónico Cuando esté disponible en JSON
last_connection Cuando esté disponible en JSON
modelo Cuando esté disponible en JSON
name Cuando esté disponible en JSON
número Cuando esté disponible en JSON
os_type Cuando esté disponible en JSON
os_version Cuando esté disponible en JSON
riesgo Cuando esté disponible en JSON
status Cuando esté disponible en JSON
Estadísticas

Ejemplo de estadística de entidad

Panel de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje resultante

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si hay datos disponibles para uno(is_success = true): "Se han enriquecido correctamente las siguientes entidades con información de Harmony Mobile: {entity.identifier}".

Si no hay datos disponibles para una de ellas (is_success=true): "Action wasn't able to enrich the following entities using information from Harmony Mobile: {entity.identifier}". ("No se ha podido enriquecer la siguiente entidad con información de Harmony Mobile: {entity.identifier}").

Si los datos no están disponibles para todos los elementos (is_success=false): no se ha enriquecido ninguna de las entidades proporcionadas.

La acción debería fallar y detener la ejecución de un cuaderno de estrategias:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Enrich Entities". Motivo: {0}''.format(error.Stacktrace)

 General

Tabla del panel de casos

 Título: {entity.identifier} Entidad

Conector

Harmony Mobile - Alerts Connector

Descripción

Extrae información sobre las alertas de Harmony Mobile. Nota: El filtro de lista de permitidos funciona con el parámetro "alertEvent".

Configurar Harmony Mobile - Alerts Connector en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta el artículo Configurar el conector.

Parámetros del conector

Utiliza los siguientes parámetros para configurar el conector:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del campo de producto Cadena Nombre del producto Sí Introduce el nombre del campo de origen para obtener el nombre del campo de producto.
Nombre del campo de evento Cadena alertType Sí Introduzca el nombre del campo de origen para obtener el nombre del campo de evento.
Nombre del campo de entorno Cadena "" No

Describe el nombre del campo en el que se almacena el nombre del entorno.

Si no se encuentra el campo de entorno, se utiliza el entorno predeterminado.
Patrón de regex de entorno Cadena .* No

Una expresión regular que se aplicará al valor encontrado en el campo "Nombre del campo de entorno".

El valor predeterminado es .* para captar todos los valores y devolverlos sin cambios.

Se usa para permitir que el usuario manipule el campo del entorno mediante la lógica de expresiones regulares.

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 será el entorno predeterminado.
Tiempo de espera de secuencia de comandos (segundos) Entero 180 Sí Límite de tiempo de espera del proceso de Python que ejecuta la secuencia de comandos actual.
Raíz de la API Cadena https://cloudinfra-gw.portal.checkpoint.com Sí Raíz de la API de la instancia de Harmony Mobile.
ID de cliente Cadena N/A Sí ID de cliente de la cuenta de Harmony Mobile.
Secreto de cliente Contraseña N/A Sí Secreto de cliente de la cuenta de Harmony Mobile.
Riesgo más bajo para obtener Entero Falso Riesgo más bajo que se debe usar para obtener alertas. Valores posibles: Informativa, Baja, Media y Alta. Si no se especifica nada, el conector ingerirá alertas con todos los niveles de riesgo.
Número máximo de horas hacia atrás Entero 1 No Número de horas desde las que se obtienen las alertas.
Número máximo de alertas que se van a obtener Entero 100 No Número de alertas que se procesarán por cada iteración del conector. Predeterminado: 100.
Usar la lista blanca como lista negra Casilla Desmarcada Sí Si está habilitada, la lista de permitidos se usará como lista de denegados.
Verificar SSL Casilla Marcada Sí Si está habilitada, verifica que el certificado SSL de la conexión con el servidor de Harmony Mobile sea válido.
Dirección del servidor proxy Cadena N/A No Dirección del servidor proxy que se va a usar.
Nombre de usuario del proxy Cadena N/A No Nombre de usuario del proxy para autenticarse.
Contraseña del proxy Contraseña N/A No La contraseña del proxy para autenticarte.

Reglas de conectores

Compatibilidad con proxy

El conector admite proxies.

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.