Integre o Siemplify com o Google SecOps

Este documento explica como integrar o Siemplify com o Google Security Operations (Google SecOps).

Versão da integração: 94.0

Exemplos de utilização

A integração do Siemplify pode resolver os seguintes exemplos de utilização:

• Investigação de phishing: use as capacidades do Google SecOps para automatizar o processo de análise de emails de phishing, extrair indicadores de comprometimento (IOCs) e enriquecê-los com informações sobre ameaças.

• Contenção de software malicioso: use as capacidades do Google SecOps para isolar automaticamente os endpoints infetados, iniciar análises e colocar em quarentena ficheiros maliciosos após a deteção de software malicioso.

• Gestão de vulnerabilidades: use as capacidades do Google SecOps para orquestrar análises de vulnerabilidades, dar prioridade às vulnerabilidades com base no risco e criar automaticamente pedidos de correção.

• Procura de ameaças: use as capacidades do Google SecOps para automatizar a execução de consultas de procura de ameaças em várias ferramentas de segurança e conjuntos de dados.

• Triagem de alertas de segurança: use as capacidades do Google SecOps para enriquecer automaticamente os alertas de segurança com informações contextuais, correlacioná-los com outros eventos e dar-lhes prioridade com base na gravidade.

• Resposta a incidentes: use as capacidades do Google SecOps para orquestrar todo o processo de resposta a incidentes, desde a deteção inicial à contenção e erradicação.

• Relatórios de conformidade: use as capacidades do Google SecOps para automatizar a recolha e a análise de dados de segurança para relatórios de conformidade.

Parâmetros de integração

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

Parâmetro	Descrição
Monitors Mail Recipients	Obrigatório. Uma lista de endereços de email separados por vírgulas a validar. O valor predefinido é [e-mail],[e-mail].
Elastic Server Address	Obrigatório. O endereço do servidor elástico. O valor predefinido é localhost.

Para obter instruções sobre como configurar uma integração no Google SecOps, consulte o artigo Configurar integrações.

Se necessário, pode fazer alterações numa fase posterior. Depois de configurar uma instância de integração, pode usá-la em manuais de soluções. Para mais informações sobre como configurar e suportar várias instâncias, consulte o artigo Suporte de várias instâncias.

Ações

Para mais informações sobre ações, consulte os artigos Responda a ações pendentes da sua mesa de trabalho e Execute uma ação manual.

Adicione estatísticas de entidades

Use a ação Adicionar estatísticas de entidades para adicionar estatísticas à entidade do Google SecOps segmentada no Siemplify.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Add Entity Insight requer os seguintes parâmetros:

Parâmetro	Descrição
Message	Obrigatório. A mensagem a adicionar à entidade. Este parâmetro suporta elementos HTML, como títulos (<h1></h1>, <h2></h2>), parágrafos (<p></p>), formatação de texto (<b></b>, <i></i>, <br>) e links (<a href="example.com"></a>).

Resultados da ação

A ação Adicionar estatísticas de entidades fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Entity Insight pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Added insight with message MESSAGE to ENTITY_ID.	A ação foi bem-sucedida.
Error executing action "Add Entity Insight". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte apresenta o valor da saída do resultado do script quando usa a ação Add Entity Insight:

Nome do resultado do script	Valor
is_success	true ou false

Adicione estatísticas gerais

Use a ação Adicionar estatística geral para adicionar uma estatística geral ao registo.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Adicionar estatística geral requer os seguintes parâmetros:

Parâmetro	Descrição
Title	Obrigatório. O título da estatística.
Message	Obrigatório. A mensagem a adicionar à entidade. Este parâmetro suporta elementos HTML, como títulos (<h1></h1>, <h2></h2>), parágrafos (<p></p>), formatação de texto (<b></b>, <i></i>, <br>) e links (<a href="example.com"></a>).
Triggered By	Opcional. Uma justificação para a estatística.

Resultados da ação

A ação Adicionar estatística geral fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add General Insight pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Added insight with message MESSAGE.	A ação foi bem-sucedida.
Error executing action "Add General Insight". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte apresenta o valor da saída do resultado do script quando usa a ação Add General Insight:

Nome do resultado do script	Valor
is_success	true ou false

Adicione etiquetas a casos semelhantes

Use a ação Adicionar etiquetas a registos semelhantes para adicionar etiquetas a registos semelhantes.

Para encontrar casos semelhantes, a ação usa a função siemplify.get_similar_cases() com os parâmetros obtidos que devolvem uma lista de IDs de registos.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Adicionar etiquetas a registos semelhantes requer os seguintes parâmetros:

Parâmetro	Descrição
Rule Generator	Opcional. Se selecionada, a ação procura casos semelhantes através do gerador de regras. Selecionado por predefinição.
Port	Opcional. Se estiver selecionada, a ação procura casos semelhantes através de números de portas. Selecionado por predefinição.
Category Outcome	Opcional. Se selecionada, a ação procura casos semelhantes através do resultado da categoria. Selecionado por predefinição.
Entity Identifier	Opcional. Se estiver selecionada, a ação procura registos semelhantes através do identificador da entidade. Selecionado por predefinição.
Days Back	Obrigatório. O número de dias a considerar ao pesquisar casos semelhantes.
Tags	Obrigatório. Uma lista de etiquetas separadas por vírgulas a adicionar a registos semelhantes.

Nota: a ação Adicionar etiquetas a registos semelhantes aplica o operador lógico AND aos parâmetros Rule Generator, Port, Category Outcome e Entity Identifier para os usar na mesma pesquisa.

Resultados da ação

A ação Adicionar etiquetas a registos semelhantes fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Adicionar etiquetas a registos semelhantes pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Found NUMBER_OF_CASES similar cases. Successfully added tags: TAG to cases CASE_ID	A ação foi bem-sucedida.
Error executing action "Add Tags To Similar Cases". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Adicionar etiquetas a registos semelhantes:

Nome do resultado do script	Valor
SimilarCasesIds	Uma lista de IDs de registos semelhantes.

Adicionar à lista personalizada

Use a ação Adicionar à lista personalizada para adicionar um identificador de entidade a uma lista personalizada categorizada e fazer comparações futuras noutras ações.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Adicionar à lista personalizada requer os seguintes parâmetros:

Parâmetro	Descrição
Category	Obrigatório. Uma lista personalizada de categorias a usar.

Resultados da ação

