Harmony Mobile

En este documento, se proporcionan instrucciones para integrar Harmony Mobile en Google SecOps.

Casos de uso

  1. Realiza el enriquecimiento de entidades
  2. Transferencia de alertas

Cómo generar el ID de cliente y el secreto del cliente

  1. Navega a la sección "Harmony Endpoint".
  2. Ve a "Configuración global".
  3. Ve a la sección "Claves de API".
  4. Presiona el botón "Nuevo".
  5. Selecciona el servicio "Harmony Mobile" y el rol "Solo lectura"
  6. Copia el "ID de cliente" y el "Secreto del cliente". Coloca esos parámetros en la configuración de la integración.

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

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura 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 String https://cloudinfra-gw.portal.checkpoint.com Sí Es la raíz de la API de la instancia de Harmony Mobile.
ID de cliente String N/A Sí ID de cliente de la cuenta de Harmony Mobile
Secreto del cliente Contraseña N/A Sí Es el secreto del cliente de la cuenta de Harmony Mobile.
Verificar SSL Casilla de verificación Marcado Sí Si se habilita, verifica que el certificado SSL para 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 en la página de Google SecOps Content Hub.

Parámetros

N/A

Ejecutar en

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
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:
Si se ejecuta correctamente: "Successfully connected to the Harmony Mobile server with the provided connection parameters!"

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

 General

Enriquece 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
Crea estadísticas Casilla de verificación Marcado No Si está habilitada, la acción creará una estadística que contendrá toda la información recuperada sobre la entidad.

Ejecutar en

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 aplicar
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
nombre 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
estado Cuando está disponible en JSON
Estadísticas

Ejemplo de estadística de entidad

Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida

La acción no debe fallar ni detener la ejecución de una guía:
Si hay datos disponibles para una(is_success = true): "Successfully enriched the following entities using information from Harmony Mobile: {entity.identifier}".

Si no hay datos disponibles para una (is_success=true): "La acción no pudo enriquecer las siguientes entidades con información de Harmony Mobile: {entity.identifier}".

Si no hay datos disponibles para todas (is_success=false): No se enriqueció ninguna de las entidades proporcionadas.

La acción debería fallar y detener la ejecución de una guía:
si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace)

 General

Tabla del muro de casos

 Título: {entity.identifier} Entidad

Conector

Harmony Mobile: Conector de alertas

Descripción

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

Configura Harmony Mobile - Alerts Connector en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta Configura el conector.

Parámetros del conector

Usa los siguientes parámetros para configurar el conector:

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

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

Si no se encuentra el campo de entorno, el entorno es el predeterminado.
Patrón de regex del entorno String .* No

Es un patrón de regex que se ejecuta en el valor que se encuentra en el campo "Nombre del campo de entorno".

El valor predeterminado es .* para capturar todo y devolver el valor sin cambios.

Se usa para permitir que el usuario manipule el campo de entorno a través de la lógica de regex.

Si el patrón de regex es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno es el entorno predeterminado.
Tiempo de espera de la secuencia de comandos (segundos) Número entero 180 Sí Es el límite de tiempo de espera para el proceso de Python que ejecuta la secuencia de comandos actual.
Raíz de la API String https://cloudinfra-gw.portal.checkpoint.com Sí Es la raíz de la API de la instancia de Harmony Mobile.
ID de cliente String N/A Sí ID de cliente de la cuenta de Harmony Mobile
Secreto del cliente Contraseña N/A Sí Es el secreto del cliente de la cuenta de Harmony Mobile.
Riesgo más bajo para recuperar Número entero Falso Es el riesgo más bajo que se debe usar para recuperar alertas. Valores posibles: Informativo, Bajo, Medio, Alto. Si no se especifica nada, el conector transferirá alertas con todos los niveles de riesgo.
Cantidad máxima de horas hacia atrás Número entero 1 No Es la cantidad de horas desde las que se recuperarán las alertas.
Cantidad máxima de alertas que se recuperarán Número entero 100 No Indica cuántas alertas se deben procesar por iteración del conector. Valor predeterminado: 100.
Usa la lista de entidades permitidas como una lista de entidades rechazadas Casilla de verificación Desmarcado Sí Si se habilita, la lista de entidades permitidas se usará como una lista de entidades rechazadas.
Verificar SSL Casilla de verificación Marcado Sí Si se habilita, se verifica que el certificado SSL para la conexión con el servidor de Harmony Mobile sea válido.
Dirección del servidor proxy String N/A No Es la dirección del servidor proxy que se usará.
Nombre de usuario del proxy String N/A No Es el nombre de usuario del proxy con el que se autenticará.
Contraseña del proxy Contraseña N/A No Es la contraseña del proxy con la que se realizará la autenticación.

Reglas de conector

Compatibilidad con proxy

El conector admite proxy.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.