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 |
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:
|
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:
A ação deve falhar e interromper a execução de um playbook:
|
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.