Criar seu primeiro playbook
Neste documento, explicamos como criar seu primeiro playbook usando as ações que você criou em Criar ações personalizadas.
O playbook que você vai criar é para um caso de uso básico de phishing e automatiza as seguintes etapas:
- Extrair detalhes do domínio: o playbook extrai o domínio de um URL encontrado em um alerta.
- Enriquecer o domínio: em seguida, ele enriquece a entidade com mais informações.
- Adicionar um insight: o playbook adiciona um insight com o país do domínio.
- Verificar uma lista personalizada: verifica se o país está em uma lista personalizada.
- Use uma condição IF: uma condição IF é usada para determinar se o caso requer mais investigação com base no fato de o país estar na lista personalizada.
Ativar ações no designer de playbook
Para garantir que as ações personalizadas criadas estejam ativadas no ambiente de desenvolvimento integrado (IDE), clique no botão Ativar para a posição ativada. Depois de ativadas, essas ações ficam disponíveis no designer de playbook.
Criar uma lista personalizada de países da OCDE
Para determinar se o país de um domínio requer mais investigação, você precisa criar uma lista personalizada de países da Organização para a Cooperação e Desenvolvimento Econômico (OCDE). Em seguida, use essa lista no playbook para verificar o país do domínio.
Para criar uma lista personalizada de países da OCDE, siga estas etapas:
- Acesse Configurações > Gerenciamento de acesso > Ambientes.
- Clique em Listas personalizadas.
- Na seção Listas personalizadas, clique em add Adicionar.
- Na caixa de diálogo Adicionar lista personalizada, insira um Identificador de entidade, uma Categoria e um Ambiente.
- Clique em Adicionar.
Criar um playbook de automação
Para criar um playbook de automação, siga estas etapas:
- Acesse o Designer de playbook e clique em Adicionar.
- Na caixa de diálogo Criar novo, selecione o botão de opção Playbook.
- Escolha uma pasta e um ambiente para o playbook.
- Insira um nome para o playbook (ao lado do botão de ativação) para começar a personalizá-lo.
Importar um playbook pronto
Para importar um playbook predefinido, siga estas etapas:
- No Designer de playbook, clique em Lista > Importar.
Criar meu primeiro playbook de automação - Todo playbook começa com um gatilho. Para definir o acionador deste playbook, arraste o acionador Todos do menu Acionadores para a primeira etapa do playbook. Isso faz com que o playbook seja ativado em todos os alertas ingeridos no Google Security Operations.
Criar um playbook
Para criar um playbook usando as ações da integração "API XML WHOIS", siga estas etapas:
- Na guia Ações, clique na lista API XML do WHOIS. Suas ações personalizadas vão aparecer abaixo do nome da integração. Se não estiverem visíveis, confirme se estão ativadas e salvas no módulo do ambiente de desenvolvimento integrado.
- Arraste a ação Get Domain Details para o playbook, colocando-a logo após o acionador.
Personalizar a ação
É possível personalizar a ação para que ela seja executada em um escopo específico. Neste exemplo, execute a ação em todas as entidades que são URLs. No campo de nome de domínio, use o marcador de posição Entity.Identifier.
Para fazer essas personalizações, siga estas etapas:
- Insira o marcador de posição: clique em Marcador de posição e procure
Entity.Identifierna barra de pesquisa. Essa ação se conecta ao site "WHOIS", extrai os detalhes do domínio e os apresenta no formato JSON. - Defina o escopo. A ação se conecta ao site "WHOIS", extrai detalhes do domínio e os apresenta no formato JSON.
- Verifique a disponibilidade. O parâmetro Check Availability que você definiu para a ação verifica se o domínio está disponível ou não.
- Depois de adicionar a ação Get Domain Details, arraste a ação Enrich Entities para o playbook. Personalize-a para ser executada em todos os URLs. Como você projetou essa ação para operar em um escopo de entidade específico, não é necessário definir o campo Nome de domínio, como fez com a ação anterior.
Adicionar a ação Entity Insight
Adicione a ação Adicionar insight de entidade, que faz parte da integração do Google SecOps:
- Defina o escopo. Para o escopo Entidade, selecione Todos os URLs, como você fez nas ações anteriores do playbook.
- Extraia o campo JSON. No campo Insight, abra o Criador de expressões do Google SecOps para extrair o campo de país do resultado JSON.
- Abra o criador de expressões para a saída JSON: clique no ícone de marcador de posição (
data_array), escolha a lista de playbook e selecioneWHOIS XML API_Get Domain Details_1.JsonResult. Isso abre o criador de expressões para a saída JSON.
Extrair o campo de país do JSON
A amostra JSON no criador de expressões é a mesma que você inseriu no ambiente de desenvolvimento integrado para Criar sua ação personalizada. Para extrair o campo "País", siga estas etapas:
- Clique em País no JSON.
- Clique em arrow_right Executar para testar o marcador de posição e conferir o resultado no campo Resultados.
Criar uma entidade
Para executar a ação Está na lista personalizada, é necessário criar uma nova entidade do país relacionado ao domínio. Para isso, siga estas etapas:
- Em Integração do Google SecOps, arraste a ação Criar entidade para o playbook.
- Configure a ação para ser executada em Todos os URLs.
- Use o criador de expressões para inserir o marcador de posição
countryno campo Identificadores de entidade. Em Tipo de entidade, escolha Entidade genérica e clique em Salvar. - Adicione a ação Está na lista personalizada:
- Arraste a ação para o playbook.
- Configure-o para ser executado em todas as entidades genéricas (a entidade que você acabou de criar).
- Em Categoria, adicione a categoria que você configurou para sua lista personalizada de países da OCDE.
- Adicione a condição IF ao playbook para determinar se o país do domínio requer mais investigação. A primeira ramificação verifica se o resultado do script para Está na lista personalizada retornou um resultado falso, e a ramificação Else vai para o resultado oposto.
- Adicione a ação Condição IF ao seu playbook. Duas ramificações vão aparecer.
- Personalize a primeira ramificação. A primeira ramificação será executada se a ação Está na lista personalizada retornar um resultado falso. Isso significa que o país do domínio não está na sua lista personalizada de países da OCDE e requer mais investigação.
- Para a primeira ação nessa ramificação, arraste uma ação Tag de caso da integração do Google SecOps.
Atribuir o caso a um nível superior
Atribua o caso a um nível mais alto para investigar mais a fundo. Para isso, siga estas etapas:
- Arraste a ação Assign Case para o playbook.
- Escolha @Tier2 como o Usuário atribuído.
Mudar a prioridade
Mude a prioridade para Alta usando a ação Alterar prioridade do Google SecOps > clique em Salvar.
Personalizar a ramificação Else
Depois de concluir a primeira ramificação, você pode personalizar a ramificação Else. Essa ramificação lida com casos em que o país do domínio é um país da OCDE, que você decidiu que não precisa de mais investigação. Para configurar a ramificação Else, siga estas etapas:
- Adicione uma tag de caso, como você fez na primeira ramificação, com o rótulo In OECD countries.
- Adicione uma ação Fechar caso a essa ramificação. Como o encerramento de um caso é uma ação sensível, configure-o para ser executado manualmente. Na seção Configurações da ação, selecione o modo Manual.
- Na seção Parâmetros da ação Fechar caso, adicione o Motivo, a Causa raiz e o Comentário.
- Clique em Salvar para salvar o playbook com os parâmetros adicionados.
Ver a execução do playbook
Para ver sua automação personalizada em ação, siga estas etapas:
- Em Casos, clique em add Adicionar > Simular casos.
- Selecione o caso E-mail de phishing > clique em Criar.
- Selecione o Ambiente > clique em Simular para simular a execução do playbook.
- Confira o playbook em execução no alerta e os resultados de cada ação nele.
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.