Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Integra Microsoft Graph Mail en Google SecOps

Microsoft Graph Mail | Microsoft Graph Mail Delegated

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

Antes de comenzar

Antes de configurar la integración de Microsoft Graph Mail, haz lo siguiente:

Crea la aplicación de Microsoft Entra.
Configura los permisos de la API para tu aplicación.
Crea un secreto del cliente.

Crea la aplicación de Microsoft Entra

Para crear la app de Microsoft Entra, completa los siguientes pasos:

Accede al portal de Azure como administrador de usuarios o administrador de contraseñas.
Selecciona Microsoft Entra ID.
Ve a Registros de apps > Nuevo registro.
Ingresa el nombre de la aplicación.
Haz clic en Registrar.

En este documento, se proporciona un ejemplo en el que se usa una configuración de usuario único. Como esta integración usa el flujo de credenciales de cliente de OAuth 2.0, no se produce el acceso interactivo del usuario. Por lo tanto, no se requiere un Redirect URI.
Guarda los valores de ID de aplicación (cliente) y de ID de directorio (usuario) para configurar los parámetros de integración.

Configura los permisos de API

Para configurar los permisos de la API para la integración, completa los siguientes pasos:

En Azure Portal, ve a Permisos de API > Agregar un permiso.
Selecciona Microsoft Graph > Permisos de aplicación.
En la sección Seleccionar permisos, selecciona los siguientes permisos obligatorios:
- Mail.Read
- Mail.ReadWrite
- Mail.Send
- User.Read
- Directory.Read.All
Nota: Esta integración admite buzones de correo compartidos. De forma predeterminada, otorgar permisos de aplicación permite que la integración lea buzones de correo en todo tu arrendatario. Para restringir el acceso solo a buzones de correo compartidos específicos, configura una política de acceso a aplicaciones de Microsoft.
Haz clic en Agregar permisos.
Haz clic en Grant admin consent for ORGANIZATION_NAME.

Cuando aparezca el diálogo Grant admin consent confirmation, haz clic en Yes.

Limita el acceso de la aplicación a buzones de correo específicos

De forma predeterminada, las aplicaciones con permisos de aplicación Mail.ReadWrite o Mail.Send tienen acceso a todos los buzones de correo de tu organización. Para restringir el acceso de la aplicación solo a buzones de correo específicos, configura políticas de acceso a la aplicación en Microsoft Exchange Online.

Para configurar las políticas de acceso a la aplicación, completa los siguientes pasos:

Conéctate a Exchange Online PowerShell:
1. Abre PowerShell como administrador.
2. Instala el módulo Exchange Online Management (si aún no está instalado):
```
Install-Module -Name ExchangeOnlineManagement
```
3. Conéctate a Exchange Online:
```
Connect-ExchangeOnline
```
Identifica el ID de aplicación y los buzones de correo de destino:
1. Obtén el ID de cliente (ID de aplicación) de tu aplicación de Microsoft Graph Mail desde Azure AD.
2. Identifica las direcciones de correo electrónico de los buzones a los que quieres que acceda la aplicación. Para facilitar la administración, crea un grupo de seguridad habilitado para correo en Azure AD y agrega estos buzones de correo como miembros.
Crea una política de acceso a la aplicación:
1. Usa el cmdlet New-ApplicationAccessPolicy para crear una política que restrinja el acceso a los buzones de correo seleccionados.
2. Opcional: Restringe el acceso a un grupo de seguridad específico de buzones de correo:
  1. Reemplaza <Your_Application_ID> por el ID de cliente de tu aplicación.
  2. Reemplaza <Security_Group_Email_Address> por la dirección de correo electrónico del grupo de seguridad que contiene los buzones de correo permitidos.
```
New-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -PolicyScopeGroupId "<Security_Group_Email_Address>" -AccessRight RestrictAccess -Description "SOAR Graph Mail Access Policy"
```
Verifica la eficacia de la política con el cmdlet Test-ApplicationAccessPolicy:
```
   Test-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -Identity "user_email_to_test@yourdomain.com"
```
Este comando indica si la aplicación tiene acceso al buzón de correo especificado según las políticas aplicadas.

Nota:

Se requieren los permisos OrganizationManagement o Security Administrator en Exchange Online para crear estas políticas.
Los cambios en las políticas suelen aplicarse en un plazo de 30 minutos.
Después de aplicar la política, la aplicación solo puede acceder a los buzones permitidos. Los intentos de acceder a otros devolverán un error Access Denied.

Crea un secreto del cliente

Para crear un secreto del cliente, completa los siguientes pasos:

Ve a Certificados y secretos > Nuevo secreto del cliente.
Proporciona una descripción para un secreto del cliente y establece su fecha límite de vencimiento.
Haz clic en Agregar.
Guarda el valor del secreto del cliente (no el ID del secreto) para usarlo como el valor del parámetro ID del secreto cuando configures la integración. El valor del secreto del cliente solo se muestra una vez.

Parámetros de integración

La integración de Microsoft Graph Mail requiere los siguientes parámetros:

Parámetro	Descripción
`Azure AD Endpoint`	Obligatorio. Es el extremo de Microsoft Entra ID que se usará en la integración. El valor puede ser diferente para los distintos tipos de inquilinos. El valor predeterminado es `https://login.microsoftonline.com`.
`Microsoft Graph Endpoint`	Obligatorio. Es el extremo de Microsoft Graph que se usará en la integración. El valor puede ser diferente para los distintos tipos de usuarios. El valor predeterminado es `https://graph.microsoft.com`.
`Client ID`	Obligatorio. Es el ID de cliente (aplicación) de la aplicación de Microsoft Entra que se usará en la integración.
`Secret ID`	Obligatorio. Es el valor del secreto del cliente de la aplicación de Microsoft Entra que se usará en la integración.
`Tenant`	Obligatorio. El valor de Microsoft Entra ID (ID de usuario).
`Default Mailbox`	Obligatorio. Es el buzón de correo que se usará en la integración.
`Mail Field Source`	Es opcional. Si se selecciona, la integración recupera la dirección del buzón de correo del atributo `mail` de los detalles del usuario. Si no se selecciona, la integración recupera la dirección del buzón de correo del campo `userPrincipalName`. No está seleccionado de forma predeterminada.
`Verify SSL`	Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Microsoft Graph. Habilitada de forma predeterminada.
`Base64 Encoded Private Key`	Es opcional. Es la clave privada codificada en Base64 que se usa para desencriptar los correos electrónicos encriptados con S/MIME. Si se proporciona un valor, también debes proporcionar el `Base64 Encoded Certificate`.
`Base64 Encoded Certificate`	Es opcional. Es el certificado codificado en Base64 que se usa para desencriptar los correos electrónicos encriptados con S/MIME. Si se proporciona un valor, también debes proporcionar el `Base64 Encoded Private Key`.
`Base64 Encoded CA certificate`	Es opcional. Es el certificado de la AC de confianza codificado en Base64 para la verificación de la firma. Si no se proporciona ningún valor, la verificación de firmas de los correos electrónicos firmados entrantes fallará, a menos que `Bypass S/MIME Signature Verification` esté habilitado.

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 Compatibilidad con varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Cómo responder a las acciones pendientes de Tu escritorio y Cómo realizar una acción manual.

Bloquear dominio

Usa la acción Bloquear dominio para bloquear dominios de correo electrónico específicos agregándolos a una regla de mensajes en el buzón de destino. Si la regla no existe, se crea.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

Entradas de acción

La acción Bloquear dominio requiere los siguientes parámetros:

Parámetro	Descripción
`Domains`	Es opcional. Lista de dominios de remitentes separados por comas que se bloquearán (por ejemplo, `example.com`). Los dominios ingresados manualmente en este campo y los dominios extraídos de forma dinámica de las entidades funcionan en conjunto y se agregarán a las condiciones de la regla.
`Mailboxes`	Obligatorio. El valor predeterminado es `Default Mailbox`. Son los buzones de correo en los que se agregará la regla de mensajes. Puede ser una lista separada por comas de nombres de principales de usuario.
`Rule Name`	Obligatorio. El valor predeterminado es `Google SecOps - Blocked Domains`. Es el nombre de la regla de mensajes a la que se agregarán estos dominios. Si la regla existe, se actualizará.
`Action`	Obligatorio. El valor predeterminado es `Select One`. Es la acción que se debe realizar para estos dominios. Valores posibles: `Select One`, `Move To Junk`, `Delete`. `Move To Junk` los moverá a la carpeta Correo no deseado y `Delete` los dirigirá a Elementos eliminados. `Select One` conserva la acción existente si la regla existe.
`How many mailboxes to process in a single batch`	Es opcional. El valor predeterminado es `20`. Especifica cuántos buzones de correo debe procesar la acción en un solo lote.

Resultados de la acción

La acción Block Domain 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 describe el resultado JSON que se recibe cuando usas la acción Bloquear dominio:

{
    "status": "Success",
    "mailbox": "user@domain.com",
    "blocked_domain": "malicious-domain.com"
}

Mensajes de salida

La acción Bloquear dominio proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully blocked domain DOMAIN for mailbox MAILBOX.`	La acción se realizó correctamente.
`Failed to block domain DOMAIN for mailbox MAILBOX. 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.

Successfully blocked domain DOMAIN for mailbox MAILBOX.

La acción se realizó correctamente.

Failed to block domain DOMAIN for mailbox MAILBOX. 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 describen los valores del resultado de la secuencia de comandos cuando se usa la acción Block Domain:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Bloquear al remitente

Usa la acción Bloquear remitente para bloquear remitentes de correo electrónico específicos agregándolos a una regla de mensajes en el buzón de destino. Si la regla no existe, se creará.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

Entradas de acción

La acción Bloquear remitente requiere los siguientes parámetros:

