Utilizar el Event Notifications Interfaz SMTP
IBM Cloud Event Notifications admite SMTP, el protocolo de correo electrónico más común en Internet. Puede enviar correo electrónico utilizando una variedad de clientes, software o lenguajes de programación que admitan SMTP conectándose a la interfaz SMTP de IBM Cloud Event Notifications. Este documento explica cómo configurar la configuración SMTP, obtener credenciales de usuario y configurar una regla CBR para acceder al servidor SMTP.
Verificación de nombre de dominio
Después de crear una configuración SMTP en una instancia IBM Cloud Event Notifications, debe realizar tres tipos de comprobaciones para obtener los parámetros necesarios para enviar correo electrónico a través de la interfaz SMTP. Estas verificaciones
se encuentran en la pestaña 'Verificar', a la que se puede acceder pulsando el menú ⋮
.
-
Crear Sender Policy Framework (SPF), que se utiliza para autenticar el remitente de un correo electrónico. SPF especifica los servidores de correo que pueden enviar correo electrónico para su dominio.
- Asegúrese de que el dominio ya existe como registro A en los registros DNS.
- Abra el proveedor de alojamiento DNS para el nombre de dominio configurado
- Cree un nuevo registro TXT con el registrador de nombres de dominio con el nombre y el valor proporcionados en la pantalla de configuración para SPF
-
Crear DomainKeys Identified Mail (DKIM), que permite a una organización responsabilizarse de la transmisión de un mensaje firmándolo. DKIM permite al receptor comprobar que el correo electrónico que afirma proceder de un dominio específico, está autorizado por el propietario de dicho dominio.
- Abra el proveedor de alojamiento DNS para el nombre de dominio configurado
- Cree un nuevo registro TXT con el registrador de nombres de dominio con el nombre y el valor proporcionados en la pantalla de configuración para DKIM
-
Para mejorar la seguridad, realizamos una verificación manual sobre el requisito de la interfaz SMTP utilizando el siguiente cuestionario:
1. Will the nature of the email content be Marketing or Transactional? 2. What is your website's URL? 3. Explain how you plan to use IBM Cloud Event Notifications to send email. To help us process your request, you should answer the following questions: a. What is your strategy for creating or obtaining your email subscriber list? b. What is your approach to managing bounced emails and handling recipient complaints? c. What methods do you have in place for recipients to unsubscribe from your email communications? d. How did you determine the sending rate or quota specified in your request? e. Are you regularly cleaning your email list to remove invalid or outdated email addresses? 4. Indicate the email addresses where you wish to receive account-related communications. You can provide a list of up to four email addresses, separated by commas. 5. In the Event Notifications subscription, you are asked to provide a Reply-To field. Confirm that this is a valid email-id with a mailbox. 6. Include a statement affirming your commitment to sending emails only to individuals who have explicitly requested them, and verify that you have established a procedure for managing bounce and complaint notifications. 7. Whether you have a manual or automated process in place for handling unsubscribes, it's important to provide an "unsubscribe" link in the email payload you send. When recipients decide not to receive further emails, they can simply click on the 'unsubscribe' link and remove their email address from your mailing list. Add a statement that you agree to have an “unsubscribe” link in the email payload that you send. 8. If you send the html content in the notification payload, do you have a process to validate this content is well formatted? Ill formatted HTML content may descrese the server reputation.
Si bien muchas preguntas son autoexplicativas, hemos dado explicaciones a unos pocos para garantizar la claridad.
-
Proporcione la naturaleza del correo electrónico: marketing o transaccional.
- Email de marketing: Estos correos electrónicos se distribuyen a una amplia audiencia, apuntando a una lista de prospectos o clientes con contenido de marketing y promocional, como fomentar una compra o descargar información.
- Correo electrónico transaccional: Estos correos electrónicos son individualizados para cada destinatario, normalmente desencadenados por acciones de usuario específicas, como hacer una compra de sitio web o solicitar un restablecimiento de contraseña.
-
Se requiere una URL del sitio web para comprender mejor el tipo de contenido que pretende enviar.
-
Se necesita un ID de correo electrónico de respuesta válido para recibir información sobre los correos electrónicos rechazados o rechazados.
-
El contenido de correo electrónico bien formateado es necesario para evitar que los correos electrónicos se clasifiquen como Spam en el extremo del destinatario. Los correos electrónicos que no están bien formateados (es decir, no están en HTML) pueden dar como resultado que los proveedores de servicios de correo electrónico clasifiquen los correos electrónicos como correo no deseado.
Al rellenar las respuestas a las preguntas antes mencionadas, los usuarios tienen que solicitar la habilitación de la verificación Event Notifications de la interfaz SMTP a través del tíquet de soporte:
- En la barra de menús de la consola de IBM Cloud, pulse el icono Ayuda > Centro de soporte.
- En la sección Ponerse en contacto con el equipo de soporte, pulse Crear caso.
- Seleccione en
Category
,Topic
como Event Notifications ySubtopic
como Otros - En
Subject
, añada Solicitud de autorización para habilitar la interfaz SMTP para Event Notifications - En la sección 'Descripción' proporcione en primer lugar IBM Cloud Event Notifications
instance id
,region
en la que se crea la instancia, y unDKIM Name
que tenga el formato{{uuid}}._domainkey.{{domain}}
- Más adelante, incluya las respuestas al cuestionario mencionado.
- Añada Archivos adjuntos si desea proporcionar más pruebas que soporten sus respuestas
- Añada los ID de correo electrónico necesarios en la sección Lista de observación. Y para obtener más información sobre otras opciones al crear un caso de soporte, consulte aquí.
-
Algunos de los problemas comunes de verificación podrían ser:
- Asegúrese de que el nombre de dominio está escrito correctamente.
- Verifique que el registro DNS para el dominio se ha actualizado correctamente, incluidos los valores de SPF/DKIM.
- La propagación de DNS puede tardar hasta 72 horas en actualizarse en Internet.
Vale la pena señalar que realizamos comprobaciones periódicas en los registros SPF y DKIM TXT del dominio proporcionado. Para asegurar la entrega ininterrumpida de correo electrónico, recomendamos mantener los registros insertados en el DNS incluso después de verificarlos una vez. Si el SPF o DKIM falla en la comprobación periódica, suspenderemos el envío de correo electrónico.
Habilitar restricciones basadas en contexto para acceder a la interfaz SMTP
La antigua lista de permisos basada en IP para la interfaz SMTP ha quedado obsoleta. Es obligatorio migrar a las restricciones basadas en el contexto al conectarse a la interfaz SMTP. Las actuales IP permitidas seguirán funcionando durante los próximos seis meses, dando tiempo a esta transición.
De forma predeterminada, el acceso a la interfaz SMTP está restringido desde cualquier dirección IP. Para permitir el acceso a la interfaz SMTP, debe habilitar restricciones basadas en el contexto. Específicamente para acceder a la interfaz SMTP, debe seleccionar la opción Tipo de API como configuración SMTP al establecer la regla CBR.
Todo el conjunto de IP asociadas en la zona de red seleccionada al configurar la regla CBR se incluirán automáticamente en la lista permitida para conectarse al servidor SMTP.
Es obligatorio configurar reglas CBR para las instancias IBM Cloud Event Notifications que pretenda utilizar para la función de interfaz SMTP
Requisitos para enviar correo electrónico a través de la interfaz SMTP
Tras verificar correctamente una configuración SMTP en una instancia IBM Cloud Event Notifications, para enviar un correo electrónico mediante la interfaz SMTP necesita los siguientes parámetros:
-
La lista de puntos finales SMTP de IBM Cloud Event Notifications para cada región se menciona en la tabla siguiente:
Puntos finales SMTP deIBM Cloud Event Notifications Event Notifications Instancia Región Punto final público SMTP Punto final privado SMTP us-south (Dallas) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com ca-tor (Toronto) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com jp-tok (Tokio) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com jp-osa (Osaka) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com au-syd (Sídney) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com eu-gb (Londres) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com eu-de (Frankfurt) smtp.eu-de.event-notifications.cloud.ibm.com private.smtp.eu-de.event-notifications.cloud.ibm.com eu-es (Madrid) smtp.eu-de.event-notifications.cloud.ibm.com private.smtp.eu-de.event-notifications.cloud.ibm.com br-sao (Sao Paulo) smtp.us-south.event-notifications.cloud.ibm.com private.smtp.us-south.event-notifications.cloud.ibm.com Los puntos finales SMTP están disponibles en las siguientes regiones:
us-south
yeu-de
. Por ejemplo, puede verse como las instancias creadas en Londres y Sydney también se conectan al punto final SMTP de Dallas, y las instancias creadas en Madrid también se conectan al punto final SMTP de Frankfurt. -
El número de puerto de la interfaz SMTP. Puerto 587 soportado actualmente.
-
El nombre de usuario y la contraseña SMTP. Los nombres de usuario y las contraseñas son únicos en todas las configuraciones SMTP y las contraseñas se cifran mediante hash unidireccional. Se puede crear un máximo de 5 usuarios en una única configuración SMTP. Actualmente estamos dando soporte a los métodos de autenticación
Login
yPlain
del protocolo SMTP. -
IBM Cloud Event Notifications La interfaz SMTP admite actualmente el método de conexión a través de
StartTLS
para la transmisión segura de datos a través de redes. -
El software o programa cliente puede comunicarse estrictamente utilizando TLS (Transport Layer Security).
-
Se pueden proporcionar direcciones IP o subredes válidas desde las que el cliente se conecta a la interfaz SMTP.
-
Al acceder a IBM Cloud Event Notifications a través de la interfaz SMTP, su aplicación cliente SMTP ensambla el mensaje. La información que debe proporcionar puede variar según la aplicación que esté utilizando. Los siguientes son los requisitos mínimos para un intercambio SMTP entre un cliente y un servidor:
- Dirección de origen: la dirección de origen debe pertenecer al dominio configurado; de lo contrario, la dirección del remitente será rechazada.
- Dirección de destino: La dirección de destino puede ser cualquier dirección de correo electrónico válida o conjunto de direcciones de correo electrónico
- Datos de mensaje: Asegúrese de que los datos del mensaje estén libres de correo no deseado, limpios y sensibles.
-
La lista de direcciones IP de salida basada en el punto final SMTP se menciona a continuación. Estas IP se listarán en los clientes de correo electrónico del destinatario:
IBM Cloud Event Notifications Direcciones IP salientes Punto final de SMTP Direcciones IP salientes smtp.us-south.event-notifications.cloud.ibm.com 150.240.68.207, 52.118.103.220, 169.47.95.114, 169.59.33.169, 150.239.167.120, 52.118.185.176 smtp.eu-de.event-notifications.cloud.ibm.com 149.81.218.203, 158.177.6.24, 149.81.39.14, 158.176.12.194, 149.81.164.10, 161.156.160.31 -
Según las configuraciones actuales, los archivos adjuntos no están soportados en la interfaz SMTP Event Notifications.
Utilización de la interfaz SMTP para enviar correos electrónicos
-
Configure el software compatible con SMTP, incluido ServiceNow, Jira, plataformas de blogs, agregadores RSS, software de administración de listas y sistemas de flujo de trabajo, utilizando el punto final SMTP, el puerto y las credenciales válidas de nombre de usuario y contraseña proporcionados.
-
Para enviar un correo electrónico utilizando la interfaz SMTP, puede utilizar un lenguaje de programación habilitado para SMTP, un servidor de correo electrónico o una aplicación. Asegúrese de completar todos los pasos necesarios mencionados anteriormente y de tener el punto final, el puerto y las credenciales SMTP correctos para conectarse a la interfaz SMTP de IBM Cloud Event Notifications.
-
Si actualmente administra su propio servidor de correo electrónico, puede utilizar el punto final SMTP, el puerto y las credenciales de IBM Cloud para enviar todo el correo electrónico saliente a través de la configuración SMTP de Event Notifications, sin modificar los clientes de correo electrónico y las aplicaciones existentes.
-
Para interactuar con la interfaz SMTP de IBM Cloud Event Notifications mediante la línea de comandos, siga el siguiente ejemplo:
openssl s_client -starttls smtp -connect {{smtp_endpoint}}:587 ... ... ... auth login 334 VXNlcm5hbWU6 dXNlcm5hbWU= 334 UGFzc3dvcmQ6 cGFzc3dvcmQ= 235 2.7.0 Authentication successful mail from: mailer@example.com 250 2.1.0 Ok rcpt to: recipient@test.com 250 2.1.5 Ok data 354 End data with <CR><LF>.<CR><LF> from: Mailer <mailer@example.com> to: Recipient <recipent@test.com> Subject: IBM Cloud Event Notifications SMTP interface Get the all events securely from IBM EN SMTP Interface .
Utilizar el punto final privado SMTP para enviar correos electrónicos
-
Para enviar correos electrónicos a través del punto final privado SMTP, debe crear o adjuntar un punto final privado virtual (VPE) a su IBM Cloud Virtual Private Cloud (VPC).
-
Asegúrese de adjuntar la puerta de enlace VPE a la misma VPC en la que están desplegados sus clústeres IKS (IBM Kubernetes Service) o VSI (Virtual Service Instance).
-
Al crear VPE:
- Seleccione la Región y VPC requeridas, desde donde desea conectarse al Endpoint Privado SMTP.
- En "Solicitar conexión a un servicio", seleccione "Event Notifications".
- Habilitar el punto final:
private.smtp.<region>.event-notifications.cloud.ibm.com
- Seleccione la subred necesaria para la IP reservada (Nota: sólo puede vincular una dirección IP por zona VPC a una puerta de enlace de punto final).
punto final privado -
Cree una Zona de red en Context-Based-Restrictions(CBR) para su VPC.
-
Cree Regla CBR para Instancia de Notificaciones de Sucesos y añada la Zona de red creada anteriormente (O) Añada la Zona de red a la Regla CBR existente que ya ha creado para Instancia de Notificaciones de Sucesos.
-
Pruebe a utilizar el punto final privado SMTP correspondiente que aparece aquí.
Seguimiento del estado de correo electrónico
- Después de enviar correos electrónicos desde cualquiera de los métodos anteriores, recibirá un ID de cola, que será beneficioso para fines de depuración.
- Esta prestación permite a los usuarios supervisar el estado de entrega de los correos electrónicos enviados a través de un destino de correo electrónico personalizado, garantizando la transparencia y mejorando la experiencia general del usuario. Para obtener más información, siga estos pasos.