Skip to content
Guía del Centro de ayuda · Distribución de pases
6 min de lecturaVerificado 2026-11-16

Su propia dirección de remitente y SMTP personalizado

Configure un servidor de retransmisión SMTP personalizado para enviar correos electrónicos de pases desde su dominio corporativo con cifrado de credenciales y seguridad anti-SSRF.

En esta guía

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:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
RETRANSMISOR SMTP PERSONALIZADO Y CIFRADO DE CREDENCIALES
ETAPA 01 DESPACHADOR DE ENTREGA DE CORREO DE PASSINSTANCE
Activado por creación de pase, envíos de Delivery Center o correo en descarga
ETAPA 02 ENRUTAMIENTO DE PASARELA Y CONTROL DE LICENCIA
Comprueba el derecho del espacio de trabajo: AddonType.OWN_SMTP (€20/mes) o indicador ownSmtp
Guardia anti-SSRF: validateSmtpHost valida la dirección IP de destino
ETAPA 03 HIDRATACIÓN DE CREDENCIALES CIFRADAS
Recupera la contraseña SMTP cifrada del almacén seguro: smtp/{customerId}
Se descifra en memoria efímera; nunca se registra ni guarda en texto plano
ETAPA 04 SERVIDOR DE RETRANSMISIÓN SMTP CORPORATIVO DEL CLIENTE
Host: smtp.yourbrand.com | Puertos: 587 (STARTTLS), 465 (SSL) o 2525
Despacha el mensaje con las firmas DKIM, SPF y DMARC del cliente
ETAPA 05 BANDEJA DE ENTRADA DEL DESTINATARIO
Entregado desde: passes@yourbrand.com (Identidad de remitente 100 % propia)

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ón ownSmtp).
  • 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:

PuertoProtocolo / CifradoRecomendación de seguridadProveedores de correo habituales
587STARTTLS (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
465SMTPS (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
2525STARTTLS alternativoApto para la nube: Ideal para alojamientos en AWS, Azure o Google Cloud donde el puerto saliente 25 está bloqueado o limitado.SendGrid, Mailgun, SparkPost
25Texto plano / TLS oportunistaNo 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. 1
    Direcciones de loopback: 127.0.0.1, localhost, ::1.
  2. 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)

  1. 3
    Servicio de metadatos de instancias de AWS (IMDS): 169.254.169.254 y todos los rangos link-local 169.254.0.0/16.
  2. 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": true con 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. 1
    Vaya a Configuración -> Mensajería -> SMTP personalizado (/settings/workspace/messaging/smtp).
  2. 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).

  1. 3
    Haga clic en Enviar correo de prueba (POST /settings/smtp-config/test).
  2. 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.
  3. 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étodoRuta del endpointÁmbito de autenticaciónDescripción
GET/api/v1/settings/smtp-configClave API (settings)Obtiene la configuración SMTP actual del espacio de trabajo (contraseña enmascarada).
PUT/api/v1/settings/smtp-configClave 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/testClave 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-configClave 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

HTTP
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):

JSON
{
  "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:

TEXT
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:

TEXT
v=DMARC1; p=quarantine; rua=mailto:dmarc-reports@yourbrand.com; pct=100

Documentación relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.