A ação Adicionar à lista personalizada fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Adicionar à lista personalizada pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The alert's entities ENTITY_ID were added to custom list category: CATEGORY.	A ação foi bem-sucedida.
Error executing action "Add to Custom List". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Adicionar à lista de clientes:

Nome do resultado do script	Valor
is_success	true ou false

Atribuir registo

Use a ação Atribuir registo para atribuir um registo a um utilizador ou a um grupo de utilizadores específico.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Assign Case requer os seguintes parâmetros:

Parâmetro	Descrição
Assigned User	Obrigatório. Um utilizador ou um grupo de utilizadores ao qual atribuir um registo.

Resultados da ação

A ação Assign Case (Atribuir registo) fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Adicionar à lista personalizada pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case was successfully assigned to ASSIGNED_USER.	A ação foi bem-sucedida.
Error executing action "Assign Case". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Assign Case:

Nome do resultado do script	Valor
is_success	true ou false

Anexe um guia interativo ao alerta

Use a ação Anexar guia interativo ao alerta para anexar um guia interativo específico a um alerta.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Anexar guia interativo ao alerta requer os seguintes parâmetros:

Parâmetro	Descrição
Playbook Name	Obrigatório. O nome do manual de estratégias a anexar ao alerta atual.

Resultados da ação

A ação Anexar guia interativo ao alerta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Search Graphs pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully attached the PLAYBOOK_NAME playbook to the alert CURRENT_ALERT_NAME.	A ação foi bem-sucedida.
Error executing action "Attach Playbook to Alert". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Anexar manual de soluções ao alerta:

Nome do resultado do script	Valor
Resultado do script	true ou false

Comentário do registo

Use a ação Comentário do registo para adicionar um comentário ao registo no qual o alerta atual está agrupado.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Case Comment requer os seguintes parâmetros:

Parâmetro	Descrição
Comment	Obrigatório. O comentário a adicionar ao registo.

Resultados da ação

A ação Case Comment fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Comment added to case: CASE_COMMENT.	A ação foi bem-sucedida.
Error executing action "Case Comment". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Case Comment:

Nome do resultado do script	Valor
SuccessStatus	true ou false

Etiqueta do registo

Use a ação Etiqueta de registo para adicionar uma etiqueta ao registo no qual o alerta atual está agrupado.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Etiqueta de registo requer os seguintes parâmetros:

Parâmetro	Descrição
Tag	Obrigatório. Uma etiqueta a adicionar à capa.

Resultados da ação

A ação Etiqueta de registo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Case Tag pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The tag TAG_ID was added to the case	A ação foi bem-sucedida.
Error executing action "Add Vote To Entity". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Etiqueta de distinção entre maiúsculas e minúsculas:

Nome do resultado do script	Valor
is_success	true ou false

Alteração da prioridade do alerta

Use a ação Alterar prioridade do alerta para atualizar a prioridade de um alerta num registo.

Esta ação é executada em todas as entidades do Google SecOps.

Nota: no Google SecOps, a prioridade de alerta mais elevada determina a prioridade do registo por predefinição.

Por exemplo, se a prioridade do registo for Medium, significa que, pelo menos, um alerta entre todos os alertas agrupados no registo tem uma prioridade Medium, enquanto outros têm prioridades mais baixas, como Low ou Informative.

Se atualizar a prioridade do registo para Low, o Google SecOps substitui a prioridade do registo por Low.

Se atualizar a prioridade de um alerta de registo para High, o Google SecOps define automaticamente a prioridade do registo como High.

Dados de ações

A ação Alterar prioridade do alerta requer os seguintes parâmetros:

Parâmetro	Descrição
Alert Priority	Obrigatório. A nova prioridade do alerta. Os valores possíveis são os seguintes: Informative Low Medium High Critical

Resultados da ação

A ação Alterar prioridade do alerta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The alert priority was set to NEW_PRIORITY_LEVEL.	A ação foi bem-sucedida.
Error executing action "Change Alert Priority". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Alterar prioridade do alerta:

Nome do resultado do script	Valor
Resultado do script	true ou false

Altere a fase do registo

Use a ação Alterar fase de maiúsculas/minúsculas para alterar a fase de maiúsculas/minúsculas.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Alterar fase do registo requer os seguintes parâmetros:

Parâmetro	Descrição
Stage	Obrigatório. A fase para a qual quer mover o registo. Os valores possíveis são os seguintes: Triage Assessment Investigation Incident Improvement Research

Resultados da ação

A ação Change Case Stage fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Case stage was successfully changed to CASE_STAGE.	A ação foi bem-sucedida.
Error executing action "Change Case Stage". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte apresenta o valor da saída do resultado do script quando usa a ação Alterar fase de maiúsculas/minúsculas:

Nome do resultado do script	Valor
Resultado do script	true ou false

Alterar prioridade

Use a ação Alterar prioridade para atualizar a prioridade do registo investigado.

Esta ação é executada em todas as entidades do Google SecOps.

Nota: no Google SecOps, a prioridade de alerta mais elevada determina a prioridade do registo por predefinição.

Por exemplo, se a prioridade do registo for Medium, significa que, pelo menos, um alerta entre todos os alertas agrupados no registo tem uma prioridade Medium, enquanto outros têm prioridades mais baixas, como Low ou Informative.

Se atualizar a prioridade do registo para Low, o Google SecOps substitui a prioridade do registo por Low.

Se atualizar a prioridade de um alerta de registo para High, o Google SecOps define automaticamente a prioridade do registo como High.

Dados de ações

A ação Alterar prioridade requer os seguintes parâmetros:

Parâmetro	Descrição
Priority	Obrigatório. A prioridade a definir para o registo. Os valores possíveis são os seguintes: Informative Low Medium High Critical

Resultados da ação

A ação Alterar prioridade fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case priority was set to NEW_CASE_PRIORITY	A ação foi bem-sucedida.
Error executing action "Close Alert". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Alterar prioridade:

Nome do resultado do script	Valor
Resultado do script	true ou false

Fechar alerta

Use a ação Fechar alerta para fechar o alerta.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Close Alert requer os seguintes parâmetros:

Parâmetro	Descrição
Reason	Obrigatório. Um motivo para fechar o alerta. Os valores possíveis são os seguintes: Malicious NotMalicious Maintenance Inconclusive
Root Cause	Obrigatório. Uma causa principal para fechar o alerta.
Comment	Obrigatório. Um comentário a adicionar ao alerta.
Assign to User	Opcional. O utilizador ao qual atribuir o alerta.
Tags	Opcional. Uma lista de etiquetas separadas por vírgulas.

