X-Force
Versão da integração: 14.0
Configurar o X-Force para trabalhar com o Google Security Operations
Para conseguir sua chave de API pessoal, faça login no site do IBM X-Force Exchange com um ID IBM ativo.
Confira seu perfil de usuário no canto superior direito da tela e acesse a página Configurações abaixo para criar um novo par de senha/chave de API.
Na página "Configurações", clique em Acesso à API e depois no botão Gerar na seção "Geração de chave de API".
Configurar a integração do X-Force no Google SecOps
Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.
Ações
Receber informações de hash
Descrição
Consulta o X-Force para informações de hash.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Limite | string | N/A | O valor do limite pode ser: baixo, médio ou alto. |
Casos de uso
N/A
Executar em
Essa ação é executada na entidade "Filehash".
Resultados da ação
Enriquecimento de entidades
| Nome do campo de enriquecimento | Lógica: quando aplicar |
|---|---|
| malware | Retorna se ele existe no resultado JSON |
| tags | Retorna se ele existe no resultado JSON |
Insights
Se a pontuação de risco da entidade exceder o limite, o insight será adicionado para avisar que o hash está marcado como malware.
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| is_risk | Verdadeiro/Falso | is_risk:False |
Resultado do JSON
[
{
"EntityResult":
{
"malware":
{
"hash": "0x474B9CCF5AB9D72CA8A333889BBB34F0",
"family": ["tsunami"],
"origins":
{
"downloadServers": {},
"subjects": {},
"CnCServers":
{
"count": 1,
"rows":
[{
"count": 483,
"origin": "CnC",
"domain": "pc-guard.net",
"filepath": "v.html",
"ip": "1.1.1.1",
"uri": "http://pc-guard.net/v.html",
"lastseen": "2014-10-20T23:19:00Z",
"md5": "474B9CCF5AB9D72CA8A333889BBB34F",
"type": "CnC",
"firstseen": "2014-10-20T23:19:00Z",
"schema": "http"
}]},
"emails": {},
"external":
{
"detectionCoverage": 46,
"family": ["heuristic", "trojan"]
}},
"created": "2014-10-20T23:19:00Z",
"familyMembers":
{
"tsunami":
{
"count": 61
}},
"md5": "0x474B9CCF5AB9D72CA8A333889BBB34F0",
"type": "md5",
"risk": "high"
},
"tags": []
},
"Entity": "474B9CCF5AB9D72CA8A333889BBB34F0"
}
]
Receber IP por categoria
Descrição
Receba o IP por categoria.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Categoria | string | N/A | Categoria do IP. |
Casos de uso
N/A
Executar em
Essa ação é executada em todas as 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
[
{
"ip": "string",
"score": "integer",
"created": "string"
}
]
Receber informações de IP
Descrição
Consulte o X-Force para informações de IP.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Limite | string | N/A | O limite precisa ser um número inteiro (exemplo: 3). |
Casos de uso
N/A
Executar em
Essa ação é executada na entidade "Endereço IP".
Resultados da ação
Enriquecimento de entidades
As entidades são marcadas como suspeitas se excederem o limite. Caso contrário, "false".
| Nome do campo de enriquecimento | Lógica: quando aplicar |
|---|---|
| subnets | Retorna se ele existe no resultado JSON |
| reasonDescription | Retorna se ele existe no resultado JSON |
| tags | Retorna se ele existe no resultado JSON |
| ip | Retorna se ele existe no resultado JSON |
| reason | Retorna se ele existe no resultado JSON |
| score | Retorna se ele existe no resultado JSON |
| categoryDescriptions | Retorna se ele existe no resultado JSON |
| gatos | Retorna se ele existe no resultado JSON |
| geo | Retorna se ele existe no resultado JSON |
| histórico | Retorna se ele existe no resultado JSON |
Insights
Se a pontuação de risco exceder o limite, adicione o insight e marque-o como suspeito.
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| is_risky | Verdadeiro/Falso | is_risky:False |
Resultado do JSON
[
{
"EntityResult":
{
"subnets":
[{
"subnet": "1.1.1.1/14",
"reasonDescription": "One of the five RIRs announced a (new) location mapping of the IP.",
"created": "2017-10-18T06:23:00.000Z",
"ip": "1.1.1.1",
"asns":
{
"8359":
{
"Company": "MTS, RU",
"cidr": 14
}},
"reason": "Regional Internet Registry",
"score": 1,
"categoryDescriptions": {},
"cats": {},
"geo":
{
"country": "Russia",
"countrycode": "RU"
}}, {
"subnet": "1.1.1.1/20",
"reasonDescription": "Based on statistical DNS analysis.",
"created": "2014-01-22T19:56:00.000Z",
"ip": "1.1.1.1",
"reason": "DNS heuristics",
"score": 1,
"categoryDescriptions":
{
"Dynamic IPs": "This category contains IP addresses of dialup hosts and DSL lines."
},
"cats":
{
"Dynamic IPs": 71
}}],
"reasonDescription": "One of the five RIRs announced a (new) location mapping of the IP.",
"tags": [],
"ip": "1.1.1.1",
"reason": "Regional Internet Registry",
"score": 1,
"categoryDescriptions":
{
"Dynamic IPs": "This category contains IP addresses of dialup hosts and DSL lines."
},
"cats":
{
"Dynamic IPs": 71
},
"geo":
{
"country": "Russia",
"countrycode": "RU"
},
"history":
[{
"reasonDescription": "One of the five RIRs announced a (new) location mapping of the IP.",
"created": "2012-03-22T07:26:00.000Z",
"ip": "1.1.1.1/14",
"reason": "Regional Internet Registry",
"score": 1,
"categoryDescriptions": {},
"cats": {},
"geo":
{
"country": "Russia",
"countrycode": "RU"
}}, {
"reasonDescription": "Based on statistical DNS analysis.",
"created": "2012-04-13T13:34:00.000Z",
"ip": "1.1.1.1/14",
"reason": "DNS heuristics",
"score": 1,
"categoryDescriptions":
{
"Dynamic IPs": "This category contains IP addresses of dialup hosts and DSL lines."
},
"cats":
{
"Dynamic IPs": 100
},
"geo":
{
"country": "Russia",
"countrycode": "RU"
}}, {
"reasonDescription": "Based on statistical DNS analysis.",
"created": "2014-01-22T19:56:00.000Z",
"ip": "1.1.1.1/20",
"reason": "DNS heuristics",
"score": 1,
"categoryDescriptions":
{
"Dynamic IPs\": "This category contains IP addresses of dialup hosts and DSL lines."
},
"cats":
{
"Dynamic IPs": 71
},
"geo":
{
"country": "Russia",
"countrycode": "RU"
}}]},
"Entity": "1.1.1.1"
}
]
Receber malware de IP
Descrição
Consulte o X-Force para saber o malware associado a um endereço IP.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Limite | string | N/A | O limite precisa ser um número inteiro (exemplo: 3). |
Casos de uso
N/A
Executar em
Essa ação é executada na entidade "Endereço IP".
Resultados da ação
Enriquecimento de entidades
As entidades são marcadas como suspeitas se "malware_count" for maior que 0.
| Nome do campo de enriquecimento | Lógica: quando aplicar |
|---|---|
| malware | Retorna se ele existe no resultado JSON |
Insights
Adicione um insight de aviso de que a entidade foi associada a malware e marque-a como suspeita se malware_count > 0.
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| is_malware | Verdadeiro/Falso | is_malware:False |
Resultado do JSON
[
{
"EntityResult":
{
"malware":
[{
"count": 13,
"origin": "CnC",
"domain": "l33t-milf.info",
"last": "2016-10-29T06:31:00Z",
"family": ["kasidet"],
"filepath": "dom/tasks.php",
"ip": "0x00000000000000000000ffff08080808",
"uri": "http://example.com/dom/tasks.php",
"first": "2016-10-29T06:31:00Z",
"host": "dom",
"lastseen": "2016-10-29T06:31:00Z",
"md5": "4C10F74CE20328B7CC4207245BC9D725",
"type": "CnC",
"firstseen": "2016-10-29T06:31:00Z",
"schema": "http"
}]},
"Entity": "1.1.1.1"
}
]
Receber informações do URL
Descrição
Consulte o X-Force para informações de URL.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Limite | string | N/A | O limite precisa ser um número inteiro(por exemplo, 3). |
Casos de uso
N/A
Executar em
Essa ação é executada na entidade de URL.
Resultados da ação
Enriquecimento de entidades
As entidades são marcadas como suspeitas se excederem o limite. Caso contrário, "false".
| Nome do campo de enriquecimento | Lógica: quando aplicar |
|---|---|
| associadas | Retorna se ele existe no resultado JSON |
| result | Retorna se ele existe no resultado JSON |
| tags | Retorna se ele existe no resultado JSON |
Insights
Adicione um insight de aviso e marque-o como suspeito se a pontuação de risco exceder o limite.
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| is_risk | Verdadeiro/Falso | is_risk:False |
Resultado do JSON
[
{
"EntityResult":
{
"associated":
[{
"url": "markossolomon.com",
"cats": {},
"score": null,
"categoryDescriptions": {}
}],
"result":
{
"url": "markossolomon.com/f1q7qx.php",
"cats":
{
"Botnet Command and Control Server": true
},
"score": 10,
"categoryDescriptions":
{
"Botnet Command and Control Server": "This category contains Web sites or domains that host a botnet command and control server."
}},
"tags": []
},
"Entity": "HTTP://MARKOSSOLOMON.COM/F1Q7QX.PHP"
}
]
Ping
Descrição
Teste a conectividade com o X-Force.
Parâmetros
N/A
Casos de uso
N/A
Executar em
Essa ação é executada em todas as 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_connected | Verdadeiro/Falso | is_connected:False |
Resultado do JSON
N/A
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.