Integra EmailV2 con Google SecOps

En este documento, se explica cómo integrar EmailV2 con Google Security Operations (Google SecOps).

Casos de uso

La integración de EmailV2 usa las funciones de Google SecOps para admitir los siguientes casos de uso:

  • Clasificación y notificación de phishing: Automatiza el proceso de envío de notificaciones por correo electrónico a los destinatarios, incluidos los usuarios externos, y configura guías asíncronas para esperar las respuestas de los usuarios (como la confirmación de un intento de phishing).

  • Enriquecimiento y retención de datos de incidentes: Busca en un buzón de correo mensajes relacionados según criterios (como remitente o asunto) y guarda todos los archivos adjuntos de correos electrónicos sospechosos directamente en el muro del caso para realizar análisis forenses y retención de datos.

  • Administración y contención de buzones de correo: Mueve automáticamente los correos electrónicos maliciosos o clasificados de la carpeta Recibidos a las carpetas de cuarentena o archivo, o borra de forma permanente los correos electrónicos que coincidan con filtros específicos (como borrar todas las copias de un correo electrónico con software malicioso conocido en varias carpetas).

  • Respuesta y colaboración en hilos: Envía una respuesta inmediata o una respuesta estructurada dentro de un hilo de correos electrónicos existente con la acción Enviar respuesta al hilo, lo que garantiza que todas las partes necesarias se mantengan al tanto con las actualizaciones de seguridad pertinentes.

Antes de comenzar

Para habilitar la integración de EmailV2 y conectarte correctamente a tu servidor de correo, debes asegurarte de que el buzón de correo configurado otorgue acceso a aplicaciones de terceros con IMAP/SMTP.

Si usas una cuenta de Gmail o Google Workspace, debes usar una contraseña de la app para autenticarte. Las contraseñas de cuentas estándar no funcionan para las conexiones IMAP/SMTP a los servidores de Google .

Para usar una contraseña de la aplicación, asegúrate de que se cumplan los siguientes requisitos:

  1. Habilita la verificación en 2 pasos: Las contraseñas de aplicaciones solo se pueden generar si la verificación en 2 pasos está habilitada en tu Cuenta de Google . Para obtener más detalles, consulta Cómo activar la verificación en 2 pasos.

  2. Genera una contraseña de la app de 16 dígitos: Crea una contraseña única para la integración. Para obtener más información, consulta Cómo acceder con contraseñas de la aplicación.

Acceso de red a IMAP/SMTP

Para acceder a los correos electrónicos recibidos y procesarlos con IMAP, y enviar correos electrónicos salientes con SMTP, se requiere acceso a la red con las credenciales de la cuenta configurada.

Requisitos de red

Función Puerto predeterminado Dirección Protocolo
Comunicación con el servidor de correo electrónico Valores múltiples Saliente IMAP/SMTP

Parámetros de integración

La integración de EmailV2 requiere los siguientes parámetros:

Parámetro Descripción
IMAP - Use SSL

Es opcional.

Si se selecciona, la acción habilita la comunicación segura (SSL/TLS) cuando se conecta al servidor IMAP.

Habilitada de forma predeterminada.

SMTP - Use Authentication

Es opcional.

Si se selecciona, la acción habilita la autenticación para la conexión SMTP.

Esto es obligatorio cuando el servidor SMTP no está en una configuración de "retransmisión abierta" y requiere credenciales para enviar correos electrónicos salientes.

Habilitada de forma predeterminada.

Sender's Address

Obligatorio.

La dirección de correo electrónico del buzón de correo que usa la integración para enviar y recibir mensajes.

Sender's Display Name

Obligatorio.

Es el nombre que aparece como remitente cuando la integración envía correos electrónicos.

SMTP Server Address

Es opcional.

Es el nombre de host de DNS o la dirección IP del servidor SMTP que se usa para enviar correos electrónicos, como smtp.gmail.com.

SMTP Port

Es opcional.

Es el número de puerto que se usa para conectarse al servidor SMTP, como 587 o 465.

IMAP Server Address

Es opcional.

Es el nombre de host de DNS o la dirección IP del servidor IMAP que se requiere para recuperar los correos electrónicos recibidos, como imap.gmail.com.

