Protección de correo electrónico de Proofpoint

En este documento, se proporciona orientación para integrar la protección de correo electrónico de Proofpoint con Google SecOps.

Integra la protección del correo electrónico de Proofpoint con Google Security Operations

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Entradas de integración

Para configurar la integración, usa los siguientes parámetros:

Parámetros
API Root Obligatorio

Es la raíz de la API de tu instancia de Proofpoint Email Protection.
Username Obligatorio

Nombre de usuario de tu instancia de Proofpoint Email Protection.
Password Obligatorio

Contraseña de tu instancia de Proofpoint Email Protection.
Verify SSL Optional

Si se marca, se verifica que el certificado de conexión SSL al servidor de Proofpoint sea válido.

Acciones

Antes de ejecutar acciones, asegúrate de configurar sus parámetros respectivos, si los hay.

Enriquece entidades

Enriquece las entidades con la protección de correo electrónico de Proofpoint.

Entidades

Esta acción se ejecuta en las siguientes entidades:

  • Nombre de host
  • Usuario

Entradas de acción

N/A

Resultados de la acción

Tipo de salida de la acción
Adjunto del muro de casos N/A
Vínculo al muro de casos N/A
Tabla del muro de casos N/A
Tabla de enriquecimiento Disponible
Resultado de JSON N/A
Resultado de secuencia de comandos Disponible
Enriquecimiento de entidades
Campo de enriquecimiento Lógica
dlpviolation N/A
messagestatus N/A
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Valor
is_success Verdadero o falso

Ping

Prueba la conectividad del servidor de protección de Proofpoint.

Entidades

Esta acción se ejecuta en todas las entidades.

Entradas de acción

N/A

Resultados de la acción

Tipo de salida de la acción
Adjunto del muro de casos N/A
Vínculo al muro de casos N/A
Tabla del muro de casos N/A
Tabla de enriquecimiento N/A
Resultado de JSON N/A
Resultado de secuencia de comandos Disponible
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Valor
is_success Verdadero o falso

Cómo buscar correos electrónicos en cuarentena

Usa la acción Buscar correos electrónicos en cuarentena para rastrear y analizar información sobre los mensajes en cuarentena en Proofpoint Email Protection.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Search Quarantined Emails requiere los siguientes parámetros:

Parámetros
Message GUID Optional

Es el GUID único del mensaje que se buscará.
Message ID Optional

Es el ID único del mensaje de Internet que se buscará.
Sender Optional

Es la dirección de correo electrónico del remitente.
Recipient Optional

Es la dirección de correo electrónico del destinatario.
Subject Optional

Es el asunto del correo electrónico en cuarentena.
Time Frame Optional

Especifica un período para los resultados.

Los valores posibles son los siguientes:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

El valor predeterminado es Last Hour.
Start Time Optional

Especifica la hora de inicio de los resultados en formato ISO 8601. Este parámetro es obligatorio si se selecciona Custom para el parámetro Time Frame.
End Time Optional

Especifica la hora de finalización de los resultados en formato ISO 8601. Si se deja en blanco y se selecciona Custom para el parámetro Time Frame, se usa la hora actual.
Folder Name Optional

Es el nombre de la carpeta de cuarentena. El valor predeterminado es Quarantine.
Query ID Optional

Es un ID que usa el cliente de REST para hacer un seguimiento de los resultados de la búsqueda.
Fetch DLP Violation Optional

Selecciona el nivel de datos de incumplimiento de la DLP que se recuperarán.

Los valores posibles son los siguientes:

  • No
  • Basic
  • Detailed

El valor predeterminado es No.
Fetch Message Status Optional

Si se selecciona, recupera el estado y los comentarios del mensaje. No está seleccionado de forma predeterminada.
Max Results To Return Optional

La cantidad máxima de resultados que se mostrarán. El valor predeterminado es 100. El valor máximo es 1000.

Resultados de la acción

La acción Search Quarantined Emails proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos Disponible
Tabla de enriquecimiento No disponible
Resultado de JSON Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Search Quarantined Emails:

[
  {
    "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 de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado del script cuando se usa la acción Search Quarantined Emails:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false

Reenvía el correo electrónico en cuarentena

Usa la acción Forward Quarantined Email para reenviar mensajes en cuarentena a otro destinatario. Nota: Esta acción funciona en los mensajes que se crearon en los últimos 30 días. Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Forward Quarantined Email requiere los siguientes parámetros:

Parámetros
Message GUIDs Obligatorio

Lista de GUIDs de mensajes en cuarentena separados por comas.
Folder Name Obligatorio

Nombre de la carpeta en la que se almacena el mensaje.
Deleted Folder Name Optional

Carpeta a la que se moverá el mensaje después de reenviarlo.
New Subject Optional

Reemplaza el asunto original.
Append Old Subject Optional

Si se selecciona, se agrega el asunto original al asunto reenviado. Está inhabilitado de forma predeterminada.
From Address Optional

Reemplaza el remitente del sobre.
Header From Optional

Reemplaza el encabezado De.
To Address Obligatorio

Direcciones de correo electrónico de los destinatarios a los que se reenviará el mensaje.
New Body Comment Optional

Es un comentario nuevo sobre el cuerpo del mensaje.

Resultados de la acción

La acción Forward Quarantined Email proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Forward Quarantined Email:

{
  "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 de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado del script cuando se usa la acción Forward Quarantined Email:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false
Mensajes de salida de la acción

La acción Forward Quarantined Email proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje
Successfully forwarded quarantined email(s) in Proofpoint Email Protection. La acción se completó correctamente.
Error executing action "Forward Quarantined Email". Reason: ERROR_REASON No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Cómo retirar un correo electrónico de la cuarentena

Usa la acción Liberar correo electrónico en cuarentena para liberar los mensajes en cuarentena especificados.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Release Quarantined Email requiere los siguientes parámetros:

Parámetros
Message GUIDs Obligatorio

Lista de GUIDs de mensajes en cuarentena separados por comas.
Folder Name Obligatorio

Nombre de la carpeta en la que se almacena el mensaje.
Deleted Folder Name Optional

Es la carpeta a la que se moverá el mensaje después de liberarlo.
Rescan Message Optional

Si se selecciona, DLP y Protección contra archivos adjuntos volverán a analizar el mensaje publicado. Está inhabilitado de forma predeterminada.
Branding Template Optional

Es la plantilla de desarrollo de la marca que se usará cuando se lance.
Security Policy Optional

Es el perfil de respuesta de Secure Reader.

Resultados de la acción

La acción Release Quarantined Email proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON Disponible
Resultado de secuencia de comandos Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Release Quarantined Email:

{
  "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 de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Release Quarantined Email:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false
Mensajes de salida de la acción

La acción Release Quarantined Email proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje
Successfully released quarantined email(s) in Proofpoint Email Protection. La acción se completó correctamente.
Error executing action "Release Quarantined Email". Reason: ERROR_REASON No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Borrar el correo electrónico en cuarentena

Usa la acción Borrar correo electrónico en cuarentena para borrar de forma permanente los mensajes en cuarentena de la carpeta de cuarentena de Proofpoint.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Borrar correo electrónico en cuarentena requiere los siguientes parámetros:

Parámetros
Message GUIDs Obligatorio

Son los GUID únicos de los mensajes que se borrarán. Admite una lista separada por comas para varios GUID.
Folder Name Obligatorio

Nombre de la carpeta en la que se almacena el mensaje (por ejemplo, Quarantine o PCI).
Time Frame Optional

Especifica un período para los resultados.

Los valores posibles son los siguientes:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

El valor predeterminado es Last Hour.
Start Time Optional

Especifica la hora de inicio de los resultados en formato ISO 8601. Este parámetro es obligatorio si se selecciona Custom para el parámetro Time Frame.
End Time Optional

Especifica la hora de finalización de los resultados en formato ISO 8601. Si se deja en blanco y se selecciona Custom para el parámetro Time Frame, se usa la hora actual.
Deleted Folder Name Optional

Nombre de la carpeta a la que se moverán los mensajes borrados.

Resultados de la acción

La acción Borrar correo electrónico en cuarentena proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON No disponible
Resultado de secuencia de comandos Disponible
Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Delete Quarantined Email:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false

Cómo mover un correo electrónico en cuarentena

Usa la acción Move Quarantined Email para mover los mensajes en cuarentena a una carpeta de destino o una cola de reglas especificadas.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Move Quarantined Email requiere los siguientes parámetros:

Parámetros
Message GUIDs Obligatorio

Son los GUID únicos de los mensajes que se moverán. Admite una lista separada por comas para varios GUID.
Folder Name Obligatorio

Nombre de la carpeta en la que se almacena el mensaje (por ejemplo, Quarantine o PCI).
Time Frame Optional

Especifica un período para los resultados.

Los valores posibles son los siguientes:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

El valor predeterminado es Last Hour.
Start Time Optional

Especifica la hora de inicio de los resultados en formato ISO 8601. Este parámetro es obligatorio si se selecciona Custom para el parámetro Time Frame.
End Time Optional

Especifica la hora de finalización de los resultados en formato ISO 8601. Si se deja en blanco y se selecciona Custom para el parámetro Time Frame, se usa la hora actual.
Target Folder Name Obligatorio

Es el nombre de la carpeta de destino a la que se moverán los correos electrónicos en cuarentena.

Resultados de la acción

La acción Mover correo electrónico en cuarentena proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON No disponible
Resultado de secuencia de comandos Disponible
Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Move Quarantined Email:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false

Cómo volver a enviar un correo electrónico en cuarentena

Usa la acción Volver a enviar correo electrónico en cuarentena para volver a enviar los mensajes en cuarentena especificados a la cola del proceso de filtrado principal para su reevaluación.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Resubmit Quarantined Email requiere los siguientes parámetros:

Parámetros
Message GUIDs Obligatorio

Son los GUID únicos de los mensajes que se volverán a enviar. Admite una lista separada por comas para varios GUID.
Folder Name Obligatorio

Nombre de la carpeta en la que se almacena el mensaje (por ejemplo, Quarantine o PCI).
Time Frame Optional

Especifica un período para los resultados.

Los valores posibles son los siguientes:

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Custom

El valor predeterminado es Last Hour.
Start Time Optional

Especifica la hora de inicio de los resultados en formato ISO 8601. Este parámetro es obligatorio si se selecciona Custom para el parámetro Time Frame.
End Time Optional

Especifica la hora de finalización de los resultados en formato ISO 8601. Si se deja en blanco y se selecciona Custom para el parámetro Time Frame, se usa la hora actual.

Resultados de la acción

La acción Resubmit Quarantined Email proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON No disponible
Resultado de secuencia de comandos Disponible
Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Resubmit Quarantined Email:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false

Descargar correo electrónico en cuarentena

Usa la acción Descargar correo electrónico en cuarentena para descargar los datos sin procesar de los mensajes en cuarentena creados en los últimos 30 días.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Download Quarantined Email requiere los siguientes parámetros:

Parámetros
Message GUIDs Obligatorio

Son los GUID únicos de los mensajes de los correos electrónicos que se descargarán.
Folder Name Optional

Nombre de la carpeta en la que se almacena el mensaje. Si no se especifica, el valor predeterminado es Quarantine.
Download Folder Path Obligatorio

Ruta de acceso a la carpeta en la que se debe almacenar el archivo. El valor predeterminado es /tmp.
Overwrite Obligatorio

Si se selecciona, se reemplazará cualquier archivo existente con el mismo nombre. Habilitada de forma predeterminada.
Save To Case Wall Optional

Si se selecciona, guarda el archivo descargado como un archivo adjunto en el muro del caso. Está inhabilitado de forma predeterminada.

Resultados de la acción

La acción Download Quarantined Email proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Adjunto del muro de casos Disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Descargar correo electrónico en cuarentena:

{
  "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 de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Download Quarantined Email:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false
Mensajes de salida de la acción

La acción Download Quarantined Email proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje
Successfully downloaded quarantined email(s) in Proofpoint Email Protection. La acción se completó correctamente.
Error executing action "Download Quarantined Email". Reason: ERROR_REASON No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.