Parámetro	Descripción
`Senders`	Es opcional. Es una lista separada por comas de las direcciones de correo electrónico de los remitentes que se deben bloquear. Los remitentes ingresados manualmente en este campo y los remitentes extraídos de forma dinámica de las entidades funcionan en conjunto y se agregarán a las condiciones de la regla.
`Mailboxes`	Obligatorio. El valor predeterminado es `Default Mailbox`. Son los buzones de correo en los que se agregará la regla de mensajes. Puede ser una lista separada por comas de nombres de principales de usuario.
`Rule Name`	Obligatorio. El valor predeterminado es `Google SecOps - Blocked Senders`. Nombre de la regla de mensaje a la que se agregarán estos remitentes. Si la regla existe, se actualizará.
`Action`	Obligatorio. El valor predeterminado es `Select One`. Es la acción que se debe realizar para estos remitentes. Valores posibles: `Select One`, `Move To Junk`, `Delete`. `Move To Junk` los moverá a la carpeta Correo no deseado y `Delete` los dirigirá a Elementos eliminados. `Select One` conserva la acción existente si la regla existe.
`How many mailboxes to process in a single batch`	Es opcional. El valor predeterminado es `20`. Especifica cuántos buzones de correo debe procesar la acción en un solo lote.

Resultados de la acción

La acción Bloquear remitente 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 describe el resultado JSON que se recibe cuando usas la acción Bloquear remitente:

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]

Mensajes de salida

La acción Block Sender proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully blocked sender SENDER for mailbox MAILBOX.`	La acción se realizó correctamente.
`Failed to block sender SENDER for mailbox MAILBOX. 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.

Successfully blocked sender SENDER for mailbox MAILBOX.

La acción se realizó correctamente.

Failed to block sender SENDER for mailbox MAILBOX. 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 describen los valores del resultado del script cuando se usa la acción Block Sender:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Borrar correo electrónico

Puedes usar la acción Borrar correo electrónico para borrar uno o más correos electrónicos de un buzón de correo. Esta acción borra los correos electrónicos según tus criterios de búsqueda. Con los permisos adecuados, la acción Borrar correo electrónico puede mover correos electrónicos a diferentes buzones.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

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
`Delete In Mailbox`	Obligatorio. Es el buzón de correo predeterminado en el que se ejecutará la operación de borrado. Si los permisos lo permiten, la acción también puede buscar en otros buzones. Este parámetro acepta varios valores como una cadena separada por comas.
`Folder Name`	Obligatorio. Es una carpeta de buzón de correo para buscar correos electrónicos. Para especificar una subcarpeta, usa la barra `/`, como `Inbox/Subfolder`.
`Mail IDs`	Opcional Es una condición de filtro para buscar correos electrónicos con IDs específicos. Este parámetro acepta una lista separada por comas de IDs de correo electrónico para buscar. Si se proporciona este parámetro, la búsqueda ignora los parámetros `Subject Filter` y `Sender Filter`.
`Subject Filter`	Opcional Es una condición de filtro que especifica el asunto del correo electrónico que se buscará.
`Sender Filter`	Opcional Es una condición de filtro que especifica el remitente de los correos electrónicos solicitados.
`Timeframe (Minutes)`	Opcional Es una condición de filtro que especifica el período en minutos para buscar correos electrónicos.
`Only Unread`	Opcional Si se selecciona, la acción solo busca correos electrónicos no leídos. No se selecciona de forma predeterminada.
`How many mailboxes to process in a single batch`	Opcional Es la cantidad de buzones de correo que se procesarán en un solo lote (conexión única al servidor de correo). El valor predeterminado es `25`.

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Borrar correo electrónico:

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 Borrar correo electrónico proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully deleted emails in the following mailboxes: MAILBOX_NAME: DELETED_EMAILS_NUMBER` `Mailbox MAILBOX was not found.`	La acción se realizó correctamente.
`Action was not able to find any emails based on the specified search criteria.` `Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER` `Failed to find any of the provided mailboxes: MAILBOX_LIST` `Failed to execute action, 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.

Successfully deleted emails in the following mailboxes: MAILBOX_NAME: DELETED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

La acción se realizó correctamente.

Action was not able to find any emails based on the specified search criteria.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, 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 describen los valores del resultado de la secuencia de comandos cuando usas la acción Borrar correo electrónico:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Borrar reglas de Recibidos

Usa la acción Borrar reglas de Recibidos para borrar una regla de mensajes de Recibidos especificada para los buzones de correo indicados. Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

Entradas de acción

La acción Borrar reglas de la bandeja de entrada requiere los siguientes parámetros:

Parámetro Descripción

Parámetro	Descripción
`Mailboxes`	Obligatorio. El valor predeterminado es `Default Mailbox`. Son los buzones de correo de los que se borrará la regla de mensaje. Puede ser una lista separada por comas de los UPN de los usuarios principales.
`Rule Name`	Obligatorio. Es el nombre exacto de la regla de mensaje de la bandeja de entrada que se borrará.
`How many mailboxes to process in a single batch`	Es opcional. El valor predeterminado es `25`. Especifica cuántos buzones de correo debe procesar la acción en un solo lote. Si no se proporciona ningún valor, se usará el valor predeterminado de 25.

Mailboxes

Obligatorio. El valor predeterminado es Default Mailbox.

Son los buzones de correo de los que se borrará la regla de mensaje. Puede ser una lista separada por comas de los UPN de los usuarios principales.

Rule Name

Obligatorio.

Es el nombre exacto de la regla de mensaje de la bandeja de entrada que se borrará.

How many mailboxes to process in a single batch

Es opcional. El valor predeterminado es 25.

Especifica cuántos buzones de correo debe procesar la acción en un solo lote. Si no se proporciona ningún valor, se usará el valor predeterminado de 25.

Resultados de la acción

La acción Delete Inbox Rules proporciona los siguientes resultados:

Tipo de salida 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 describe el resultado JSON que se recibe cuando usas la acción Borrar reglas de Recibidos:

{
    "deleted_rule": [
        "New test cases"
    ],
    "successful_mailboxes": [
        "labops1@siemplifycyarx.onmicrosoft.com"
    ],
    "failed_mailboxes": [
        "user2@example.com",
        "user3@example.com"
    ]
}

Mensajes de salida

La acción Borrar reglas de Recibidos proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully deleted inbox rule RULE_NAME from mailbox MAILBOX.`	La acción se realizó correctamente.
`Failed to delete inbox rule RULE_NAME from mailbox MAILBOX. 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.

Successfully deleted inbox rule RULE_NAME from mailbox MAILBOX.

La acción se realizó correctamente.

Failed to delete inbox rule RULE_NAME from mailbox MAILBOX. 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 describen los valores del resultado del script cuando se usa la acción Delete Inbox Rules:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Descarga archivos adjuntos de correos electrónicos

Usa la acción Descargar archivos adjuntos de correos electrónicos para descargar archivos adjuntos de correos electrónicos según los criterios proporcionados.

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

Esta acción es asíncrona. Si es necesario, ajusta el valor del tiempo de espera de la secuencia de comandos en el IDE de Google SecOps.

La acción reemplaza el carácter de guion bajo \` forward slash or/backslash characters in the names of the downloaded attachments with the_`.

Entradas de acción

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

Parámetro	Descripción
`Search In Mailbox`	Obligatorio. Es el buzón de correo predeterminado en el que se ejecuta la operación de búsqueda. Si los permisos lo permiten, la acción también puede buscar en otros buzones. Este parámetro acepta varios valores como una cadena separada por comas.
`Folder Name`	Obligatorio. Es una carpeta de buzón de correo en la que se ejecutará la búsqueda. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`.
`Download Destination`	Obligatorio. Un tipo de almacenamiento para guardar los archivos adjuntos descargados. De forma predeterminada, la acción intenta guardar el archivo adjunto en el bucket de Cloud Storage. Guardar un archivo adjunto en el sistema de archivos local es una opción de resguardo. Los valores posibles son `GCP Bucket` y `Local File System`. El valor predeterminado es `GCP Bucket`.
`Download Path`	Obligatorio. Una ruta de acceso para descargar archivos adjuntos Cuando guardas archivos adjuntos en el bucket de Cloud Storage o en un sistema de archivos local, la acción espera que especifiques la ruta de descarga en formato similar a Unix, como `/tmp/test`.
`Mail IDs`	Opcional Es una condición de filtro para buscar correos electrónicos con IDs específicos. Este parámetro acepta una lista separada por comas de IDs de correo electrónico para buscar. Si se proporciona este parámetro, la búsqueda ignora los parámetros `Subject Filter` y `Sender Filter`.
`Subject Filter`	Opcional Es una condición de filtro que especifica el asunto del correo electrónico que se buscará. Este filtro usa la lógica `contains`.
`Sender Filter`	Opcional Es una condición de filtro que especifica el remitente de los correos electrónicos solicitados. Este filtro usa la lógica `equals`.
`Download Attachments From EML`	Opcional Si se selecciona, la acción descarga los archivos adjuntos de los archivos EML. No se selecciona de forma predeterminada.
`Download attachments to unique path?`	Opcional Si se selecciona, la acción descarga los archivos adjuntos en la ruta de acceso única proporcionada en el campo del parámetro `Download Path` para evitar que se sobrescriban los archivos adjuntos descargados anteriormente. No está seleccionada de forma predeterminada.
`How many mailboxes to process in a single batch`	Opcional Es la cantidad de buzones de correo que se procesarán en un solo lote (conexión única al servidor de correo). El valor predeterminado es `25`.

Resultados de la acción

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

Tipo de salida 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 describe el resultado en formato JSON que se recibe cuando se usa la acción Descargar archivos adjuntos del correo electrónico:

[
    {
        "attachment_name": "name1.png",
        "downloaded_path": "file_path/name1.png"
    },
    {
        "attachment_name": "name2.png",
        "downloaded_path": "file_path/name2.png"
    }
]

Mensajes de salida

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

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS.` `Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS.` `In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.`	La acción se realizó correctamente.
`Failed to find any emails using the provided criteria!` `Failed to find any of the provided mailboxes: MAILBOXES` `Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX` `Error executing action. Reason: ERROR_REASON`	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS.

Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS.

In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.

La acción se realizó correctamente.

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOXES

Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX

Error executing action. Reason: ERROR_REASON

No se pudo realizar la acción.

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

Resultado de secuencia de comandos

En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando se usa la acción Download Attachments From Email:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Extrae datos de un archivo EML adjunto

