Arquitectura del retransmisor SMTP personalizado
De forma predeterminada, Passinstance envía las notificaciones de entrega de pases, los correos de bienvenida y las campañas a través de nuestro clúster optimizado de infraestructura gestionada de correo en la UE (eu-central-1 Fráncfort). Para organizaciones, entidades financieras y agencias de marca blanca que exigen que todos los correos salientes salgan estrictamente desde sus propios servidores de correo corporativos (como Google Workspace, Microsoft 365, SendGrid, Mailgun, Postmark o un retransmisor interno Postfix), Passinstance ofrece la función de retransmisor SMTP personalizado.
Cuando está habilitado, Passinstance enruta todos los envíos transaccionales de pases y las campañas de Delivery Center a través de su servidor SMTP designado, garantizando alineación completa del dominio remitente, firma DKIM propia y cumplimiento de archivado interno:
Precios y habilitación del complemento
El retransmisor SMTP personalizado es una capacidad modular del espacio de trabajo:
-
Precio: Disponible como complemento modular por €20/mes (
AddonType.OWN_SMTP, indicador de funciónownSmtp). -
Volúmenes incluidos: Al enrutar a través de su propio servidor SMTP, no consume tarifas de entrega de correo electrónico de la plataforma Passinstance; los límites de volumen de envío se rigen exclusivamente por los límites de tasa de su propio proveedor de correo.
-
Activar el complemento: Vaya a Configuración -> Espacio de trabajo -> Complementos y active Retransmisor SMTP personalizado.
Puertos y modos de seguridad admitidos
El cliente SMTP de Passinstance (request payload) admite puertos de envío SMTP estándar y alternativos:
| Puerto | Protocolo / Cifrado | Recomendación de seguridad | Proveedores de correo habituales |
|---|---|---|---|
587 | STARTTLS (TLS explícito) | Recomendado (predeterminado): Conecta en texto plano y asciende de inmediato a TLS 1.3 antes de autenticarse. | Google Workspace, Microsoft 365, SendGrid, Mailgun, Postmark |
465 | SMTPS (SSL/TLS implícito) | Seguro: La conexión se encapsula en TLS desde la negociación inicial del socket (secure: true). | Entrega gestionada de correo SMTP, servidores privados con certificados SSL dedicados |
2525 | STARTTLS alternativo | Apto para la nube: Ideal para alojamientos en AWS, Azure o Google Cloud donde el puerto saliente 25 está bloqueado o limitado. | SendGrid, Mailgun, SparkPost |
25 | Texto plano / TLS oportunista | No recomendado para entrega en Internet: Suele estar bloqueado por ISP y cortafuegos en la nube para prevenir spam. | Retransmisores de correo internos heredados dentro de perímetros corporativos privados |
Validación de seguridad de hosts anti-SSRF (validateSmtpHost)
Para evitar ataques Server-Side Request Forgery (SSRF) y proteger la infraestructura interna en la nube, Passinstance valida cada nombre de host SMTP configurado contra límites de red estrictos (validateSmtpHost en smtp-config.service.ts):
Regla de seguridad: Cualquier intento de configurar un host SMTP que resuelva a una dirección IP interna, link-local o privada lanza de inmediato
BadRequestException: Invalid SMTP host address.
Los siguientes destinos están bloqueados de forma permanente:
-
1
Direcciones de loopback:
127.0.0.1,localhost,::1. -
2
Rangos IPv4 privados RFC 1918:
- 10.0.0.0/8 (10.0.0.0 - 10.255.255.255) - 172.16.0.0/12 (172.16.0.0 - 172.31.255.255) - 192.168.0.0/16 (192.168.0.0 - 192.168.255.255)
-
3
Servicio de metadatos de instancias de AWS (IMDS):
169.254.169.254y todos los rangos link-local169.254.0.0/16. -
4
Nombres de host no resolubles: Se rechazan los nombres de host que no superan la resolución pública de registros DNS A/AAAA.
Almacenamiento de credenciales en almacén cifrado de secretos
Passinstance trata las credenciales de autenticación SMTP bajo principios de seguridad de confianza cero (zero-trust):
-
Cifrado en almacén seguro: Al guardar su configuración SMTP, la contraseña se cifra y se almacena en el almacén cifrado de secretos bajo la ruta del inquilino
smtp/{customerId}. -
Sin texto plano en la base de datos: La base de datos principal almacena únicamente los metadatos de conexión (host, puerto, usuario, dirección de remitente y modo de cifrado). El campo de contraseña en la base de datos es nulo.
-
Ocultación en respuestas de API: Los endpoints GET (
GET /settings/smtp-config) devuelven"hasPassword": truecon la contraseña enmascarada como"********". Las contraseñas nunca se devuelven al navegador. -
Acceso efímero de los workers: Cuando se despacha un correo saliente, el worker de la cola de trabajos en segundo plano recupera el secreto directamente desde el almacén cifrado hacia memoria temporal y lo descarta en cuanto finaliza la sesión del socket.
Configurar SMTP personalizado en el panel de control
-
1
Vaya a Configuración -> Mensajería -> SMTP personalizado (
/settings/workspace/messaging/smtp). -
2
Complete los parámetros de conexión de su servidor:
- Host SMTP: FQDN de su servidor de correo (por ejemplo, smtp.sendgrid.net o smtp.office365.com). - Puerto: 587 (STARTTLS) o 465 (SSL). - Usuario: Nombre de usuario de autenticación SMTP o clave API. - Contraseña: Contraseña SMTP o token de API. - Dirección de correo del remitente: Dirección remitente (por ejemplo, passes@yourbrand.com). - Nombre visible del remitente: Nombre mostrado al destinatario (por ejemplo, YourBrand Wallet Support).
-
3
Haga clic en Enviar correo de prueba (
POST /settings/smtp-config/test). -
4
Introduzca una dirección de correo electrónico a la que tenga acceso y haga clic en Enviar. Passinstance comprueba la resolución DNS, la negociación TLS, la autenticación y envía un correo de verificación.
-
5
Una vez superada la prueba, haga clic en Guardar configuración. Todos los correos posteriores se enrutarán a través de su servidor.
Endpoints de la API REST para SMTP personalizado
| Método | Ruta del endpoint | Ámbito de autenticación | Descripción |
|---|---|---|---|
| GET | /api/v1/settings/smtp-config | Clave API (settings) | Obtiene la configuración SMTP actual del espacio de trabajo (contraseña enmascarada). |
| PUT | /api/v1/settings/smtp-config | Clave API (settings) | Actualiza los parámetros de conexión SMTP y cifra la contraseña en el almacén seguro. |
| POST | /api/v1/settings/smtp-config/test | Clave API (settings) | Realiza una prueba de conexión de socket en vivo y envía un correo de verificación. |
| DELETE | /api/v1/settings/smtp-config | Clave API (settings) | Elimina la configuración SMTP personalizada y devuelve el espacio de trabajo a la entrega gestionada de correo. |
Ejemplo: probar la configuración SMTP antes de guardar
POST /api/v1/settings/smtp-config/test HTTP/1.1
Host: api.passinstance.com
X-API-Key: <API_KEY>
Content-Type: application/json
{
"host": "smtp.mailgun.org",
"port": 587,
"user": "postmaster@mg.yourbrand.com",
"pass": "secret-api-key-99214",
"fromEmail": "passes@yourbrand.com",
"fromName": "YourBrand Wallet",
"secure": false,
"testRecipientEmail": "admin@yourbrand.com"
}
Respuesta (200 OK):
{
"success": true,
"message": "SMTP test email sent successfully",
"details": {
"response": "250 2.0.0 Ok: queued as 7F8E9A10",
"accepted": ["admin@yourbrand.com"],
"rejected": []
}
}
Autenticación de dominio: alineación SPF, DKIM y DMARC
Para garantizar una alta entregabilidad en bandeja de entrada y evitar filtros antispam al enviar mediante su propio servidor SMTP, asegúrese de tener correctamente configurados los registros DNS de su dominio:
1. Sender Policy Framework (SPF)
Incluya el mecanismo SPF de su proveedor SMTP en el registro TXT de su dominio raíz:
v=spf1 include:mailgun.org include:_spf.google.com ~all
2. DomainKeys Identified Mail (DKIM)
Verifique que su proveedor de correo haya generado claves DKIM de 2048 bits para su dominio de envío y publique los registros CNAME de clave pública correspondientes en su DNS.
3. Alineación DMARC
Publique un registro de política DMARC (_dmarc.yourbrand.com) para exigir alineación entre la dirección From: conforme a RFC 5322 y sus identificadores verificados SPF/DKIM:
v=DMARC1; p=quarantine; rua=mailto:dmarc-reports@yourbrand.com; pct=100
Documentación relacionada
-
Entrega por correo electrónico y SMS — Campañas, plantillas y controles en tiempo de ejecución de envío.
-
Marca personalizada y opciones de marca blanca — Dominios propios de descarga y personalización visual del portal.
-
Distribución en autoservicio — PassFlows, enlaces inteligentes y distribución mediante NFC.
