1 Correo electrónico

Descripción general

Para configurar el correo electrónico como canal de entrega de mensajes, debe configurarlo como tipo de medio y asignar direcciones específicas a los usuarios.

Varias notificaciones para un mismo evento se agruparán en el mismo hilo de correo electrónico.

Configuración

Para configurar el correo electrónico como tipo de medio:

  1. Vaya a Alerts > Media types.
  2. Haga clic en Create media type (o haga clic en Email en la lista de tipos de medio predefinidos).

La pestaña Media type contiene atributos generales del tipo de medio:

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.

La contraseña se exporta en texto claro al exportar la configuración del tipo de medio de correo electrónico.

Los siguientes parámetros son específicos del tipo de medio de correo electrónico:

Parameter Description
Email provider Seleccione el proveedor de correo electrónico: Generic SMTP, Gmail, Gmail relay, Office365 o Office365 relay.
Si selecciona las opciones relacionadas con Gmail/Office365, solo tendrá que proporcionar la dirección de correo electrónico del remitente y la contraseña; opciones como SMTP server, SMTP server port, SMTP helo y Connection security se completarán automáticamente por Zabbix. Consulte también: Automated Gmail/Office365 media types.
SMTP server Establezca un servidor SMTP para gestionar los mensajes salientes.
Este campo está disponible si se selecciona Generic SMTP como proveedor de correo electrónico.
SMTP server port Establezca el puerto del servidor SMTP para gestionar los mensajes salientes.
Este campo está disponible si se selecciona Generic SMTP como proveedor de correo electrónico.
Email La dirección introducida aquí se utilizará como dirección From de los mensajes enviados.
Se admite añadir un nombre visible del remitente (como "Zabbix_info" en Zabbix_info zabbix\@company.com en la captura de pantalla anterior) junto con la dirección de correo electrónico real.
Existen algunas restricciones sobre los nombres visibles en los correos de Zabbix en comparación con lo permitido por RFC 5322, como se ilustra en los ejemplos:
Ejemplos válidos:
zabbix\@company.com (solo dirección de correo electrónico, no es necesario usar corchetes angulares)
Zabbix_info zabbix\@company.com (nombre visible y dirección de correo electrónico entre corchetes angulares)
∑Ω-monitoring zabbix\@company.com (caracteres UTF-8 en el nombre visible)
Ejemplos no válidos:
Zabbix HQ zabbix\@company.com (hay nombre visible, pero la dirección de correo electrónico no está entre corchetes angulares)
"Zabbix\@\<H(comment)Q\>" zabbix\@company.com (aunque es válido según RFC 5322, los pares entrecomillados y los comentarios no son compatibles en los correos de Zabbix)
SMTP helo Establezca un valor correcto para SMTP helo, normalmente un nombre de dominio.
Si está vacío, se enviará el nombre de dominio del correo electrónico (es decir, lo que aparece después de @ en el campo Email). Si no es posible obtener el nombre de dominio, se registrará una advertencia a nivel de depuración y se enviará el nombre de host del server como dominio para el comando HELO.
Este campo está disponible si se selecciona Generic SMTP como proveedor de correo electrónico.
Connection security Seleccione el nivel de seguridad de la conexión:
None - no use la opción CURLOPT_USE_SSL
STARTTLS - use la opción CURLOPT_USE_SSL con el valor CURLUSESSL_ALL
SSL/TLS - el uso de CURLOPT_USE_SSL es opcional
SSL verify peer Marque la casilla para verificar el certificado SSL del servidor SMTP.
El valor de la directiva de configuración del server "SSLCALocation" debe colocarse en CURLOPT_CAPATH para la validación del certificado.
Esto establece la opción de cURL CURLOPT_SSL_VERIFYPEER.
SSL verify host Marque la casilla para verificar que el campo Common Name o el campo Subject Alternate Name del certificado del servidor SMTP coincida.
Esto establece la opción de cURL CURLOPT_SSL_VERIFYHOST.
Authentication Seleccione el nivel de autenticación:
None - no se establece ninguna opción de cURL
Username and password - implica "AUTH=*" y deja la elección del mecanismo de autenticación a cURL
OAuth - autenticación OAuth
La autenticación OAuth no es compatible con el proveedor de correo electrónico Office365 relay.
Username Nombre de usuario que se utilizará en la autenticación.
Esto establece el valor de CURLOPT_USERNAME.
Se admiten macros de usuario.
Password Contraseña que se utilizará en la autenticación.
Esto establece el valor de CURLOPT_PASSWORD.
Se admiten macros de usuario.
El valor introducido aquí se exporta tal cual cuando se exporta la configuración del tipo de medio. Para evitar exponer credenciales sensibles en archivos exportados, use una macro de usuario (por ejemplo {$EMAIL_SMTP_PASSWORD}) en lugar de una contraseña literal: la referencia a la macro se exportará, mientras que el valor secreto deberá configurarse de nuevo en el sistema de destino.
OAuth tokens Haga clic en Configure para configurar los parámetros para recuperar OAuth tokens en una nueva ventana.
Este campo solo está disponible si se selecciona "OAuth" en el campo Authentication.
Message format Seleccione el formato del mensaje:
HTML - enviar como HTML
Plain text - enviar como texto sin formato

