Integre o Siemplify com o Google SecOps

Versão da integração: 94.0

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

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 pontos finais 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 as 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 para validação nos fluxos de trabalho relacionados com email da integração. Esta lista é usada para definir os destinatários para processamento. O valor predefinido é [e-mail],[e-mail].
Elastic Server Address	Obrigatório. O endereço do servidor elástico usado para estabelecer ligação à base de dados do Siemplify. Normalmente, este é o endereço da máquina anfitriã onde a instância do Elastic é executada. O valor predefinido é localhost.

Para ver 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 Realize uma ação manual.

Adicione estatísticas de entidades

Use a ação Adicionar estatísticas de entidades para adicionar estatísticas a uma entidade do Google SecOps 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>) 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
Tabela de parede para capas	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 não é executada em entidades do Google SecOps.

Dados de ações

A ação Add General Insight 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>) Links (<a href="example.com"></a>).
Triggered By	Opcional. Um campo de texto livre para fornecer uma justificação da estatística, explicando por que motivo foi adicionada ao registo.

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
Tabela de parede para capas	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() para obter uma lista de IDs de registos com base num conjunto de critérios e parâmetros.

O operador lógico AND é aplicado aos parâmetros Rule Generator, Port, Category Outcome e Entity Identifier para filtrar casos que correspondam a todos os critérios especificados.

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. Ativada por predefinição.
Port	Opcional. Se estiver selecionada, a ação procura casos semelhantes através de números de porta. Ativada por predefinição.
Category Outcome	Opcional. Se selecionada, a ação procura casos semelhantes através do resultado da categoria. Ativada por predefinição.
Entity Identifier	Opcional. Se selecionada, a ação procura registos semelhantes através do identificador da entidade. Ativada por predefinição.
Days Back	Obrigatório. O número de dias anteriores à data atual para pesquisar casos semelhantes.
Tags	Obrigatório. Uma lista de etiquetas separadas por vírgulas a aplicar aos registos semelhantes encontrados.

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
Tabela de parede para capas	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_SIMILAR_CASES similar cases. Successfully added tags: TAG_NAMES to cases CASE_IDS	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. O nome da categoria da lista personalizada à qual adicionar o identificador da entidade.

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
Tabela de parede para capas	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_IDS 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 o registo a um utilizador ou a um grupo de utilizadores específico.

Esta ação não é executada em 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. O utilizador ou o grupo de utilizadores ao qual atribuir o 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
Tabela de parede para capas	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 ao alerta.

Esta ação não é executada em 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 plano de ação a anexar ao alerta atual.
Allow Duplicates	Opcional. Se estiver selecionada, a estratégia pode ser anexada ao alerta mais do que uma vez. Ativada por predefinição.

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
Tabela de parede para capas	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 apresenta 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 não é executada em 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
Tabela de parede para capas	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 não é executada em 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. A etiqueta a adicionar ao registo.

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
Tabela de parede para capas	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_NAME 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 não é executada em 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 num 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. Se a prioridade do alerta for atualizada para um valor superior à prioridade do registo atual, a prioridade do registo é atualizada automaticamente para corresponder à nova prioridade mais elevada. 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
Tabela de parede para capas	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 do registo para alterar a fase do registo.

Esta ação não é executada em 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 Alterar fase 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
Tabela de parede para capas	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 NEW_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 alterar a prioridade do registo.

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

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
Tabela de parede para capas	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 não é executada em 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. A classificação principal para o encerramento do alerta. Os valores possíveis são os seguintes: Malicious NotMalicious Maintenance Inconclusive
Root Cause	Obrigatório. A explicação detalhada do problema técnico que originou o alerta.
Comment	Obrigatório. As notas, o resumo da investigação ou o contexto adicional para o encerramento do alerta.
Assign to User	Opcional. Um utilizador ao qual atribuir o alerta após o respetivo encerramento.
Tags	Opcional. Uma lista de etiquetas separadas por vírgulas a anexar ao alerta para classificação, filtragem e capacidade de pesquisa futura.

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
Tabela de parede para capas	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_CAUSE Comment: ALERT_COMMENT Reason: 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 não é executada em 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. A classificação principal para o encerramento do alerta. Os valores possíveis são os seguintes: Malicious NotMalicious Maintenance Inconclusive
Root Cause	Obrigatório. Uma explicação detalhada do problema técnico que originou o alerta.
Comment	Obrigatório. As notas, o resumo da investigação ou o contexto adicional para o encerramento do alerta.

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
Tabela de parede para capas	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_CAUSE Comment: 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, pode escolher o delimitador diretamente nas entradas da ação e ignorar a configuração da base de dados.

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

