BlueLiv
Neste documento, descrevemos como integrar o BlueLiv ao Google Security Operations.
Guia de integração
O objetivo da integração é ingerir as ameaças do BlueLiv, usando os filtros relevantes para mostrar apenas as ameaças desejadas no Google Security Operations, usando o conector de ameaças, e, em seguida, realizar outras ações nessas ameaças de acordo com os casos de uso relevantes.
Neste guia rápido, vamos analisar algumas coisas para facilitar o uso da integração para os clientes do Google SecOps.
Configuração da integração
Vamos analisar os parâmetros e onde encontrá-los para facilitar a configuração da integração:
- Raiz da API: é o URL que você está usando para acessar a página inicial do BlueLiv, com o sufixo /api/v2 adicionado. Por exemplo:
https://tcdach.blueliv.com/api/v2precisa ser o valor desse parâmetro. - Nome de usuário: o mesmo que você usa para se conectar à página inicial do BlueLiv.
- Senha: a mesma senha usada para se conectar à página inicial do BlueLiv.
ID da organização: é fácil identificar o ID da organização no URL que você está usando para navegar no produto. Por exemplo:
Neste exemplo, o ID da organização é
117:https://tcdach.blueliv.com/dashboard/organizations/117/indexed
Depois de analisar os parâmetros de integração, podemos nos aprofundar nos outros termos da nossa integração.
Tipos de módulos
A BlueLiv dividiu a seção de ameaças em tipos de módulo. Nesta integração, usamos esses tipos para ajudar a plataforma SOAR e ingerir apenas as informações relevantes se você quiser filtrar por tipo de módulo. Os seguintes tipos de módulo estão disponíveis no BlueLiv:
- Credenciais
- Redes sociais
- Cartões de crédito
- Proteção de domínio
- Malware
- Vazamento de dados
- Hacktivismo
- Dark web
- Personalizado
- Rastreador de mídia
- Apps para dispositivos móveis
ID da ameaça e ID do módulo
https://tcdach.blueliv.com/dashboard/organizations/117/modules/1303/resource/31024379
Cada ameaça que você encontra no BlueLiv tem um UID, um número que a representa.
Esse também pode ser facilmente identificado no URL. Uma ameaça também é chamada de recurso. Por exemplo, aqui o UID da ameaça é 31024379.
Além disso, para cada módulo que você tem no BlueLiv, há um UID, um número que
o representa. Por exemplo, aqui o UID da ameaça é 1303.
Recomendação sobre configuração
A Blueliv só permite uma sessão aberta por vez. Recomendamos usar usuários diferentes para a configuração da integração e conectores para fins de estabilidade. Observação: cada conector precisa de um usuário separado.
Casos de uso
- Monitoramento proativo de ameaças cibernéticas
- Proteção da marca
- Proteção contra violação de dados
- Prevenção contra fraudes
- Detecção de falsificação
Configurar a integração do BlueLiv no Google SecOps
Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.
Parâmetros de integração
Use os seguintes parâmetros para configurar a integração:
| Nome de exibição do parâmetro | Tipo | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|---|
| Raiz da API | String | https://example |
Sim | Raiz da API da instância do BlueLiv. |
| Nome de usuário | String | N/A | Sim | Nome de usuário do BlueLiv. |
| Senha | Senha | N/A | Sim | Senha do usuário |
| ID da organização | String | N/A | Sim | Especifique o ID da organização a ser usado no BlueLiv |
| Verificar SSL | Caixa de seleção | Desmarcado | Sim | Se ativada, verifica se o certificado SSL para a conexão com o servidor do IronScales é válido. |
Ações
Ping
Descrição
Teste a conectividade com o BlueLiv usando os parâmetros fornecidos na página de configuração da integração no Google SecOps Content Hub.
Parâmetros
N/A
Corrida
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
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 as duas chamadas de API forem bem-sucedidas: "Conexão com o servidor do BlueLiv estabelecida com os parâmetros de conexão fornecidos!" A ação deve falhar e interromper a execução de um playbook: Se apenas a primeira chamada foi bem-sucedida e a segunda não funcionou: "O login com o nome de usuário e a senha foi bem-sucedido, mas parece que o ID da organização está incorreto. Verifique o parâmetro ID da organização na página de configuração da integração e tente de novo " Se não for concluída: "Falha ao se conectar ao BlueLiv! O erro é {0}".format(exception.stacktrace) |
Geral |
Enriquecer entidades
Descrição
Enriqueça entidades usando informações do módulo Threat Context da Blueliv. Entidades compatíveis: IP, hash, URL, agente de ameaça, campanha de ameaça, assinatura de ameaça, domínio, CVE.
Parâmetros
| Nome | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|
| Pontuação mais baixa para marcar como suspeito | 5 | Sim | Especifique qual deve ser a pontuação mais baixa para que a entidade seja marcada como suspeita. Máximo: 10. |
| Criar insight | Verdadeiro | Não | Se ativada, a ação vai criar insights com informações sobre entidades. |
Corrida
Essa ação é executada nas seguintes entidades:
- Endereço IP
- Hash
- URL
- Ator de ameaça
- Campanha contra ameaças
- Assinatura de ameaças
- CVE
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| sucesso | Verdadeiro/falso | success:False |
Painel de casos
| Caso | Sucesso | Falha | Mensagem |
|---|---|---|---|
| Se algumas entidades foram enriquecidas | verdadeiro | falso | As seguintes entidades foram enriquecidas com informações da Blueliv: {entity.identifier} |
| Se não for enriquecido, alguns | verdadeiro | falso | A ação não conseguiu enriquecer as seguintes entidades usando informações do Blueliv: {entity.identifier} |
| se não estiverem enriquecidos | falso | falso | Nenhuma entidade foi enriquecida com informações da Blueliv. |
| Erro fatal, credenciais inválidas, raiz da API | falso | verdadeiro | Erro ao executar a ação "Enriquecer entidades". Motivo: {error traceback} |
| Se o módulo "Contexto de ameaça" não estiver disponível | falso | Verdadeiro | Erro ao executar a ação "Enriquecer entidades". Motivo: sua instância não é compatível com o módulo "Contexto de ameaça". |
Adicionar comentário a uma ameaça
Descrição
A ação vai adicionar um comentário de texto a uma ameaça específica.
Parâmetros
| Nome de exibição do parâmetro | Tipo | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|---|
| Tipo de módulo | String | N/A | Sim | Especifique o tipo de módulo ao qual o recurso pertence. |
| ID do módulo | String | N/A | Sim | Especifique o ID do módulo ao qual o recurso pertence. |
| ID do recurso | String | N/A | Sim | Especifique o ID do recurso ao qual o comentário será adicionado. |
| Texto do comentário | String | N/A | Sim | Insira o comentário que você quer adicionar ao recurso. |
Corrida
Essa ação não é executada em entidades.
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Painel de casos
| Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
|---|---|---|
| Mensagem de saída* | A ação não pode falhar nem interromper a execução de um playbook: Se o processo for concluído: "O comentário foi adicionado ao ID da ameaça: "+{threat_ID} A ação deve falhar e interromper a execução de um playbook: Se não for bem-sucedido: "Falha ao realizar a ação 'Adicionar comentário a uma ameaça {0}".format(exception.stacktrace) |
Geral |
| Tabela do Painel de Casos | Nome: "ID da ameaça "+{threat_id}+" Comentários: Coluna:
|
Marcar ameaça como favorita
Descrição
A ação vai marcar a ameaça especificada como favorita no BlueLiv.
Parâmetros
| Nome de exibição do parâmetro | Tipo | Valor padrão | Valores de DDL | É obrigatório | Descrição |
|---|---|---|---|---|---|
| Tipo de módulo | String | N/A | Sim | Especifique o tipo de módulo ao qual o recurso pertence. | |
| ID do módulo | String | N/A | Sim | Especifique o ID do módulo ao qual o recurso pertence. | |
| ID do recurso | String | N/A | Sim | Especifique o ID do recurso ao qual o comentário será adicionado. | |
| Status de favorito | DDL | Com estrela do usuário | Sem estrela Com estrela do usuário Grupo com estrela Com estrela |
Sim | Informe o status de favorito que você quer aplicar à ameaça especificada. |
Corrida
Essa ação não é executada em entidades.
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Painel de casos
| Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
|---|---|---|
| Mensagem de saída* | A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido: "O ID da ameaça: "+{threat_ID}+" foi marcado como favorito" A ação deve falhar e interromper a execução de um playbook: Se não for bem-sucedido: "Falha ao realizar a ação "Marcar ameaça como favorita {0}".format(exception.stacktrace) |
Geral |
Adicionar rótulos a ameaças
Descrição
A ação vai adicionar o nome do rótulo especificado aos IDs de ameaça especificados.
Parâmetros
| Nome de exibição do parâmetro | Tipo | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|---|
| Tipo de módulo | String | N/A | Sim | Especifique o tipo de módulo ao qual o recurso pertence. |
| ID do módulo | String | N/A | Sim | Especifique o ID do módulo ao qual o recurso pertence. |
| ID do recurso | String | N/A | Sim | Especifique os IDs de recurso, em uma lista separada por vírgulas, para adicionar os rótulos. |
| Nomes de rótulos | String | N/A | Sim | Especifique os nomes dos rótulos que você quer aplicar às ameaças especificadas em uma lista separada por vírgulas. Preste atenção às letras maiúsculas e minúsculas. |
Corrida
Essa ação não é executada em entidades.
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Painel de casos
| Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
|---|---|---|
| Mensagem de saída* | A ação não pode falhar nem interromper a execução de um playbook: Se alguns rótulos não forem encontrados: "Não foi possível encontrar os seguintes rótulos no BlueLiv":+(unsuccessful_label names_list)+". Verifique os nomes dos rótulos fornecidos nos parâmetros de ação e tente novamente" Se algumas ameaças não forem encontradas: "Não foi possível encontrar as seguintes ameaças no BlueLiv":+(unsuccessful_threat_IDs)+". Verifique os IDs de ameaça fornecidos nos parâmetros de ação e tente de novo" Se tiver sido bem-sucedido: "Os seguintes rótulos foram adicionados:" +(successful_label_names_list)+" aos seguintes "IDs de ameaça: "+(successful_threat_IDs_list) A ação deve falhar e interromper a execução de um playbook: Se nenhum rótulo for encontrado: "Não foi possível encontrar nenhum dos seguintes rótulos no BlueLiv":+(unsuccessful_label names_list)+". Verifique os nomes dos rótulos fornecidos nos parâmetros de ação e tente de novo" Se nenhuma ameaça for encontrada: "Não foi possível encontrar nenhuma das seguintes ameaças no BlueLiv":+(unsuccessful_threat_IDs_list)+". Verifique os IDs de ameaça fornecidos nos parâmetros de ação e tente novamente" Se não for bem-sucedido: "Falha ao realizar a ação "Adicionar rótulos a ameaças".format(exception.stacktrace) |
Geral |
Remover rótulos de ameaças
Descrição
A ação vai remover os rótulos especificados dos IDs de ameaça especificados.
Parâmetros
| Nome | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|
| Tipo de módulo | N/A | Sim | Especifique o tipo de módulo ao qual o recurso pertence. |
| ID do módulo | Sim | Especifique o ID do módulo ao qual o recurso pertence | |
| ID do recurso | Sim | Especifique uma lista separada por vírgulas de IDs de recursos dos quais você quer remover rótulos. | |
| Nomes de rótulos | Sim | Especifique uma lista separada por vírgulas de rótulos que precisam ser removidos. Preste atenção às letras maiúsculas e minúsculas. |
Corrida
Essa ação não é executada em entidades.
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Painel de casos
| Caso | Sucesso | Falha | Mensagem |
|---|---|---|---|
| Se alguns rótulos não foram encontrados | verdadeiro | falso | "Não foi possível encontrar os seguintes rótulos no BlueLiv: \n {labels}. Verifique os nomes dos rótulos que você forneceu nos parâmetros de ação e tente de novo." |
| Se algumas ameaças não foram encontradas | verdadeiro | falso | Não foi possível encontrar as seguintes ameaças do módulo {module} {threat IDs}: {threat IDs}. Verifique os IDs de ameaça que você forneceu nos parâmetros de ação e tente de novo. |
| Se for bem-sucedido para alguns: | verdadeiro | falso | Os seguintes rótulos foram removidos da ameaça {threat ID} no Blueliv: {successful_labels} |
| Se algumas não tiverem sido aplicadas: | verdadeiro | falso | Os seguintes rótulos já não faziam parte da ameaça {threat ID} no Blueliv: {labels already not a part} |
| Se nenhum rótulo for encontrado | falso | verdadeiro | Erro ao executar a ação "Remover rótulos de ameaças". Motivo: nenhum dos rótulos foi encontrado. Verifique a ortografia. |
| Se nenhuma ameaça for encontrada | falso | verdadeiro | Erro ao executar a ação "Remover rótulos de ameaças". Motivo: nenhuma das ameaças foi encontrada. Verifique a ortografia. |
| Erro fatal, credenciais inválidas, raiz da API | falso | verdadeiro | Erro ao executar a ação "Remover rótulos de ameaças". Motivo: {error traceback} |
| Se o tipo ou ID do módulo não for válido | falso | verdadeiro | Erro ao executar a ação "Remover rótulos de ameaças". Motivo: o ID ou o tipo de módulo fornecido é inválido. |
Listar ameaças de entidade
Descrição
Lista ameaças relacionadas a entidades no Blueliv. Entidades compatíveis: todas.
Limitações conhecidas
A API Blueliv pode não retornar resultados, mesmo que a string corresponda de forma idêntica ao nome da ameaça. Veja um exemplo abaixo:
https://pastebin.com/YRkUCLGc: o URL é mostrado ao pesquisar usando a palavra-chave "pastebin".
https://pastebin.com/YRkUCLGc: não aparece ao pesquisar usando a palavra-chave "https://pastebin.com/YRkUCLGc".
Parâmetros
| Nome de exibição do parâmetro | Tipo | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|---|
| Filtro de rótulo | CSV | N/A | Não | Especifique uma lista de rótulos separados por vírgulas que serão usados para filtrar ameaças. Observação: o filtro de rótulos funciona com a lógica "OR". |
| Filtro de módulo | CSV | N/A | Não | Especifique uma lista separada por vírgulas de módulos que serão usados para filtrar ameaças. |
| Número máximo de ameaças a serem retornadas | Inteiro | 50 | Não | Especifique quantas ameaças retornar por entidade. Se nada for especificado, a ação vai retornar 50 ameaças. |
Corrida
Essa ação é executada em todas as entidades.
Resultados da ação
Resultado do script
| Nome do resultado do script | Opções de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Resultado do JSON
{
"id": xxxxxxx,
"module_id": xxxx,
"module_name": "Data Leakage",
"module_short_name": "xxx-xxxxx",
"module_type": "DATA_LEAKAGE",
"url": "xxx",
"content_type": "text/html",
"countries_id": "xx",
"analysis_result": "INFORMATIVE",
"analysis_calc_result": "INFORMATIVE",
"created_at": 1626163680000,
"checked_at": 1626163680000,
"changed_at": 1626163680000,
"user_rating": 0,
"read": true,
"fav": "NOT_STARRED",
"issued": false,
"labels": [
{
"id": 36116,
"name": "GithubCodeByFilename",
"background_color": 16777215,
"text_color": 0,
"type": "GLOBAL"
},
{
"id": 160,
"name": "Public",
"background_color": 45960,
"text_color": 16777215,
"type": "GLOBAL"
}
],
"tlpStatus": "AMBER",
"searchPhrase": "credit card",
"followedUp": false,
"history": []
},
Painel de casos
| Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
|---|---|---|
| Mensagem de saída* | A ação não pode falhar nem interromper a execução de um playbook: Se os dados estiverem disponíveis para um(is_success = true): "As ameaças disponíveis para as seguintes entidades no Blueliv foram listadas: {entity.identifier}". Se não houver ameaças para uma (is_success=true): "Nenhuma ameaça relacionada foi encontrada para as seguintes entidades no Blueliv: {entity.identifier}" Se não houver ameaças para uma (is_success=true): "No related threats were found to the provided entities in Blueliv" 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: "Erro ao executar a ação 'Listar ameaças de entidade'. Motivo: {0}''.format(error.Stacktrace) |
Geral |
| Tabela do painel de casos | Título: {entity.identifier} Nome do módulo URL Título Rótulos Criado em |
Entidade |
Conector
BlueLiv - Conector de ameaças
Descrição
Extraia ameaças de segurança do BlueLiv. O conector busca todas as ameaças mais recentes dos módulos do BlueLiv.
Os filtros de lista de permissões e de bloqueio funcionam com os tipos de módulo do BlueLiv. Por exemplo, se você quiser receber ameaças apenas de módulos de hacktivismo, ative a lista de permissões e digite o nome do tipo "Hacktivismo".
Para cada tipo de módulo, há uma estrutura diferente de dados sendo ingerida no Google SecOps. Modifique o mapeamento na sua instância do Google SecOps para atender melhor às suas necessidades. Confira os diferentes valores de "event_type" para cada evento que retorna do BlueLiv.
Para o tipo de ameaça Malware, no momento, fornecemos apenas os dados de eventos básicos. Em breve, vamos adicionar outro evento para lidar melhor com os dados especiais que vêm de um tipo de ameaça de malware.
Configurar o conector de ameaças do BlueLiv no Google SecOps
Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.
Parâmetros do conector
Use os seguintes parâmetros para configurar o conector:
| Nome de exibição do parâmetro | Tipo | Valor padrão | É obrigatório | Descrição |
|---|---|---|---|---|
| Nome do campo do produto | String | ProductName | Sim | Insira o nome do campo de origem para recuperar o nome do campo do produto. |
| Nome do campo do evento | String | event_type | Sim | Insira o nome do campo de origem para recuperar o nome do campo de evento. |
| Nome do campo do ambiente | String | "" | Não | Descreve o nome do campo em que o nome do ambiente é armazenado. Se o campo de ambiente não for encontrado, o ambiente será o padrão. |
| Padrão Regex do ambiente | String | .* | Não | Um padrão de regex para ser executado no valor encontrado no campo "Nome do campo de ambiente". O padrão é .* para capturar tudo e retornar o valor inalterado. Usado para permitir que o usuário manipule o campo de ambiente usando a lógica de regex. Se o padrão de regex for nulo ou vazio, ou se o valor do ambiente for nulo, o resultado final será o ambiente padrão. |
| Tempo limite de script (segundos) | Inteiro | 180 | Sim | Limite de tempo limite para o processo do Python que executa o script atual. |
| URL da API | String | https://example.blueliv.com/api/v2 | Sim | Raiz da API da instância do BlueLiv. |
| Nome de usuário | String | N/A | Sim | Nome de usuário do BlueLiv |
| Senha | Senha | N/A | Sim | Senha do usuário para o BlueLiv |
| ID da organização | String | N/A | Sim | Especifique o ID da organização a ser usado no BlueLiv |
| Buscar o máximo de horas anteriores | Inteiro | 1 | Não | Quantidade de horas de onde os eventos serão buscados. |
| Máximo de ameaças a serem buscadas | Inteiro | 10 | Não | Quantas ameaças devem ser processadas por iteração do conector. |
| Gravidade | String | Média | Sim | A gravidade será um dos seguintes valores: baixa, média, alta, crítica. |
| Resultados da análise para ingestão | String (valores: NOT_AVAILABLE, NOT_IMPORTANT, NOT_PROCESSABLE, POSITIVE, NEGATIVE, INFORMATIVE, IMPORTANT) | N/A | Não | Filtre as ameaças pela análise do analista para essa ameaça, ingerindo apenas ameaças com o resultado da análise escolhido. Forneça uma lista separada por vírgulas dos resultados de análise que você quer ingerir. |
| Rótulos para filtrar | String (lista separada por vírgulas) | N/A | Não | Forneça uma lista separada por vírgulas dos nomes dos rótulos que você quer usar para filtrar. Preste atenção às letras maiúsculas e minúsculas e escreva os rótulos exatamente como aparecem na interface do BlueLiv. |
| Status de leitura para ingestão | String (valores: "Only Read", "Only Unread") | N/A | Não | Filtre as ameaças pelo status de leitura para que o conector faça a ingestão de acordo com ele. Se nenhum valor for fornecido, vamos buscar os dois. Opções: "Somente lidas", "Somente não lidas". |
| A ingestão deve ser feita apenas para ameaças marcadas com estrela? | Caixa de seleção | Desmarcado | Não | Se marcada, somente as ameaças marcadas com estrela (favoritas) serão ingeridas |
| As ameaças relacionadas a incidentes devem ser ingeridas? | String (valores: Only Incidents, Only Non Incidents) | N/A | Não | Se o conector deve filtrar as ameaças verificando a relação com um incidente. Se nenhum valor for fornecido, vamos buscar ambos. As opções são: "Somente incidentes" (vai ingerir apenas ameaças relacionadas a incidentes) e "Somente não incidentes" (vai ingerir apenas ameaças que não estão relacionadas a incidentes). |
| Usar a lista de permissões como uma lista de bloqueio | Caixa de seleção | Desmarcado | Sim | Se ativada, a lista de permissões será usada como uma lista de bloqueio. |
| Verificar SSL | Caixa de seleção | Desmarcado | Sim | Se estiver ativado, verifique se o certificado SSL da conexão com o servidor do BlueLiv é válido. |
| Endereço do servidor proxy | String | N/A | Não | O endereço do servidor proxy a ser usado. |
| Nome de usuário do proxy | String | N/A | Não | O nome de usuário do proxy para autenticação. |
| Senha do proxy | Senha | N/A | Não | A senha do proxy para autenticação. |
Regras do conector
Suporte a proxy
O conector é compatível com proxy.
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.