Esta página foi traduzida pela API Cloud Translation.

Integre o Wiz com o Google SecOps

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

Versão da integração: 1.0

Antes de começar

Para usar a integração, precisa de uma raiz da API, um ID de cliente e um segredo do cliente.

Para mais informações sobre como gerar estas credenciais, consulte as Definições das contas de serviço.

Parâmetros de integração

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

Parâmetro	Descrição
`API Root`	Obrigatório. A raiz da API da instância do Wiz.
`Client ID`	Obrigatório. O ID de cliente associado às suas credenciais da API Wiz.
`Client Secret`	Obrigatório. O segredo do cliente associado às suas credenciais da API Wiz.
`Verify SSL`	Obrigatório. Se estiver selecionada, a integração valida o certificado SSL quando se liga ao servidor Wiz. Ativada por predefinição.

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.

Tchim-tchim

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

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

Mensagem de saída	Descrição da mensagem
`Successfully connected to the Wiz server with the provided connection parameters!`	A ação foi bem-sucedida.
`Failed to connect to the Wiz server! Error is ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully connected to the Wiz server with the provided connection parameters!

A ação foi bem-sucedida.

Failed to connect to the Wiz server!
      Error is  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
`is_success`	`True` ou `False`

Obtenha detalhes do problema

Use a ação Get Issue Details para obter informações sobre um problema especificado no Wiz.

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

Dados de ações

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

Parâmetro Descrição

Parâmetro	Descrição
`Issue ID`	Obrigatório. O identificador exclusivo do problema do Wiz a obter ou no qual quer tomar medidas.

Issue ID

Obrigatório.

O identificador exclusivo do problema do Wiz a obter ou no qual quer tomar medidas.

Resultados da ação

A ação Get Issue Details (Obter detalhes do problema) 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 Issue Details:

{
   "id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
   "createdAt": "2025-07-26T11:47:43.94524Z",
   "updatedAt": "2025-07-31T07:34:54.445702Z",
   "status": "RESOLVED",
   "severity": "CRITICAL",
   "type": "TOXIC_COMBINATION",
   "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
   "resolvedAt": "2025-07-31T07:34:54.445702Z",
   "entitySnapshot": {
       "cloudPlatform": "GCP",
       "id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
       "name": "cluster-solr",
       "region": "us-central1",
       "subscriptionName": "Wiz-Labs",
       "type": "KUBERNETES_CLUSTER"
   },
   "projects": [
       {
           "id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
           "name": "GCP Lab"
       }
   ],
   "sourceRules": [
       {
           "id": "wc-id-1038",
           "name": "Container using an image infected with critical/high severity malware",
           "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
       }
   ]
}

Mensagens de saída

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

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully returned details for the following issue using information from Wiz: ISSUE_ID` `The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID`	A ação foi bem-sucedida.
`Error executing action "Get Issue Details". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully returned details for the following issue using information from Wiz: ISSUE_ID

The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID

A ação foi bem-sucedida.

Error executing action "Get Issue 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 indica o valor do resultado do script quando usa a ação Get Issue Details:

Nome do resultado do script	Valor
`is_success`	`True` ou `False`

Reabrir problema

Use a ação Reabrir problema para reabrir um problema especificado no Wiz.

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

Dados de ações

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

Parâmetro Descrição

Parâmetro	Descrição
`Issue ID`	Obrigatório. O identificador exclusivo do problema no Wiz para obter ou atualizar.

Issue ID

Obrigatório.

O identificador exclusivo do problema no Wiz para obter ou atualizar.

Resultados da ação

A ação Reabrir problema 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 Reopen Issue:

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "OPEN",
    "dueAt": null,
    "resolutionReason": null
}

Mensagens de saída

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

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully reopened issue with ID ISSUE_ID` no Wiz.	A ação foi bem-sucedida.
`Error executing action "Reopen Issue". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully reopened issue with ID ISSUE_ID no Wiz.

A ação foi bem-sucedida.

Error executing action "Reopen Issue". 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 Reabrir problema:

Nome do resultado do script	Valor
`is_success`	`True` ou `False`

Ignorar problema

Use a ação Ignorar problema para ignorar um problema especificado no Wiz.

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

Dados de ações

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

Parâmetro Descrição

Parâmetro	Descrição
`Issue ID`	Obrigatório. O identificador exclusivo do problema no Wiz.
`Resolution Reason`	Obrigatório. O motivo da resolução do problema. Os valores possíveis são os seguintes: `False Positive` `Exception` `Won't Fix~` O valor predefinido é `False Positive`.
`Resolution Note`	Opcional. Uma nota que dá contexto adicional para a resolução do problema.

