Integrar o Zendesk ao Google SecOps

Neste documento, explicamos como integrar o Zendesk ao Google Security Operations.

Casos de uso

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

  • Automatizar a emissão de tíquetes de incidentes: crie automaticamente tíquetes do Zendesk com base em alertas de segurança para garantir que todos os incidentes sejam rastreados e atribuídos à equipe correta.

  • Simplifique a comunicação do analista: adicione comentários e notas internas aos tíquetes diretamente dos playbooks para manter as partes interessadas informadas sem sair da plataforma.

  • Padronize os fluxos de trabalho de resposta: aplique macros do Zendesk aos tíquetes para automatizar ações repetitivas e garantir o tratamento consistente de problemas de segurança comuns.

  • Acompanhar a resolução de tíquetes: recupere periodicamente os detalhes do tíquete e as atualizações de status para sincronizar o ciclo de vida do incidente nas duas plataformas.

  • Pesquisar contexto histórico: consulte os tíquetes atuais por palavra-chave para encontrar incidentes históricos relacionados e acelerar as investigações em andamento.

Antes de começar

Antes de configurar a integração no Google SecOps, verifique os seguintes requisitos no ambiente do Zendesk:

  • Token da API: um administrador precisa gerar um token da API válido para autenticar a conexão. Para instruções detalhadas, consulte Como gerenciar o acesso do token de API à API Zendesk.

  • Permissões da conta: verifique se a conta usada para gerar o token de API tem permissões suficientes para criar e atualizar tíquetes nos grupos de destino. A API herda as permissões do usuário autenticado. Isso significa que um token de API gerado por um administrador é limitado pelas permissões do papel atribuído a ele.

  • Acesso por token: ative o acesso por token nas configurações da API Zendesk para permitir que a integração se comunique com a API Zendesk.

Parâmetros de integração

A integração do Zendesk requer os seguintes parâmetros:

Parâmetro Descrição
Server Address

Obrigatório.

O URL da sua instância do Zendesk.

O valor padrão é https://{subdomain}.zendesk.com.

User Email Address

Obrigatório.

O endereço de e-mail da conta de usuário do Zendesk usada para autenticar a conexão.

Api Token

Obrigatório.

O token de API exclusivo gerado nas configurações de administrador do Zendesk.

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.

Adicionar comentário ao tíquete

Adicionar um comentário a um tíquete atual.

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A Número do tíquete.
Corpo do comentário String N/A N/A
Nome do autor String N/A N/A
Observação interna Booleano N/A N/A

Casos de uso

N/A

Corrida

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
N/A

Aplicar macros ao tíquete

Aplicar uma macro a um tíquete.

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A Número do tíquete.
Título da macro String N/A N/A

Casos de uso

N/A

Corrida

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_applied Verdadeiro/falso is_applied:False
Resultado do JSON
N/A

Criar tíquete

Crie um tíquete com propriedades específicas.

Limitações conhecidas

A API do Zendesk não aceita e-mails com caracteres Unicode. Isso afeta o parâmetro "Email CC". A ação vai ignorá-los

Parâmetros

Parâmetro Tipo Valor padrão Descrição
Assunto String N/A N/A
Descrição String N/A N/A
Usuário atribuído String N/A Nome completo do usuário.
Grupo de atribuição String N/A Nome do grupo.
Prioridade String N/A A prioridade será uma das seguintes: urgente, alta, normal ou baixa.
Tipo de bilhete String N/A A prioridade será uma das seguintes: urgente, alta, normal ou baixa.
Tag String N/A N/A
Observação interna Caixa de seleção Desmarcado Especifique se o comentário deve ser público ou interno. Se a caixa estiver desmarcada, o app será público. Se estiver marcada, ele será apenas interno.
E-mails em cópia CSV N/A Especifique uma lista separada por vírgulas de endereços de e-mail que também devem receber a notificação de criação do tíquete. Observação: é possível adicionar no máximo 48 e-mails em cópia. Essa é uma limitação do Zendesk.
Validar CCs de e-mail Booleano Selecionado Se ativada, a ação vai tentar verificar se os usuários com os e-mails fornecidos no parâmetro "CCs de e-mail" existem. Se pelo menos um usuário não existir, a ação vai falhar. Se esse parâmetro estiver desativado, a ação não vai realizar essa verificação.

Casos de uso

N/A

Corrida

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
ticket_id N/A N/A
Resultado do JSON
N/A
Painel de casos
Tipo de resultado Valor/descrição Tipo
Mensagem de saída*

Se a opção "Validar CCs de e-mail" estiver ativada e pelo menos um e-mail não for encontrado (falha): erro ao executar a ação "{nome da ação}". Motivo: os usuários com os seguintes e-mails não foram encontrados: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validar CCs de e-mail".

Se pelo menos uma entrada não for um endereço de e-mail válido: Erro ao executar a ação "{action name}". Motivo: os usuários com os seguintes e-mails não foram encontrados: {entity.identifier}. Verifique a ortografia ou desative o parâmetro "Validar CCs de e-mail".

Geral

Ver detalhes do tíquete

Receba detalhes, comentários e anexos do tíquete pelo ID dele.

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A O ID do tíquete.

Casos de uso

N/A

Corrida

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
ticket_details N/A N/A
Resultado do JSON
{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

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

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

Pesquisar ingressos

Pesquise tíquetes por palavra-chave.

Parâmetros

Parâmetros Tipo Valor padrão Descrição
Consulta de pesquisa String N/A Conteúdo da consulta (exemplo: type:ticket status:pending).

Casos de uso

N/A

Corrida

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
results_count N/A N/A
Resultado do JSON
N/A

Atualizar tíquete

Atualizar detalhes do tíquete

Parâmetros

Parâmetro Tipo Valor padrão Descrição
ID do tíquete String N/A Número do tíquete.
Assunto String N/A O assunto do tíquete.
Usuário atribuído String N/A Nome completo do usuário.
Grupo de atribuição String N/A Nome do grupo.
Prioridade String N/A A prioridade será uma das seguintes: urgente, alta, normal ou baixa.
Tipo de bilhete String N/A O tipo de tíquete será um dos seguintes: problema, incidente, pergunta ou tarefa.
Tag String N/A Tag a ser adicionada ao tíquete.
Status String N/A O status será um dos seguintes: novo, aberto, pendente, em espera, resolvido ou fechado.
Outros comentários String N/A Se você quiser adicionar um comentário ao tíquete, especifique o texto que quer adicionar como comentário aqui.
Observação interna Caixa de seleção Desmarcado Especifique se o comentário deve ser público ou interno. Se a caixa estiver desmarcada, o app será público. Se estiver marcada, ele será apenas interno.

Casos de uso

N/A

Corrida

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_updated Verdadeiro/falso is_updated:False
Resultado do JSON
N/A

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