O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Proteção de e-mail da Proofpoint

Este documento fornece orientações sobre como integrar o Proofpoint Email Protection ao Google SecOps.

Integrar a proteção de e-mail da Proofpoint ao Google Security Operations

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

Entradas de integração

Para configurar a integração, use os seguintes parâmetros:

Parâmetros
`API Root`	Obrigatório Raiz da API da sua instância do Proofpoint Email Protection.
`Username`	Obrigatório Nome de usuário da sua instância do Proofpoint Email Protection.
`Password`	Obrigatório Senha da sua instância do Proofpoint Email Protection.
`Verify SSL`	Opcional Se marcada, verifica se o certificado de conexão SSL com o servidor do Proofpoint é válido.

Ações

Antes de executar ações, configure os parâmetros respectivos, se houver.

Enriquecer entidades

Enriqueça entidades com a proteção de e-mail da Proofpoint.

Entidades

Essa ação é executada nas seguintes entidades:

Nome do host
Usuário

Entradas de ação

N/A

Saídas da ação

Tipo de saída da ação
Anexo do Painel de Casos	N/A
Link do Painel de Casos	N/A
Tabela do Painel de Casos	N/A
Tabela de enriquecimento	Disponível
Resultado JSON	N/A
Resultado do script	Disponível

Enriquecimento de entidade

Campo de enriquecimento	Lógica
`dlpviolation`	N/A
`messagestatus`	N/A

Resultado do script

Nome do resultado do script	Valor
is_success	Verdadeiro/falso

Ping

Teste a conectividade do servidor de proteção do Proofpoint.

Entidades

Essa ação é executada em todas as entidades.

Entradas de ação

N/A

Saídas da ação

Tipo de saída da ação
Anexo do Painel de Casos	N/A
Link do Painel de Casos	N/A
Tabela do Painel de Casos	N/A
Tabela de enriquecimento	N/A
Resultado JSON	N/A
Resultado do script	Disponível

Resultado do script

Nome do resultado do script	Valor
is_success	Verdadeiro/falso

Pesquisar e-mails em quarentena

Use a ação Pesquisar e-mails em quarentena para rastrear e analisar informações sobre mensagens em quarentena na proteção de e-mail da Proofpoint.

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

Entradas de ação

A ação Pesquisar e-mails em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUID`	Opcional O GUID exclusivo da mensagem a ser pesquisada.
`Message ID`	Opcional O ID exclusivo da mensagem da Internet a ser pesquisado.
`Sender`	Opcional O endereço de e-mail do remetente.
`Recipient`	Opcional O endereço de e-mail do destinatário.
`Subject`	Opcional O assunto do e-mail em quarentena.
`Time Frame`	Opcional Especifique um período para os resultados. Os valores possíveis são: `Last Hour` `Last 6 Hours` `Last 24 Hours` `Last Week` `Custom` O valor padrão é `Last Hour`.
`Start Time`	Opcional Especifique a hora de início dos resultados no formato ISO 8601. Esse parâmetro é obrigatório se `Custom` for selecionado para o parâmetro `Time Frame`.
`End Time`	Opcional Especifique a hora de término dos resultados no formato ISO 8601. Se ficar em branco e `Custom` for selecionado para o parâmetro `Time Frame`, a hora atual será usada.
`Folder Name`	Opcional O nome da pasta de quarentena. O valor padrão é `Quarantine`.
`Query ID`	Opcional Um ID usado pelo cliente REST para rastrear os resultados da pesquisa.
`Fetch DLP Violation`	Opcional Selecione o nível de dados de violação da DLP a serem buscados. Os valores possíveis são: `No` `Basic` `Detailed` O valor padrão é `No`.
`Fetch Message Status`	Opcional Se selecionado, busca o status da mensagem e os comentários. Não selecionada por padrão.
`Max Results To Return`	Opcional O número máximo de resultados a serem retornados. O valor padrão é `100`. O valor máximo é `1000`.

Saídas da ação

A ação Pesquisar e-mails em quarentena oferece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Disponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Pesquisar e-mails em quarentena:

[
  {
    "processingserver": "mta1",
    "date": "2026-05-25 09:30:00",
    "subject": "Test Subject",
    "messageid": "message-id-2",
    "folder": "PCI",
    "size": 1200,
    "rcpts": [
      "recipient@example.com"
    ],
    "from": "sender@example.com",
    "spamscore": 99,
    "guid": "message-guid-1",
    "host_ip": "10.10.10.10",
    "localguid": "14:14:7"
  }
]

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Pesquisar e-mails em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Encaminhar e-mail em quarentena

Use a ação Encaminhar e-mail em quarentena para encaminhar mensagens em quarentena para outro destinatário. Observação: essa ação funciona em mensagens criadas nos últimos 30 dias. Essa ação não é executada em entidades do Google SecOps.

Entradas de ação

A ação Encaminhar e-mail em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUIDs`	Obrigatório Lista separada por vírgulas de GUIDs de mensagens em quarentena.
`Folder Name`	Obrigatório Nome da pasta em que a mensagem está armazenada.
`Deleted Folder Name`	Opcional Pasta para mover a mensagem depois do encaminhamento.
`New Subject`	Opcional Substitui o assunto original.
`Append Old Subject`	Opcional Se selecionada, anexa o assunto original ao assunto encaminhado. Essa configuração está desativada por padrão.
`From Address`	Opcional Substitui o remetente do envelope.
`Header From`	Opcional Substitui o cabeçalho "De".
`To Address`	Obrigatório Endereços de e-mail dos destinatários para encaminhamento.
`New Body Comment`	Opcional Novo comentário no corpo da mensagem.