Resultados da ação

A ação Fechar alerta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The alert was closed. Root Cause: ROOT_CAUSEComment: ALERT_COMMENTReason: REASON	A ação foi bem-sucedida.
Error executing action "Close Alert". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Close Alert:

Nome do resultado do script	Valor
StatusResult	true ou false

Fechar Pedido

Use a ação Fechar registo para fechar o registo.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Close Case requer os seguintes parâmetros:

Parâmetro	Descrição
Reason	Obrigatório. Um motivo para encerrar o registo. Os valores possíveis são os seguintes: Malicious NotMalicious Maintenance Inconclusive
Root Cause	Obrigatório. Uma causa principal para o encerramento do registo.
Comment	Obrigatório. Um comentário a adicionar ao registo.

Resultados da ação

A ação Fechar registo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case was closed. Root Cause: ROOT_CAUSEComment: CASE_COMMENTReason: REASON	A ação foi bem-sucedida.
Error executing action "Close Case". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Close Case:

Nome do resultado do script	Valor
StatusResult	true ou false

Crie uma entidade

Use a ação Criar entidade para criar uma nova entidade e adicioná-la a um alerta.

Esta ação é executada em todas as entidades do Google SecOps.

Nota: para a versão 5.6.2 e posteriores da plataforma Google SecOps, a ação Criar entidade permite-lhe escolher o delimitador no processo de mapeamento e ignorar a configuração da base de dados.

Para a versão 5.6.0 até 5.6.2 da plataforma Google SecOps, a delimitação pode ocorrer na ação Criar entidade ou na base de dados.

Para usar um delimitador personalizado (não predefinido) quando cria uma entidade, use o mesmo delimitador na ação e na base de dados.

Para usar um delimitador personalizado, conclua qualquer uma das seguintes opções:

• Altere o delimitador predefinido (,) para o seu delimitador personalizado nas entradas de ações e na base de dados.
• Altere o delimitador na base de dados e mantenha o valor do parâmetro Delimiter vazio na ação.

Dados de ações

A ação Create Entity requer os seguintes parâmetros:

Parâmetro	Descrição
Entities Identifies	Obrigatório. Uma lista de identificadores de entidades separados por vírgulas a criar no registo, como VALUE1,VALUE2,VALUE3 .
Delimiter	Opcional. O delimitador usado para dividir a entrada do parâmetro Entities Identifies em vários identificadores. Se não definir um valor, a ação trata a entrada como um identificador de entidade único. O valor predefinido é ,.
Entity Type	Obrigatório. O tipo de entidade a criar, como HOSTNAME, USERNAME ou IP.
Is Internal	Opcional. Se selecionada, a ação trata as entidades como parte de uma rede interna. Não selecionado por predefinição.
Is Suspicious	Opcional. Se selecionada, a ação trata as entidades como suspeitas. Não selecionado por predefinição.

Resultados da ação

A ação Create Entity (Criar entidade) fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Create Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
<codeENTITY_ID created successfully.	A ação foi bem-sucedida.
Error executing action "Create Entity". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do guião quando usa a ação Create Entity:

Nome do resultado do script	Valor
StatusResult	true ou false

Crie um resumo do registo do Gemini

Use a ação Criar resumo do registo do Gemini para criar um novo resumo do registo do Gemini e adicioná-lo a um alerta.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Criar resumo do registo do Gemini fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Create Gemini Case Summary:

{
  "summary": "On the Linux agent instance-1 (IP addresses 10.150.0.3 and 34.85.128.214), user vanshikavw_google_com initiated the process curl (SHA1 hash 3395856ce81f2b7382dee72602f798b642f14140) to create the malware file /home/vanshikavw_google_com/eicar_test_vanshikavw-test-new.\n*  VirusTotal identifies the SHA1 hash 3395856ce81f2b7382dee72602f798b642f14140 as a virus.eicar/test.\n*  CURL is associated with multiple actors, including APT27, APT34, APT41, APT44, APT9, FIN11, FIN13, FIN6, TEMP.Armageddon, Turla Team, UNC1151, UNC1860, UNC215, UNC2165, UNC2500, UNC251, UNC2595, UNC2633, UNC2900, UNC2975, UNC3569, UNC3661, UNC3944, UNC4483, UNC4936, UNC4962, UNC5007, UNC5051, UNC5055, UNC5156, UNC5221, UNC5266, UNC5330, UNC5371, UNC5470, UNC5859, and UNC961.\n*  CURL is known to use MITRE ATT&CK techniques such as T1113, T1095, T1036, T1553, T1222, T1055, T1140, T1070, T1027, T1622, T1057, T1010, T1083, T1518, T1082, T1016, T1059, T1496, and T1588.\n*  A GTI MALWARE search did not find any information about eicar_test_vanshikavw-test-new.\n*  A GTI IP_ADDRESS search did not find any information about 10.150.0.3 or 34.85.128.214.", 
  "next_steps": ["Isolate instance-1 to prevent any potential lateral movement or further compromise of the network, as the curl process is associated with multiple threat actors.", 
  "Investigate the user account vanshikavw_google_com to determine if the user's credentials have been compromised or if the user initiated the curl process intentionally, as the curl process is associated with multiple threat actors.", 
  "Analyze the network traffic to and from the IP addresses 10.150.0.3 and 34.85.128.214 for any suspicious communication patterns, as the curl process is associated with multiple threat actors.", 
  "Examine the process execution logs on instance-1 for any other unusual or unauthorized activities, as the curl process is associated with multiple threat actors.", 
  "Review the configuration of the Linux agent on instance-1 to ensure that it is properly secured and that no unauthorized modifications have been made, as the curl process is associated with multiple threat actors."], 
  "reasons": ["The case involves a Linux agent instance-1 (IP addresses 10.150.0.3 and 34.85.128.214) where user vanshikavw_google_com initiated the process curl to create the file /home/vanshikavw_google_com/eicar_test_vanshikavw-test-new.", 
  "The SHA1 hash 3395856ce81f2b7382dee72602f798b642f14140 of the curl process is identified by VirusTotal as virus.eicar/test, indicating it is a known test virus.", 
  "The process CURL is associated with multiple threat actors, including APT27, APT34, APT41, APT44, APT9, FIN11, FIN13, FIN6, TEMP.Armageddon, Turla Team, UNC1151, UNC1860, UNC215, UNC2165, UNC2500, UNC251, UNC2595, UNC2633, UNC2900, UNC2975, UNC3569, UNC3661, UNC3944, UNC4483, UNC4936, UNC4962, UNC5007, UNC5051, UNC5055, UNC5156, UNC5221, UNC5266, UNC5330, UNC5371, UNC5470, UNC5859, and UNC961, suggesting a potential link to malicious activity.", 
  "CURL is known to use various MITRE ATT&CK techniques such as T1113, T1095, T1036, T1553, T1222, T1055, T1140, T1070, T1027, T1622, T1057, T1010, T1083, T1518, T1082, T1016, T1059, T1496, and T1588, indicating a wide range of potential malicious behaviors.", 
  "The file eicar_test_vanshikavw-test-new was not found in GTI MALWARE searches, and the IP addresses 10.150.0.3 and 34.85.128.214 were not found in GTI IP_ADDRESS searches."]}

