Unbegrenzt Testkonten auf einer Catch-all-Domain

Warum ein Mail-Provider die falsche Form für QA ist

Jede Art, einer Testsuite E-Mail-Adressen zu geben, wurde schon versucht, und jede leckt an einer anderen Stelle:

Die vierte Zeile ist diese Anleitung. Es ist derselbe Mechanismus, auf dem die öffentlichen Wegwerf-Domains laufen — ein Server, der jede Adresse auf einer Domain akzeptiert statt einer Liste von Postfächern —, angewendet auf einen Namen, den außer Ihnen niemand verwendet.

Der eine DNS-Eintrag

Fügen Sie bei Ihrem DNS-Provider einen einzelnen MX-Eintrag am Apex einer Domain hinzu, die Ihnen gehört. Kein weiterer Eintrag hier, kein TXT zum Nachweis von irgendetwas, kein Konto auf dieser Website:

MX-Eintrag für die Domain10 smtp.grabmail.ioKopieren

1. Veröffentlichen Sie den MX. Priorität 10, zeigend auf smtp.grabmail.io. Löschen Sie jeden anderen MX auf der Domain — Mail kann nur an einen Ort zugestellt werden, und ein übrig gebliebener Eintrag schickt einen Teil davon woandershin.
2. Warten Sie auf DNS. Meist Minuten; gelegentlich die TTL des Eintrags, der vorher da war. dig MX qa-example.com zeigt, wann es übernommen wurde.
3. Schicken Sie eine Nachricht an eine beliebige Adresse darauf. Die erste Zustellung ist es, was die Domain verbindet: Der Server schlägt in diesem Moment den MX nach, sieht sich selbst, und nimmt an. Von da an ist jede Adresse auf der Domain ein Postfach.

Ein Namensschema, das sagt, wer das Postfach angelegt hat

Da jede Adresse gültig ist, kann der lokale Teil frei Informationen tragen — und um zwei Uhr morgens, mit einem fehlgeschlagenen Lauf und einem offenen Postfach, werden Sie das auch wollen. Drei Teile, durch Bindestriche verbunden, in dieser Reihenfolge:

// one helper, every runner: who made it, which run, and eight random characters
export const testAddress = (who: string, run = process.env.GITHUB_RUN_ID ?? 'local') =>
  `${who}-${run}-${crypto.randomUUID().slice(0, 8)}@qa-example.com`;

testAddress('signup');        // signup-1234567890-3f9a1c2e@qa-example.com

Jede Adresse lesen, dieselben drei Aufrufe

An der API ändert sich für die eigene Domain nichts. Derselbe Listing-Aufruf, derselbe Nachrichten-Aufruf, dasselbe Löschen — kein Schlüssel in der öffentlichen Stufe, und die Domain in der Adresse ist das Einzige, was sich unterscheidet:

$ curl -sG https://grabmail.io/api/v1/mailbox --data-urlencode "address=signup-1234567890-3f9a1c2e@qa-example.com"

Das heißt, jeder Helfer auf dieser Website funktioniert unverändert, nachdem eine Konstante bearbeitet wurde: die Playwright-Fixture, der Cypress-Task, die Python- und Node-Module. Drei Dinge sind es wert, gewusst zu werden, über die die öffentlichen Domains einen nicht nachdenken lassen:

Ein 404 bedeutet, dass der MX noch nicht da ist

Die Auflistung antwortet mit 404 für eine Domain, die hier nicht gehostet wird. Bei der eigenen Domain ist das ein DNS-Problem — der Eintrag hat sich noch nicht verbreitet, oder zeigt woandershin — kein API-Problem. Zuerst dig MX.

Der Alias funktioniert auch auf Ihrer Domain

Jedes Postfach, auf jeder Domain, hat eine zweite Adresse auf einer separaten Domain, die dorthin zustellt und es nicht lesen kann. Geben Sie diese einer Website, wenn sie das Postfach lieber nicht öffnen können soll; pollen Sie Ihre eigene Adresse.

Eine ausgelastete Adresse wird paginiert

Eine Catch-all-Adresse, die Bounces oder einen Tag voller Benachrichtigungen sammelt, kann mehr als eine Seite von 200 enthalten. Übergeben Sie next als before zurück, bis es null ist.

