Integrar o UrlScan.io ao Google SecOps

Este documento fornece orientações sobre como integrar o urlscan.io ao Google SecOps.

Este documento explica como integrar o UrlScan.io ao Google Security Operations.

Casos de uso

A integração do UrlScan.io usa os recursos do Google SecOps para oferecer suporte aos seguintes casos de uso:

  • Análise automatizada de URLs: envie automaticamente URLs suspeitos para o UrlScan.io para determinar os níveis de risco e recuperar capturas de tela para verificação visual durante a triagem de incidentes.

  • Enriquecimento de inteligência contra ameaças: enriqueça os alertas consultando o UrlScan.io para metadados detalhados sobre endereços IP, domínios e URLs, fornecendo aos analistas contexto imediato sobre ASN, tipos de servidor e pontuações maliciosas.

  • Pesquisa proativa de verificação histórica: pesquise verificações públicas e privadas associadas a indicadores de comprometimento para identificar atividades e padrões maliciosos históricos.

  • Análise forense e relatórios detalhados: recupere detalhes abrangentes da verificação usando IDs de verificação específicos para realizar análises detalhadas de cookies, contagens de solicitações e links relacionados para investigações de segurança complexas.

Antes de começar

Para autenticar a conexão entre o Google SecOps e o UrlScan.io, é necessário fornecer uma chave de API válida.

É possível conseguir e gerenciar suas chaves de API na seção Perfil da sua conta do urlscan.io.

Parâmetros de integração

A integração do urlscan.io requer os seguintes parâmetros:

Parâmetro Descrição
Api Key

Obrigatório.

A chave de API exclusiva usada para autenticação com o serviço urlscan.io.

Verify SSL

Opcional.

Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor UrlScan.io.

Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Se necessário, você pode fazer mudanças depois. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Ping

Teste a conectividade.

Parâmetros

N/A

Casos de uso

N/A

Corrida

Essa ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades
Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
N/A

Verificação de URL

Envie um URL para ser verificado e receba os detalhes da verificação.

Parâmetros

Nome do parâmetro Tipo É obrigatório Valor padrão Descrição
Visibilidade

DDL
possíveis:
público, não listado, privado.

Não público As verificações no urlscan.io têm um dos três níveis de visibilidade. Use o nível adequado para seu envio.
Limite integer Não -1 Marque a entidade como suspeita se a pontuação dos vereditos for igual ou maior que o limite especificado. O padrão é -1. Nesse caso, consideramos todos os URLs verificados como suspeitos.
Criar insight Booleano Não Sim Se ativada, a ação vai criar um insight com informações sobre as entidades.
Somente insight suspeito Booleano Não Não Se ativada, a ação só vai criar insights para entidades suspeitas. Observação: o parâmetro "Criar insight" precisa estar ativado.
Adicionar captura de tela ao insight Booleano Não Não Se ativada, a ação vai adicionar uma captura de tela do site ao insight, se estiver disponível.

Casos de uso

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Domínio
  • URL

Resultados da ação

Enriquecimento de entidades
Nome Key
real_url tasks/url
visibility visibility
requests_count len(data/requests)
cookies CSV de dados/cookies/nome
related_links CSV de dados/links/href
main_country page/country
main_domain página/domínio
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 CSV/países
overall_score verdicts/overall/score
categories verdicts/overall/categories
tags verdicts/overall/tags
Mal-intencionado verdicts/overall/malicious
Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do 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
        }
    }
]

Pesquisar verificações

Pesquise verificações atuais do urlscan.io por atributos como domínios, IPs, números de sistema autônomo (AS), hashes etc. A ação vai encontrar verificações públicas realizadas por qualquer pessoa, bem como verificações não listadas e particulares realizadas por você ou suas equipes.

Parâmetros

Nome do parâmetro Tipo É obrigatório Valor padrão Descrição
Máximo de verificações Inteiro Não 100 Número de verificações a serem retornadas por entidade. Padrão: 100, máximo: 10.000 (dependendo da assinatura).

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nomes de host
  • URLs
  • Filename
  • Hashes
  • Domínio

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do 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"
  }
  ]
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se a verificação encontrar algumas das entidades (is_success = true): mostre "Successfully listed scans for the following entities:\n".format(entity.identifier)
  • Se não encontrar verificações para algumas das entidades (is_success = true): print "Action wasn't able to list scans for the following entities:\n".format(entity.identifier)
  • Se não encontrar verificações para todas as entidades(is_success = false): mostre "A ação não conseguiu listar as verificações das entidades disponíveis".
  • Se não houver entidades: mostre "No suitable entities were found in the current scope".

    A ação deve falhar e interromper a execução de um playbook:
    se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: mostre "Error executing action 'Search for Scans'". Motivo: {0}''.format(error.Stacktrace).
Geral
Tabela do painel de casos

Título: "{identificador da entidade} – Resultados da pesquisa"

Colunas:

ID de verificação

URL

Data da verificação

Tamanho

IPS

Países únicos

País

Tipo de verificação

Geral
Link do Painel de Casos Título: relatório da Web do urlscan.io + (ID da entidade). Geral
Anexo do Painel de Casos Vai conter a captura de tela. Geral

Receber detalhes completos da verificação

Receber todos os detalhes da verificação por ID

Parâmetros

Nome do parâmetro Tipo É obrigatório Valor padrão Descrição
ID de verificação String Sim N/A Receba o relatório de verificação usando o ID da verificação. Valores separados por vírgula.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
['Effective URL'] = response['page']['url']
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

  • Se encontrar alguns IDs de verificação (is_success = true): mostre "Resultados buscados para as seguintes verificações: {IDs de verificação}"
  • Se não encontrar alguns (is_success = true): mostre "A ação não conseguiu buscar resultados para as seguintes verificações: {scan ids}
  • Se não encontrar todos (is_success = false): mostre "A ação não conseguiu buscar resultados. Os IDs de verificação fornecidos não estão disponíveis usando o urlscan.io"

A ação deve falhar e interromper a execução de um playbook:

  • Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: exiba "Erro ao executar a ação 'Receber detalhes completos da verificação'". Motivo: {0}''.format(error.Stacktrace)
Geral
Link do Painel de Casos Título: "urlscan.io Web Report + (Scan ID). Geral
Anexo do Painel de Casos Vai conter a captura de tela. Geral

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.