Para habilitar la autenticación SMTP, el server de Zabbix debe compilarse con la opción de compilación --with-libcurl, que requiere libcurl (consulte los requisitos de server para obtener detalles sobre la versión).

Consulte también common media type parameters para obtener detalles sobre cómo configurar los mensajes predeterminados y las opciones de procesamiento de alertas.

Tokens OAuth

Los siguientes parámetros son necesarios para recuperar tokens OAuth:

Parámetro Descripción
Punto final de redirección Introduzca la URL del frontend de Zabbix donde el servicio OAuth redirigirá la autorización OAuth (usando el formato https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize).
Se establece automáticamente para un nuevo tipo de medio de correo electrónico cuando se define la URL del frontend.
ID de cliente Introduzca el identificador único de la aplicación cliente registrada en el servidor de autorización OAuth.
Secreto de cliente Introduzca el secreto privado de la aplicación cliente registrada en el servidor de autorización OAuth.
Punto final de autorización Introduzca la URL del servidor de autorización OAuth para solicitar la autorización del usuario.
Parámetros de autorización Introduzca los parámetros para el punto final de autorización.
Código de autorización Introduzca el código de autorización:
Automático: el código se recuperará automáticamente a través de una página de redirección
Manual: introduzca el código manualmente si la recuperación automática falla
Punto final de token Introduzca la URL del servidor de autorización OAuth para intercambiar el código de autorización por tokens de acceso y actualización.
Parámetros de token Introduzca los parámetros para el token de acceso.

La recuperación de tokens OAuth tiene características automatizadas para los proveedores de correo electrónico Gmail, Gmail relay y Office365. Solo es necesario proporcionar los valores de los parámetros Punto final de redirección, ID de cliente y Secreto de cliente. Zabbix completará automáticamente los demás valores requeridos (consulte Valores predeterminados de URL OAuth por proveedor).

Obtención de tokens de acceso y actualización OAuth

Después de enviar los parámetros OAuth:

  1. Se abre una ventana emergente del navegador que dirige al usuario al Punto final de autorización.

  2. El usuario autoriza a Zabbix en el servicio OAuth.

  3. El servicio OAuth redirige al usuario a la acción del frontend de Zabbix oauth.authorize con el código de autorización y el valor del alcance.

  4. En respuesta, Zabbix realizará una solicitud al Punto final de token para intercambiar el código de autorización por los tokens de acceso y actualización.

Pruebas

Para comprobar si un tipo de medio de correo electrónico configurado funciona correctamente:

  1. Localice el correo electrónico correspondiente en la lista de tipos de medio.
  2. Haga clic en Test en la última columna de la lista (se abrirá una ventana de prueba).
  3. Introduzca una dirección de destinatario en Send to, el cuerpo del mensaje y, opcionalmente, el asunto.
  4. Haga clic en Test para enviar un mensaje de prueba.

En la misma ventana se mostrará un mensaje de éxito o de error de la prueba:

Medios del usuario

Una vez configurado el tipo de medio de correo electrónico, vaya a la sección Usuarios > Usuarios y edite el perfil del usuario para asignarle el medio de correo electrónico. Los pasos para configurar los medios del usuario, que son comunes para todos los tipos de medios, se describen en la página Tipos de medios.