Integra Anomali con Google SecOps

En este documento, se describe cómo integrar Anomali en Google Security Operations (Google SecOps).

Antes de comenzar

Para obtener tu clave de API personal, completa los siguientes pasos:

  1. Accede a tu cuenta de Anomali ThreatStream.

  2. Haz clic en Mis claves de API.

  3. Copia el valor de la clave de API y pégalo en el campo del parámetro Api Key en el diálogo Configurar instancia de Google SecOps.

Red

Función Puerto predeterminado Dirección Protocolo
API Valores múltiples Saliente apikey

Parámetros de integración

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

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la instancia String N/A No Es el nombre de la instancia para la que deseas configurar la integración.
Descripción String N/A No Es la descripción de la instancia.
Raíz de la API String https://api.threatstream.com/api Sí Es la dirección de la instancia de Anomali.
Nombre de usuario String user@domain.com Sí La dirección de correo electrónico del usuario que se debe usar para conectarse a Anomali.
Contraseña Contraseña N/A Sí La contraseña del usuario correspondiente.
Clave de API String N/A Sí Es la clave de API generada en la consola de AlienVault.
Ejecuta de forma remota Casilla de verificación Desmarcado No Marca el campo para ejecutar la integración configurada de forma remota. Una vez que se marca, aparece la opción para seleccionar el usuario remoto (agente).

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.

Obtén información sobre amenazas

Enriquece entidades con información de Anomali ThreatStream. Entidades admitidas: IP, URL, hash y direcciones de correo electrónico (entidades de usuario que coinciden con la expresión regular de correo electrónico).

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Límite String 10 Sí Especifica cuántos registros se deben devolver por entidad.
Umbral de gravedad DDL

Media

Valores posibles:

  • Muy alto
  • Alta
  • Media
  • Baja
No Especifica cuál debe ser el umbral de gravedad de la entidad para marcarla como sospechosa. Si se encuentran varios registros para la misma entidad, la acción tomará la gravedad más alta de todos los registros disponibles.
Umbral de confianza Número entero 50 No Especifica cuál debe ser el umbral de confianza de la entidad para marcarla como sospechosa. Nota: El máximo es 100. Si se encuentran varios registros para la entidad, la acción tomará el promedio. Los registros activos tienen prioridad. Valor predeterminado: 50.
Ignora el estado de falso positivo Casilla de verificación Desmarcado No Si se habilita, la acción ignorará el estado de falso positivo y marcará la entidad como sospechosa según el umbral de gravedad y el umbral de confianza. Si se inhabilita, la acción nunca etiquetará las entidades de falsos positivos como sospechosas, independientemente de si cumplen o no con las condiciones de umbral de gravedad y umbral de confianza.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • URL
  • Hash
  • Direcciones de correo electrónico (entidades de usuario que coinciden con la regex de correo electrónico)

Resultados de la acción