Saídas da ação

A ação Encaminhar e-mail em quarentena fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Encaminhar e-mail em quarentena:

{
  "success": [
    {
      "processingserver": "m0409394.ppops.net",
      "date": "2026-06-10 12:27:51",
      "subject": "JS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X",
      "messageid": "AM6PR05MB5064A15BF3842D5A4A09AE70BE1A2@AM6PR05MB5064.eurprd05.prod.outlook.com",
      "folder": "Outbound Spam",
      "size": 12174,
      "rcpts": [
        "user@example.com"
      ],
      "from": "james.bond@siemplifycyarx.onmicrosoft.com",
      "spamscore": 0,
      "guid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq",
      "host_ip": "mail-norwayeastazhn15013062.outbound.protection.outlook.com [52.102.179.62]",
      "localguid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq"
    }
  ]
}

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Encaminhar e-mail em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Mensagens de saída da ação

A ação Encaminhar e-mail em quarentena fornece as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
`Successfully forwarded quarantined email(s) in Proofpoint Email Protection.`	A ação foi concluída.
`Error executing action "Forward Quarantined Email". Reason: ERROR_REASON`	Falha na ação. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Liberar e-mail em quarentena

Use a ação Liberar e-mail em quarentena para liberar as mensagens especificadas.

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

Entradas de ação

A ação Liberar e-mail em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUIDs`	Obrigatório Lista separada por vírgulas de GUIDs de mensagens em quarentena.
`Folder Name`	Obrigatório Nome da pasta em que a mensagem está armazenada.
`Deleted Folder Name`	Opcional Pasta para mover a mensagem após a liberação.
`Rescan Message`	Opcional Se selecionada, faz uma nova verificação da mensagem liberada pela DLP e pela Defesa de anexos. Essa configuração está desativada por padrão.
`Branding Template`	Opcional Modelo de branding a ser usado quando lançado.
`Security Policy`	Opcional Perfil de resposta do leitor seguro.

Saídas da ação

A ação Liberar e-mail em quarentena fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Liberar e-mail em quarentena:

{
  "success": [
    {
      "processingserver": "m0409394.ppops.net",
      "date": "2026-06-10 12:27:51",
      "subject": "JS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X",
      "messageid": "AM6PR05MB5064A15BF3842D5A4A09AE70BE1A2@AM6PR05MB5064.eurprd05.prod.outlook.com",
      "quarantinefolder": "Outbound Spam",
      "size": 12174,
      "rcpts": [
        "user@example.com"
      ],
      "from": "james.bond@siemplifycyarx.onmicrosoft.com",
      "spamscore": 0,
      "guid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq",
      "host_ip": "mail-norwayeastazhn15013062.outbound.protection.outlook.com [52.102.179.62]",
      "localguid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq"
    }
  ]
}

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Liberar e-mail em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Mensagens de saída da ação

A ação Liberar e-mail em quarentena fornece as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
`Successfully released quarantined email(s) in Proofpoint Email Protection.`	A ação foi concluída.
`Error executing action "Release Quarantined Email". Reason: ERROR_REASON`	Falha na ação. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Excluir e-mail em quarentena

Use a ação Excluir e-mail em quarentena para excluir permanentemente as mensagens em quarentena da pasta de quarentena do Proofpoint.

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

Entradas de ação

A ação Excluir e-mail em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUIDs`	Obrigatório Os GUIDs de mensagem exclusivos a serem excluídos. Aceita uma lista separada por vírgulas para vários GUIDs.
`Folder Name`	Obrigatório O nome da pasta em que a mensagem está armazenada (por exemplo, `Quarantine` ou `PCI`).
`Time Frame`	Opcional Especifique um período para os resultados. Os valores possíveis são: `Last Hour` `Last 6 Hours` `Last 24 Hours` `Last Week` `Custom` O valor padrão é `Last Hour`.
`Start Time`	Opcional Especifique a hora de início dos resultados no formato ISO 8601. Esse parâmetro é obrigatório se `Custom` for selecionado para o parâmetro `Time Frame`.
`End Time`	Opcional Especifique a hora de término dos resultados no formato ISO 8601. Se ficar em branco e `Custom` for selecionado para o parâmetro `Time Frame`, a hora atual será usada.
`Deleted Folder Name`	Opcional O nome da pasta para onde as mensagens excluídas serão movidas.

Saídas da ação

A ação Excluir e-mail em quarentena fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Resultado do script	Disponível

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Excluir e-mail em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Mover e-mail em quarentena

