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 é |
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.