Mensagens de saída

A ação Criar resumo do registo do Gemini pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Case summary generation completed.	A ação foi bem-sucedida.
Error executing action "Create Gemini Case Summary". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Create Gemini Case Summary:

Nome do resultado do script	Valor
is_success	true ou false

Crie ou atualize propriedades de entidades

Use a ação Create Or Update Entity Properties para criar ou alterar propriedades de entidades no âmbito da entidade.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Create Or Update Entity Properties requer os seguintes parâmetros:

Parâmetro	Descrição
Entity Field	Obrigatório. O nome do campo da entidade a criar ou atualizar.
Field Value	Obrigatório. O valor a definir para o campo da entidade especificado.

Resultados da ação

A ação Create Or Update Entity Properties fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Property ENTITY_ID were changed for the following entities: ENTITY_ID.	A ação foi bem-sucedida.
Error executing action "Create Or Update Entity Properties". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Create Or Update Entity Properties:

Nome do resultado do script	Valor
is_success	true ou false

Obtenha detalhes do registo

Use a ação Get Case Details para obter todos os dados de um registo (inclui comentários, informações de entidades, estatísticas, manuais de procedimentos executados, informações de alertas e eventos).

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Get Case Details requer os seguintes parâmetros:

Parâmetro	Descrição
Case Id	Opcional. O ID do registo a consultar. Se não for fornecido nada, a ação usa por predefinição a capitalização atual.
Fields to Return	Opcional. Uma lista de campos separados por vírgulas a devolver. Se não for fornecido nada, são devolvidos todos os campos. Nota: pode obter valores aninhados encadeando chaves e índices de listas através do parâmetro Nested Keys Delimiter.
Nested Keys Delimiter	Opcional. O caráter usado para separar chaves aninhadas quando pede campos específicos. O delimitador não pode ser uma vírgula(,). A obtenção de chaves aninhadas requer este delimitador.

Resultados da ação

A ação Get Case Details (Obter detalhes do registo) fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Get Case Details:

{
"id": 24879,
"creationTimeUnixTimeInMs": 1750862500562,
"modificationTimeUnixTimeInMs": 1750862500562,
"name": "Malware",
"priority": -1,
"isImportant": false,
"isIncident": false,
"startTimeUnixTimeInMs": 1727243021999,
"endTimeUnixTimeInMs": 1727243022479,
"assignedUser": "@Tier1",
"description": null,
"isTestCase": true,
"type": 1,
"stage": "Triage",
"environment": "Default Environment",
"status": 1,
"incidentId": null,
"tags": ["hi", "Simulated Case"],
"alertCards": [{
  "id": 172354,
  "creationTimeUnixTimeInMs": 1750862500651,
  "modificationTimeUnixTimeInMs": 1750862500651,
  "identifier": "EICAR_TEST_VANSHIKAVW-TEST-NEW0CC43705-04A7-43FD-88CD-B3E7FECA881D",
  "status": 0,
  "name": "EICAR_TEST_VANSHIKAVW-TEST-NEW",
  "priority": -1,
  "workflowsStatus": 1,
  "slaExpirationUnixTime": null,
  "slaCriticalExpirationUnixTime": null,
  "startTime": 1727243021999,
  "endTime": 1727243022479,
  "alertGroupIdentifier": "MalwareSFBrxjAXvKJsJyKe5iQalf00zrv/QwX966dRoEyP2eA=_8cc160b5-7039-421c-926c-1a98073f11d2",
  "eventsCount": 3,
  "title": "EICAR_TEST_VANSHIKAVW-TEST-NEW",
  "ruleGenerator": "Malware",
  "deviceProduct": "SentinelOneV2",
  "deviceVendor": "SentinelOneV2",
  "playbookAttached": "Testing",
  "playbookRunCount": 1,
  "isManualAlert": false,
  "sla": {
    "slaExpirationTime": null,
    "criticalExpirationTime": null,
    "expirationStatus": 2,
    "remainingTimeSinceLastPause": null
    },
  "fieldsGroups": [],
  "sourceUrl": null,
  "sourceRuleUrl": null,
  "siemAlertId": null,
  "relatedCases": [],
  "lastSourceUpdateUnixTimeInMs": null,
  "caseId": 24879,
  "nestingDepth": 0
  }],
"isOverflowCase": false,
"isManualCase": false,
"slaExpirationUnixTime": null,
"slaCriticalExpirationUnixTime": null,
"stageSlaExpirationUnixTimeInMs": null,
"stageSlaCriticalExpirationUnixTimeInMs": null,
"canOpenIncident": false,
"sla": {
  "slaExpirationTime": null,
  "criticalExpirationTime": null,
  "expirationStatus": 2,
  "remainingTimeSinceLastPause": null
  },
"stageSla": {
  "slaExpirationTime": null,
  "criticalExpirationTime": null,
  "expirationStatus": 2,
  "remainingTimeSinceLastPause": null},
  "relatedAlertTicketId": null,
  "relatedAlertCards": []
  }

Mensagens de saída

A ação Get Case Details pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Finished executing Get Case Details successfully	A ação foi bem-sucedida.
Error executing action "Get Case Details". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte apresenta o valor do resultado do script quando usa a ação Get Case Details:

Nome do resultado do script	Valor
is_success	true ou false

Get Connector Context Value

