Integra UrlScan.io con Google SecOps

En este documento, se proporcionan instrucciones para integrar urlscan.io con Google SecOps.

En este documento, se explica cómo integrar UrlScan.io con Google Security Operations.

Casos de uso

La integración de UrlScan.io usa las funciones de Google SecOps para admitir los siguientes casos de uso:

  • Análisis automatizado de URLs: Envía automáticamente URLs sospechosas a UrlScan.io para determinar los niveles de riesgo y recuperar capturas de pantalla para la verificación visual durante la clasificación de incidentes.

  • Enriquecimiento de inteligencia contra amenazas: Enriquece las alertas consultando UrlScan.io para obtener metadatos detallados sobre direcciones IP, dominios y URLs, lo que proporciona a los analistas un contexto inmediato sobre ASN, tipos de servidores y puntuaciones maliciosas.

  • Búsqueda proactiva de análisis históricos: Busca análisis públicos y privados existentes asociados con indicadores de compromiso para identificar patrones y actividades maliciosas históricas.

  • Análisis forense y generación de informes detallados: Recupera detalles completos de los análisis con IDs de análisis específicos para realizar un análisis detallado de las cookies, los recuentos de solicitudes y los vínculos relacionados para investigaciones de seguridad complejas.

Antes de comenzar

Para autenticar la conexión entre Google SecOps y UrlScan.io, debes proporcionar una clave de API válida.

Puedes obtener y administrar tus claves de API en la sección Perfil de tu cuenta de urlscan.io.

Parámetros de integración

La integración de urlscan.io requiere los siguientes parámetros:

Parámetro Descripción
Api Key

Obligatorio.

Es la clave de API única que se usa para autenticarse con el servicio de urlscan.io.

Verify SSL

Es opcional.

Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de UrlScan.io.

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.

Ping

Prueba la conectividad.

Parámetros

N/A

Casos de uso

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades
Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
N/A

Verificación de URL

Envía una URL para que se analice y obtén los detalles del análisis.

Parámetros

Nombre del parámetro Tipo Es obligatorio Valor predeterminado Descripción
Visibilidad

DDL
posibles:
público, no listado, privado.

No público Los análisis en urlscan.io tienen uno de tres niveles de visibilidad. Asegúrate de usar el nivel adecuado para tu envío.
Umbral integer No -1 Marca la entidad como sospechosa si la puntuación de los veredictos es igual o superior al umbral determinado. El valor predeterminado es -1. En este caso, consideramos que todas las URLs analizadas son sospechosas.
Crea estadísticas Booleano No Sí Si está habilitada, la acción creará una estadística que contendrá información sobre las entidades.
Solo estadísticas sospechosas Booleano No No Si se habilita, la acción solo creará estadísticas para las entidades sospechosas. Nota: Se debe habilitar el parámetro "Crear estadística".
Agregar captura de pantalla a la estadística Booleano No No Si se habilita, la acción agregará una captura de pantalla del sitio web a la estadística, si está disponible.

Casos de uso

N/A

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Dominio
  • URL

Resultados de la acción