IMAP Port

Es opcional.

Es el número de puerto que se usa para conectarse al servidor IMAP, como 993.

Username

Obligatorio.

Es el nombre de usuario que se requiere para autenticarse en el servidor de correo (por lo general, la dirección de correo electrónico completa).

Password

Obligatorio.

Es la contraseña necesaria para autenticarse en el servidor de correo.

En el caso de las cuentas de Gmail o Google Workspace, debes ingresar la contraseña de la aplicación de 16 dígitos que se generó en la configuración de seguridad de tu Google cuenta.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.

Borrar correo electrónico

Usa la acción Borrar correo electrónico para quitar los correos electrónicos del buzón que coincidan con los criterios de búsqueda especificados. Puedes usar esta acción para borrar el primer correo electrónico coincidente que se encuentre o todos los correos electrónicos coincidentes.

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

Entradas de acción

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

Parámetro Descripción
Folder Name

Obligatorio.

Es una lista separada por comas de las carpetas del buzón de correo en las que la acción busca correos electrónicos.

Message IDs

Es opcional.

Es una lista separada por comas de los IDs de mensajes específicos que se deben buscar y borrar.

Si se proporciona, esta lista anula Subject Filter, Sender Filter y Recipient Filter.

Subject Filter

Es opcional.

Es un asunto que se usa para limitar la búsqueda de correos electrónicos que coincidan.

Sender Filter

Es opcional.

Es la dirección de un remitente que se usa para buscar correos electrónicos que coincidan.

Recipient Filter

Es opcional.

Es la dirección de un destinatario que se usa para buscar correos electrónicos que coincidan.

Days Back

Es opcional.

Es el período (en días) en el que la acción busca correos electrónicos para borrar.

El período se calcula con un nivel de detalle diario.

Si usas un valor de 0, la búsqueda se restringe a los correos electrónicos recibidos solo durante el día actual.

El valor predeterminado es 0.

Delete all matching emails

Es opcional.

Si se selecciona, la acción borra todos los correos electrónicos que coinciden con los criterios especificados; de lo contrario, solo borra la primera coincidencia.

Está inhabilitado de forma predeterminada.

Resultados de la acción

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

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Borrar correo electrónico:

{
    "deleted_emails": {
        "email_1_deleted": {
            "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
            "deleted_from_folder": "Inbox",
            "subject": "Suspicious Login Alert - Deleted",
            "sender": "noreply@system.com",
            "timestamp": "2025-11-20T14:30:00Z"
        },
        "email_2_deleted": {
            "message_id": "<u1v2w3x4y5z6a7b8c9d0e1f2g3h4i5j6k7l8m9n0@mail.example.com>",
            "deleted_from_folder": "Spam",
            "subject": "Phishing Offer",
            "sender": "scam@badsite.net",
            "timestamp": "2025-11-15T09:15:00Z"
        }
    }
}
Mensajes de salida

La acción Borrar correo electrónico puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

NUMBER_OF_DELETED_EMAILS email(s) were deleted successfully

Failed to find emails for deletion!

La acción se realizó correctamente.

Error deleting emails ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Borrar correo electrónico:

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

DownloadEmailAttachments

Usa la acción Descargar archivos adjuntos de correo electrónico para recuperar archivos adjuntos de correos electrónicos específicos y guardarlos en una ruta de acceso designada en el servidor de Google SecOps.

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

Entradas de acción

La acción Descargar archivos adjuntos de correo electrónico requiere los siguientes parámetros:

Parámetro Descripción
Folder Name

Obligatorio.

Es una lista separada por comas de las carpetas del buzón de correo en las que la acción busca el correo electrónico.

El valor predeterminado es Inbox.

Download Path

Obligatorio.

Es la ruta de acceso en el servidor de Google SecOps en la que se guardan los archivos adjuntos descargados.

Message IDs

Es opcional.

Es una lista separada por comas de los IDs de mensajes de los que se descargarán los archivos adjuntos.

Subject filter

Es opcional.

Es una línea de asunto que se usa para acotar la búsqueda del correo electrónico.

Resultados de la acción