Para usar um delimitador personalizado (não predefinido), escolha 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 parâmetro Delimiter vazio nesta ação.

Dados de ações

A ação Criar entidade 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. Um delimitador usado para dividir a entrada de Entities Identifies em vários identificadores. Se não for fornecido nenhum 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 HOST NAME, USER NAME ou IP Set.
Is Internal	Opcional. Se selecionada, a ação marca as entidades como parte de uma rede interna. Não está ativada por predefinição.
Is Suspicious	Opcional. Se selecionada, a ação marca as entidades como suspeitas. Não está ativada 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
Tabela de parede para capas	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
ENTITY_IDS 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 não é executada em 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
Tabela de parede para capas	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 as propriedades das 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 campo da entidade a criar ou atualizar.
Field Value	Obrigatório. O valor do 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
Tabela de parede para capas	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 Or Update Entity Properties pode devolver as seguintes mensagens de saída:

Mensagem de saída	Descrição da mensagem
Property ENTITY_FIELD 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

Receba alertas de registos

Use a ação Get Case Alerts para obter alertas relacionados com casos especificados.

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

Dados de ações

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

Parâmetro	Descrição
Case ID	Obrigatório. Uma lista de IDs dos registos separados por vírgulas para os quais a ação obtém os alertas associados.
Alert ID	Opcional. Uma lista de IDs de alertas separados por vírgulas, que limita os alertas devolvidos. Este parâmetro só é usado quando Case ID contém valores.
Fields To Return	Opcional. Uma lista de campos separados por vírgulas a devolver no resultado JSON. Para obter valores aninhados, use Nested Keys Delimiter para encadear chaves aninhadas e índices de listas. Por exemplo, se o delimitador for ".": key1.nested_key1.0.nested_key2, key2, key3.1.nested_key1 Se não for fornecido nenhum valor, são devolvidos todos os campos.
Nested Keys Delimiter	Opcional. O caráter usado para separar chaves aninhadas e índices de listas ao definir campos a devolver. Este parâmetro não pode ser uma vírgula (,).

Obtenha detalhes do registo