Eine Testdomain nutzbar halten

Eine eigene Domain steht auf keiner Sperrliste für Wegwerf-Mail, und das ist oft überhaupt der Grund, eine zu verwenden: Die getestete Anwendung lehnt grabmail.io und jede andere öffentliche Domain ab, genau wie sie es soll. Vier Gewohnheiten halten das so:

• Verwenden Sie eine dedizierte Domain — qa-example.com, keine Subdomain der Produktion und nicht die Domain, an die Kunden schreiben. Der Dienst akzeptiert nur registrierbare Domains (example.com, nie mail.example.com), und eine Testdomain sollte keine andere Aufgabe haben.
• Veröffentlichen Sie sie nicht. Die Listen entstehen aus dem, was auf öffentlichen Temp-Mail-Websites und in geteilten Adress-Dumps auftaucht. Eine Domain, die nur je in Ihrer eigenen Testsuite auftaucht, hat keinen Weg auf sie.
• Sichern Sie sie mit SPF und DMARC. Eine Domain, die nur empfängt, ohne SPF, ist eine Domain, von der aus jeder Mail fälschen kann; zwei Einträge schließen das, und kosten nichts.
• Richten Sie keine echte Mail darauf aus. In dem Moment, in dem ein Staging-System Kundenbenachrichtigungen an eine Catch-all-Adresse schickt, hält ein öffentliches Postfach Kundendaten. Testdomains tragen Testmail.

Wenn die Anwendung jede Catch-all-Domain ablehnt — manche Betrugsprüfungen tun das, indem sie testen, ob eine zufällige Adresse auf der Domain akzeptiert wird —, gibt es einen kostenpflichtigen Pool aus gewöhnlich aussehenden .com-Domains, die von den Listen ferngehalten werden, beschrieben auf der Preisseite. Warum Anmeldeformulare Wegwerf-E-Mail blockieren erklärt, was jede Art von Prüfung sieht.

Für ein Team: eine Domain, viele Tester, viele Pipelines

Eine Catch-all-Domain bedient alle, weil der lokale Teil das Einzige ist, das sich unterscheiden muss, und der ist kostenlos. Was ein Team braucht, ist Einigkeit über das Namensschema oben und drei kleine Konventionen:

Ein Präfix pro Pipeline und pro Person

e2e-, nightly-, alice-. Ein Job-Log nach dem Präfix zu durchsuchen findet jedes Postfach, das er angelegt hat; nach dem eines Kollegen zu suchen findet den Bug, den er sich gerade ansieht.

Nichts wird je geteilt

Es gibt kein „Team-Postfach“ auf der Domain und keine Fixture, die eine feste Adresse ausgibt. Wenn zwei Personen dasselbe Postfach brauchen, schickt eine von ihnen der anderen die Adresse.

Die Ratenlimits gelten pro Client

Ein Lesevorgang pro Sekunde und Adresse, 1200 Anfragen pro Minute und Client — ein CI-Runner ist ein Client, ein Laptop ein anderer. Ein Team von zehn, das gleichzeitig Suiten laufen lässt, sind zehn Clients, nicht einer.

Die geltenden Grenzen

Die eigene Domain bekommt denselben Dienst wie die öffentlichen, mit denselben Obergrenzen. Keine davon ist einstellbar, und keine ist ein Problem für eine Testsuite:

Bevor Sie es für fertig erklären

• Eine dedizierte, registrierbare Domain, mit einem MX-Eintrag: 10 smtp.grabmail.io, und keinem weiteren MX.
• Eine Nachricht an eine beliebige Adresse darauf geschickt und über die API zurückgelesen.
• SPF und DMARC veröffentlicht, sodass niemand als die Domain versenden kann.
• Ein Namens-Helfer — wer, welcher Lauf, acht zufällige Zeichen — von jeder Suite verwendet.
• Die Domain in der Umgebungskonfiguration gehalten, nie im Code, in Screenshots oder Tickets.
• Nichts, was echte Kunden-Mail verschickt, darauf ausgerichtet.

Von hier aus sind die Suiten die bereits geschriebenen: Playwright mit der Domain in seiner Fixture, die runner-unabhängige Disziplin, und der GitHub-Actions-Workflow mit der Domain in einer Variable.

Fragen