Usa la acción Extraer datos de un EML adjunto para recuperar datos de los archivos EML adjuntos al correo electrónico y devolverlos en los resultados de la acción. Esta acción admite los formatos de archivo .eml, .msg y .ics.

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

Entradas de acción

La acción Extract Data From Attached EML requiere los siguientes parámetros:

Parámetro	Descripción
`Search In Mailbox`	Obligatorio. Es el buzón de correo predeterminado en el que se ejecuta la operación de búsqueda. Si los permisos lo permiten, la acción también puede buscar en otros buzones de correo. Este parámetro acepta varios valores como una cadena separada por comas.
`Folder Name`	Opcional Es una carpeta de buzón de correo en la que se ejecutará la búsqueda. Para especificar una subcarpeta, usa la barra `/`, como `Inbox/Subfolder`.
`Mail IDs`	Obligatorio. Es una condición de filtro para buscar correos electrónicos con IDs específicos. Este parámetro acepta una lista separada por comas de IDs de correos electrónicos para buscar.
`Regex Map JSON`	Opcional Es una definición de JSON que contiene expresiones regulares para aplicar al archivo de correo electrónico adjunto y generar valores de clave adicionales en el resultado de JSON de la acción. El ejemplo de este valor de parámetro es el siguiente: {ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}

Resultados de la acción

La acción Extract Data From Attached EML proporciona los siguientes resultados:

Tipo de salida 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 describe el resultado en JSON que se recibe cuando se usa la acción Extraer datos de un archivo EML adjunto:

[
    {
        "type": "EML",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.eml"
    },
    {
        "type": "MSG",
        "subject": "examplesubject",
        "from": "user@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>examplehtml</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.msg"
    },
    {
        "type": "ICS",
        "subject": "examplesubject",
        "from": "sender@example.com",
        "to": "user1@example.com,user2@example.com",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.ics"
    }
]

Mensajes de salida

La acción Extract Data From Attached EML proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS` `Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST`	La acción se realizó correctamente.
`Failed to find any emails using the provided criteria!` `Failed to find any of the provided mailboxes: MAILBOX_LIST` `Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX` `Failed to execute action, the error is: ERROR_REASON`	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS

Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST

La acción se realizó correctamente.

Failed to find any emails using the provided criteria!

Failed to find any of the provided mailboxes: MAILBOX_LIST

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX

Failed to execute action, the error is:
      ERROR_REASON

No se pudo realizar la acción.

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

Resultado de secuencia de comandos

En la siguiente tabla, se describen los valores de la salida del resultado de la secuencia de comandos cuando se usa la acción Extraer datos de un EML adjunto:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Reenviar correo electrónico

Usa la acción Reenviar correo electrónico para reenviar correos electrónicos que incluyan hilos anteriores. Con los permisos adecuados, esta acción puede enviar correos electrónicos desde un buzón de correo distinto del especificado en la configuración de la integración.

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

Entradas de acción

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

Parámetro	Descripción
`Send From`	Obligatorio. Es una dirección de correo electrónico opcional desde la que se enviará un correo electrónico, si los permisos lo permiten. De forma predeterminada, el correo electrónico se envía desde el buzón de correo predeterminado especificado en la configuración de la integración.
`Folder Name`	Opcional Es una carpeta de buzón de correo en la que se buscan correos electrónicos. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`.
`Mail ID`	Obligatorio. Es el ID del correo electrónico que se reenviará.
`Subject`	Obligatorio. Es el asunto del correo electrónico.
`Send to`	Obligatorio. Lista de direcciones de correo electrónico separadas por comas de los destinatarios del correo electrónico, como `user1@example.com, user2@example.com`.
`CC`	Opcional Es una lista separada por comas de direcciones de correo electrónico para el campo CC del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`BCC`	Opcional Es una lista separada por comas de las direcciones de correo electrónico para el campo CCO del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`Attachments Paths`	Opcional Es una lista separada por comas de rutas de acceso para los archivos adjuntos almacenados en el servidor, como `/FILE_DIRECTORY/file.pdf`, `/FILE_DIRECTORY/image.jpg`.
`Mail content`	Obligatorio. Es el cuerpo del correo electrónico.

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Reenviar correo electrónico:

Tipo de salida 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 Reenviar correo electrónico proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Email with message ID MAIL_ID was forwarded successfully. La acción se realizó correctamente.

Mensaje de salida	Descripción del mensaje
`Email with message ID MAIL_ID was forwarded successfully.`	La acción se realizó correctamente.
`Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found.` `Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER` `Action failed to run because specified attachments were not found: ATTACHMENTS_LIST` `Failed to execute action, 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.

Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found.

Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, 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 describen los valores del resultado de la secuencia de comandos cuando usas la acción Reenviar correo electrónico:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Obtener la cuenta de buzón de la configuración de la instalación

Usa la acción Get Mailbox Account Out Of Facility Settings para recuperar la configuración de fuera de la oficina (OOF) de la cuenta de buzón de correo de la entidad de Google SecOps User proporcionada.

La acción Obtener la configuración de fuera de la oficina de la cuenta de buzón de correo usa la versión beta de la API de Microsoft Graph.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Get Mailbox Account Out Of Facility Settings proporciona los siguientes resultados:

Tipo de salida 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 muestra el resultado JSON que se recibe cuando usas la acción Get Mailbox Account Out Of Facility Settings:

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
   "id": "ID",
   "availability": "Offline",
   "activity": "Offline",
   "statusMessage": null,
   "outOfOfficeSettings": {
       "message": "\n\nOut Of Facility111\n",
       "isOutOfOffice": true
   }
}

Mensajes de salida

La acción Get Mailbox Account Out Of Facility Settings puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully returned OOF settings for ENTITY_ID.` `Failed to find the following usernames in Office 365 service: USERNAME_LIST.`	La acción se realizó correctamente.
`Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON` `Action wasn't able to find OOF settings for ENTITY_ID.`	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Successfully returned OOF settings for ENTITY_ID.

Failed to find the following usernames in Office 365 service: USERNAME_LIST.

La acción se realizó correctamente.

Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON

Action wasn't able to find OOF settings for ENTITY_ID.

No se pudo realizar la acción.

Verifica la conexión al 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 usas la acción Get Mailbox Account Out Of Facility Settings:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Reglas de listas

Usa la acción List Rules para enumerar todas las reglas de mensajes de un buzón específico con la API de Microsoft Graph.

Entradas de acción

La acción List Rules requiere los siguientes parámetros:

Parámetro Descripción

Parámetro	Descripción
`Mailboxes`	Obligatorio. El valor predeterminado es `Default Mailbox`. Son los buzones de correo para los que se enumerarán las reglas. Puede ser una lista separada por comas de nombres principales de usuario.
`Rule Name`	Es opcional. Filtra por el nombre visible de la regla.
`Limit`	Es opcional. El valor predeterminado es `20`. Limita la cantidad de reglas que se devolverán por buzón de correo.

Mailboxes

Obligatorio. El valor predeterminado es Default Mailbox.

Son los buzones de correo para los que se enumerarán las reglas. Puede ser una lista separada por comas de nombres principales de usuario.

Rule Name

Es opcional.

Filtra por el nombre visible de la regla.

Limit

Es opcional. El valor predeterminado es 20.

Limita la cantidad de reglas que se devolverán por buzón de correo.

Resultados de la acción

La acción List Rules 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	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción List Rules proporciona detalles de la ejecución en la tabla del muro del caso.

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando usas la acción List Rules:

[
  {
    "mailbox": "user@example.com",
    "rules": [
      {
        "id": "AAMkAD...",
        "displayName": "Google SecOps - Blocked Senders",
        "sequence": 1,
        "isEnabled": true
      }
    ]
  }
]

Mensajes de salida

La acción List Rules proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully fetched NUMBER_OF_RULES rules for mailbox MAILBOX.`	La acción se realizó correctamente.
`Failed to fetch rules for mailbox MAILBOX. 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.

Successfully fetched NUMBER_OF_RULES rules for mailbox MAILBOX.

La acción se realizó correctamente.

Failed to fetch rules for mailbox MAILBOX. 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 describen los valores del resultado de la secuencia de comandos cuando se usa la acción List Rules:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Marcar correo electrónico como no deseado

Usa la acción Mark Email as Junk para marcar correos electrónicos como correo no deseado en un buzón especificado. Esta acción agrega al remitente del correo electrónico a la lista de remitentes bloqueados y mueve el mensaje a la carpeta Correo no deseado.

La acción Marcar correo electrónico como correo no deseado usa la versión beta de la API de Microsoft Graph.

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

Entradas de acción

La acción Marcar correo electrónico como spam requiere los siguientes parámetros:

Parámetro Descripción

Parámetro	Descripción
`Search In Mailbox`	Obligatorio. Un buzón de correo en el que se buscarán correos electrónicos De forma predeterminada, la acción intenta buscar el correo electrónico en el buzón de correo predeterminado que especificaste en la configuración de la integración. Para ejecutar una búsqueda en otros buzones de correo, configura los permisos adecuados para la acción. Este parámetro acepta varios valores como una cadena separada por comas.
`Folder Name`	Obligatorio. Es una carpeta de buzón de correo en la que se buscan correos electrónicos. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`. El valor predeterminado es `Inbox`.
`Mail IDs`	Obligatorio. Son los IDs o valores `internetMessageId` de los correos electrónicos que se marcarán como no deseados. Este parámetro acepta varios valores como una cadena separada por comas.

Search In Mailbox

Obligatorio.

Un buzón de correo en el que se buscarán correos electrónicos

De forma predeterminada, la acción intenta buscar el correo electrónico en el buzón de correo predeterminado que especificaste en la configuración de la integración. Para ejecutar una búsqueda en otros buzones de correo, configura los permisos adecuados para la acción.

Este parámetro acepta varios valores como una cadena separada por comas.

Folder Name

Obligatorio.

Es una carpeta de buzón de correo en la que se buscan correos electrónicos. Para especificar una subcarpeta, usa la barra diagonal /, como Inbox/Subfolder.

El valor predeterminado es Inbox.

Mail IDs

Obligatorio.

Son los IDs o valores internetMessageId de los correos electrónicos que se marcarán como no deseados.

Este parámetro acepta varios valores como una cadena separada por comas.

Resultados de la acción

La acción Marcar correo electrónico como no deseado 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 Marcar correo electrónico como no deseado puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully marked the email as junk.` `Failed to find email with ID ID in MAILBOX.` `Mailbox MAILBOX was not found.`	La acción se realizó correctamente.
`Error executing action "Mark Email as Junk". Reason: ERROR_REASON` `Failed to find any emails based on provided parameters!` `Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.`	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Successfully marked the email as junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

