Skip to content
Helpcentrum-gids · Pass-distributie
5 min leestijdGecontroleerd 2026-11-16

Eigen afzenderadres en eigen SMTP

Configureer een aangepaste SMTP-relayserver om pass-e-mails vanaf uw bedrijfsdomein te verzenden met poortflexibiliteit, versleutelde opslag van inloggegevens en anti-SSRF-beveiliging.

In deze gids

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:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
EIGEN SMTP-RELAY & VERSLEUTELING VAN INLOGGEGEVENS
FASE 01 PASSINSTANCE E-MAILBEZORGDISPATCHER
Geactiveerd via pasaanmaak, Delivery Center-verzendingen of downloadpagina-mail
FASE 02 GATEWAYROUTING & FUNCTIECONTROLE
Controleert werkruimterecht: AddonType.OWN_SMTP (€20/mnd) of ownSmtp-vlag
Anti-SSRF hostbewaking: validateSmtpHost valideert doel-IP-adres
FASE 03 OPHALEN VAN VERSLEUTELDE INLOGGEGEVENS
Haalt versleuteld SMTP-wachtwoord op uit beveiligde opslag: smtp/{customerId}
Ontsleuteld in tijdelijk geheugen; nooit gelogd of onversleuteld in database
FASE 04 ZAKELIJKE SMTP-RELAYSERVER VAN DE KLANT
Host: smtp.yourbrand.com | Poorten: 587 (STARTTLS), 465 (SSL) of 2525
Verstuurt bericht met eigen DKIM-, SPF- en DMARC-handtekeningen van de klant
FASE 05 INBOX VAN ONTVANGER
Bezorgd vanaf: passes@yourbrand.com (100% eigen merkafzenderidentiteit)

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, functievlag ownSmtp).
  • 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:

PoortProtocol / versleutelingBeveiligingsaanbevelingGangbare mailproviders
587STARTTLS (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
465SMTPS (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
2525Alternatieve STARTTLSCloudvriendelijk: Ideaal voor hosting op AWS, Azure of Google Cloud waar uitgaande poort 25 geblokkeerd of beperkt is.SendGrid, Mailgun, SparkPost
25Platte tekst / opportunistische TLSAfgeraden 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. 1
    Loopback-adressen: 127.0.0.1, localhost, ::1.
  2. 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)

  1. 3
    AWS Instance Metadata Service (IMDS): 169.254.169.254 en alle 169.254.0.0/16 link-local-bereiken.
  2. 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": true met 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. 1
    Ga naar Instellingen -> Berichten -> Eigen SMTP (/settings/workspace/messaging/smtp).
  2. 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).

  1. 3
    Klik op Test-e-mail verzenden (POST /settings/smtp-config/test).
  2. 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.
  3. 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

MethodeEndpointpadAuth-bereikBeschrijving
GET/api/v1/settings/smtp-configAPI-sleutel (settings)Haalt de huidige SMTP-configuratie van de werkruimte op (wachtwoord gemaskeerd).
PUT/api/v1/settings/smtp-configAPI-sleutel (settings)Werkt SMTP-verbindingsparameters bij en versleutelt het wachtwoord in de beveiligde opslag.
POST/api/v1/settings/smtp-config/testAPI-sleutel (settings)Voert een live socketverbindingstest uit en verstuurt een verificatie-e-mail.
DELETE/api/v1/settings/smtp-configAPI-sleutel (settings)Verwijdert de eigen SMTP-configuratie en schakelt de werkruimte terug naar beheerde e-mailbezorging.

Voorbeeld: SMTP-configuratie testen vóór opslaan

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"
}

Respons (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": []
  }
}

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:

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

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

Gerelateerde documentatie

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.