Enriquecimiento de entidades
Nombre Lógica: Cuándo aplicarla
id Devuelve si existe en el resultado JSON
estado Devuelve si existe en el resultado JSON
itype Devuelve si existe en el resultado JSON
expiration_time Devuelve si existe en el resultado JSON
ip Devuelve si existe en el resultado JSON
feed_id Devuelve si existe en el resultado JSON
confidence Devuelve si existe en el resultado JSON
uuid Devuelve si existe en el resultado JSON
retina_confidence Devuelve si existe en el resultado JSON
trusted_circle_ids Devuelve si existe en el resultado JSON
source Devuelve si existe en el resultado JSON
latitud Devuelve si existe en el resultado JSON
tipo Devuelve si existe en el resultado JSON
descripción Devuelve si existe en el resultado JSON
tags Devuelve si existe en el resultado JSON
threat_score Devuelve si existe en el resultado JSON
source_confidence Devuelve si existe en el resultado JSON
modification_time Devuelve si existe en el resultado JSON
org_name Devuelve si existe en el resultado JSON
asn Devuelve si existe en el resultado JSON
creation_time Devuelve si existe en el resultado JSON
tlp Devuelve si existe en el resultado JSON
País Devuelve si existe en el resultado JSON
longitude Devuelve si existe en el resultado JSON
gravedad, Devuelve si existe en el resultado JSON
subtype Devuelve si existe en el resultado JSON
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
correcto Verdadero o falso success:False
Resultado de JSON
    {
        "Entity": "ENTITY_ID",
        "EntityResult": {
            "Info": [{
                "source_created": null,
                "status": "inactive",
                "itype": "mal_domain",
                "expiration_ts": "2020-11-28T13:29:57.000Z",
                "ip": "192.0.2.1",
                "is_editable": false,
                "feed_id": 1111111,
                "update_id": 1111111111,
                "longitude": -0.1223454,
                "is_public": true,
                "threat_type": "malware",
                "workgroups": [],
                "rdns": null,
                "confidence": 11111,
                "uuid": "UUID",
                "retina_confidence": 1111111,
                "trusted_circle_ids": null,
                "id": 111111111111111110000,
                "source": "COVID19 Cyber Threat Coalition Blocklist - Domains",
                "owner_organization_id": 111,
                "import_session_id": null,
                "source_modified": null,
                "type": "domain",
                "sort": [1607193157800, "56224953198"],
                "description": null,
                "tags": [{
                    "id": "wu6",
                    "name": "Blocklist"
                }, {
                    "id": "pvj",
                    "name": "Coronavirus"
                }, {
                    "id": "01i",
                    "name": "COVID-19"
                }, {
                    "id": "o70",
                    "name": "Malicious"
                }, {
                    "id": "fk0",
                    "name": "Source:COVID19-Cyber-Threat-Coalition"
                }],
                "threatscore": 11111,
                "source_reported_confidence": 11111,
                "modified_ts": "2020-12-05T18:32:37.800Z",
                "org": "Namecheap",
                "asn": "11111111",
                "created_ts": "2020-10-29T13:33:24.904Z",
                "tlp": null,
                "is_anonymous": false,
                "latitude": 51.4964,
                "country": "GB",
                "can_add_public_tags": false,
                "value": "VALUE",
                "subtype": null,
                "meta": {
                    "registration_updated": "2020-10-24T22:16:59+00:00",
                    "detail2": "bifocals_deactivated_on_2020-12-05_18:30:00.085789",
                    "severity": "high",
                    "registration_created": "2020-10-24T22:16:42+00:00"
                },
                "resource_uri": "/api/v2/intelligence/"
            }],
            "Campaigns": [{
                "association_info": [{
                    "comment": null,
                    "created": "2020-10-29T13:33:29.200283",
                    "from_id": "ID"
                }],
                "can_add_public_tags": true,
                "circles": [],
                "created_ts": "2020-03-15T04:24:55.428496",
                "end_date": "2020-03-23T16:05:00.761000",
                "feed_id": 0,
                "id": "ID",
                "is_anonymous": true,
                "is_cloneable": "yes",
                "is_public": true,
                "modified_ts": "2021-02-02T02:38:19.892072",
                "name": "Coronavirus (COVID-19)",
                "objective": null,
                "organization": {
                    "id": 0,
                    "name": "Analyst",
                    "title": "Analyst"
                },
                "publication_status": "published",
                "published_ts": "2020-04-06T21:40:24.452312",
                "resource_uri": "/api/v1/campaign/",
                "source_created": null,
                "source_modified": null,
                "start_date": "2020-01-30T13:10:00.070000",
                "status": {
                    "display_name": "Ongoing",
                    "id": 1,
                    "resource_uri": "/api/v1/campaignstatus/1/"
                },
                "tags": ["Malware", "Fraud", "Phishing", "COVID-19", "Coronavirus", "Scams"],
                "tags_v2": [{
                    "id": "wqe",
                    "name": "Coronavirus"
                }, {
                    "id": "hlg",
                    "name": "COVID-19"
                }, {
                    "id": "74i",
                    "name": "Phishing"
                }, {
                    "id": "0y2",
                    "name": "Malware"
                }, {
                    "id": "u63",
                    "name": "Scams"
                }, {
                    "id": "1er",
                    "name": "Fraud"
                }],
                "tlp": "white",
                "uuid": "UUID",
                "workgroups": []
            }],
            "Tip": [{
                "all_circles_visible": true,
                "association_info": [{
                    "comment": null,
                    "created": "2020-10-29T13:33:29.212118",
                    "from_id": "ID"
                }],
                "body_content_type": "richtext",
                "campaign": null,
                "can_add_public_tags": true,
                "circles": [],
                "created_ts": "2020-03-19T04:23:35.714929",
                "feed_id": 0,
                "id": "ID",
                "is_anonymous": true,
                "is_cloneable": "yes",
                "is_editable": true,
                "is_email": false,
                "is_public": true,
                "modified_ts": "2021-02-02T02:38:20.061912",
                "name": "Coronavirus (COVID-19) Cyber Threats",
                "original_source": null,
                "original_source_id": null,
                "owner_org": {
                    "id": 0,
                    "name": "Analyst",
                    "title": "Analyst"
                },
                "parent": null,
                "published_ts": "2020-05-25T18:39:36.890647",
                "resource_uri": "/api/v1/ID/",
                "source_created": null,
                "source_modified": null,
                "starred_by_me": false,
                "starred_total_count": 5,
                "status": "published",
                "tags": ["Scams", "HCL-", "Malware"],
                "tags_v2": [{
                    "id": "ID",
                    "name": "Coronavirus"
                }, {
                    "id": "ID",
                    "name": "COVID-19"
                }, {
                    "id": "ID",
                    "name": "Phishing"
                }],
                "threat_actor": null,
                "tlp": "white",
                "ttp": null,
                "uuid": "UUID",
                "votes": {
                    "me": null,
                    "total": 0
                },
                "watched_by_me": false,
                "watched_total_count": 11111,
                "workgroups": []
            }],
            "Actors": [],
            "Incidents": [],
            "TTP": []
        }
    }
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