Enriquecimiento de entidades
Nombre Clave
real_url tasks/url
visibility visibility
requests_count len(data/requests)
cookies CSV de datos, cookies o nombre
related_links CSV de datos, vínculos o href
main_country página/país
main_domain página/dominio
main_ip page/ip
main_asn page/asnname
main_server página/servidor
related_ips_count len(lists/ips)
related_domains_count len(lists/domains)
related_countries Listas de CSV/países
overall_score verdicts/overall/score
categories verdicts/overall/categories
tags verdicts/overall/tags
malicioso verdicts/overall/malicious
Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
[
    {
        "Entity": "https://example.com",
        "EntityResult": {
            "lists": {
                "ips": [
                    "0.0.0.0"
                ],
                "countries": [
                    "ZZ"
                ],
                "asns": [
                    "00000"
                ],
                "domains": [
                    "subdomain.example.com"
                ],
                "servers": [
                    "GenericServer/1.0.0"
                ],
                "urls": [
                    "https://example.com/",
                    "https://example.com/assets/image.png",
                    "https://example.com/assets/script.js",
                    "https://example.com/assets/style.svg",
                    "https://example.com/favicon.ico"
                ],
                "linkDomains": [
                    "node1.example.com",
                    "node2.example.com",
                    "node3.example.com"
                ],
                "certificates": [
                    {
                        "subjectName": "*.example.com",
                        "issuer": "CA-0",
                        "validFrom": 1000000000,
                        "validTo": 2000000000
                    }
                ],
                "hashes": [
                    "hash_string_alpha_001",
                    "hash_string_alpha_002",
                    "hash_string_alpha_003"
                ]
            },
            "page": {
                "asn": "AS00000",
                "asnname": "PROVIDER - Service Provider Inc., ZZ",
                "city": "",
                "country": "ZZ",
                "domain": "subdomain.example.com",
                "ip": "0.0.0.0",
                "ptr": "host.provider.net",
                "server": "GenericServer/1.0.0",
                "url": "https://example.com/",
                "apexDomainAgeDays": 1,
                "mimeType": "application/octet-stream",
                "title": "Title Placeholder",
                "tlsValidDays": 0,
                "tlsAgeDays": 0,
                "domainAgeDays": 1,
                "tlsValidFrom": "2000-01-01T00:00:00.000Z",
                "umbrellaRank": 0,
                "apexDomain": "example.com",
                "tlsIssuer": "CA-0",
                "status": "000"
            },
            "scanner": {
                "country": "zz"
            },
            "stats": {
                "IPv6Percentage": 0,
                "adBlocked": 0,
                "malicious": 0,
                "securePercentage": 0,
                "secureRequests": 0,
                "totalLinks": 0,
                "uniqCountries": 0
            },
            "submitter": {
                "country": "ZZ"
            },
            "task": {
                "method": "system",
                "source": "source_id",
                "time": "2000-01-01T00:00:00.000Z",
                "url": "https://example.com/",
                "uuid": "00000000-0000-0000-0000-000000000000",
                "visibility": "private",
                "reportURL": "https://service.io/result/id/",
                "screenshotURL": "https://service.io/screen/id.png",
                "domURL": "https://service.io/dom/id/",
                "domain": "subdomain.example.com",
                "apexDomain": "example.com"
            },
            "verdicts": {
                "overall": {
                    "score": 0,
                    "categories": [],
                    "brands": [],
                    "tags": [],
                    "malicious": false,
                    "hasVerdicts": false
                },
                "service_provider": {
                    "score": 0,
                    "categories": [],
                    "brands": [],
                    "tags": [],
                    "malicious": false,
                    "hasVerdicts": false
                },
                "engines": {
                    "score": 0,
                    "malicious": false,
                    "categories": [],
                    "enginesTotal": 0,
                    "maliciousTotal": 0,
                    "benignTotal": 0,
                    "maliciousVerdicts": [],
                    "benignVerdicts": [],
                    "hasVerdicts": false,
                    "tags": [
                        "tag-alpha",
                        "tag-beta"
                    ]
                },
                "community": {
                    "score": 0,
                    "categories": [],
                    "brands": [],
                    "votesTotal": 0,
                    "votesMalicious": 0,
                    "votesBenign": 0,
                    "malicious": false,
                    "hasVerdicts": false
                }
            },
            "is_risky": false
        }
    }
]

Buscar análisis

Busca análisis existentes de urlscan.io por atributos, como dominios, IPs, números de sistema autónomo (AS), hashes, etc. La acción encontrará análisis públicos realizados por cualquier persona, así como análisis no listados y privados realizados por ti o tus equipos.

Parámetros