Use a ação Get Connector Context Value para obter um valor armazenado sob uma chave especificada na base de dados do Google SecOps para um contexto do conetor.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Get Connector Context Value requer os seguintes parâmetros:

Parâmetro	Descrição
Connector Identifier	Obrigatório. O identificador do conector para o qual obter o valor do contexto.
Key Name	Obrigatório. O nome da chave para a qual obter o valor do contexto.
Create Case Wall Table	Opcional. Se selecionada, a ação cria uma tabela de registo de ocorrências com o valor de contexto obtido, a menos que o valor exceda o limite de carateres. Selecionado por predefinição.

Resultados da ação

A ação Get Connector Context Value fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela de parede da caixa

A ação Get Connector Context Value pode gerar a seguinte tabela:

Nome da tabela: Connector

Colunas da tabela:

• Identificador do conetor
• Chave
• Valor

Mensagens de saída

A ação Get Connector Context Value pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully found context value for the provided context key CONTEXT_KEY for the connector identifier CONNECTOR_IDENTIFIER. Context value was not found for the provided context key CONTEXT_KEY and connector identifier CONNECTOR_IDENTIFIER. Action can't return the Case Wall table as the context values are too big.	A ação foi bem-sucedida.
Error executing action "Get Connector Context Value". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte apresenta o valor da saída do resultado do script quando usa a ação Get Connector Context Value:

Nome do resultado do script	Valor
is_success	true ou false

Obtenha valores de campos personalizados

Use a ação Get Custom Field Values para obter os valores atuais do campo personalizado com base no âmbito especificado.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Get Custom Field Values requer os seguintes parâmetros:

Parâmetro	Descrição
Scope	Obrigatório. O âmbito a partir do qual obter os campos personalizados. Os valores possíveis são os seguintes: Case Alert All

Resultados da ação

A ação Get Custom Field Values fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Get Custom Field Values:

[{
   "Case": {
       "Case Custom Field Name 1": "Updated Custom Field Value",
       "Case Custom Field Name 2": "Updated Custom Field Value"
   },
   "Alert": {
       "Alert Custom Field Name 1": "Updated Custom Field Value",
       "Alert Custom Field Name 2": "Updated Custom Field Value"
   }
}]

Mensagens de saída

A ação Get Custom Field Values pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully returned SCOPE custom fields. No custom fields were found in scope SCOPE.	A ação foi bem-sucedida.
Error executing action "Get Custom Field Values". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Get Custom Field Values:

Nome do resultado do script	Valor
is_success	True ou False

Get Scope Context Value

Use a ação Get Scope Context Value para obter um valor armazenado numa chave especificada na base de dados do Google SecOps.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Obter valor do contexto do âmbito requer os seguintes parâmetros:

Parâmetro	Descrição
Context Scope	Obrigatório. O âmbito do contexto a partir do qual obter dados. Os valores possíveis são os seguintes: Not specified Alert Case Global
Key Name	Obrigatório. O nome da chave para obter o valor correspondente do contexto especificado.
Create Case Wall Table	Opcional. Se selecionada, a ação cria uma tabela de registo de ocorrências com o valor de contexto obtido, a menos que o valor exceda o limite de carateres. Selecionado por predefinição.

Resultados da ação

A ação Get Scope Context Value fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela de parede da caixa

A ação Get Scope Context Value pode gerar a seguinte tabela:

Nome da tabela: SCOPE

Colunas da tabela:

• Chave
• Valor

Mensagens de saída

A ação Get Scope Context Value pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully found context value for the provided context key CONTEXT_KEY with scope CONTEXT_SCOPE. No context values were found for the provided context scope CONTEXT_SCOPE. Context value was not found for the provided context key CONTEXT_KEY with scope CONTEXT_SCOPE. Action can't return the Case Wall table as the context values are too big.	A ação foi bem-sucedida.
Error executing action "Get Scope Context Value". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Get Scope Context Value:

Nome do resultado do script	Valor
is_success	true ou false

Obtenha casos semelhantes

Use a ação Get Similar Cases para pesquisar casos semelhantes e devolver os respetivos IDs.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Get Similar Cases requer os seguintes parâmetros:

Parâmetro	Descrição
Rule Generator	Opcional. Se selecionada, a ação procura casos semelhantes através do gerador de regras. Selecionado por predefinição.
Port	Opcional. Se estiver selecionada, a ação procura casos semelhantes através de números de portas. Selecionado por predefinição.
Category Outcome	Opcional. Se selecionada, a ação procura casos semelhantes através do resultado da categoria. Selecionado por predefinição.
Entity Identifier	Opcional. Se estiver selecionada, a ação procura registos semelhantes através do identificador da entidade. Selecionado por predefinição.
Days Back	Obrigatório. O número de dias anteriores ao dia atual para a ação de pesquisar casos semelhantes.
Include Open Cases	Opcional. Se estiver selecionada, a ação pesquisa registos abertos. Selecionado por predefinição.
Include Closed Cases	Opcional. Se selecionada, a ação pesquisa casos fechados. Selecionado por predefinição.

A ação Get Similar Cases aplica o operador lógico AND aos parâmetros Rule Generator, Port, Category Outcome, Entity Identifier, Include Open Cases e Include Closed Cases para os usar na mesma pesquisa.

Resultados da ação

A ação Get Similar Cases fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Get Similar Cases:

{
  "results": [{
    "id": 23874, 
    "name": "Malware", 
    "tags": ["hi", "Simulated Case"], 
    "start time": "2024-09-25 05:43:41.999000+00:00", 
    "start time unix": 1727243021999, 
    "last modified": "2025-06-19 13:24:01.062000+00:00", 
    "priority": "Informative", 
    "assigned user": "@Tier1", 
    "matching_criteria": {
        "ruleGenerator": true, 
        "port": true, 
        "outcome": true, 
        "entities": true
      }, 
    "matched_entities": [
      {"entity": "INSTANCE-1", "type": "HOSTNAME", "isSuspicious": false}, 
      {"entity": "10.150.0.3", "type": "ADDRESS", "isSuspicious": false}, {"entity": "172.17.0.1", "type": "ADDRESS", "isSuspicious": false}, {"entity": "VANSHIKAVW_GOOGLE_COM", "type": "USERUNIQNAME", "isSuspicious": false}, 
      {"entity": "CURL", "type": "PROCESS", "isSuspicious": false}, {"entity": "EICAR_TEST_VANSHIKAVW-TEST-NEW", "type": "FILENAME", "isSuspicious": false}, 
      {"entity": "3395856CE81F2B7382DEE72602F798B642F14140", "type": "FILEHASH", "isSuspicious": false}, 
      {"entity": "34.85.128.214", "type": "ADDRESS", "isSuspicious": false}, 
      {"entity": "/HOME/VANSHIKAVW_GOOGLE_COM/EICAR_TEST_VANSHIKAVW-TEST-NEW", "type": "FILENAME", "isSuspicious": false}
      ], 
      "status": "Open"}], 
      "stats": 
      {"Malicious": 0.0, "Is Important": 0.0, "Is Incident": 0.0, "Status Open": 100.0}, 
      "platform_url": "https://soarapitest.backstory.chronicle.security/"
}