Si hay datos disponibles para una entidad (is_success=true): "Successfully returned information about the following entities from Anomali ThreatStream: {entity.identifier}"

Si no hay datos disponibles para una entidad (is_success=true): "Action wasn't able to return information about the following entities from Anomali ThreatStream: {entity.identifier}"

Si no está disponible para todas las entidades (is_success=false): "No se enriqueció ninguna entidad.

Error crítico (falla): Se produjo un error cuando se ejecutaba la acción "Get Threat Info". Motivo: {error traceback}"

General

Ping

Prueba la conectividad con Anomali ThreatStream.

Parámetros

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
correcto Verdadero o falso success:False

Recupera asociaciones relacionadas con entidades de Anomali ThreatStream.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Campañas de devoluciones Casilla de verificación Marcado No Si se habilita, la acción recuperará las campañas relacionadas y los detalles sobre ellas.
Devuelve boletines de amenazas Casilla de verificación Marcado No Si se habilita, la acción recuperará los boletines de amenazas relacionados y los detalles sobre ellos.
Actores de retorno Casilla de verificación Marcado No Si se habilita, la acción recuperará los actores relacionados y los detalles sobre ellos.
Devuelve patrones de ataque Casilla de verificación Marcado No Si se habilita, la acción recuperará los patrones de ataque relacionados y los detalles sobre ellos.
Devolver planes de acción Casilla de verificación Marcado No Si se habilita, la acción recuperará los cursos de acción relacionados y los detalles sobre ellos.
Identidades de retorno Casilla de verificación Marcado No Si se habilita, la acción recuperará las identidades relacionadas y los detalles sobre ellas.
Devuelve incidentes Casilla de verificación Marcado No Si se habilita, la acción recuperará los incidentes relacionados y sus detalles.
Devolución de infraestructura Casilla de verificación Marcado No Si se habilita, la acción recuperará la infraestructura relacionada y los detalles sobre ella.
Devolver conjuntos de intrusiones Casilla de verificación Marcado No Si se habilita, la acción recuperará los conjuntos de intrusiones relacionados y los detalles sobre ellos.
Devolver el malware Casilla de verificación Marcado No Si se habilita, la acción recuperará el malware relacionado y los detalles sobre él.
Firmas de devolución Casilla de verificación Marcado No Si se habilita, la acción recuperará las firmas relacionadas y los detalles sobre ellas.
Herramientas de devolución Casilla de verificación Marcado No Si se habilita, la acción recuperará las herramientas relacionadas y los detalles sobre ellas.
TTP de devolución Casilla de verificación Marcado No Si se habilita, la acción recuperará las TTP relacionadas y los detalles sobre ellas.
Devuelve vulnerabilidades Casilla de verificación Marcado No Si está habilitada, la acción recuperará las vulnerabilidades relacionadas y los detalles sobre ellas.
Crea una entidad de campaña Casilla de verificación Desmarcado No Si se habilita, la acción creará una entidad a partir de las asociaciones de campañas disponibles.
Crea la entidad Actors Casilla de verificación Desmarcado No Si habilitas esta opción, la acción creará una entidad a partir de las asociaciones de actores disponibles.
Crea una entidad de firma Casilla de verificación Desmarcado No Si se habilita, la acción creará una entidad a partir de las asociaciones de Signature disponibles.
Crea una entidad de vulnerabilidad Casilla de verificación Desmarcado No Si se habilita, la acción creará una entidad a partir de las asociaciones de vulnerabilidades disponibles.
Cantidad máxima de asociaciones que se devolverán Número entero 5 No Especifica cuántas asociaciones se deben devolver por tipo.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Hash
  • Dirección IP
  • URL
  • Correo electrónico

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
correcto Verdadero o falso success:False
Resultado de JSON
{
    "campaign": [
        {
            "name": "Example 1",
            "id": 1
        },
        {
            "name": "Example 2",
            "id": 2
        }
    ],
    "actor": [
        {
            "name": "Actor 1",
            "id": 1
        },
        {
            "name": "Actor 2",
            "id": 2
        }
    ],
    "attackpattern": [
        {
            "name": "Pattern 1",
            "id": 1
        },
        {
            "name": "Pattern 2",
            "id": 2
        }
    ],
    "courseofaction": [
        {
            "name": "Course of Action 1",
            "id": 1
        },
        {
            "name": "Course Of Action 2",
            "id": 2
        }
    ],
    "identity": [
        {
            "name": "Identity 1",
            "id": 1
        },
        {
            "name": "Identity 2",
            "id": 2
        }
    ],
    "incident": [
        {
            "name": "Incident 1",
            "id": 1
        },
        {
            "name": "Incident 2",
            "id": 2
        }
    ],
    "infrastructure": [
        {
            "name": "Infrustructure 1",
            "id": 1
        },
        {
            "name": "Infrustructure 2",
            "id": 2
        }
    ],
    "intrusionset": [
        {
            "name": "Intrusion set 1",
            "id": 1
        },
        {
            "name": "Intrusion set 2",
            "id": 2
        }
    ],
    "malware": [
        {
            "name": "Malware 1",
            "id": 1
        },
        {
            "name": "Malware 2",
            "id": 2
        }
    ],
    "signature": [
        {
            "name": "Signature 1",
            "id": 1
        },
        {
            "name": "Signature 2",
            "id": 2
        }
    ],
    "tool": [
        {
            "name": "Tool 1",
            "id": 1
        },
        {
            "name": "Tool 2",
            "id": 2
        }
    ],
    "ttp": [
        {
            "name": "TTP 1",
            "id": 1
        },
        {
            "name": "TTP 2",
            "id": 2
        }
    ],
    "vulnerability": [
        {
            "name": "Vulnerability 1",
            "id": 1
        },
        {
            "name": "Vulnerability 2",
            "id": 2
        }
    ],
}
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debería fallar ni detener la ejecución de una guía:

Si se realiza correctamente y se encuentra al menos una asociación entre entidades (is_success=true): "Se recuperaron correctamente las asociaciones relacionadas de Anomali"

Si no se encuentran asociaciones (is_success=false): "No se encontraron asociaciones relacionadas".

Mensaje asíncrono: "Esperando que se recuperen todos los detalles de la asociación"

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "Obtener asociación relacionada". Reason: {0}''.format(error.Stacktrace)

General
Tabla del muro de casos

Nombre de la tabla: "Asociaciones relacionadas"

Columnas de la tabla:

  • ID
  • Nombre
  • Tipo
  • Estado

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