La acción se realizó correctamente.

Error executing action "Mark Email as Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

No se pudo realizar la acción.

Verifica la conexión al 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 usas la acción Marcar correo electrónico como no deseado:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Marcar el correo electrónico como no spam

Usa la acción Marcar correo electrónico como no spam para marcar correos electrónicos como no spam en un buzón específico. Esta acción quita al remitente de la lista de remitentes bloqueados y mueve el mensaje a la carpeta Recibidos.

La acción Marcar correo electrónico como no deseado usa la versión beta de la API de Microsoft Graph.

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

Entradas de acción

La acción Marcar correo electrónico como no deseado requiere los siguientes parámetros:

Parámetro Descripción

Parámetro	Descripción
`Search In Mailbox`	Obligatorio. Un buzón de correo en el que se puede buscar un correo electrónico De forma predeterminada, la acción intenta buscar el correo electrónico en el buzón predeterminado que especificaste en la configuración de la integración. Para ejecutar una búsqueda en otros buzones de correo, configura los permisos adecuados para la acción. Este parámetro acepta varios valores como una cadena separada por comas.
`Folder Name`	Obligatorio. Es una carpeta de la bandeja de entrada en la que se buscará el correo electrónico. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`.
`Mail IDs`	Obligatorio. Son los IDs o los valores de `internetMessageId` de los correos electrónicos que se marcarán como spam. Este parámetro acepta varios valores como una cadena separada por comas.

Search In Mailbox

Obligatorio.

Un buzón de correo en el que se puede buscar un correo electrónico

De forma predeterminada, la acción intenta buscar el correo electrónico en el buzón predeterminado que especificaste en la configuración de la integración. Para ejecutar una búsqueda en otros buzones de correo, configura los permisos adecuados para la acción.

Este parámetro acepta varios valores como una cadena separada por comas.

Folder Name

Obligatorio.

Es una carpeta de la bandeja de entrada en la que se buscará el correo electrónico. Para especificar una subcarpeta, usa la barra diagonal /, como Inbox/Subfolder.

Mail IDs

Obligatorio.

Son los IDs o los valores de internetMessageId de los correos electrónicos que se marcarán como spam.

Este parámetro acepta varios valores como una cadena separada por comas.

Resultados de la acción

La acción Marcar correo electrónico como no deseado 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 Marcar correo electrónico como no deseado puede devolver los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully marked the email as not junk.` `Failed to find email with ID ID in MAILBOX.` `Mailbox MAILBOX was not found.`	La acción se realizó correctamente.
`Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON` `Failed to find any emails based on provided parameters!` `Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.`	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Successfully marked the email as not junk.

Failed to find email with ID ID in MAILBOX.

Mailbox MAILBOX was not found.

La acción se realizó correctamente.

Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON

Failed to find any emails based on provided parameters!

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.

No se pudo realizar la acción.

Verifica la conexión al 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 usas la acción Marcar el correo electrónico como no spam:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Mover correo electrónico a carpeta

Usa la acción Move Email To Folder para mover uno o varios correos electrónicos de la carpeta de correo electrónico de origen a la otra carpeta del buzón. Con los permisos adecuados, esta acción puede mover correos electrónicos a otros buzones diferentes del que se proporciona en la configuración de la integración.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

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

Entradas de acción

Para configurar la acción Move Email To Folder, usa los siguientes parámetros:

Parámetro	Descripción
`Move In Mailbox`	Obligatorio. Es el buzón de correo predeterminado en el que se ejecuta la operación de movimiento. Si los permisos lo permiten, la acción también puede buscar en otros buzones de correo. Este parámetro acepta varios valores como una cadena separada por comas.
`Source Folder Name`	Obligatorio. Es una carpeta de origen desde la que se moverá el correo electrónico. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`.
`Destination Folder Name`	Obligatorio. Una carpeta de destino a la que se moverá el correo electrónico Proporciona el valor del parámetro en el siguiente formato: `Inbox/folder_name/subfolder_name`. Este parámetro no distingue mayúsculas de minúsculas.
`Mail IDs`	Opcional Es una condición de filtro para buscar correos electrónicos con IDs específicos. Este parámetro acepta una lista separada por comas de IDs de correo electrónico para buscar. Si se proporciona este parámetro, la búsqueda ignora los parámetros `Subject Filter` y `Sender Filter`.
`Subject Filter`	Opcional Es una condición de filtro que especifica el asunto del correo electrónico que se buscará. Este filtro usa la lógica `contains`.
`Sender Filter`	Opcional Es una condición de filtro que especifica el remitente de los correos electrónicos solicitados. Este filtro usa la lógica `equals`.
`Timeframe (Minutes)`	Opcional Es una condición de filtro que especifica el período, en minutos, para buscar correos electrónicos.
`Only Unread`	Opcional Si se selecciona, la acción solo busca correos electrónicos no leídos. No se selecciona de forma predeterminada.
`How many mailboxes to process in a single batch`	Opcional Es la cantidad de buzones de correo que se procesarán en un solo lote (conexión única al servidor de correo). El valor predeterminado es `25`.

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Mover correo electrónico a una carpeta:

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 Move Email To Folder proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Mensaje de salida	Descripción del mensaje
`Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER` `Mailbox MAILBOX was not found.`	La acción se realizó correctamente.
`Action was not able to find any emails based on the specified search criteria.` `Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER` `Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER` `Failed to find any of the provided mailboxes: MAILBOX_LIST` `Failed to execute action, 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.

Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER

Mailbox MAILBOX was not found.

La acción se realizó correctamente.

Action was not able to find any emails based on the specified search criteria.

Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, 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 describen los valores del resultado de la secuencia de comandos cuando usas la acción Move Email To Folder:

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 el servicio de correo de Microsoft Graph.

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

Entradas de acción

Ninguno

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Ping:

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 proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully connected to the Microsoft Graph mail service with the provided connection parameters! La acción se realizó correctamente.