Use a ação Get Case Details para obter todos os dados de um registo (incluindo 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 do qual pretende obter detalhes. Se não for indicado nenhum valor, a ação usa 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. É possível obter valores aninhados específicos através do parâmetro Nested Keys Delimiter para separar chaves e índices de listas.
Nested Keys Delimiter	Opcional. O caráter usado para separar chaves aninhadas quando pede campos específicos. Isto permite-lhe obter valores de objetos aninhados. O delimitador não pode ser uma vírgula(,).

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
Tabela de parede para capas	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 de uma chave especificada na base de dados do Google SecOps para um contexto de 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 exclusivo do conector a partir do qual obter o valor de contexto.
Key Name	Obrigatório. A chave na qual o valor de contexto está armazenado.
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 tabela não é criada se o valor obtido exceder o limite de carateres. Ativada 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
Tabela de parede para capas	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 paredes de caixas

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 de um 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 quer 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
Tabela de parede para capas	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 da base de dados do Google SecOps que está armazenado numa chave e num contexto especificados.

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 o valor. Os valores possíveis são os seguintes: Not specified Alert Case Global O valor predefinido é Not specified.
Key Name	Obrigatório. A chave sob a qual o valor é armazenado no 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 tabela não é criada se o valor obtido exceder o limite de carateres. Ativada 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
Tabela de parede para capas	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 paredes de caixas

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 registos semelhantes

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

A ação aplica o operador lógico AND aos parâmetros Rule Generator, Port, Category Outcome, Entity Identifier, Include Open Cases e Include Closed Cases para filtrar os registos que correspondem a todos os critérios especificados.

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. Ativada por predefinição.
Port	Opcional. Se estiver selecionada, a ação procura casos semelhantes através de números de porta. Ativada por predefinição.
Category Outcome	Opcional. Se selecionada, a ação procura casos semelhantes através do resultado da categoria. Ativada por predefinição.
Entity Identifier	Opcional. Se selecionada, a ação procura registos semelhantes através do identificador da entidade. Ativada por predefinição.
Days Back	Obrigatório. O número de dias anteriores à data atual para pesquisar a ação.
Include Open Cases	Opcional. Se estiver selecionada, a ação inclui registos abertos na pesquisa. Ativada por predefinição.
Include Closed Cases	Opcional. Se estiver selecionada, a ação inclui registos encerrados na pesquisa. Ativada por predefinição.

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
Tabela de parede para capas	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	Uma lista de IDs de registos semelhantes.

Educação

Use a ação Instrução para fornecer instruções a um analista diretamente no registo.

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

Dados de ações

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

Parâmetro	Descrição
Instruction	Obrigatório. As 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
Tabela de parede para capas	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 uma entidade existe numa lista personalizada designada.

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. O nome da categoria da lista personalizada a pesquisar.

Resultados da ação

A ação Is In Custom List 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
Tabela de parede para capas	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. This alert does not contain 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 o registo como importante.

Esta ação não é executada em 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
Tabela de parede para capas	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 não é executada em 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 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
Tabela de parede para capas	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 alerta SLA para pausar o temporizador do contrato de nível de serviço (SLA) do alerta.

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
Tabela de parede para capas	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 o registo.

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
Tabela de parede para capas	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 successfully.	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 do alerta está em conformidade com as condições de tempo definidas pelo utilizador.

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

Dados de ações

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

Parâmetro	Descrição
Timestamp Type	Opcional. O tipo de indicação de tempo a usar para comparação. Os valores possíveis são os seguintes: Alert Start Time Alert Creation Time Case Creation Time O valor predefinido é Alert Start Time.
Permitted Start Time	Obrigatório. A hora de início do período permitido para alertas, como 0:00:00.
Permitted End Time	Obrigatório. A hora de fim do período permitido para alertas, como 0:00:00.
Monday	Opcional. Se estiver selecionada, a ação inclui segundas-feiras nos dias permitidos para alertas. Não está ativada por predefinição.
Tuesday	Opcional. Se estiver selecionada, a ação inclui terças-feiras nos dias permitidos para alertas. Ativada por predefinição.
Wednesday	Opcional. Se estiver selecionada, a ação inclui quartas-feiras nos dias permitidos para alertas. Ativada por predefinição.
Thursday	Opcional. Se estiver selecionada, a ação inclui quintas-feiras nos dias permitidos para alertas. Não está ativada por predefinição.
Friday	Opcional. Se selecionada, a ação inclui sextas-feiras nos dias permitidos para alertas. Não está ativada por predefinição.
Saturday	Opcional. Se estiver selecionada, a ação inclui os sábados nos dias permitidos para alertas. Não está ativada por predefinição.
Sunday	Opcional. Se estiver selecionada, a ação inclui domingos nos dias permitidos para alertas. Não está ativada por predefinição.
Input Timezone	Opcional. Esta ação suporta fusos horários padrão, como UTC, além de zonas IANA, como America/New_York. Se fornecer uma zona IANA, 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
Tabela de parede para capas	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_TIMEis within condition parameters of between START_TIME - END_TIME on LIST_OF_PERMITTED_DAYS	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 com o Siemplify.

Esta ação não é executada em 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
Tabela de parede para capas	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 da saída 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 Aumentar incidente para marcar um caso de verdadeiro positivo como Critical e aumentar o incidente do caso.

Esta ação não é executada em 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
Tabela de parede para capas	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 Raise Incident 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 do registo.

Esta ação não é executada em 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 do 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
Tabela de parede para capas	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.

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 o identificador da entidade.

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
Tabela de parede para capas	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 The given category does not exist.	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 retomar e reiniciar o temporizador do contrato de nível de serviço (SLA) para o alerta.

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
Tabela de parede para capas	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 alerta de ANS 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 anular a pausa e reiniciar o temporizador do contrato de nível de serviço (SLA) para o 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 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
Tabela de parede para capas	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 successfully.	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 o alerta.

Nota: esta ação substitui qualquer SLA existente para o alerta.

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

Dados de ações

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

Parâmetro	Descrição
SLA Period	Obrigatório. A duração total do SLA antes de ser considerado violado. O período total do SLA não pode exceder 30 dias. O valor predefinido é 5.
SLA Time Unit	Obrigatório. A unidade de tempo para o período do SLA. Os valores possíveis são os seguintes: Minutes Hours Days O valor predefinido é Minutes.
SLA Time To Critical Period	Obrigatório. A duração do SLA antes de entrar num estado crítico. O valor predefinido é 4.
SLA Time To Critical Unit	Obrigatório. A unidade de tempo para o período de SLA crítico. Os valores possíveis são os seguintes: Minutes Hours Days O valor predefinido é Minutes.

Resultados da ação

A ação Set Alert SLA 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
Tabela de parede para capas	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 do 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. A duração total do SLA antes de ser considerado violado. O período total do SLA não pode exceder 30 dias. O valor predefinido é 5.
SLA Time Unit	Obrigatório. A unidade de tempo para o período do SLA. Os valores possíveis são os seguintes: Minutes Hours Days O valor predefinido é Minutes.
SLA Time To Critical Period	Opcional. A duração do SLA antes de entrar num estado crítico. O valor predefinido é 4.
SLA Time To Critical Unit	Obrigatório. A unidade de tempo para o período de SLA crítico. Os valores possíveis são os seguintes: Minutes Hours Days O valor predefinido é Minutes.

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
Tabela de parede para capas	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 Definir SLA de registo:

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 os seguintes: Case Alert O valor predefinido é Case.
Custom Fields Data	Obrigatório. Os valores atualizados dos campos personalizados. Pode atualizar vários campos personalizados numa única execução de ações. O valor predefinido é: { "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 de Custom Fields Data aos valores existentes dos campos personalizados. Se não estiver selecionada, a ação substitui os valores existentes pelos dados do parâmetro Custom Fields Data. Não está ativada 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
Tabela de parede para capas	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 pontuação de risco para atualizar a pontuação de risco do 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.

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
Tabela de parede para capas	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 O valor predefinido é Not specified.
Key Name	Obrigatório. O nome da chave para obter o valor correspondente.
Key Value	Obrigatório. O valor a armazenar na chave especificada.

Resultados da ação

A ação Definir valor do contexto do âmbito 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
Tabela de parede para capas	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 do 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
Tabela de parede para capas	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
is_success	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 os seguintes: Case Alert O valor predefinido é Case.
Custom Fields Data	Obrigatório. As condições dos campos personalizados que têm de ser cumpridas para retomar um guião. Os nomes dos campos personalizados e os respetivos valores obrigatórios têm de ser configurados 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. Para retomar quando um campo personalizado tiver qualquer valor, configure uma string vazia: {"Custom Field Name": ""} Para retomar quando um campo personalizado for igual a um valor específico, como VALUE_1, especifique o valor: {"Custom Field Name": "VALUE_1"} O valor predefinido mostra o formato JSON esperado: { "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
Tabela de parede para capas	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

Para mais informações sobre tarefas, consulte os artigos Configure uma nova tarefa e Agendamento avançado.

Siemplify - Actions Monitor

Use a tarefa Siemplify - Actions Monitor para receber notificações sobre ações que falharam, pelo menos, três vezes separadas nas últimas três horas.

Parâmetros de trabalho

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 e é executada de acordo com a programação. Quando não está selecionada, a tarefa está desativada e não é executada. Ativada 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.

Parâmetros de trabalho

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 registos e casos.
Verify SSL	Opcional. Se selecionada, a tarefa verifica se o certificado SSL do publicador é válido. Não está ativada 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 estiver selecionada, a tarefa verifica se o certificado SSL do publicador é válido. Não está ativada por predefinição.

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