La acción Descargar archivos adjuntos de correo electrónico proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Mensajes de salida

La acción Descargar archivos adjuntos de correo electrónico puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Downloaded NUMBER_OF_ATTACHMENTS attachments. ATTACHMENT_PATHS

La acción se realizó correctamente.

failed to download email attachments, the error is: ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Descargar archivos adjuntos de correo electrónico:

Nombre del resultado de la secuencia de comandos Valor
attachments_local_paths Es una cadena de rutas de acceso completas separadas por comas a los archivos adjuntos guardados.

Reenviar correo electrónico

Usa la acción Reenviar correo electrónico para enviar un correo electrónico existente, incluido el contenido de su conversación anterior, a nuevos destinatarios proporcionando el ID de mensaje único del correo electrónico original.

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

Entradas de acción

La acción Reenviar correo electrónico requiere los siguientes parámetros:

Parámetro Descripción
Folder Name

Obligatorio.

Son las carpetas del buzón de correo en las que se encuentra el correo electrónico original.

  • Proporciona una lista separada por comas si quieres verificar varias carpetas.
  • El nombre de la carpeta debe coincidir exactamente con el de la carpeta de IMAP.
  • Si el nombre de la carpeta contiene espacios, debe estar entre comillas dobles.

El valor predeterminado es Inbox.

Message ID of the email to forward

Obligatorio.

Es el message_id único del correo electrónico existente que reenvía la acción.

Recipients

Obligatorio.

Es una lista separada por comas de las direcciones de correo electrónico principales de los destinatarios nuevos.

CC

Es opcional.

Es una lista de direcciones de correo electrónico separadas por comas que se incluirán en el campo CC.

BCC

Es opcional.

Es una lista separada por comas de las direcciones de correo electrónico que se incluirán en el campo CCO.

Subject

Obligatorio.

Es el asunto del correo electrónico reenviado.

Content

Es opcional.

Contenido adicional del cuerpo que se incluirá en el correo electrónico reenviado.

Return message id for the forwarded email

Es opcional.

Si se selecciona, la acción devuelve el ID de mensaje único del correo electrónico reenviado recientemente en el resultado JSON.

Está inhabilitado de forma predeterminada.

Attachment Paths

Es opcional.

Es una lista separada por comas de las rutas de acceso de los archivos en el servidor para los archivos adjuntos adicionales.

Resultados de la acción

La acción Reenviar correo electrónico proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Reenviar correo electrónico:

{
   "Date"
   "message_id"
   "Recipient"
}
Mensajes de salida

La acción Reenviar correo electrónico puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Email was forwarded successfully.

Mail was forwarded successfully. Mail message ID is: MESSAGE_ID

La acción se realizó correctamente.

Failed to forward the email! The Error is ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Reenviar correo electrónico:

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

Mover correo electrónico a una carpeta

Usa la acción Mover correo electrónico a la carpeta para transferir correos electrónicos de una carpeta de origen especificada a otra carpeta de destino dentro del buzón de correo.

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

Entradas de acción

La acción Mover correo electrónico a la carpeta requiere los siguientes parámetros:

Parámetro Descripción
Source Folder Name

Obligatorio.

Es el nombre de la carpeta de origen desde la que se mueven los correos electrónicos.

Destination Folder Name

Obligatorio.

Es el nombre de la carpeta de destino a la que se mueven los correos electrónicos.

Message IDs

Es opcional.

Es una lista separada por comas de los IDs de mensajes específicos que se deben buscar y mover.

Si se proporciona, esta lista anula Subject Filter.

Subject Filter

Es opcional.

Es un asunto que se usa para limitar la búsqueda de correos electrónicos que coincidan.

Only Unread

Es opcional.

Si se selecciona, la búsqueda restringe los resultados solo a los correos electrónicos no leídos.

Está inhabilitado de forma predeterminada.

Resultados de la acción

La acción Mover correo electrónico a la carpeta proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados de JSON que se reciben cuando se usa la acción Mover correo electrónico a la carpeta:

{
    "emails": {
        "email_1": {
            "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1@mail.example.com>",
            "received": "Mon, 24 Nov 2025 10:00:00 +0000",
            "sender": "security-alert@example.com",
            "recipients": "user@example.com",
            "subject": "Phishing Alert: Urgent Action Required",
            "plaintext_body": "Original alert content...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Quarantine"
        },
        "email_2": {
            "message_id": "<a5b6c7d8e9f01g2h3i4j5k6l7m8n9o0p1q2r3s4t@mail.example.com>",
            "received": "Sun, 23 Nov 2025 14:30:00 +0000",
            "sender": "noreply@system.com",
            "recipients": "user@example.com",
            "subject": "System Update Notification",
            "plaintext_body": "System update successful...",
            "moved_from_folder": "Inbox",
            "moved_to_folder": "Archive"
        }
    }
}
Mensajes de salida

La acción Mover correo electrónico a la carpeta puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

NUMBER_OF_MOVED_EMAILS mails were successfully moved from SOURCE_FOLDER a DESTINATION_FOLDER

No mails were found matching the search criteria!

La acción se realizó correctamente.

Error search emails: ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Mover correo electrónico a la carpeta:

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

Ping

Usa la acción Ping para probar la conectividad con Email V2.

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

Entradas de acción

Ninguno

Resultados de la acción

La acción Ping proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Mensajes de salida

La acción Ping puede devolver los siguientes mensajes de resultado:

Mensaje de salida Descripción del mensaje

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

La acción se realizó correctamente.

Failed to connect to the IMAP server! Error is ERROR_REASON

Failed to connect to the SMTP server! Error is ERROR_REASON

SMTP (or IMAP) configuration is needed to execute action. Please configure STMP (or IMAP) on integration configuration page in Content Hub.

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

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

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

Guarda los archivos adjuntos de correos electrónicos en el caso

Usa la acción Guardar archivos adjuntos de correo electrónico en el caso para recuperar y guardar automáticamente los archivos adjuntos de correos electrónicos específicos del buzón de entrada directamente en el muro del caso actual.

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

Entradas de acción

La acción Guardar archivos adjuntos de correo electrónico en el caso requiere los siguientes parámetros:

Parámetro Descripción
Folder Name

Obligatorio.

Es una lista separada por comas de las carpetas del buzón de correo en las que la acción busca el correo electrónico.

Message ID

Es opcional.

Es el ID de mensaje único del correo electrónico del que se descargarán los archivos adjuntos.

Attachment To Save

Es opcional.

Es el nombre específico del archivo adjunto que se guardará.

Si no se proporciona ningún valor, la acción guarda todos los archivos adjuntos del correo electrónico en el muro del caso.

Resultados de la acción

La acción Guardar archivos adjuntos de correo electrónico en el caso proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Guardar archivos adjuntos de correo electrónico en el caso:

{
    "saved_attachments_from_email": {
        "message_id": "<a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0@mail.example.com>",
        "subject": "Email with Malicious Attachment",
        "sender": "external@suspicious.com",
        "attachments_saved": [
            {
                "file_name": "Invoice_Q3_2025.pdf",
                "file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
                "saved_to_case_wall": "True"
            },
            {
                "file_name": "Report_Data.docx",
                "file_hash_md5": "b3e0c1a9f8d7c6b5a4e3d2c1b0a9f8e7",
                "saved_to_case_wall": "True"
            }
        ]
    }
}
Mensajes de salida

La acción Guardar archivos adjuntos de correo electrónico en el caso puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully saved the following attachments from the email MESSAGE_ID: MESSAGE_INFO

La acción se realizó correctamente.

Failed to save the email attachments to the case, the error is: ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Guardar archivos adjuntos de correo electrónico en el caso:

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

Buscar correo electrónico

Usa la acción Buscar correo electrónico para encontrar correos electrónicos específicos dentro del buzón de correo configurado con varios criterios de filtrado.

La acción recupera detalles sobre los mensajes que coinciden en un archivo JSON, que se puede usar para un análisis automatizado o manual posterior.

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

Entradas de acción

La acción Buscar correo electrónico requiere los siguientes parámetros:

Parámetro Descripción
Folder Name

Obligatorio.

Es una lista separada por comas de las carpetas del buzón de correo en las que la acción busca correos electrónicos.