Mensaje de salida	Descripción del mensaje
`Successfully connected to the Microsoft Graph mail service with the provided connection parameters!`	La acción se realizó correctamente.
`Failed to connect to the Microsoft Graph mail service! 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.

Failed to connect to the Microsoft Graph mail service! 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 describen los valores del resultado de la secuencia de comandos cuando usas la acción Ping:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Quitar bloqueo de dominio

Usa la acción Quitar bloqueo de dominio para quitar los dominios de correo electrónico especificados de una regla de mensaje en el buzón de destino. Si la regla queda vacía, se borrará.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

Entradas de acción

La acción Quitar dominio de bloqueo requiere los siguientes parámetros:

Parámetro	Descripción
`Domains`	Es opcional. Lista separada por comas de los dominios del remitente que se quitarán (por ejemplo, `example.com`). Los dominios ingresados manualmente en este campo y los dominios extraídos de forma dinámica de las entidades funcionan en conjunto y se quitarán de las condiciones de la regla.
`Mailboxes`	Obligatorio. El valor predeterminado es `Default Mailbox`. Son los buzones de correo en los que existe la regla de mensaje. Puede ser una lista separada por comas de nombres principales de usuario.
`Rule Name`	Obligatorio. El valor predeterminado es `Google SecOps - Blocked Domains`. Nombre de la regla de mensaje de la que se quitarán estos dominios.
`How many mailboxes to process in a single batch`	Es opcional. El valor predeterminado es `20`. Especifica cuántos buzones de correo debe procesar la acción en un solo lote.

Resultados de la acción

La acción Remove Block Domain 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 describe el resultado JSON que se recibe cuando se usa la acción Remove Block Domain:

[
  {
    "Entity": "example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "user@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]

Mensajes de salida

La acción Quitar dominio de bloqueo proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully removed domain DOMAIN from the blocked senders list for mailbox MAILBOX.

La acción se realizó correctamente.

Failed to remove domain DOMAIN from the blocked senders list for mailbox MAILBOX. 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 describen los valores del resultado de la secuencia de comandos cuando se usa la acción Quitar dominio de bloqueo:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Quitar el bloqueo del remitente

Usa la acción Quitar remitente bloqueado para quitar remitentes de correo electrónico específicos de una regla de mensajes en el buzón de destino. Si la regla queda vacía, se borrará.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el entorno de desarrollo integrado (IDE) de Google SecOps según sea necesario.

Entradas de acción

La acción Remove Block Sender requiere los siguientes parámetros:

Parámetro	Descripción
`Senders`	Es opcional. Es una lista separada por comas de las direcciones de correo electrónico de los remitentes que se quitarán. Los remitentes que se ingresan de forma manual en este campo y los que se extraen de forma dinámica de las entidades funcionan juntos y se quitarán de las condiciones de la regla.
`Mailboxes`	Obligatorio. El valor predeterminado es `Default Mailbox`. Son los buzones de correo en los que existe la regla de mensaje. Puede ser una lista separada por comas de nombres principales de usuario.
`Rule Name`	Obligatorio. El valor predeterminado es `Google SecOps - Blocked Senders`. Nombre de la regla de mensajes de la que se quitarán estos remitentes.
`How many mailboxes to process in a single batch`	Es opcional. El valor predeterminado es `20`. Especifica cuántos buzones de correo debe procesar la acción en un solo lote.

Resultados de la acción

La acción Remove Block Sender proporciona los siguientes resultados:

Tipo de salida 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 describe el resultado JSON que se recibe cuando usas la acción Quitar remitente bloqueado:

[
  {
    "Entity": "user@example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "target@example.com"
      ],
      "failed_mailboxes": []
    }
  }
]

Mensajes de salida

La acción Remove Block Sender proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully removed sender SENDER from the blocked senders list for mailbox MAILBOX.

La acción se realizó correctamente.

Failed to remove sender SENDER from the blocked senders list for mailbox MAILBOX. 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 describen los valores del resultado del script cuando se usa la acción Remove Block Sender:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Guarda el correo electrónico en el caso

Usa la acción Save Email To The Case para guardar correos electrónicos o archivos adjuntos de correos electrónicos en el muro de casos de Google SecOps. Con los permisos adecuados, esta acción puede guardar correos electrónicos de buzones de entrada que no sean el que se proporciona en la configuración de la integración.

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

Entradas de acción

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

Parámetro	Descripción
`Search In Mailbox`	Obligatorio. Es el buzón de correo predeterminado en el que se ejecuta la operación de búsqueda. Si los permisos lo permiten, la acción también puede buscar en otros buzones.
`Folder Name`	Opcional Es una carpeta de la bandeja de entrada en la que se buscará el correo electrónico. Para especificar una subcarpeta, usa la barra `/`, como `Inbox/Subfolder`.
`Mail ID`	Obligatorio. Es una lista de IDs de correos electrónicos separados por comas que se pueden buscar. Si usaste la acción Send Email para enviar correos electrónicos, establece el valor del parámetro en el marcador de posición `{SendEmail.JSONResult\|id}` o `{SendEmail.JSONResult\|internetMessageId}`.
`Save Only Email Attachments`	Opcional Si se selecciona, la acción solo guarda los archivos adjuntos del correo electrónico especificado. No se selecciona de forma predeterminada.
`Attachment To Save`	Opcional Si se selecciona el parámetro `Save Only Email Attachments`, la acción solo guarda los archivos adjuntos especificados por este parámetro. Este parámetro acepta varios valores como una cadena separada por comas.
`Base64 Encode`	Opcional Si se selecciona, la acción codifica el archivo de correo electrónico en formato base64. No está seleccionado de forma predeterminada.

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Save Email To The Case:

Tipo de resultado 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
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Archivo adjunto del muro de casos

Los siguientes archivos adjuntos están asociados con la acción Save Email To The Case:

EMAIL_SUBJECT.eml, si la acción guarda el correo electrónico
Si la acción guarda el archivo adjunto, el nombre del archivo adjunto contiene una extensión de archivo, si la hay.

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando se usa la acción Save Email To The Case:

{
    "id": "ID",
    "createdDateTime": "2024-02-16T14:10:34Z",
    "eml_info": "example_info",
    "lastModifiedDateTime": "2024-02-16T14:10:41Z",
    "changeKey": "cxsdjjh",
    "categories": [],
    "receivedDateTime": "2024-02-16T14:10:35Z",
    "sentDateTime": "2024-02-16T14:09:36Z",
    "hasAttachments": true,
    "internetMessageId": "INTERNET_MESSAGE_ID",
    "subject": "all attachments",
    "bodyPreview": "all the attachments",
    "importance": "normal",
    "parentFolderId": "PARENT_FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "example-index",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com/",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "<html><head>example-html</head></html>"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

Mensajes de salida

En un muro de casos, la acción Guardar correo electrónico en el caso proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Email successfully saved!

Successfully saved the following attachments: ATTACHMENTS_LIST

The following attachments were not found in email with mail id: EMAIL_ID: ATTACHMENTS_LIST

La acción se realizó correctamente.

Mailbox MAILBOX_NAME was not found.

Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX_NAME

Failed to execute action, 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 describen los valores para el resultado de la secuencia de comandos cuando usas la acción Guardar correo electrónico en el caso:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Buscar correos electrónicos

Usa la acción Buscar correos electrónicos para ejecutar una búsqueda de correos electrónicos en el buzón predeterminado según los criterios de búsqueda proporcionados. Con los permisos adecuados, esta acción puede ejecutar una búsqueda en otros buzones.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el IDE de Google SecOps según sea necesario.

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

Entradas de acción

La acción Buscar correos electrónicos requiere los siguientes parámetros:

Parámetro	Descripción
`Search In Mailbox`	Obligatorio Es el buzón de correo predeterminado en el que se ejecuta la operación de búsqueda. Si los permisos lo permiten, la acción también puede buscar en otros buzones. Este parámetro acepta varios valores como una cadena separada por comas. Para realizar búsquedas complejas en una cantidad significativa de buzones de correo, usa la integración del paquete de extensión de Exchange.
`Folder Name`	Optional Es una carpeta de la bandeja de entrada en la que se buscarán correos electrónicos. Para especificar una subcarpeta, usa la barra diagonal `/` (como `Inbox/Subfolder`). El valor predeterminado es `Inbox`.
`Subject Filter`	Optional Es una condición de filtro que especifica el asunto del correo electrónico que se buscará. Este filtro usa la lógica `contains`.
`Sender Filter`	Optional Es una condición de filtro que especifica el remitente de los correos electrónicos solicitados. Este filtro usa la lógica `equals`.
`Recipient Filter`	Optional Es una condición de filtro que especifica el destinatario de los correos electrónicos solicitados.
`Timeframe (minutes)`	Optional Es una condición de filtro que especifica el período en minutos para buscar correos electrónicos.
`Start Time`	Optional Especifica la hora de inicio de la búsqueda de correos electrónicos en formato ISO 8601. Este parámetro tiene prioridad sobre `Timeframe (minutes)`.
`End Time`	Optional Especifica la hora de finalización de la búsqueda de correos electrónicos en formato ISO 8601. Si no se proporciona y `Start Time` es válido, este parámetro usa la hora actual.
`Body Regex Filter`	Optional Especifica un patrón de expresión regular para buscar dentro del cuerpo del correo electrónico.
`Message IDs`	Optional Es una lista separada por comas de los IDs de mensajes que se deben buscar. Nota: Este filtro tiene prioridad sobre otros filtros.
`Max Emails To Return`	Optional Es la cantidad de correos electrónicos que se devolverán para la acción. Si no estableces un valor, se usa el valor predeterminado de la API. El valor predeterminado es `10`.
`Only Unread`	Optional Si se selecciona, la acción solo busca correos electrónicos no leídos. No se selecciona de forma predeterminada.
`Select All Fields For Return`	Optional Si se selecciona, la acción devuelve todos los campos disponibles para el correo electrónico obtenido. No está seleccionado de forma predeterminada.
`How many mailboxes to process in a single batch`	Optional Es la cantidad de buzones de correo que se procesarán en un solo lote (una sola conexión al servidor de correo electrónico). El valor predeterminado es `25`.
`Search in all mailboxes`	Optional Si se selecciona, la acción busca en todos los buzones de correo accesibles. No se selecciona de forma predeterminada.
`Limit the Amount of Information Returned in the JSON Result`	Optional Si se selecciona, la cantidad de información que devuelve la acción se limita solo a los campos clave del correo electrónico. No está seleccionado de forma predeterminada.
`Disable the Action JSON Result`	Optional Si se selecciona, la acción no devuelve un resultado en JSON. No se selecciona de forma predeterminada.

Resultados de la acción

La acción Buscar correos electrónicos 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	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción Buscar correos electrónicos puede generar la siguiente tabla:

Título de la tabla: Correos electrónicos coincidentes

Columnas:

ID de correo electrónico
Asunto
Remitente
Receptores
Fecha de recepción

Resultado de secuencia de comandos

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

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

Mensajes de salida de la acción

La acción Buscar correos electrónicos proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Successfully found emails in the following mailboxes: MAILBOX: FOUND_EMAILS_NUMBER

Mailbox MAILBOX was not found.

Action was not able to find any emails based on the specified search criteria.

La acción se realizó correctamente.

Failed to find any of the provided mailboxes: MAILBOX_LIST

Failed to execute action, 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.

Enviar correo electrónico

Usa la acción Enviar correo electrónico para enviar correos electrónicos desde un buzón específico a una lista arbitraria de destinatarios.

Esta acción puede enviar correos electrónicos con formato HTML o de texto sin formato. Con los permisos adecuados, la acción puede enviar correos electrónicos desde un buzón diferente del especificado en la configuración de la integración.

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

Referencia rápida de la configuración de S/MIME

Usa la siguiente referencia para determinar qué parámetros de S/MIME configurar según el nivel de seguridad del correo electrónico saliente:

Tipo de correo electrónico deseado	`Base64 Encoded Certificate`	`Base64 Encoded Private Key`	`Base64 Encoded Recipient Certificate`
Correo electrónico estándar (sin S/MIME)	Dejar vacío	Dejar vacío	Dejar vacío
Firmado digitalmente	Obligatorio	Obligatorio	Dejar vacío
Encriptado	Dejar vacío	Dejar vacío	Obligatorio
Firmado y encriptado	Obligatorio	Obligatorio	Obligatorio

Convierte archivos de certificado en Base64

Para codificar tus archivos de certificado y clave privada en cadenas Base64 de una sola línea para los parámetros de acción, ejecuta los siguientes comandos:

Linux y macOS:

base64 -w 0 sender_cert.crt
base64 -w 0 sender_key.key

Windows PowerShell:

[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\certificate.crt"))
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\private_key.key"))

Entradas de acción

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

Parámetro	Descripción
`Send From`	Obligatorio. Es una dirección de correo electrónico opcional desde la que se envían correos electrónicos, si los permisos lo permiten. De forma predeterminada, la acción envía correos electrónicos desde el buzón de correo predeterminado especificado en la configuración de la integración.
`Subject`	Obligatorio. Es el asunto del correo electrónico.
`Send to`	Obligatorio. Lista de direcciones de correo electrónico separadas por comas de los destinatarios del correo electrónico, como `user1@example.com, user2@example.com`.
`CC`	Opcional Es una lista separada por comas de direcciones de correo electrónico para el campo CC del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`BCC`	Opcional Es una lista separada por comas de las direcciones de correo electrónico para el campo CCO del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`Attachments Paths`	Opcional Es una lista separada por comas de rutas de acceso para los archivos adjuntos almacenados en el servidor, como `/FILE_DIRECTORY/file.pdf`, `/FILE_DIRECTORY/image.jpg`.
`Attachments Location`	Obligatorio. Es una ubicación en la que se almacenan los archivos adjuntos. De forma predeterminada, la acción intenta subir archivos adjuntos desde el bucket de Cloud Storage. Los valores posibles son `GCP Bucket` o `Local File System`. El valor predeterminado es `GCP Bucket`.
`Mail Content Type`	Opcional Es el tipo de contenido del correo electrónico. Los valores posibles son los siguientes: `Text` `HTML` El valor predeterminado es `Text`.
`Mail Content`	Obligatorio. Es el cuerpo del correo electrónico.
`Reply-To Recipients`	Opcional Es una lista de destinatarios separados por comas que se usarán en el encabezado Responder a. Usa el encabezado Reply-To para redireccionar los correos electrónicos de respuesta a la dirección de correo electrónico especificada en lugar de la dirección del remitente en el campo From.
`Base64 Encoded Certificate`	Opcional Es el certificado público X.509 codificado en Base64 (`.cer`, `.crt`, `.pem`) del remitente (formato de una sola línea). Se usa para la firma digital S/MIME. Si se proporciona, también debes proporcionar `Base64 Encoded Private Key`.
`Base64 Encoded Private Key`	Opcional Es la clave privada codificada en Base64 (`.key`, `.pem`) del remitente (formato de una sola línea). Se usa para la firma digital de S/MIME. Es obligatorio si se proporciona `Base64 Encoded Certificate`.
`Base64 Encoded Recipient Certificate`	Opcional Es el certificado público codificado en Base64 (`.cer`, `.crt`, `.pem`) del destinatario (formato de una sola línea). Se usa para la encriptación de correos electrónicos.

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Enviar correo electrónico:

Tipo de salida 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 Send Email proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Email was sent successfully.

La acción se realizó correctamente.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, 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 describen los valores del resultado de la secuencia de comandos cuando usas la acción Enviar correo electrónico:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Enviar correo electrónico en HTML

Usa la acción Send Email HTML para enviar correos electrónicos que usen la plantilla HTML de Google SecOps desde un buzón específico a una lista arbitraria de destinatarios. Con los permisos adecuados, la acción puede enviar correos electrónicos desde un buzón que no sea el predeterminado.

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

Entradas de acción

La acción Send Email HTML requiere los siguientes parámetros:

Parámetro	Descripción
`Send From`	Obligatorio. Es una dirección de correo electrónico opcional desde la que se envían correos electrónicos, si los permisos lo permiten. De forma predeterminada, la acción envía correos electrónicos desde el buzón de correo predeterminado especificado en la configuración de la integración.
`Subject`	Obligatorio. Es el asunto del correo electrónico.
`Send to`	Obligatorio. Lista de direcciones de correo electrónico separadas por comas de los destinatarios del correo electrónico, como `user1@example.com, user2@example.com`.
`CC`	Opcional Es una lista separada por comas de direcciones de correo electrónico para el campo CC del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`BCC`	Opcional Es una lista separada por comas de las direcciones de correo electrónico para el campo CCO del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`Attachments Paths`	Opcional Ruta de acceso completa del adjunto que se proporcionará, como `/FILE_DIRECTORY/file.pdf` o `/FILE_DIRECTORY/image.jpg`. Puedes proporcionar varios valores en una cadena separada por comas.
`Email HTML Template`	Obligatorio. Es el tipo de plantilla HTML que se usará. Los valores posibles son `Email HTML Template` y `Dynamically generated list of available templates`. El valor predeterminado es `Email HTML Template`.
`Mail Content`	Obligatorio. Es el cuerpo del correo electrónico.
`Reply-To Recipients`	Opcional Es una lista de destinatarios separados por comas que se usará en el encabezado Reply-To. Usa el encabezado Reply-To para redireccionar los correos electrónicos de respuesta a la dirección de correo electrónico específica en lugar de la dirección del remitente que se indica en el campo From.
`Attachment Location`	Obligatorio. Es una ubicación en la que se almacenan los archivos adjuntos. De forma predeterminada, la acción intenta subir archivos adjuntos desde el bucket de Cloud Storage. Los valores posibles son `GCP Bucket` o `Local File System`. El valor predeterminado es `GCP Bucket`.

Resultados de la acción

La acción Enviar correo electrónico HTML 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 describe el resultado JSON que se recibe cuando usas la acción Enviar correo electrónico HTML:

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "example-key",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "outlook.com",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "ID",
    "conversationId": "ID",
    "conversationIndex": "INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

Mensajes de salida

En un muro de casos, la acción Send Email HTML proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Email was sent successfully. La acción se realizó correctamente.

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

No se pudo realizar la acción.

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

Resultado de secuencia de comandos

En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando usas la acción Send Email HTML:

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 al hilo para enviar un mensaje como respuesta al hilo de correos electrónicos. Con los permisos adecuados, la acción puede enviar correos electrónicos desde un buzón de correo distinto del especificado en la configuración de la integración.

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

Entradas de acción

La acción Send Thread Reply requiere los siguientes parámetros:

Parámetro	Descripción
`Send From`	Obligatorio. Es una dirección de correo electrónico opcional desde la que se envían correos electrónicos, si los permisos lo permiten. De forma predeterminada, la acción envía correos electrónicos desde el buzón de correo predeterminado especificado en la configuración de la integración.
`Mail ID`	Obligatorio. Es el ID de correo electrónico que se buscará.
`Folder Name`	Opcional Es una carpeta de buzón de correo en la que se buscan correos electrónicos. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`. El valor predeterminado es `Inbox`.
`Attachments Paths`	Opcional Es una lista separada por comas de rutas de acceso para los archivos adjuntos almacenados en el servidor, como `/FILE_DIRECTORY/file.pdf`, `/FILE_DIRECTORY/image.jpg`.
`Mail Content`	Obligatorio. Es el cuerpo del correo electrónico.
`Reply All`	Opcional Si se selecciona, la acción envía una respuesta a todos los destinatarios relacionados con el correo electrónico original. No se selecciona de forma predeterminada. Este parámetro tiene prioridad sobre el parámetro `Reply To`.
`Reply To`	Opcional Es una lista de correos electrónicos separados por comas a los que se enviará la respuesta. Si no proporcionas ningún valor y la casilla de verificación `Reply All` está desmarcada, la acción solo envía una respuesta al remitente original del correo electrónico. Si se selecciona la casilla de verificación `Reply All`, la acción ignora este parámetro.
`Attachments Location`	Obligatorio. Es una ubicación en la que se almacenan los archivos adjuntos. De forma predeterminada, la acción intenta subir archivos adjuntos desde el bucket de Cloud Storage. Los valores posibles son `GCP Bucket` o `Local File System`. El valor predeterminado es `GCP Bucket`.
`Message Timezone`	Es opcional. Es la zona horaria que se usa para la fecha de envío del correo electrónico original en el encabezado de respuesta (por ejemplo, `UTC`, `America/New_York` o `Europe/London`). Si el valor proporcionado no es válido, se usa el valor predeterminado. El valor predeterminado es `UTC`.

