La autenticación es necesaria cada vez que desees retransmitir mensajes a través de nuestra plataforma. Cuando utilices nuestra API, deberás utilizar una de las claves de API de tu cuenta (ya sea la clave de API de una cuenta o una de las claves de envío de dominio).

Para nuestro servidor SMTP, debes utilizar las credenciales SMTP de tu dominio.

Claves API

Clave API de una cuenta de Mailgun

Las claves de API de cuenta brindan acceso a nuestros numerosos puntos de conexión de API que te permiten ver y modificar muchos aspectos de tu cuenta y tus dominios. En otras palabras, puedes realizar mediante programación casi todas las mismas tareas utilizando las API de Mailgun que de otro modo se realizarían dentro del Panel de control de Mailgun.

Mailgun permite la creación y el uso de múltiples claves de API en la cuenta. Tener varias claves de API es útil en varios escenarios, como los dos que se enumeran a continuación.

• Segmentar el uso proporcionando una clave única para cada una de las aplicaciones, entornos, equipos o departamentos de tu organización. Cuando se utiliza para este propósito y se configura correctamente, cualquier problema asociado con una única clave de API solo afectaría a una aplicación, un entorno, un equipo o un departamento en lugar de a todas las aplicaciones, entornos, equipos o departamentos.
• Rotación periódica de las claves. Mientras que una clave de API existente permanece en uso, se puede crear una nueva clave de API y luego usarla para reemplazar la clave de API existente al ritmo y con la urgencia que se necesite y de forma que se adapte a tu cronograma.

Nota importante:

La clave de API se puede ver solo una vez: Dentro de un recuadro emergente después de la creación de la clave. Por tanto, además de configurar la clave de API en tus aplicaciones de envío, almacena la clave de API en una ubicación segura (como el administrador de credenciales/contraseñas de tu organización) para su uso futuro.

Consecuentemente, si pierdes la clave de API, Mailgun no podrá ver ni divulgar la clave de API en una fecha posterior. La única solución para esta situación es crear una nueva clave de API, configurar tu(s) aplicación(es) de envío con la nueva clave de API y almacenar la nueva clave de API en una ubicación segura para su uso futuro.

Para ver las claves de API de la cuenta (o más específicamente sus ID de clave de API, descripciones y fechas de creación asociadas):

1. En la esquina superior derecha del Panel de control de Mailgun, haz clic en tu menú "Profile" (Perfil) para ampliar su lista de opciones.

2. A continuación, haz clic en la opción "API Security" (Seguridad de la API). O, como alternativa, puedes usar este enlace directo. 

3. La página resultante muestra la sección con pestañas de Claves de API , que enumera las claves de API de la cuenta (así como la clave pública de verificaciones y la clave de firma de webhook HTTP).

Claves de envío de dominios

Las claves de envío de dominio son claves de API que solo permiten el envío de mensajes mediante una llamada POST a través de nuestros puntos de conexión /messages y /messages.mime para el dominio en el que se crean. A continuación te mostramos cómo hacerlo:

1. En primer lugar, inicia sesión en el Panel de control de Mailgun (si aún no lo has hecho).
2. A continuación, dentro del panel de navegación de la izquierda, haz clic en la opción "Sending" (Envíos) para ampliar tu lista de subopciones.
3. A continuación, haz clic en la subopción "Domain settings" (Ajustes del dominio), y luego haz clic en la pestaña "Sending API keys" (Claves de API de envío).
4. Haz clic en el botón "Add sending key" (Añadir clave de envío).
5. En el recuadro emergente, introduce una descripción adecuada (como el nombre de la aplicación o del cliente para el que estás creando la clave) antes de, por último, hacer clic en el botón "Create Sending Key" (Crear clave de envío).
6. Copia tu clave API de envío y guárdala en un lugar seguro. Por motivos de seguridad, no podremos volver a mostrarte la clave. Si pierdes tu clave, tendrás que crear una nueva.

Nota: Una vez que añadas una nueva clave de envío de dominio, ésta estará lista para ser utilizada inmediatamente y no afectará al uso de su clave API principal.

Credenciales SMTP

Tus credenciales SMTP son diferentes para cada dominio que añadas.Puedes encontrar tus usuarios actuales y añadir más haciendo clic en los ajustes de tu dominio.A continuación te mostramos cómo hacerlo:

1. En primer lugar, inicia sesión en el Panel de control de Mailgun (si aún no lo has hecho).
2. A continuación, dentro del panel de navegación de la izquierda, haz clic en la opción "Sending" (Envíos) para ampliar tu lista de subopciones.
3. A continuación, haz clic en la subopción "Domain settings" (Ajustes del dominio), y luego haz clic en la pestaña "SMTP credentials" (Credenciales SMTP).
4. Para actualizar la contraseña, haz clic en el botón "Reset password" (Restablecer contraseña).
5. Confirma el restablecimiento de tu contraseña haciendo clic en el botón "Reset Password" (Restablecer contraseña) en el recuadro emergente.
6. NOTA: La nueva contraseña SMTP estará disponible dentro de una ventana de notificación de color gris oscuro que aparece en la parte inferior derecha del panel de control.Guarda esta contraseña en tu aplicación y en un gestor de contraseñas seguro, ya que no se volverá a mostrar. 

¿Quieres crear credenciales SMTP utilizando la API de dominios? Consulta nuestra documentación. 

¿Necesitas acortar o personarlizar de otra forma tu contraseña SMTP?  Consulta este artículo.

¿Qué puertos soporta Mailgun?

Nuestros servidores escuchan en los puertos 25, 465 (SSL/TLS), 587 (STARTTLS) y 2525.

Hay que tener en cuenta algunas cosas a la hora de seleccionar un puerto:

• Algunos ISP bloquean o limitan el puerto 25 de SMTP. Nosotros recomendamos usar el puerto 587 en su lugar.
• Google Compute Engine permite el puerto 2525 para el envío SMTP.
• Las IP de Mailgun cambian frecuentemente, no recomendamos establecer restricciones de firewall contra nuestras direcciones IP.
• Consulta nuestra documentación SMTP en el manual de usuario para aprender a configurar el software SMTP y los clientes de correo electrónico más populares para que funcionen con Mailgun.

Para obtener una explicación más detallada sobre los puertos, consulta nuestro artículo en el blog.

¿Tienes preguntas?

¡Mailgun by Sinch tiene respuestas! Si te queda alguna duda o pregunta, abre una incidencia utilizando la página de asistencia dentro de tu panel de control de Mailgun.  Nuestro equipo de asistencia estará encantado de ayudarte.