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 |
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:
|
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:
La acción debería fallar y detener la ejecución de una guía:
|
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.