Mensagens de saída

A ação Get Similar Cases pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Processed NUMBER_OF_CASES similar cases: CASE_IDS_LIST	A ação foi bem-sucedida.
Error executing action "Get Similar Cases". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Get Similar Cases:

Nome do resultado do script	Valor
SimilarCasesIds	CASE_IDS_LIST

Educação

Use a ação Instrução para definir instruções para um analista.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Instruction requer os seguintes parâmetros:

Parâmetro	Descrição
Instruction	Obrigatório. O conteúdo das instruções para o analista.

Resultados da ação

A ação Instruction fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Add Vote To Entity pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Please perform the following instructions: INSTRUCTION.	A ação foi bem-sucedida.
Error executing action "Instruction". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Instruction:

Nome do resultado do script	Valor
Resultado do script	true ou false

Está na lista de clientes

Use a ação Is In Custom List para verificar se o identificador da entidade faz parte de uma lista personalizada especificada.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Está na lista personalizada requer os seguintes parâmetros:

Parâmetro	Descrição
Category	Obrigatório. Uma categoria de lista personalizada para verificar a existência de entidades de alerta.

Resultados da ação

A ação Está na lista personalizada fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Está na lista personalizada pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
This alert contains entities in the given custom list category: CATEGORY.	A ação foi bem-sucedida.
Error executing action "Is In Custom List". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Is In Custom List:

Nome do resultado do script	Valor
ScriptResult	true ou false

Marcar como importante

Use a ação Marcar como importante para marcar um registo como importante.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Marcar como importante oferece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Marcar como importante pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case was automatically marked as important.	A ação foi bem-sucedida.
Error executing action "Mark As Important". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Marcar como importante:

Nome do resultado do script	Valor
Resultado do script	true ou false

URL da Web aberta

Use a ação Abrir URL da Web para gerar um link do navegador.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Open Web Url requer os seguintes parâmetros:

Parâmetro	Descrição
Title	Obrigatório. O título do URL.
URL	Obrigatório. O URL de destino.

Resultados da ação

A ação Abrir URL da Web fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Abrir URL da Web pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
URL_TITLE URL_LINK	A ação foi bem-sucedida.
Error executing action "Open Web Url". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Abrir URL da Web:

Nome do resultado do script	Valor
Resultado do script	true ou false

Pausar SLA de alerta

Use a ação Pausar SLA de alerta para pausar o temporizador do contrato de nível de serviço (SLA) para um alerta específico no registo.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Pause Alert SLA requer os seguintes parâmetros:

Parâmetro	Descrição
Message	Opcional. O motivo da pausa do ANS de alerta.

Resultados da ação

A ação Pausar SLA de alerta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Pause Alert SLA pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The alert SLA was paused.	A ação foi bem-sucedida.
Error executing action "Pause Alert SLA". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Pausar alerta de ANS:

Nome do resultado do script	Valor
is_success	true ou false

Pause o SLA do registo

Use a ação Pausar SLA do registo para pausar o temporizador do contrato de nível de serviço (SLA) para um registo específico.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Pause Case SLA requer os seguintes parâmetros:

Parâmetro	Descrição
Message	Opcional. O motivo da pausa do ANS do registo.

Resultados da ação

A ação Pausar SLA do registo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Pause Case SLA pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case SLA was paused.	A ação foi bem-sucedida.
Error executing action "Pause Case SLA". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Pause Case SLA:

Nome do resultado do script	Valor
is_success	true ou false

Hora de alerta permitida

Use a ação Tempo de alerta permitido para verificar se a hora de início de um alerta selecionado está em conformidade com as condições de tempo definidas pelo utilizador.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Permitted Alert Time requer os seguintes parâmetros:

Parâmetro	Descrição
Permitted Start Time	Obrigatório. A hora de início do período permitido para alertas.
Permitted End Time	Obrigatório. A hora de fim do período permitido para alertas.
Monday	Opcional. Se estiver selecionada, a ação trata as segundas-feiras como dias permitidos para alertas. Não selecionado por predefinição.
Tuesday	Opcional. Se estiver selecionada, a ação trata as terças-feiras como dias permitidos para alertas. Selecionado por predefinição.
Wednesday	Opcional. Se estiver selecionada, a ação trata as quartas-feiras como dias permitidos para alertas. Selecionado por predefinição.
Thursday	Opcional. Se estiver selecionada, a ação trata as quintas-feiras como dias permitidos para alertas. Não selecionado por predefinição.
Friday	Opcional. Se estiver selecionada, a ação trata as sextas-feiras como dias permitidos para alertas. Não selecionado por predefinição.
Saturday	Opcional. Se estiver selecionada, a ação trata os sábados como dias permitidos para alertas. Não selecionado por predefinição.
Sunday	Opcional. Se estiver selecionada, a ação trata os domingos como dias permitidos para alertas. Não selecionado por predefinição.
Timestamp Type	Opcional. O tipo de indicação de tempo que vai ser usado para comparação.
Input Timezone	Opcional. O nome do fuso horário. Por exemplo: UTC. Esta ação também suporta a introdução com zonas IANA (por exemplo, America/New_York). Se a entrada for fornecida através de zonas, a ação ajusta-se automaticamente à mudança da hora.

Resultados da ação

A ação Permitted Alert Time fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Permitted Alert Time pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Case Time of ALERT_TIME is within condition parameters of between START_TIME - END_TIME on CHECKED_DAY	A ação foi bem-sucedida.
Error executing action "Permitted Alert Time". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Permitted Alert Time:

Nome do resultado do script	Valor
Permitted	true ou false

