Architectuur van eigen SMTP-relay
Standaard verstuurt Passinstance bezorgmeldingen voor passen, welkomst-e-mails en campagneverzendingen via ons geoptimaliseerde e-mailcluster met beheerde EU-e-mailinfrastructuur (eu-central-1 Frankfurt). Voor organisaties, financiële instellingen en white-labelbureaus die vereisen dat alle uitgaande e-mails strikt vanaf hun eigen zakelijke mailservers worden verzonden (zoals Google Workspace, Microsoft 365, SendGrid, Mailgun, Postmark of een interne Postfix-relay), biedt Passinstance de functie Eigen SMTP-relay.
Wanneer deze functie is ingeschakeld, routeert Passinstance alle transactionele pasverzendingen en campagnes uit het Delivery Center via uw opgegeven SMTP-host, wat zorgt voor volledige uitlijning met uw afzenderdomein, eigen DKIM-ondertekening en interne archiveringscompliance:
Tarieven & add-onrecht
De eigen SMTP-relay is een modulaire functie op werkruimteniveau:
-
Tarief: Beschikbaar als modulaire add-on voor €20/maand (
AddonType.OWN_SMTP, functievlagownSmtp). -
Inbegrepen volumes: Wanneer u via uw eigen SMTP-server routeert, betaalt u geen e-mailbezorgkosten op het Passinstance-platform; verzendlimieten worden uitsluitend bepaald door de snelheidslimieten van uw eigen e-mailprovider.
-
De add-on activeren: Ga naar Instellingen -> Werkruimte -> Add-ons en schakel Eigen SMTP-relay in.
Ondersteunde poorten & beveiligingsmodi
De SMTP-client van Passinstance (request payload) ondersteunt zowel standaard- als alternatieve SMTP-verzendpoorten:
| Poort | Protocol / versleuteling | Beveiligingsaanbeveling | Gangbare mailproviders |
|---|---|---|---|
587 | STARTTLS (Expliciete TLS) | Aanbevolen (standaard): Maakt verbinding in platte tekst en schakelt vóór authenticatie direct op naar TLS 1.3. | Google Workspace, Microsoft 365, SendGrid, Mailgun, Postmark |
465 | SMTPS (Impliciete SSL/TLS) | Veilig: Verbinding wordt vanaf de initiële sockethandshake direct versleuteld met TLS (secure: true). | Beheerde e-mailbezorging via SMTP, eigen mailservers met dedicated SSL-certificaten |
2525 | Alternatieve STARTTLS | Cloudvriendelijk: Ideaal voor hosting op AWS, Azure of Google Cloud waar uitgaande poort 25 geblokkeerd of beperkt is. | SendGrid, Mailgun, SparkPost |
25 | Platte tekst / opportunistische TLS | Afgeraden voor internetbezorging: Wordt vaak geblokkeerd door internetproviders en cloudfirewalls om spam te voorkomen. | Interne verouderde mailrelays binnen afgeschermde bedrijfsnetwerken |
Anti-SSRF hostbeveiligingsvalidatie (validateSmtpHost)
Om Server-Side Request Forgery (SSRF) te voorkomen en interne cloudinfrastructuur te beschermen, valideert Passinstance elke geconfigureerde SMTP-hostnaam tegen strikte netwerkgrenzen (validateSmtpHost in smtp-config.service.ts):
Beveiligingsregel: Elke poging om een SMTP-host in te stellen die verwijst naar een intern, link-local of privé-IP-adres resulteert direct in een
BadRequestException: Invalid SMTP host address.
De volgende bestemmingen worden permanent geblokkeerd:
-
1
Loopback-adressen:
127.0.0.1,localhost,::1. -
2
RFC 1918 privé-IPv4-bereiken:
- 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
AWS Instance Metadata Service (IMDS):
169.254.169.254en alle169.254.0.0/16link-local-bereiken. -
4
Niet-oplosbare hostnamen: Hostnamen waarvoor openbare DNS A-/AAAA-recordresolutie mislukt, worden geweigerd.
Opslag van inloggegevens in versleutelde geheime opslag
Passinstance behandelt SMTP-authenticatiegegevens volgens zero-trustbeveiliging:
-
Versleutelde opslag: Zodra u uw SMTP-configuratie opslaat, wordt het wachtwoord versleuteld opgeslagen in de versleutelde geheime opslag onder het tenantpad
smtp/{customerId}. -
Geen platte tekst in de database: De primaire database slaat uitsluitend verbindingsmetadata op (host, poort, gebruikersnaam, afzenderadres, versleutelingsmodus). Het wachtwoordveld in de database blijft
null. -
Afgeschermd in API-responsen: GET-endpoints (
GET /settings/smtp-config) retourneren"hasPassword": truemet het wachtwoord gemaskeerd als"********". Wachtwoorden worden nooit teruggestuurd naar de browser. -
Tijdelijke workertoegang: Wanneer een uitgaande e-mail wordt verzonden, haalt de achtergrondworker het geheim rechtstreeks uit de versleutelde opslag in het tijdelijke geheugen op en wist dit onmiddellijk zodra de socketsessie eindigt.
Eigen SMTP configureren in het Dashboard
-
1
Ga naar Instellingen -> Berichten -> Eigen SMTP (
/settings/workspace/messaging/smtp). -
2
Vul de verbindingsparameters van uw server in:
- SMTP-host: FQDN van uw mailserver (bijv. smtp.sendgrid.net of smtp.office365.com). - Poort: 587 (STARTTLS) of 465 (SSL). - Gebruikersnaam: SMTP-gebruikersnaam of API-sleutel. - Wachtwoord: SMTP-wachtwoord of API-token. - E-mailadres afzender: Afzenderadres (bijv. passes@yourbrand.com). - Naam afzender: Weergavenaam (bijv. YourBrand Wallet Support).
-
3
Klik op Test-e-mail verzenden (
POST /settings/smtp-config/test). -
4
Vul een e-mailadres in waartoe u toegang hebt en klik op Verzenden. Passinstance test de DNS-resolutie, TLS-handshake en authenticatie en bezorgt een voorbeeld-test-e-mail.
-
5
Zodra de test slaagt, klikt u op Configuratie opslaan. Alle volgende e-mails worden vanaf dat moment via uw server gerouteerd.
REST API-endpoints voor eigen SMTP
| Methode | Endpointpad | Auth-bereik | Beschrijving |
|---|---|---|---|
| GET | /api/v1/settings/smtp-config | API-sleutel (settings) | Haalt de huidige SMTP-configuratie van de werkruimte op (wachtwoord gemaskeerd). |
| PUT | /api/v1/settings/smtp-config | API-sleutel (settings) | Werkt SMTP-verbindingsparameters bij en versleutelt het wachtwoord in de beveiligde opslag. |
| POST | /api/v1/settings/smtp-config/test | API-sleutel (settings) | Voert een live socketverbindingstest uit en verstuurt een verificatie-e-mail. |
| DELETE | /api/v1/settings/smtp-config | API-sleutel (settings) | Verwijdert de eigen SMTP-configuratie en schakelt de werkruimte terug naar beheerde e-mailbezorging. |
Voorbeeld: SMTP-configuratie testen vóór opslaan
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"
}
Respons (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": []
}
}
Domeinauthenticatie: uitlijning van SPF, DKIM & DMARC
Om een hoge inboxbezorging te waarborgen en spamfilters te vermijden bij verzending via uw eigen SMTP-server, moeten de DNS-records van uw domein correct zijn ingericht:
1. Sender Policy Framework (SPF)
Neem het SPF-mechanisme van uw SMTP-provider op in het TXT-record van uw hoofddomein:
v=spf1 include:mailgun.org include:_spf.google.com ~all
2. DomainKeys Identified Mail (DKIM)
Zorg dat uw mailprovider 2048-bits DKIM-sleutels heeft gegenereerd voor uw verzenddomein en publiceer de bijbehorende publieke-sleutel-CNAME-records in uw DNS.
3. DMARC-uitlijning
Publiceer een DMARC-beleidsrecord (_dmarc.yourbrand.com) om overeenstemming af te dwingen tussen het RFC 5322 From:-adres en uw geverifieerde SPF-/DKIM-identificatoren:
v=DMARC1; p=quarantine; rua=mailto:dmarc-reports@yourbrand.com; pct=100
Gerelateerde documentatie
-
E-mail- en sms-bezorging — Campagnes, sjablonen en runtime-verzendcontroles.
-
Eigen huisstijl & white-labelopties — Eigen downloaddomeinen en portaalthema's.
-
Selfservice-distributie — PassFlows, slimme links en NFC-distributie.
