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:
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.
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 Port |
Es opcional. Es el número de puerto que se usa para conectarse al servidor SMTP, como
|
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 Port |
Es opcional. Es el número de puerto que se usa para conectarse al servidor IMAP, como
|
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 |
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 El valor predeterminado es |
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 |
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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.
El valor predeterminado es |
Message ID of the email to forward |
Obligatorio. Es el |
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 |
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 |
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 |
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 |
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 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 |
|---|---|
|
La acción se realizó correctamente. |
|
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 |
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 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 |
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 |
|---|---|
|
La acción se realizó correctamente. |
|
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
|
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
|
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
|
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 |
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 |
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
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.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
Folderacepta 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 |
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 |
Event Field Name |
Obligatorio. Es el nombre del campo que determina el nombre del evento (subtipo). El valor predeterminado es |
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 |
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 Port |
Obligatorio. Es el número de puerto que se usa para conectarse al servidor IMAP. El valor predeterminado es |
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 |
Password |
Obligatorio. La contraseña del buzón de correo que se usa para extraer correos electrónicos. El valor predeterminado es |
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 |
Server Time Zone |
Es opcional. La zona horaria configurada en el servidor de correo. El valor predeterminado es |
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
|
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
|
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 |
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 |
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 El valor predeterminado es |
Attached Mail File Prefix |
Es opcional. Un prefijo (como El valor predeterminado es |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.