Tchim-tchim

Use a ação Ping para testar a conetividade.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Ping fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Ping pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Email address is syntactically correct.	A ação foi bem-sucedida.
Error executing action "Ping". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Ping:

Nome do resultado do script	Valor
Resultado do script	true ou false

Comunique um incidente

Use a ação Gerar incidente para gerar um incidente de registo e marcar os casos verdadeiros positivos como Critical.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Raise Incident requer os seguintes parâmetros:

Parâmetro	Descrição
Soc Role	Opcional. A função do SOC do Google SecOps para atribuir o registo.

Resultados da ação

A ação Raise Incident (Gerar incidente) fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Search ASM Issues pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case raised to CASE_STAGE status.	A ação foi bem-sucedida.
Error executing action "Raise Incident". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Raise Incident:

Nome do resultado do script	Valor
Resultado do script	true ou false

Remova a etiqueta

Use a ação Remover etiqueta para remover etiquetas de um registo.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Remover etiqueta requer os seguintes parâmetros:

Parâmetro	Descrição
Tag	Obrigatório. Uma lista de etiquetas separadas por vírgulas a remover de um registo.

Resultados da ação

A ação Remover etiqueta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Remover etiqueta pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully removed the following tags from case CASE_ID:TAGS	A ação foi bem-sucedida.
It is not possible to remove the tag. Error executing action "Remove Tag". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Remover etiqueta:

Nome do resultado do script	Valor
is_success	true ou false

Remova da lista personalizada

Use a ação Remover da lista personalizada para remover entidades associadas a um alerta de uma categoria de lista personalizada especificada.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

A ação Remover da lista personalizada requer os seguintes parâmetros:

Parâmetro	Descrição
Category	Obrigatório. O nome da categoria da lista personalizada da qual remover as entidades.

Resultados da ação

A ação Remover da lista personalizada fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Remove From Custom List pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The alert's entities ENTITY_ID were removed from custom list category: CATEGORY	A ação foi bem-sucedida.
Error executing action "Remove From Custom List". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Remove From Custom List:

Nome do resultado do script	Valor
ScriptResult	true ou false

Retomar SLA de alerta

Use a ação Retomar SLA de alerta para reiniciar o temporizador do contrato de nível de serviço (SLA) para um alerta específico no registo.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Retomar SLA de alerta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Retomar SLA de alerta pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The alert SLA was resumed.	A ação foi bem-sucedida.
Error executing action "Resume Alert SLA". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Retomar alerta de ANS:

Nome do resultado do script	Valor
is_success	true ou false

Retomar SLA do registo

Use a ação Retomar SLA do registo para reiniciar o temporizador do contrato de nível de serviço (SLA) de um registo específico.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Retomar SLA do registo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Retomar SLA do registo pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
The case SLA was resumed.	A ação foi bem-sucedida.
Error executing action "Resume Case SLA". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Retomar SLA do registo:

Nome do resultado do script	Valor
is_success	True ou False

Defina o SLA de alertas

Use a ação Definir SLA de alerta para definir o temporizador de SLA para um alerta.

Esta ação tem a prioridade mais elevada e substitui o SLA existente definido para o alerta específico.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Definir SLA de alerta requer os seguintes parâmetros:

Parâmetro	Descrição
SLA Period	Obrigatório. O período de violação do SLA. O valor predefinido é 5.
SLA Time Unit	Obrigatório. A unidade de tempo para o período do SLA. O valor predefinido é Minutes. Os valores possíveis são os seguintes: Minutes Hours Days
SLA Time To Critical Period	Obrigatório. O limite crítico do SLA. O valor predefinido é 4.
SLA Time To Critical Unit	Obrigatório. A unidade de tempo para o período de ANS crítico. O valor predefinido é Minutes. Os valores possíveis são os seguintes: Minutes Hours Days

Resultados da ação

A ação Definir SLA de alerta fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Definir SLA de alerta pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Alert ALERT_NAME of case CASE_ID was set with SLA of SLA_PERIOD SLA_TIME_UNIT and critical period of CRITICAL_PERIOD CRITICAL_TIME_UNIT.	A ação foi bem-sucedida.
Error executing action "Set Alert SLA". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Definir SLA de alerta:

Nome do resultado do script	Valor
is_success	true ou false

Defina o SLA do registo

Use a ação Definir SLA do registo para definir o SLA de um registo.

Esta ação tem a prioridade mais elevada e substitui o SLA existente definido para o caso específico.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Definir SLA de registo requer os seguintes parâmetros:

Parâmetro	Descrição
SLA Period	Obrigatório. O período de violação do SLA. O valor predefinido é 5.
SLA Time Unit	Obrigatório. A unidade de tempo para o período do SLA. O valor predefinido é Minutes. Os valores possíveis são os seguintes: Minutes Hours Days
SLA Time To Critical Period	Obrigatório. O limite crítico do SLA. O valor predefinido é 4.
SLA Time To Critical Unit	Obrigatório. A unidade de tempo para o período de ANS crítico. O valor predefinido é Minutes. Os valores possíveis são os seguintes: Minutes Hours Days

Resultados da ação

A ação Definir SLA do registo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Search ASM Issues pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Case CASE_ID was set with SLA of SLA_PERIOD SLA_TIME_UNIT and critical period of CRITICAL_PERIOD CRITICAL_TIME_UNIT.	A ação foi bem-sucedida.
Error executing action "Set Case SLA". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Set Case SLA:

Nome do resultado do script	Valor
is_success	true ou false

Defina campos personalizados

Use a ação Definir campos personalizados para definir valores para campos personalizados.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Definir campos personalizados requer os seguintes parâmetros:

Parâmetro	Descrição
Scope	Obrigatório. O âmbito a definir para os campos personalizados. Os valores possíveis são Case e Alert. O valor predefinido é Case.
Custom Fields Data	Obrigatório. Os valores a atualizar para os campos personalizados. Pode atualizar vários campos personalizados numa única execução de ações. O valor predefinido é o seguinte: { "Custom Field Name 1": "Custom Field Value 1", "Custom Field Name 2": "Custom Field Value 2" }
Append Values	Opcional. Se estiver selecionada, a ação anexa as entradas do parâmetro Custom Fields Data aos valores existentes dos campos personalizados. Se não for selecionada, a ação substitui os valores existentes pelos dados do parâmetro Custom Fields Data. Não selecionado por predefinição.