Nombre del parámetro Tipo Es obligatorio Valor predeterminado Descripción
Cantidad máxima de análisis Número entero No 100 Es la cantidad de análisis que se devolverán por entidad. Valor predeterminado: 100; máximo: 10, 000 (según la suscripción).

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Nombres de host
  • URL
  • Nombre del archivo
  • Hashes
  • Dominio

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{"entity_identifier": "www.unitedneighborsfcu.com",
"entity_results":[
  {
        "indexedAt": "2020-12-09T12:16:43.329Z",
        "task": {
            "visibility": "public",
            "method": "automatic",
            "domain": "www.unitedneighborsfcu.com",
            "time": "2020-12-09T12:16:23.168Z",
            "source": "certstream-suspicious",
            "uuid": "96310829-fed4-4d61-9fb0-39eb2952719f",
            "url": "https://www.unitedneighborsfcu.com"
        },
        "stats": {
            "uniqIPs": 6,
            "consoleMsgs": 0,
            "uniqCountries": 3,
            "dataLength": 1938842,
            "encodedDataLength": 1568193,
            "requests": 28
        },
        "page": {
            "country": "US",
            "server": "Microsoft-IIS/10.0",
            "domain": "www.unitedneighborsfcu.com",
            "ip": "8.21.114.55",
            "mimeType": "text/html",
            "asnname": "LEVEL3, US",
            "asn": "AS3356",
            "url": "https://www.unitedneighborsfcu.com/",
            "status": "200"
        },
        "_id": "96310829-fed4-4d61-9fb0-39eb2952719f",
        "sort": [1607516183168, "96310829-fed4-4d61-9fb0-39eb2952719f"],
        "result": "https://urlscan.io/api/v1/result/96310829-fed4-4d61-9fb0-39eb2952719f/",
        "screenshot": "https://urlscan.io/screenshots/96310829-fed4-4d61-9fb0-39eb2952719f.png"
  }
  ]
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

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

  • if find scans for some of the entities (is_success = true): print "Successfully listed scans for the following entities:\n".format(entity.identifier)
  • Si no se encontraron análisis para algunas de las entidades (is_success = true): print "Action wasn't able to list scans for the following entities:\n".format(entity.identifier)
  • Si no se encontraron análisis para todas las entidades(is_success = false): imprime "Action wasn't able to list scans for the available entities".
  • Si no hay entidades: imprime "No suitable entities were found in the current scope.

    La acción debería fallar y detener la ejecución de una guía:
    Si hay un error grave, como credenciales incorrectas, falta de conexión al servidor, etc.: imprime "Error executing action "Search for Scans". Motivo: {0}''.format(error.Stacktrace).
General
Tabla del muro de casos

Título: "{identificador de entidad} - Resultados de la búsqueda"

Columnas:

ID de análisis

URL

Fecha del análisis

Tamaño

IPS

Países únicos

País

Tipo de escaneo

General
Vínculo al muro de casos Título: "urlscan.io Web Report + (ID de entidad). General
Archivo adjunto del muro de casos Contendrá la captura de pantalla. General

Obtén todos los detalles del análisis

Obtén los detalles completos del análisis por ID de análisis

Parámetros

Nombre del parámetro Tipo Es obligatorio Valor predeterminado Descripción
ID de análisis String Sí N/A Obtén el informe de análisis con el ID de análisis. Valores separados por comas.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
['Effective URL'] = response['page']['url']
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

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

  • if find some scan ids (is_success = true): print "Successfully fetched results for the following scans: {scan ids}
  • Si no se encontraron algunos (is_success = true): imprime "Action wasn't able to fetch results for the following scans: {scan ids}
  • Si no se encontraron todos (is_success = false): Imprime "Action wasn't able to fetch results. Los IDs de análisis proporcionados no están disponibles con urlscan.io"

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

  • if fatal error, like wrong credentials, no connection to server, other: print "Error executing action "Get Scan Full Details". Reason: {0}''.format(error.Stacktrace)
General
Vínculo al muro de casos Título: Informe web de urlscan.io + (ID de análisis). General
Archivo adjunto del muro de casos Contendrá la captura de pantalla. General

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