Use a ação Mover e-mail em quarentena para mover mensagens em quarentena para uma pasta de destino ou fila de regras especificada.

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

Entradas de ação

A ação Mover e-mail em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUIDs`	Obrigatório Os GUIDs de mensagem exclusivos a serem movidos. Aceita uma lista separada por vírgulas para vários GUIDs.
`Folder Name`	Obrigatório O nome da pasta em que a mensagem está armazenada (por exemplo, `Quarantine` ou `PCI`).
`Time Frame`	Opcional Especifique um período para os resultados. Os valores possíveis são: `Last Hour` `Last 6 Hours` `Last 24 Hours` `Last Week` `Custom` O valor padrão é `Last Hour`.
`Start Time`	Opcional Especifique a hora de início dos resultados no formato ISO 8601. Esse parâmetro é obrigatório se `Custom` for selecionado para o parâmetro `Time Frame`.
`End Time`	Opcional Especifique a hora de término dos resultados no formato ISO 8601. Se ficar em branco e `Custom` for selecionado para o parâmetro `Time Frame`, a hora atual será usada.
`Target Folder Name`	Obrigatório O nome da pasta de destino para onde os e-mails em quarentena serão movidos.

Saídas da ação

A ação Mover e-mail em quarentena oferece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Resultado do script	Disponível

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Mover e-mail em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Reenviar e-mail em quarentena

Use a ação Reenviar e-mail em quarentena para reenviar mensagens específicas em quarentena de volta à fila principal do processo de filtragem para reavaliação.

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

Entradas de ação

A ação Reenviar e-mail em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUIDs`	Obrigatório Os GUIDs de mensagem exclusivos a serem reenviados. Aceita uma lista separada por vírgulas para vários GUIDs.
`Folder Name`	Obrigatório O nome da pasta em que a mensagem está armazenada (por exemplo, `Quarantine` ou `PCI`).
`Time Frame`	Opcional Especifique um período para os resultados. Os valores possíveis são: `Last Hour` `Last 6 Hours` `Last 24 Hours` `Last Week` `Custom` O valor padrão é `Last Hour`.
`Start Time`	Opcional Especifique a hora de início dos resultados no formato ISO 8601. Esse parâmetro é obrigatório se `Custom` for selecionado para o parâmetro `Time Frame`.
`End Time`	Opcional Especifique a hora de término dos resultados no formato ISO 8601. Se ficar em branco e `Custom` for selecionado para o parâmetro `Time Frame`, a hora atual será usada.

Saídas da ação

A ação Reenviar e-mail em quarentena oferece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Resultado do script	Disponível

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Reenviar e-mail em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Baixar e-mail em quarentena

Use a ação Fazer o download do e-mail em quarentena para baixar os dados brutos das mensagens em quarentena criadas nos últimos 30 dias.

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

Entradas de ação

A ação Fazer o download do e-mail em quarentena exige os seguintes parâmetros:

Parâmetros
`Message GUIDs`	Obrigatório Os GUIDs de mensagem exclusivos dos e-mails a serem baixados.
`Folder Name`	Opcional O nome da pasta em que a mensagem está armazenada. Se não for especificado, o padrão será `Quarantine`.
`Download Folder Path`	Obrigatório O caminho da pasta em que o arquivo precisa ser armazenado. O valor padrão é `/tmp`.
`Overwrite`	Obrigatório Se selecionada, substitui qualquer arquivo com o mesmo nome. Ativado por padrão.
`Save To Case Wall`	Opcional Se selecionada, salva o arquivo baixado como um anexo no Painel de Casos. Essa configuração está desativada por padrão.

Saídas da ação

A ação Fazer o download do e-mail em quarentena fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Disponível
Link do Painel de Casos	Indisponível
Tabela do Painel de Casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Fazer o download do e-mail em quarentena:

{
  "success": [
    {
      "downloaded_file_path": "/tmp/filename",
      "processingserver": "m0409394.ppops.net",
      "date": "2026-06-10 12:27:51",
      "subject": "JS*C4JDBQADN1.NSBN3*2IDNEN*GTUBE-STANDARD-ANTI-UBE-TEST-EMAIL*C.34X",
      "messageid": "AM6PR05MB5064A15BF3842D5A4A09AE70BE1A2@AM6PR05MB5064.eurprd05.prod.outlook.com",
      "folder": "Outbound Spam",
      "size": 12174,
      "rcpts": [
        "user@example.com"
      ],
      "from": "data",
      "spamscore": 0,
      "guid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq",
      "host_ip": "mail-norwayeastazhn15013062.outbound.protection.outlook.com [52.102.179.62]",
      "localguid": "VSumNsz7vyHqnWhaZkUwElagll3ZCYZq"
    }
  ]
}

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Fazer o download do e-mail em quarentena:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Mensagens de saída da ação

A ação Baixar e-mail em quarentena fornece as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
`Successfully downloaded quarantined email(s) in Proofpoint Email Protection.`	A ação foi concluída.
`Error executing action "Download Quarantined Email". Reason: ERROR_REASON`	Falha na ação. Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

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