Resumen

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

Claves 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 de Mailgun 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 de Mailgun en tus aplicaciones de envío, almacena la clave de API de Mailgun 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 de Mailgun, no podremos ver ni divulgar la clave de API de Mailgun en una fecha posterior. La única solución para esta situación es crear una nueva clave de API de Mailgun, configurar tu/s aplicación/es de envío con la nueva clave de API de Mailgun y almacenar la nueva clave de API de Mailgun en una ubicación segura para su uso futuro.

¿Prefieres ver un vídeo? El siguiente vídeo comenzará en la sección que muestra la creación de una clave de API.

Para crear una nueva clave de API de Mailgun:

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. En la página siguiente se muestra la "Verification Public Key" (clave pública de verificación), la "HTTP Webhook Signing Key" (clave de firma de webhook HTTP) y, lo que es más importante en este caso, las claves de API de Mailgun. Para crear una clave nueva, haz clic en el botón "Add new key" (Añadir nueva clave).
   
4. Por último, introduce una descripción, elige un rol y haz clic en el botón "Create Key" (Crear clave) en el recuadro emergente para confirmar la creación de una nueva clave de API de Mailgun.
   1. Nota: Las cuentas que utilicen Planes Free o Basic no podrán elegir un rol distinto de Admin para la clave de API.

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, /messages.mime, y /events 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 izquierdo, haz clic en el producto Send y luego en la opción "Sending" (Envíos) para desplegar su 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.

Clave de firma de webhook HTTP

Mailgun utiliza la clave de firma de webhook HTTP de la cuenta para firmar todas las cargas enviadas a los puntos de conexión de webhooks que estén configurados para tu cuenta (si los hay).

1. En primer lugar, inicia sesión en el Panel de control de Mailgun (si aún no lo has hecho).
2. Después, en la esquina superior derecha del Panel de control de Mailgun, haz clic en tu menú "Profile" (Perfil) para ampliar su lista de opciones.
   
3. A continuación, haz clic en la opción "API Security" (Seguridad de la API).  También puedes utilizar este enlace directo. 

   

4. Entonces, para la clave ya existentes en la sección "HTTP webhook signing key" (clave de firma de webhook HTTP), haz clic en el icono de actualizar.
   
   
5. Por último, haz clic en el botón "Reset Key" (Restablecer clave) en el recuadro emergente para confirmar la eliminación de la clave de firma de webhook HTTP existente. Esto también generará automáticamente una nueva clave de firma de webhook HTTP.
   
   

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 izquierdo, haz clic en el producto Send y luego en la opción "Sending" (Envíos) para desplegar su 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. Asegúrate de que el dominio para el que quieres restablecer las credenciales SMTP aparece en la lista desplegable de dominios, en la parte superior derecha de la página.
   
5. Para actualizar la contraseña, haz clic en el botón "Reset password" (Restablecer contraseña).
6. Confirma el restablecimiento de tu contraseña haciendo clic en el botón "Reset Password" (Restablecer contraseña) en el recuadro emergente.
   
7. NOTA: La nueva contraseña SMTP estará disponible para copiarse dentro de una ventana de notificación de color gris oscuro que aparece en la parte inferior derecha del panel de control. Copia y 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? ¿Necesitas acortar o personarlizar de otra forma tu contraseña SMTP?  Consulta este artículo.

Puertos SMTP y protocolos de cifrado

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.

¿Necesitas ayuda?

Nuestro equipo de asistencia en Sinch Mailgun estará encantado de ayudarte. Ponte en contacto con nosotros en la página de Asistencia de tu Panel de control de Mailgun y en breve estaremos contigo.