Issue ID

Obrigatório.

O identificador exclusivo do problema no Wiz.

Resolution Reason

Obrigatório.

O motivo da resolução do problema.

Os valores possíveis são os seguintes:

False Positive
Exception
Won't Fix~

O valor predefinido é False Positive.

Resolution Note

Opcional.

Uma nota que dá contexto adicional para a resolução do problema.

Resultados da ação

A ação Ignorar problema 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 Ignore Issue:

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "REJECTED",
    "dueAt": null,
    "resolutionReason": "FALSE_POSITIVE"
}

Mensagens de saída

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

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully ignored issue with ID ISSUE_ID` no Wiz.	A ação foi bem-sucedida.
`Error executing action "Ignore Issue". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully ignored issue with ID ISSUE_ID no Wiz.

A ação foi bem-sucedida.

Error executing action "Ignore Issue". 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 Ignorar problema:

Nome do resultado do script	Valor
`is_success`	`True` ou `False`

Resolva o problema

Use a ação Resolver problema para resolver um problema especificado no Wiz.

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

Dados de ações

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

Parâmetro Descrição

Parâmetro	Descrição
`Issue ID`	Obrigatório. O identificador exclusivo do problema no Wiz.
`Resolution Reason`	Obrigatório. O motivo da resolução do problema. Os valores possíveis são os seguintes: `Malicious Threat` `Not Malicious Threat` `Security Test Threat` `Planned Action Threat` `Inconclusive Threat` O valor predefinido é `Not Malicious Threat`.
`Resolution Note`	Opcional. Uma nota que dá contexto adicional sobre a resolução.

Issue ID

Obrigatório.

O identificador exclusivo do problema no Wiz.

Resolution Reason

Obrigatório.

O motivo da resolução do problema.

Os valores possíveis são os seguintes:

Malicious Threat
Not Malicious Threat
Security Test Threat
Planned Action Threat
Inconclusive Threat

O valor predefinido é Not Malicious Threat.

Resolution Note

Opcional.

Uma nota que dá contexto adicional sobre a resolução.

Resultados da ação

A ação Resolver problema 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 Resolve Issue:

{
    "id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
    "resolutionNote": "",
    "status": "RESOLVED",
    "dueAt": null,
    "resolutionReason": "NOT_MALICIOUS_THREAT"
}

Mensagens de saída

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

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully resolved issue with ID ISSUE_ID` no Wiz.	A ação foi bem-sucedida.
`Error executing action "Resolve Issue". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully resolved issue with ID ISSUE_ID no Wiz.

A ação foi bem-sucedida.

Error executing action "Resolve Issue". 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 Resolve Issue:

Nome do resultado do script	Valor
`is_success`	`True` ou `False`

Adicionar comentário ao problema

Use a ação Adicionar comentário ao problema para adicionar um comentário a um problema especificado no Wiz.

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

Dados de ações

A ação Add Comment To Issue requer os seguintes parâmetros:

Parâmetro Descrição

Parâmetro	Descrição
`Issue ID`	Obrigatório. O identificador exclusivo do problema no Wiz.
`Comment`	Obrigatório. O texto do comentário a adicionar ao problema.

Issue ID

Obrigatório.

O identificador exclusivo do problema no Wiz.

Comment

Obrigatório.

O texto do comentário a adicionar ao problema.

Resultados da ação

A ação Add Comment To Issue (Adicionar comentário ao problema) 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 Add Comment To Issue:

{
  "createdAt": "2025-08-01T11:59:00.843434941Z", "id":
  "6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}

Mensagens de saída

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

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully added a comment to the issue with ID ISSUE_ID` no Wiz.	A ação foi bem-sucedida.
`Error executing action "Add Comment To Issue". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully added a comment to the issue with ID ISSUE_ID no Wiz.

A ação foi bem-sucedida.

Error executing action "Add Comment To Issue". 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 comentário ao problema:

Nome do resultado do script	Valor
`is_success`	`True` ou `False`

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