Resultados de la acción

En la siguiente tabla, se describen los tipos de salida asociados con la acción Enviar respuesta de conversación:

Tipo de salida 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 muestra el resultado JSON que se recibe cuando se usa la acción Enviar respuesta al hilo:

  {
    "id": "yyyy",
    "createdDateTime": "2024-02-02T10:57:18Z",
    "lastModifiedDateTime": "2024-02-02T10:57:23Z",
    "changeKey": "dsf+oAAQLaPjk",
    "categories": [],
    "receivedDateTime": "2024-02-02T10:57:20Z",
    "sentDateTime": "2024-02-02T10:57:19Z",
    "hasAttachments": true,
    "internetMessageId": "sdfhsjdfhjsdjfd",
    "subject": "RE: reply checking",
    "bodyPreview": "Reply check kr",
    "importance": "normal",
    "parentFolderId": "id",
    "conversationId": "id",
    "conversationIndex": "sdghfjfke",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": "Reply check kr"
    },
    "sender": {
      "emailAddress": {
        "name": "aff",
        "address": "ddxsm@a.com"
      }
    },
    "from": {
      "emailAddress": {
        "name": "fasf",
        "address": "ddxsm@a.com"
      }
    },
    "toRecipients": [
      {
        "emailAddress": {
          "name": "wf",
          "address": "ddxsm@a.com"
        }
      }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
      "contentType": "html",
      "content": "Reply check"
    },
    "flag": {
      "flagStatus": "notFlagged"
    }
  }

Mensajes de salida

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

Mensaje de salida Descripción del mensaje

Successfully sent reply to the mail with ID: EMAIL_ID La acción se realizó correctamente.

Error executing action "Send Thread Reply". Reason: if you want
      to send a reply only to your own email address, you need to work with
      "Reply To" parameter.

No se pudo realizar la acción.

Verifica el valor del parámetro Reply To.

Error executing action "Send Thread Reply" because the provided mail id EMAIL_ID was not found.

Action failed to run because specified attachments were not found: ATTACHMENTS_LIST

Failed to execute action, 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 describen los valores del resultado del script cuando usas la acción Send Thread Reply:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Enviar correo electrónico de votación

Usa la acción Enviar correo electrónico de votación para enviar correos electrónicos con las opciones de respuesta predefinidas. Esta acción usa plantillas HTML de Google SecOps para dar formato al correo electrónico. Con los permisos adecuados, la acción Send Vote Email puede enviar correos electrónicos desde un buzón que no sea el predeterminado.

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

Entradas de acción

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