El valor predeterminado es Inbox.

Subject Filter

Es opcional.

Es un asunto que se usa para limitar la búsqueda de correos electrónicos que coincidan.

Sender Filter

Es opcional.

Es la dirección de un remitente que se usa para buscar correos electrónicos que coincidan.

Recipient Filter

Es opcional.

Es la dirección de un destinatario que se usa para buscar correos electrónicos que coincidan.

Time frame (minutes)

Obligatorio.

Es el período (en minutos) en el que la búsqueda busca correos electrónicos.

El valor predeterminado es 60.

Only Unread

Es opcional.

Si se selecciona, la búsqueda solo recupera los correos electrónicos no leídos.

Inhabilitado de forma predeterminada

Max Emails To Return

Obligatorio.

Es la cantidad máxima de correos electrónicos que devuelve la acción como resultado.

El valor predeterminado es 100.

Resultados de la acción

La acción Buscar correo electrónico proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Buscar correo electrónico:

{
    "emails": {
        "email_1": {
            "message id": "<CAJP=A_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Mon, 26 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user1@example.com,user2@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "pdfdocument.pdf",
            "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        },
        "email_2": {
            "message id": "<WEAA=D_uGkttoWc1eahvP43rWVEsdk77nMu1FomhgRjRSmySLLg@mail.example.com>",
            "received": "Wen, 21 Aug 2019 03:20:13 -0700 (PDT)",
            "sender": "user@test.example",
            "recipients": "user3@example.com",
            "subject": "Cool offer",
            "plaintext_body": "Hi, ...",
            "attachmment_1": "photo.jpg",        "attachment_1_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82",
            "attachmment_2": "word_document.docx",
            "attachment_2_file_hash_md5": "3bd4a36cc0ed0bfc12ae5e2ece929e82"
        }
    }
}
Mensajes de salida

La acción Buscar correo electrónico puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Search found NUMBER_OF_FOUND_EMAILS emails based on the provided search criteria

Search didn't found any matching emails

La acción se realizó correctamente.

Search didn't completed successfully due to error: ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Buscar correo electrónico:

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

Enviar correo electrónico

Usa la acción Enviar correo electrónico para enviar correos electrónicos desde el buzón configurado a varios destinatarios.

Esta acción devuelve de forma opcional el ID del mensaje, que luego puede usar la acción Wait for Email From User para hacer un seguimiento de las respuestas de los usuarios y controlar la ejecución de la guía.

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

Entradas de acción

La acción Enviar correo electrónico requiere los siguientes parámetros:

Parámetro Descripción
Recipients

Obligatorio.

Son las direcciones de correo electrónico de los destinatarios principales.

Si hay varias direcciones, deben estar separadas por comas.

CC

Es opcional.

Son las direcciones de correo electrónico que se incluirán en el campo Con copia (CC).

Si hay varias direcciones, deben estar separadas por comas.

Bcc

Es opcional.

Son las direcciones de correo electrónico que se incluirán en el campo Con copia oculta (Cco).

Si hay varias direcciones, deben estar separadas por comas.

Subject

Obligatorio.

Es el asunto del mensaje de correo electrónico.

Content

Obligatorio.

Es el contenido del cuerpo del mensaje de correo electrónico.

Return message id for the sent email

Es opcional.

Si se selecciona, la acción devuelve el ID de mensaje único en el resultado JSON.

La acción Wait for Email From User puede usar este ID para hacer un seguimiento de las respuestas.

Está inhabilitado de forma predeterminada.

Attachments Paths

Es opcional.

Es una lista separada por comas de las rutas de acceso absolutas de los archivos en el servidor para los archivos adjuntos.

Resultados de la acción

La acción Enviar correo electrónico proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Enviar correo electrónico:

{
    "message_id": "<4f1e50e8f4027d187a2385a39b83cde46e5b53c1-10013525-100078757@example.com>"
}
Mensajes de salida

La acción Enviar correo electrónico puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mail sent successfully.

Mail sent successfully. Mail message ID is: MESSAGE_ID

La acción se realizó correctamente.

Execution Failed: ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Enviar correo electrónico:

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

Enviar respuesta en la conversación

Usa la acción Enviar respuesta de conversación para enviar un mensaje nuevo como respuesta dentro de un hilo de correos electrónicos existente con el ID del mensaje original.

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

Entradas de acción

La acción Enviar respuesta al hilo requiere los siguientes parámetros:

Parámetro Descripción
Message ID

Obligatorio.

Es el ID único del mensaje al que se envía la respuesta.

Folder Name

Obligatorio.

Es una lista separada por comas de las carpetas del buzón de correo en las que la acción busca el correo electrónico original.

El nombre de la carpeta debe coincidir exactamente con el de la carpeta de IMAP. Si el nombre contiene espacios, debe estar entre comillas dobles (como "[Gmail]/Todos los correos electrónicos").

El valor predeterminado es Inbox.

Content

Obligatorio.

Es el contenido del cuerpo del mensaje de respuesta.

Attachment Paths

Es opcional.

Es una lista separada por comas de las rutas de acceso de los archivos en el servidor para los archivos adjuntos que se incluirán en la respuesta.

Reply All

Es opcional.

Si se selecciona, la respuesta se envía a todos los destinatarios de la conversación de correo electrónico original.

Este parámetro tiene prioridad sobre Reply To.

Habilitada de forma predeterminada.

Reply To

Es opcional.

Es una lista separada por comas de direcciones de correo electrónico específicas para recibir la respuesta.

Si Reply All está inhabilitado y no se proporciona ningún valor, la respuesta se envía solo al remitente del correo electrónico original.

Resultados de la acción

La acción Enviar respuesta al hilo proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Enviar respuesta al hilo:

{
    "message_id": "<162556278608.14165.480701790user@example>",
    "recipients": "test@example.com"
}
Mensajes de salida

La acción Enviar respuesta al hilo puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully sent reply to the message with ID MESSAGE_ID in Exchange.

La acción se realizó correctamente.

Error executing action "Send Thread Reply". Reason: ERROR_REASON

No se pudo realizar la acción.

Verifica la conexión con el servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Enviar respuesta al hilo:

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

Espera el correo electrónico del usuario

Usa la acción Esperar correo electrónico del usuario para pausar la ejecución de la guía y supervisar un buzón de entrada en busca de una respuesta a un mensaje enviado anteriormente por la acción Enviar correo electrónico.

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

Entradas de acción

La acción Espera el correo electrónico del usuario requiere los siguientes parámetros:

Parámetro Descripción
Email Message_id

Obligatorio.

Es el ID de mensaje único del correo electrónico enviado para el que la acción hace un seguimiento de las respuestas.

Si el mensaje se envió con la acción Enviar correo electrónico, selecciona SendEmail.JSONResult.message_id como marcador de posición.

Email Date

Obligatorio.

Es la marca de tiempo que indica cuándo se envió el correo electrónico original. La acción usa este valor para calcular la ventana de respuesta.

Si el mensaje se envió con la acción Enviar correo electrónico, usa el marcador de posición SendEmail.JSONResult.email_date.

Email Recipients

Obligatorio.

Es una lista separada por comas de las direcciones de correo electrónico de los destinatarios de los que la acción espera una respuesta.

Si el mensaje se envió con la acción Enviar correo electrónico, usa el marcador de posición SendEmail.JSONResult.email_date.

Wait stage timeout (minutes)

Es opcional.

Es la duración (en minutos) que la acción espera una respuesta antes de marcar la etapa de espera como agotada.

El valor predeterminado es 1440.

Wait for all recipients to reply?

Es opcional.

Si se selecciona, la guía espera las respuestas de todos los destinatarios para continuar; de lo contrario, continúa después de recibir la primera respuesta.

Habilitada de forma predeterminada.

Wait stage exclude pattern

Es opcional.

Es un patrón de expresión regular que se usa para excluir respuestas específicas (como mensajes automáticos de fuera de la oficina) para que no se consideren respuestas válidas.

Folder to check for reply

Es opcional.

Es una lista separada por comas de las carpetas del buzón de correo en las que la acción busca la respuesta del usuario.

Este parámetro distingue mayúsculas de minúsculas.

El valor predeterminado es Inbox.

Fetch Response Attachments

Es opcional.

Si se selecciona, los archivos adjuntos que se incluyan en la respuesta del destinatario se guardarán como archivos adjuntos para el resultado de la acción.

Está inhabilitado de forma predeterminada.

Resultados de la acción

La acción Wait for Email From User proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo 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
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Espera el correo electrónico del usuario:

{
    "Responses":
    {[
     "user1@example.com": "Approved",
     "user2@example.com": "",
     "user3@example.com": ""
     ]}
}
Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Espera un correo electrónico del usuario:

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

Conectores

Para obtener más información sobre cómo configurar conectores en Google SecOps, consulta Transferir tus datos (conectores).

Conector de correo electrónico IMAP genérico

Usa el conector de correo electrónico IMAP genérico para conectarte periódicamente a un correo electrónico IMAP y verificar si hay correos electrónicos nuevos en un buzón de correo especificado. El conector procesa los correos electrónicos nuevos casi en tiempo real y los traduce en alertas y casos contextualizados dentro de la plataforma de Google SecOps.

Problemas conocidos y limitaciones

  1. Archivos adjuntos de Outlook (.eml): Es posible que el conector no procese los archivos adjuntos convertidos al formato .eml por Microsoft Outlook si faltan encabezados esenciales. Google SecOps sigue creando una alerta para el correo electrónico, pero sin un evento basado en el archivo adjunto. El siguiente registro indica este problema:

    Error Code 1: Encountered an email object with missing headers. Please
    visit documentation portal for more details.
    
  2. Nombres de archivo faltantes: Cuando se procesan archivos de correo electrónico adjuntos que no tienen un nombre de archivo en los encabezados del correo electrónico, el conector asigna un nombre de archivo de marcador de posición único: Undefined_{UUID}.eml, lo que permite que el archivo adjunto aparezca como un evento en Google SecOps.

Reenvío de casos por correo electrónico

Google SecOps se comunica con el servidor de correo electrónico para buscar e incorporar correos electrónicos, y los reenvía a la plataforma para su traducción y contextualización casi en tiempo real como alertas de seguridad.

Reglas de conector

  • El conector usa SSL/TLS para garantizar la comunicación encriptada con el servidor de correo electrónico.
  • El conector admite la conexión al servidor de correo con un proxy para el tráfico de IMAP e IMAPS.
  • El conector permite buscar correos electrónicos en varias carpetas de buzones de correo. El parámetro Folder acepta una lista de nombres de carpetas que distingue mayúsculas de minúsculas y está separada por comas.
  • El conector admite la codificación Unicode, lo que le permite procesar correos electrónicos enviados en idiomas distintos del inglés.

Entradas del conector

El conector de correo electrónico IMAP genérico requiere los siguientes parámetros:

Parámetro Descripción
Default Environment

Es opcional.

Es el nombre del entorno al que se asignan las alertas transferidas.

Run Every

Es opcional.

La frecuencia con la que se ejecuta el conector para verificar si hay correos electrónicos nuevos.

El valor predeterminado es 00:00:10:00 (10 minutos).

Product Field Name

Obligatorio.

Es el nombre del campo en el que se almacena el nombre del producto.

El nombre del producto afecta principalmente la asignación. Para optimizar y mejorar el proceso de asignación del conector, el valor predeterminado se resuelve en un valor de resguardo al que se hace referencia desde el código. Cualquier entrada no válida para este parámetro se resuelve en un valor de resguardo de forma predeterminada.

El valor predeterminado es Product Name.

Event Field Name

Obligatorio.

Es el nombre del campo que determina el nombre del evento (subtipo).

El valor predeterminado es event_name_mail_type.

Additional headers to extract from emails

Es opcional.

Es una lista separada por comas de campos de encabezado personalizados que se extraerán del mensaje de correo electrónico durante el procesamiento del conector.

Script Timeout (Seconds)

Obligatorio.

Es el límite de tiempo de espera, en segundos, para el proceso de Python que ejecuta la secuencia de comandos actual.

El valor predeterminado es 60.

IMAP Server Address

Obligatorio.

Es la dirección IP o el nombre de host de DNS del servidor IMAP al que se conectará.

El valor predeterminado es imap.gmail.com.

IMAP Port

Obligatorio.

Es el número de puerto que se usa para conectarse al servidor IMAP.

El valor predeterminado es 993.

Username

Obligatorio.

Es el nombre de usuario del buzón de correo del que el conector extrae los correos electrónicos.

El valor predeterminado es username.

Password

Obligatorio.

La contraseña del buzón de correo que se usa para extraer correos electrónicos.

El valor predeterminado es 1.

Folder to check for emails

Obligatorio.

Es una lista separada por comas de las carpetas del buzón de correo en las que el conector busca correos electrónicos.

Este parámetro distingue mayúsculas de minúsculas.

El valor predeterminado es Inbox.

Server Time Zone

Es opcional.

La zona horaria configurada en el servidor de correo.

El valor predeterminado es UTC.

Environment Regex Pattern

Es opcional.

Es un patrón de expresión regular que se usa para manipular los datos del campo de evento y extraer el nombre del entorno.

IMAP USE SSL

Es opcional.

Si se selecciona, el conector usa SSL/TLS para establecer una conexión IMAP segura con el servidor de correo electrónico.

Habilitada de forma predeterminada.

Unread Emails Only

Es opcional.

Si se selecciona, el conector solo extrae los correos electrónicos no leídos.

Habilitada de forma predeterminada.

Mark Emails as Read

Es opcional.

Si se selecciona, los correos electrónicos se marcan como leídos después de que el conector los extrae correctamente.

Habilitada de forma predeterminada.

Attach Original EML

Es opcional.

Si se selecciona, el mensaje original se adjunta a la alerta creada como un archivo .eml.

Está inhabilitado de forma predeterminada.

Regex expressions to handle forwarded emails

Es opcional.

Es una cadena JSON de una sola línea que contiene patrones de expresiones regulares para extraer los campos de asunto, remitente y destinatario originales de los correos electrónicos reenviados.

Exclusion Body Regex

Es opcional.

Es un patrón de expresión regular que se usa para excluir correos electrónicos de la transferencia si el contenido del cuerpo coincide con el patrón, como ([N|n]ewsletter)|([O|o]ut of office).

Exclusion Subject Regex

Es opcional.

Es un patrón de expresión regular que se usa para excluir correos electrónicos de la transferencia si la línea de asunto coincide con el patrón, como ([N|n]ewsletter)|([O|o]ut of office).

Offset Time In Days

Obligatorio.

Es la cantidad máxima de días hacia atrás desde los que el conector recupera el correo (período máximo).

Este valor también sirve como resguardo para la ejecución inicial o si la marca de tiempo del conector vence, lo que garantiza que se transfieran las alertas durante el período inhabilitado.

El valor predeterminado es 5.

Max Emails Per Cycle

Obligatorio.

Es la cantidad máxima de correos electrónicos que el conector procesa en un solo ciclo de sondeo.

El valor predeterminado es 10.

Proxy Server Address

Es opcional.

Es la dirección del servidor proxy que se usará.

Proxy Username

Es opcional.

Es el nombre de usuario para la autenticación del servidor proxy.

Proxy Password

Es opcional.

Es la contraseña para la autenticación del servidor proxy.

Create a Separate Siemplify Alert per Attached Mail File?

Es opcional.

Si se selecciona, el conector crea una alerta independiente para cada archivo de correo electrónico adjunto que se encuentre en un mensaje.

Esto es útil cuando la asignación de eventos se configura para crear entidades a partir de archivos de correo electrónico adjuntos.

Está inhabilitado de forma predeterminada.

Original Received Mail Prefix

Es opcional.

Un prefijo (como orig) que se agrega a las claves extraídas (para, de, asunto, etc.) del correo electrónico original recibido en el buzón de correo supervisado.

El valor predeterminado es orig.

Attached Mail File Prefix

Es opcional.

Un prefijo (como attach) agregado a las claves extraídas (para, de, asunto, etc.) de los archivos de correo adjuntos que se encuentran en el correo electrónico.

El valor predeterminado es attach.

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