E-Mail-Tools

Vorschau

Verbundene Anwendungen sind derzeit nur für ausgewählte Konten freigeschaltet.

Fünfzehn Tools verwalten die Adressen auf deinen Domains: Postfächer, Weiterleitungen (das Portal nennt sie Aliase), Abwesenheitsnotizen, das Catch-All und die DNS-Einträge, die E-Mail braucht. Sie erscheinen, sobald dein Konto eine Domain hat. Wie das E-Mail-Hosting selbst funktioniert, steht unter Postfächer und Aliase.

Eine Weiterleitung kann deine E-Mails an jeden schicken

Mit mail:write kann eine Anwendung eine Adresse an jede beliebige Adresse der Welt weiterleiten, und ab dann geht jede Nachricht dorthin mit. Kein Tool liest ein Postfach, auf diesem Weg könnten E-Mail-Inhalte dein Konto also verlassen. Wird eine solche Weiterleitung eingerichtet, bekommst du eine E-Mail, siehe Weiterleitungen aus deinen Domains hinaus.

Die Tools

Tool	Was es tut	Braucht
mail_account_list	Listet Postfächer, Weiterleitungen, Mailinglisten und geteilte Postfächer, auf Wunsch einer Domain oder Art	mail:read, domain:read
mail_account_get	Zeigt eine Adresse	mail:read
mailbox_create	Legt ein Postfach an und gibt den Link zurück, unter dem du sein Passwort setzt	mail:write, domain:read
mailbox_password_link	Gibt den Link zurück, unter dem du das Passwort eines Postfachs setzt oder änderst	mail:read
mail_forward_create	Leitet eine Adresse an 1 bis 10 andere Adressen weiter	mail:write, domain:read
mail_account_update	Schaltet ein Postfach oder eine Weiterleitung ab oder an, oder ersetzt die Ziele einer Weiterleitung	mail:write
mail_account_delete	Löscht ein Postfach oder eine Weiterleitung	mail:read, mail:delete
mail_vacation_get	Zeigt die Abwesenheitsnotiz eines Postfachs, ihren Text nur auf Wunsch	mail:read
mail_vacation_set	Schaltet eine Abwesenheitsnotiz an oder ab und setzt Tage, Betreff und Text	mail:write
mail_catchall_get	Zeigt, welches Postfach E-Mails an Adressen bekommt, die es nicht gibt	mail:read, domain:read
mail_catchall_set	Richtet das Catch-All auf ein Postfach, anstelle eines bisherigen	mail:write, domain:read
mail_catchall_disable	Schaltet das Catch-All ab: E-Mails an unbekannte Adressen werden dann abgewiesen	mail:delete, mail:write, domain:read
mail_dns_status	Listet die DNS-Einträge, die E-Mail braucht, und ob jeder stimmt	mail:read, domain:read
mail_dns_apply	Schreibt die fehlenden Mail-Einträge	mail:write, dns:write, domain:read
mail_dns_replace	Ersetzt die Mail-Einträge eines anderen Anbieters durch die von ITSH	mail:write, dns:write, domain:read

Etwas anzulegen, das es in derselben Form schon gibt, ist kein Fehler: das Tool gibt es mit created false zurück, ein erneuter Versuch ist also sicher. Ein neues Postfach übernimmt seine Adresse vom Catch-All.

Passwörter: ein Link, kein Passwort

Kein Tool setzt ein Postfach-Passwort, gibt es heraus oder nimmt es an. mailbox_create und mailbox_password_link geben einen Link auf die Seite des Postfachs im Portal zurück, der dort, während du angemeldet bist, den Passwort-Dialog öffnet. Der Link enthält nur die Nummer des Postfachs, nichts Geheimes.

Ein Postfach, das eine Anwendung angelegt hat, ist erst nutzbar, wenn du über diesen Link sein Passwort gesetzt hast. Das ist so gewollt und keine fehlgeschlagene Einrichtung.

Weiterleitungen aus deinen Domains hinaus

mail_forward_create und mail_account_update können an Adressen außerhalb der Domains deines Kontos weiterleiten. Für jede Weiterleitung, die an eine solche Adresse zu senden beginnt, gilt:

• sobald die Weiterleitung eingerichtet ist, bekommst du eine E-Mail, die die weitergeleitete Adresse und die neuen Ziele außerhalb deiner Domains nennt
• das Aktivitätsprotokoll führt die Ziele unter Weiterleitung an Adressen außerhalb deiner Domains angefordert: auf
• lässt sich diese E-Mail nicht vorbereiten, wird die Weiterleitung gar nicht eingerichtet, und die Anwendung bekommt forward_notice_unavailable:

the account holder cannot be told about a forward outside the account's domains right now, so it was not set up; try again shortly

Hast du das nicht veranlasst, entferne die Weiterleitung im Portal unter E-Mail und trenne die Anwendung.

Löschen

Mit einem Postfach wird jede Nachricht darin gelöscht, und nichts holt sie zurück. Das Tool löscht ein Postfach deshalb nur, wenn confirm_email seine Adresse wiederholt:

Mail account 42 is the mailbox info@example.com: deleting it needs confirm_email set to that address.

Das schützt davor, dass die Anwendung die falsche ID löscht. Es schützt nicht vor einer Anwendung, der man gesagt hat, das Postfach zu löschen. Eine Weiterleitung wird ohne Bestätigung gelöscht, und das Aktivitätsprotokoll behält ihre Ziele.

Mail-DNS-Einträge

Tool	Schreibt	Lässt in Ruhe
mail_dns_status	Nichts	Alles
mail_dns_apply	Fehlende Einträge. Ein vorhandener SPF-Eintrag bekommt den Server von ITSH dazu, ein vorhandener DMARC-Eintrag dessen Berichtsadresse	Einträge, die kollidieren, etwa der MX eines anderen Anbieters
mail_dns_replace	Die Einträge von ITSH, nachdem es jeden Eintrag auf den Namen gelöscht hat, die E-Mail braucht, auch MX, SPF und DMARC eines anderen Anbieters	Nichts auf diesen Namen

Nach mail_dns_replace erreicht keine E-Mail mehr einen anderen Anbieter. Das Tool sagt der Anwendung, es nur zu nutzen, wenn du ausdrücklich verlangst, die E-Mail der Domain zu ITSH umzuziehen. Beide schreibenden Tools arbeiten mit Domains, die die ITSH-Nameserver nutzen.

Ein Lauf darf mit mail_dns_apply höchstens 10 und mit mail_dns_replace höchstens 20 Einträge ändern. Eine Zone, die mehr braucht, wird abgelehnt, bevor sich etwas ändert, mit einem Link auf die Domain-Seite im Portal, wo du E-Mail selbst einrichtest:

this zone needs more record changes than a connected application may make in one run; nothing was changed

Bis DNS-Änderungen überall sichtbar sind, kann es bis zu einer Stunde dauern.

Ablehnungen mit Link

Code	Ursache	Die Antwort
mail_not_entitled	Auf der Domain ist kein E-Mail-Hosting gebucht	Verlinkt die Domain-Seite, wo du es buchst
address_taken	Ein anderes Postfach, eine Weiterleitung oder Liste belegt die Adresse	Sagt der Anwendung, sie mit mail_account_list zu suchen
not_supported	Die Adresse ist eine Mailingliste oder ein geteiltes Postfach	„… which is changed in the ITSH control panel only.“
mail_dns_too_many_changes	Die Zone braucht mehr Änderungen, als ein Lauf machen darf	Verlinkt die Domain-Seite

Limits

Limit	Wert
Adresse	Lokaler Teil bis zu 64 Buchstaben, Ziffern und . _ % + -; die ganze Adresse bis zu 254 Zeichen
Weiterleitungsziele	1 bis 10 je Weiterleitung
Abwesenheitsnotiz	Betreff eine Zeile mit bis zu 255 Zeichen, Text bis zu 4.000; Tage als YYYY-MM-DD, das Ende nicht vor dem Anfang
Auflisten	Standardmäßig 50 Adressen je Aufruf, höchstens 200
Änderungen	60 pro Minute je Konto, geteilt mit deinen eigenen Änderungen im Portal
Mail-DNS	20 Prüfungen und 5 Schreibvorgänge pro Minute je Konto, geteilt mit deinen eigenen Prüfungen und Schreibvorgängen im Portal. Eine Prüfung kostet 2 Registrar-Aufrufe, ein Schreibvorgang verbraucht das ganze Registrar-Budget des Kontos für eine Minute
Zeit je Aufruf	10 Sekunden; 45 für die drei Mail-DNS-Tools

Wie es weitergeht

• Verbindungen verwalten für die E-Mails, die du bekommst
• Domain einrichten für die Mail-Einträge selbst