Parámetro	Descripción
`Send From`	Obligatorio. Es una dirección de correo electrónico opcional desde la que se envían correos electrónicos, si los permisos lo permiten. De forma predeterminada, la acción envía correos electrónicos desde el buzón de correo predeterminado especificado en la configuración de la integración.
`Subject`	Obligatorio. Es el asunto del correo electrónico.
`Send to`	Obligatorio. Lista de direcciones de correo electrónico separadas por comas de los destinatarios del correo electrónico, como `user1@example.com, user2@example.com`.
`CC`	Opcional Es una lista separada por comas de direcciones de correo electrónico para el campo CC del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`BCC`	Opcional Es una lista separada por comas de las direcciones de correo electrónico para el campo CCO del correo electrónico. El formato es el mismo que para el parámetro `Send to`.
`Attachments Paths`	Opcional Ruta de acceso completa del adjunto que se proporcionará, como `/FILE_DIRECTORY/file.pdf` o `/FILE_DIRECTORY/image.jpg`. Puedes proporcionar varios valores en una cadena separada por comas.
`Email HTML Template`	Obligatorio. Es el tipo de plantilla HTML que se usará. Los valores posibles son `Email HTML Template` y `Dynamically generated list of available templates`. El valor predeterminado es `Email HTML Template`.
`Reply-To Recipients`	Opcional Es una lista de destinatarios separados por comas que se usará en el encabezado Reply-To. Usa el encabezado Reply-To para redireccionar los correos electrónicos de respuesta a la dirección de correo electrónico especificada en lugar de la dirección del remitente que se indica en el campo From.
`Structure of voting options`	Obligatorio. Es la estructura de la votación que se enviará a los destinatarios. Los valores posibles son `Yes/No` o `Approve/Reject`. El valor predeterminado es `Yes/No`.
`Attachment Location`	Obligatorio. Es una ubicación en la que se almacenan los archivos adjuntos. De forma predeterminada, la acción intenta subir el archivo adjunto desde el bucket de Cloud Storage. Los valores posibles son `GCP Bucket` o `Local File System`. El valor predeterminado es `GCP Bucket`.

Resultados de la acción

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

Tipo de salida 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 describe el resultado JSON que se recibe cuando usas la acción Enviar correo electrónico de votación:

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "KEY",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "<example-message-ID>",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "CONVERSATION_INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "sender@example.com"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "user@example.com"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "recipient@example.com"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

Mensajes de salida

En un muro de casos, la acción Send Vote Email proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Email was sent successfully. La acción se realizó correctamente.

Action failed to run because the HTML template was not specified.

Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST

Failed to execute action, the error is: ERROR_REASON

No se pudo realizar la acción.

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

Resultado de secuencia de comandos

En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando usas la acción Enviar correo electrónico de votación:

Nombre del resultado de la secuencia de comandos	Valor
`is_success`	`True` o `False`

Esperar el correo electrónico del usuario

Usa la acción Wait For Email From User para esperar la respuesta del usuario en función de un correo electrónico enviado con la acción Send Email.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el IDE de Google SecOps según sea necesario. Si estableces el tiempo de espera en 0 o lo dejas vacío, se usará el tiempo de espera predeterminado configurado en los parámetros de configuración del entorno.

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

Entradas de acción

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

Parámetro	Descripción
`Mail ID`	Obligatorio El ID o el `internetMessageId` del correo electrónico que esperará la acción. Si usaste la acción Enviar correo electrónico para enviar correos electrónicos, establece el valor del parámetro en el marcador de posición `{SendEmail.JSONResult\|id}` o `{SendEmail.JSONResult\|internetMessageId}`.
`Mail Date`	Optional Es la marca de tiempo de envío del correo electrónico que espera la acción. Si el mensaje se envió con la acción Enviar correo electrónico, selecciona el campo `{SendEmail.JSONResult\|sentDateTime}` o `{SendEmail.JSONResult\|createdDateTime}` como marcador de posición.
`Mail Recipients`	Optional Lista separada por comas de las direcciones de correo electrónico de los destinatarios cuya respuesta espera la acción. Si el mensaje se envió con la acción Enviar correo electrónico, selecciona el campo `{SendEmail.JSONResult\|toRecipients}` como marcador de posición.
`How long to wait for recipient reply (minutes)`	Optional Es la cantidad de minutos que se debe esperar la respuesta del usuario antes de marcar que se agotó el tiempo de espera. El valor predeterminado es `10080`.
`Wait for All Recipients to Reply?`	Optional Si se selecciona, la acción espera respuestas de todos los destinatarios hasta que se agote el tiempo de espera o se proceda con la primera respuesta. No se selecciona de forma predeterminada.
`Wait Stage Exclude pattern`	Optional Es una expresión regular para excluir respuestas específicas de la etapa de espera. Este parámetro funciona tanto con el asunto como con el cuerpo del correo electrónico. Por ejemplo, si configuras la expresión regular `Out of Office.*`, la acción no considera los mensajes automáticos de fuera de la oficina como respuestas del destinatario y espera una respuesta real del usuario.
`Folder to Check for Reply`	Optional Carpeta de correo electrónico del buzón para buscar las respuestas entrantes de los destinatarios. La búsqueda se ejecuta en el buzón de correo desde el que se envió el correo electrónico que contiene una pregunta. Admite subcarpetas anidadas con la barra inclinada `/` (por ejemplo, `Inbox/Subfolder`). Este parámetro distingue mayúsculas de minúsculas. El valor predeterminado es `Inbox`.
`Fetch Response Attachments`	Optional Si se selecciona y la respuesta del destinatario contiene archivos adjuntos, la acción recupera la respuesta y la agrega como archivo adjunto al resultado de la acción. No se selecciona de forma predeterminada.
`Limit the Amount of Information Returned in the JSON Result`	Optional Si se selecciona, la cantidad de información que devuelve la acción se limita solo a los campos clave del correo electrónico. Esta opción se selecciona de forma predeterminada.
`Disable the Action JSON Result`	Optional Si se selecciona, la acción no devuelve un resultado en JSON. No se selecciona de forma predeterminada.

Resultados de la acción

La acción Wait For Email From User 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	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Resultado de secuencia de comandos	Disponible

Archivo adjunto del muro de casos

El siguiente adjunto de Case Wall está asociado con la acción Wait For Email From User:

Tipo: Entidad

Contenido del adjunto: Título, nombre de archivo (extensiones incluidas, si corresponde) y fileContent

Título: Archivo adjunto de la respuesta de RECIPIENT_EMAIL.
Nombre de archivo: ATTACHMENT_FILENAME + FILE_EXTENSION
fileContent: CONTENT_OF_THE_ATTACHED_FILE

Tabla del muro de casos

La acción Espera un correo electrónico del usuario puede generar la siguiente tabla:

Título de la tabla: Correos electrónicos coincidentes

Columnas:

ID de correo electrónico
Fecha de recepción
Remitente
Destinatarios
Asunto

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 Esperar correo electrónico del usuario:

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

Mensajes de salida de la acción

La acción Wait For Email From User proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Found the user EMAIL_RECIPIENT reply: USER_REPLY

Timeout getting reply from user: EMAIL_RECIPIENT.

La acción se realizó correctamente.

Action failed to receive any replies until timeout.

Failed to execute action, 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.

Espera los resultados de la votación por correo electrónico

Usa la acción Wait For Vote Email Results para esperar la respuesta del usuario en función del correo electrónico de votación enviado con la acción Send Vote Email.

Esta acción es asíncrona. Ajusta el tiempo de espera de la acción en el IDE de Google SecOps según sea necesario.

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

Entradas de acción

La acción Wait For Vote Email Results requiere los siguientes parámetros:

Parámetro	Descripción
`Vote Mail Sent From`	Obligatorio. Es el buzón de correo electrónico desde el que la acción Send Vote Email envió un correo electrónico. El valor predeterminado es el buzón de correo que especificaste en la configuración de la integración. De manera opcional, puedes establecer un valor diferente para este parámetro si el correo electrónico de votación se envía desde un buzón de correo diferente.
`Mail ID`	Obligatorio. Es el ID del correo electrónico. Si el correo electrónico se envía con la acción `Send Vote Email`, establece el valor del parámetro en el marcador de posición `SendVoteEmail.JSONResult\|id` o `SendEmail.JSONResult\|internetMessageId`. Para devolver IDs de correo electrónico, puedes usar la acción Buscar correos electrónicos.
`Wait for All Recipients To Reply?`	Opcional Si se selecciona, la acción espera las respuestas de todos los destinatarios hasta que se alcance el tiempo de espera o se continúe con la primera respuesta. Habilitada de forma predeterminada.
`Wait Stage Exclude Pattern`	Opcional Es una expresión regular para excluir respuestas específicas de la etapa de espera. Este parámetro funciona con el cuerpo del correo electrónico. Por ejemplo, la acción no considera los mensajes automáticos de ausencia como respuestas del destinatario, sino que espera una respuesta real del usuario.
`Folder To Check For Reply`	Opcional Es una carpeta de correo electrónico del buzón de entrada en la que se busca la respuesta del usuario. La búsqueda se ejecuta en el buzón de correo desde el que se envió el correo electrónico que contiene una pregunta. Este parámetro acepta una lista de carpetas separadas por comas para verificar la respuesta del usuario en varias carpetas. Este parámetro distingue mayúsculas de minúsculas. El valor predeterminado es `Inbox`.
`Folder To Check For Sent Mail`	Opcional Es una carpeta del buzón de correo en la que se buscará el correo electrónico enviado. Es un buzón de correo desde el que enviaste el correo electrónico con una pregunta. Este parámetro acepta una lista de carpetas separadas por comas para verificar la respuesta del usuario en varias carpetas. Este parámetro distingue mayúsculas de minúsculas. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`. El valor predeterminado es `Sent Items`.
`Fetch Response Attachments`	Opcional Si se selecciona y la respuesta del destinatario contiene archivos adjuntos, la acción recupera la respuesta y la agrega como archivo adjunto al muro del caso. No se selecciona de forma predeterminada.

Resultados de la acción

La acción Wait For Vote Email Results proporciona los siguientes resultados:

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

Archivo adjunto del muro de casos

El siguiente archivo adjunto del muro de casos está asociado con la acción Wait For Vote Email Results:

Tipo: Entidad

Contenido del adjunto: Título, nombre de archivo (extensiones incluidas, si corresponde) y fileContent

Título: RECIPIENT_EMAIL archivo adjunto de respuesta.
Nombre de archivo: ATTACHMENT_FILENAME + FILE_EXTENSION
fileContent: CONTENT_OF_THE_ATTACHED_FILE

Tabla del muro de casos

En un muro de casos, la acción Wait For Email Results genera la siguiente tabla:

Título de la tabla: Correos electrónicos coincidentes

Columnas:

ID de correo electrónico
Fecha de recepción
Remitente
Destinatarios
Asunto

Resultado de JSON

En el siguiente ejemplo, se describe el resultado JSON que se recibe cuando usas la acción Wait For Vote Email Results:

{
    "Responses": [
        {
            "recipient": "user@example.com",
            "vote": "Approve"
        }
    ]
}

Mensajes de salida

La acción Wait For Vote Email Results proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje

Found the user EMAIL_RECIPIENT reply: USER_REPLY.

Exceeded timeout to get a reply from user: EMAIL_RECIPIENT.

La acción se realizó correctamente.

Action failed to receive any replies until timeout.

Failed to execute action, the error is: ERROR_REASON

No se pudo realizar la acción.

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

Resultado de secuencia de comandos

En la siguiente tabla, se describen los valores del resultado de la secuencia de comandos cuando usas la acción Wait For Vote Email Results:

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 Microsoft Graph Mail

Usa el conector de correo electrónico de Microsoft Graph para recuperar correos electrónicos del servicio de correo electrónico de Microsoft Graph.

Usa la lista dinámica para filtrar los valores especificados de las partes del cuerpo y el asunto del correo electrónico con expresiones regulares. De forma predeterminada, el conector usa una expresión regular para filtrar las URLs del correo electrónico.

Entradas del conector

El conector delegado de Microsoft Graph Mail requiere los siguientes parámetros:

Parámetro	Descripción
`Product Field Name`	Obligatorio. Es el nombre del campo en el que se almacena el nombre del producto. El valor predeterminado es `device_product`. El nombre del producto afecta principalmente la asignación. Para optimizar y mejorar el proceso de asignación del conector, el valor predeterminado `device_product` se resuelve en un valor de resguardo al que se hace referencia desde el código. De forma predeterminada, cualquier entrada no válida para este parámetro se resuelve en un valor de resguardo.
`Event Field Name`	Obligatorio. Es el nombre del campo que se usa para determinar el nombre del evento (subtipo). El valor predeterminado es `event_name`.
`Environment Field Name`	Opcional Nombre del campo en el que se almacena el nombre del entorno. Si no se encuentra el campo de entorno, este se establece en `""`.
`Environment Regex Pattern`	Opcional Es un patrón de expresión regular que se ejecuta en el valor que se encuentra en el campo `Environment Field Name`. Este parámetro te permite manipular el campo de entorno con la lógica de expresiones regulares. Usa el valor predeterminado `.*` para recuperar el valor sin procesar de `Environment Field Name` requerido. Si el patrón de expresión regular es nulo o está vacío, o el valor del entorno es nulo, el resultado final del entorno es `""`.
`Email Exclude Pattern`	Opcional Es una expresión regular para excluir correos electrónicos específicos de la transferencia, como spam o noticias. Este parámetro funciona tanto con el asunto como con el cuerpo del correo electrónico.
`PythonProcessTimeout`	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 `300`.
`Azure AD Endpoint`	Obligatorio. Es el extremo de Microsoft Entra que se usará en la integración. El valor predeterminado es `https://login.microsoftonline.com`.
`Microsoft Graph Endpoint`	Obligatorio. Es el extremo de Microsoft Graph que se usará en la integración. El valor predeterminado es `https://graph.microsoft.com`.
`Mail Address`	Obligatorio. Una dirección de correo electrónico que usará el conector.
`Client ID`	Obligatorio. Es un ID de aplicación (cliente) de la aplicación de Microsoft Entra.
`Secret ID`	Obligatorio. Es el valor del secreto del cliente de la aplicación de Microsoft Entra.
`Tenant (Directory) ID`	Obligatorio. El valor de Microsoft Entra ID (ID de usuario).
`Folder to check for emails`	Obligatorio. Una carpeta de correo electrónico en la que se buscarán los correos electrónicos Este parámetro acepta una lista de carpetas separadas por comas en las que se buscará la respuesta del usuario en varias carpetas. Para especificar una subcarpeta, usa la barra diagonal `/`, como `Inbox/Subfolder`. Este parámetro distingue mayúsculas de minúsculas. El valor predeterminado es `Inbox`.
`Offset Time In Hours`	Obligatorio. Cantidad de horas antes de la primera iteración del conector para recuperar correos electrónicos. Este parámetro se aplica a la primera iteración del conector después de que lo habilitas por primera vez. El conector puede usar este parámetro como un valor de resguardo cuando venza la marca de tiempo de la iteración más reciente del conector. El valor predeterminado es `24`.
`Max Emails Per Cycle`	Obligatorio. Es la cantidad de correos electrónicos que se recuperarán en cada iteración del conector. El valor predeterminado es `10`.
`Unread Emails Only`	Opcional Si se selecciona esta opción, el conector solo crea casos a partir de correos electrónicos no leídos. No está seleccionado de forma predeterminada.
`Mark Emails as Read`	Opcional Si se selecciona, el conector marca los correos electrónicos como leídos después de transferirlos. No se selecciona de forma predeterminada.
`Disable Overflow`	Opcional Si se selecciona, el conector ignora el mecanismo de desbordamiento de Google SecOps. No se selecciona de forma predeterminada.
`Verify SSL`	Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta a Microsoft Graph. Habilitada de forma predeterminada.
`Original Received Mail Prefix`	Opcional Prefijo que se agregará a las claves de eventos extraídas (por ejemplo, `to`, `from` o `subject`) del correo electrónico original recibido en el buzón supervisado. El valor predeterminado es `orig`.
`Attached Mail File Prefix`	Opcional Prefijo que se agregará a las claves de eventos extraídas (por ejemplo, `to`, `from` o `subject`) del archivo de correo electrónico adjunto que se recibió en el buzón supervisado. El valor predeterminado es `attach`.
`Create a Separate Google Secops Alert per Attached Mail File`	Opcional Si se selecciona, el conector crea varias alertas, con una alerta para cada archivo de correo electrónico adjunto. Este comportamiento es útil cuando procesas correos electrónicos con varios archivos de correo electrónico adjuntos y configuras la asignación de eventos de Google SecOps para crear entidades a partir de archivos de correo electrónico adjuntos. No se selecciona de forma predeterminada.
`Attach Original EML`	Opcional Si se selecciona, el conector adjunta el correo electrónico original a la información del caso como un archivo EML. No se selecciona de forma predeterminada.
`Headers to add to events`	Opcional Es una cadena separada por comas de encabezados de correo electrónico que se agregarán a los eventos de Google SecOps, como `DKIM-Siganture`, `Received` o `From`. Puedes configurar una coincidencia exacta para los encabezados o establecer este valor de parámetro como una expresión regular. El conector filtra los valores configurados de la lista `internetMessageHeaders` y los agrega al evento de Google SecOps. Para evitar que el conector agregue encabezados al evento, establece el valor del parámetro de la siguiente manera: `None`. De forma predeterminada, el conector agrega todos los encabezados disponibles.
`Case Name Template`	Opcional Un nombre de caso personalizado. Cuando configuras este parámetro, el conector agrega una clave nueva llamada `custom_case_name` al evento de Google SecOps SOAR. Puedes proporcionar marcadores de posición con el siguiente formato: `[name of the field]`. Ejemplo: `Phishing - [event_mailbox]`. Para los marcadores de posición, el conector usa el primer evento de Google SecOps SOAR. El conector solo controla las claves que contienen el valor de cadena.
`Alert Name Template`	Opcional Es el nombre de una alerta personalizada. Puedes proporcionar marcadores de posición con el siguiente formato: `[name of the field]`. Ejemplo: `Phishing - [event_mailbox]`. Para los marcadores de posición, el conector usa el primer evento de Google SecOps SOAR. El conector solo controla las claves que contienen el valor de cadena. Si no proporcionas ningún valor o una plantilla no válida, el conector usará el nombre de alerta predeterminado.
`Proxy Server Address`	Opcional Es la dirección del servidor proxy que se usará.
`Proxy Username`	Opcional Es el nombre de usuario del proxy con el que se realizará la autenticación.
`Proxy Password`	Opcional Es la contraseña del proxy para autenticarse.
`Mail Field Source`	Opcional Si se selecciona, la integración recupera la dirección de la casilla de correo electrónico del atributo `mail` de los detalles del usuario. Si no se selecciona, la integración recupera la dirección de la casilla de correo del campo `userPrincipalName`. No se selecciona de forma predeterminada.
`Extract URLs from HTML Email Part`	Opcional Si se selecciona, el conector extrae las URLs del cuerpo HTML del correo electrónico. Esto permite que el conector extraiga URLs complejas, pero no extrae URLs de la parte de texto sin formato del correo electrónico. Las URLs extraídas están disponibles en el campo de evento `urls_from_html_part`. Habilitada de forma predeterminada.
`Event Fields to Exclude`	Opcional Es una lista de campos de eventos separados por comas que se deben excluir de la creación de eventos (como `field1,field2`).
`Exclude Attachments`	Opcional Si se selecciona, el conector no transferirá los archivos adjuntos de correo electrónico ni los agregará a los casos.
`Bypass S/MIME Signature Verification`	Opcional Si se selecciona, el conector transfiere correos electrónicos firmados con S/MIME sin requerir un certificado de la AC codificado en Base64 para la verificación de firmas. El cuerpo del mensaje, los encabezados y los archivos adjuntos se extraen directamente.
`Base64 Encoded Private Key`	Opcional Es la clave privada codificada en Base64 que se usa para desencriptar los correos electrónicos entrantes encriptados con S/MIME. Si se proporciona, también debes proporcionar `Base64 Encoded Certificate`.
`Base64 Encoded Certificate`	Opcional Es el certificado codificado en Base64 que se usa para desencriptar los correos electrónicos entrantes encriptados con S/MIME. Si se proporciona, también debes proporcionar `Base64 Encoded Private Key`.
`Base64 Encoded CA certificate`	Opcional Es el certificado de la AC de confianza codificado en Base64 para verificar las firmas digitales de los correos electrónicos entrantes con S/MIME. Si no se proporciona un certificado de la AC, la verificación de la firma de los correos electrónicos firmados entrantes falla, a menos que se habilite `Bypass S/MIME Signature Verification`.

Reglas de conector

El conector admite proxies.

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