Resultados da ação

A ação Definir campos personalizados fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Definir campos personalizados:

{
"Custom Field Name": "Updated Custom Field Value",
"Custom Field Name": "Updated Custom Field Value",
}

Mensagens de saída

A ação Definir campos personalizados pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully updated the following SCOPE custom fields: UPDATED_CUSTOM_FIELD_NAMES	A ação foi bem-sucedida.
Error executing action "Set Custom Fields". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte apresenta o valor do resultado do script quando usa a ação Definir campos personalizados:

Nome do resultado do script	Valor
is_success	true ou false

Defina a pontuação de risco

Use a ação Definir classificação de risco para atualizar a classificação de risco de um registo.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Definir pontuação de risco requer os seguintes parâmetros:

Parâmetro	Descrição
Risk Score	Obrigatório. A pontuação de risco a definir para o registo selecionado.

Resultados da ação

A ação Definir pontuação de risco fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Definir pontuação de risco pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully set Risk Score for case CASE_ID	A ação foi bem-sucedida.
Error executing action "Set Risk Score". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Definir classificação de risco:

Nome do resultado do script	Valor
is_success	true ou false

Defina o valor do contexto do âmbito

Use a ação Definir valor do contexto do âmbito para definir um valor para uma chave que é armazenada na base de dados do Google SecOps.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Definir valor do contexto do âmbito requer os seguintes parâmetros:

Parâmetro	Descrição
Context Scope	Obrigatório. O âmbito do contexto a partir do qual obter dados. Os valores possíveis são os seguintes: Not specified Alert Case Global
Key Name	Obrigatório. O nome da chave para obter o valor correspondente do contexto especificado.
Key Value	Obrigatório. O valor a armazenar na chave especificada.

Resultados da ação

A ação Get Scope Context Value fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Definir valor do contexto do âmbito pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully set context value for the context key CONTEXT_KEY with scope CONTEXT_SCOPE.	A ação foi bem-sucedida.
Error executing action "Set Scope Context Value". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Definir valor do contexto do âmbito:

Nome do resultado do script	Valor
is_success	true ou false

Atualize a descrição do registo

Use a ação Atualizar descrição do registo para atualizar a descrição de um registo.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Atualizar descrição do registo requer os seguintes parâmetros:

Parâmetro	Descrição
Description	Obrigatório. A descrição a definir para o registo.

Resultados da ação

A ação Atualizar descrição do registo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Não disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Atualizar descrição do registo pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully updated the case description.	A ação foi bem-sucedida.
Error executing action "Update Case Description". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Atualizar descrição do registo:

Nome do resultado do script	Valor
StatusResult	true ou false

Aguardar campos personalizados

Use a ação Aguardar campos personalizados para aguardar que os valores dos campos personalizados continuem a execução do livro de jogadas.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação Wait For Custom Fields requer os seguintes parâmetros:

Parâmetro	Descrição
Scope	Obrigatório. O âmbito a definir para os campos personalizados. Os valores possíveis são Case e Alert. O valor predefinido é Case.
Custom Fields Data	Obrigatório. As condições necessárias para que os campos personalizados permitam que a ação retome a execução de um playbook. Configure os nomes dos campos personalizados e os respetivos valores obrigatórios como um objeto JSON. Se definir condições para vários campos, a ação aguarda que todos os campos correspondam às respetivas condições. O comportamento da ação depende da entrada que fornecer. Para que a ação retome a execução de um manual de procedimentos com qualquer valor num campo personalizado, configure uma string vazia para o campo personalizado da seguinte forma: { "Custom Field": "" } Para que a ação retome a execução de um playbook quando o campo personalizado for igual a um valor específico, como VALUE_1, especifique o valor do campo personalizado da seguinte forma: { "Custom Field": "VALUE_1" } O valor predefinido é o seguinte: { "Custom Field Name 1": "Custom Field Value 1", "Custom Field Name 2": "Custom Field Value 2" }

Resultados da ação

A ação Aguardar campos personalizados fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para caixas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Wait For Custom Fields:

{
"Custom Field Name": "Updated Custom Field Value",
"Custom Field Name": "Updated Custom Field Value",
}

Mensagens de saída

A ação Aguardar campos personalizados pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Successfully waited for the following SCOPE custom fields: UPDATED_CUSTOM_FIELD_NAMES Waiting for SCOPE custom fields updates...	A ação foi bem-sucedida.
Error executing action "Wait For Custom Fields". Reason: ERROR_REASON	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Aguardar campos personalizados:

Nome do resultado do script	Valor
is_success	true ou false

Empregos

A integração do Siemplify permite-lhe usar as seguintes tarefas:

• Siemplify - Actions Monitor
• Siemplify - Cases Collector DB
• Siemplify - Logs Collector

Siemplify - Actions Monitor

Use a tarefa Siemplify - Actions Monitor para receber notificações de todas as ações que falharam individualmente pelo menos três vezes nas últimas três horas.

Dados de tarefas

A tarefa Siemplify - Actions Monitor requer os seguintes parâmetros:

Parâmetro	Descrição
Run Interval In Seconds	Opcional. O intervalo em segundos para a execução da tarefa. Este parâmetro determina a frequência com que a integração verifica se existem ações do manual de procedimentos com falhas. O valor predefinido é 900.
Is Enabled	Opcional. Se estiver selecionada, a tarefa está ativa. Selecionado por predefinição.

Siemplify - Cases Collector DB

Use a tarefa Siemplify - Cases Collector DB para obter e processar registos de segurança de um publicador designado.

Dados de tarefas

A tarefa Siemplify - Cases Collector DB requer os seguintes parâmetros:

Parâmetro	Descrição
Publisher Id	Obrigatório. O ID do publicador a partir do qual recolher casos e registos.
Verify SSL	Opcional. Se selecionada, a tarefa verifica se o certificado SSL do publicador é válido. Não selecionado por predefinição.

Siemplify - Logs Collector

Use a tarefa Siemplify - Logs Collector para obter e processar registos de um publicador especificado.

Dados de tarefas

A tarefa Siemplify - Logs Collector requer os seguintes parâmetros:

Parâmetro	Descrição
Publisher Id	Obrigatório. O ID do publicador a partir do qual recolher os registos.
Verify SSL	Opcional. Se selecionada, a tarefa verifica se o certificado SSL do publicador é válido. Não selecionado por predefinição.

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