Hinatadocs

E-Mail zu Vorgang

Hinata kann ein Postfach überwachen und aus jeder ungelesenen E-Mail einen Vorgang machen. Du richtest eine Support- oder Eingangsadresse auf ein IMAP-Postfach aus. Jede neue Mail wird dann ein Vorgang im Projekt deiner Wahl:

  • Betreff wird Titel.
  • Text wird Beschreibung.
  • Absender wird als Melder gespeichert.

Als Ziel kannst du nur ein Projekt wählen, in dem du selbst Mitglied bist.

Das ist der eingehende Teil. Ausgehende Mails (Verifizierung, Passwort-Reset, Benachrichtigungen) erklärt E-Mail & SMTP.

Zur Laufzeit konfiguriert, kein Neustart

Du stellst den E-Mail-Eingang im Adminbereich ein. Die Einstellungen liegen in MongoDB. Einschalten, Postfach ändern oder Zielprojekt wechseln wirkt ohne Serverneustart, weil der Poller die Einstellungen in jedem Durchlauf neu liest.

So funktioniert es

Der Server fragt das Postfach regelmäßig ab. Ist der Eingang aktiviert und sind Host und Standardprojekt gesetzt, passiert in jedem Durchlauf Folgendes:

  1. Verbindung per IMAP oder IMAPS.
  2. Der gewählte Ordner wird nach ungelesenen Nachrichten durchsucht.
  3. Aus jeder Nachricht entsteht ein Vorgang.
  4. Die Nachricht wird als gelesen markiert und nie doppelt importiert.
geplanter Poll (respektiert dein Poll-Intervall)
        │
        ▼
aktiviert? Host + Standardprojekt gesetzt?  ── nein ──▶ nichts tun
        │ ja
        ▼
IMAP/IMAPS verbinden → Ordner öffnen (READ_WRITE)
        │
        ▼
UNSEEN-Nachrichten suchen
        │
        ▼
für jede: Vorgang im Standardprojekt erstellen, dann als SEEN markieren

Schlägt ein Durchlauf fehl (Postfach nicht erreichbar, falsche Zugangsdaten), wird der Fehler geloggt. Der nächste Durchlauf versucht es erneut. Es geht keine Mail verloren, weil ungelesene Nachrichten beim nächsten erfolgreichen Abruf importiert werden.

Was erstellt wird

Jede Nachricht wird ein Vorgang im gewählten Standardprojekt:

VorgangsfeldStammt aus
TitelDer Betreff der E-Mail (oder (no subject), falls leer), auf eine sichere Länge gekürzt
BeschreibungEin kurzer Kopf mit dem Absender, dann die Nachricht. Eine HTML-Mail behält ihr Layout: Spalten, Farben, Schriften, Abstände, Bilder und Buttons werden so nachgebaut, dass die Beschreibung aussieht wie die Mail, und bleiben bearbeitbar. Auf dem Handy rutschen Spalten untereinander, wie im Mail-Programm. Eine reine Textmail bleibt Text
TypTask
MelderDie E-Mail-Adresse des Absenders
AutorDer Absender, falls seine Adresse zu einem aktiven Hinata-Konto gehört. Dann bekommt er wie jeder Beobachter Benachrichtigungen zu jeder Änderung. Gehört die Adresse niemandem, bleibt der Vorgang ohne Autor. Der Kopf der Beschreibung nennt den Absender trotzdem
AnhängeDie Anhänge der E-Mail, sobald sie dieselbe Prüfung wie ein Upload bestanden haben. Den Typ liest der Server aus dem Inhalt, nicht aus dem Kopf der Mail. Einen abgelehnten Anhang speichert er nicht. Die Beschreibung bekommt dafür eine Zeile wie „Anhang rechnung.pdf abgelehnt: Dieser Dateityp ist hier nicht erlaubt“, das Protokoll des Servers den Grund

Externe Bilder

Lädt eine Mail Bilder von fremden Servern, etwa Logo und Banner eines Newsletters, hält Hinata sie zurück, wie ein Mail-Programm. Der Platz jedes Bildes bleibt frei, und über der Beschreibung steht:

Externe Bilder wurden blockiert, um deine Privatsphäre zu schützen. Einmal laden · Immer von vodafone.com laden

  • Einmal laden zeigt die Bilder, solange du den Vorgang offen hast.
  • Immer von … laden merkt sich die Domain des Absenders in deinem Konto. Mails von dort zeigen ihre Bilder danach sofort. Die Liste verwaltest du unter Vertrauenswürdige Absender.

Die Bilder lädt immer der Server und reicht sie an die App weiter. Der fremde Server erfährt also nie, wer den Vorgang liest, und jedes Bild wird vor dem Anzeigen geprüft. Mehr dazu unter Objektspeicher.

„Immer laden“ bietet Hinata nur an, wenn der Absender echt ist. Das prüft der Server selbst: Die Mail braucht eine gültige DKIM-Signatur, und die signierende Domain muss zur Domain im Absender passen. Den Schlüssel dazu holt der Server aus dem DNS des Absenders. So prüft auch DMARC. Eine Mail mit gefälschtem Absender besteht diese Prüfung nicht.

Fehlt die Signatur oder passt sie nicht, gibt es nur „Einmal laden“. Der Hinweis über den Bildern sagt dann, warum.

Die Signatur sagt nur, dass die Mail über den Absender verschickt wurde, nicht wer ihren Inhalt geschrieben hat. Vertraue einer Domain deshalb nur, wenn niemand sonst Inhalte in ihre Mails bringen kann, etwa über ein Kontaktformular oder einen Newsletter-Dienst, der fremde Texte weiterreicht. Eine signierte Mail kann außerdem jeder, der sie hat, unverändert noch einmal verschicken. „Immer laden“ vertraut also dem Inhalt der Domain, nicht dem Weg, auf dem die Mail ankam.

Mails über 10 MB prüft der Server nicht; dort gibt es ebenfalls nur „Einmal laden“.

Was der Absender dabei sieht

Um den Schlüssel zu holen, fragt der Server das DNS des Absenders. Dessen Nameserver sieht also ungefähr, wann Hinata die Mail verarbeitet hat. Wer sie liest, erfährt er nicht.

Zusätzlich kannst du in der Verbindung den Namen des Mailservers eintragen, siehe unten. Dann zählt auch das Prüfergebnis deines Mailservers. Nötig ist das nicht.

Nur mit einem Mailserver, der fremde Prüfkopfzeilen entfernt

Der Name schützt nur, wenn dein Mailserver eingehende Kopfzeilen Authentication-Results mit seinem eigenen Namen entfernt, bevor er selbst prüft. Sonst könnte ein Absender eine gefälschte Bestätigung mitschicken. Postfix mit OpenDMARC, Rspamd und Exchange Online tun das. Prüft dein Mailserver gar nicht, lass das Feld leer.

Mails, die die Textprüfung ablehnt

Enthält eine Mail etwas, das die automatische Textprüfung ablehnt, wird sie kein Vorgang. Der Server antwortet nicht, sonst ließe sich der Eingang nutzen, um Spam an fremde Adressen zu schicken. Den Inhalt speichert er nicht. Die Verbindung im Adminbereich zählt, wie viele Mails es waren und wann die letzte kam.

Ein Autor ohne Projektmitgliedschaft

Autor zu sein gibt keinen Zugriff. Nur wer Projektmitglied ist, kann den Vorgang öffnen. Ein Autor außerhalb des Projekts bekommt weiter E-Mail- und Push-Benachrichtigungen, aber ohne Link, denn der würde nur zum Fehler „kein Mitglied“ führen. Soll er den Vorgang verfolgen, nimm ihn ins Projekt auf.

Es ist ein normaler Vorgang. Er startet im Standardstatus des Workflows und erscheint auf Board und Backlog. Du kannst ihn zuweisen, labeln, verlinken und kommentieren. Ist das Projekt mit Git verbunden, sammelt er Entwicklungsinformationen, sobald jemand seinen Schlüssel erwähnt.

Wähle ein dediziertes Eingangsprojekt

Leite eingehende Mails in ein eigenes Projekt, zum Beispiel einen Support-Posteingang. Dort sichtet jemand jeden neuen Vorgang, weist ihn zu, setzt Typ und Priorität oder verschiebt ihn ins richtige Projekt. So landen keine ungefilterten Mails auf einem aktiven Board.

Konfiguration

Öffne Adminbereich → E-Mail-Eingang und trag die Postfachdaten ein:

EinstellungStandardBedeutung
AktiviertfalseHauptschalter für den Poller
Host(leer)Hostname des IMAP-Servers
Port993IMAP-Port
SSLtrueIMAPS verwenden (implizites TLS). Der Standardport dafür ist 993
Benutzername(leer)Postfach-Login
Passwort(leer)Postfach-Passwort. Nur schreibbar, die API gibt es nie zurück
OrdnerINBOXWelcher Ordner gescannt wird
Standardprojekt(leer)Das Projekt, in dem die Vorgänge landen
Poll-Intervall60 sMindestabstand zwischen zwei Abrufen in Sekunden
Name des Mailservers (authserv-id)(leer)Freiwillig. Der Name, den dein empfangender Mailserver in den Kopf Authentication-Results schreibt, etwa mx.example.org. Bestätigt dieser Kopf einen Absender, zählt das zusätzlich zur eigenen Prüfung des Servers. Den Namen findest du im Quelltext einer empfangenen Mail

Der Eingang tut nichts, solange nicht Aktiviert an ist und Host und Standardprojekt gesetzt sind. Eine halbfertige Konfiguration bleibt also wirkungslos.

Verwende ein dediziertes Postfach

Jede ungelesene Nachricht im Ordner wird importiert und als gelesen markiert. Nutze ein Postfach nur für diesen Zweck. In einem gemeinsamen Posteingang würden sonst normale ungelesene Mails zu Vorgängen und als gelesen markiert.

Vorgänge nach einem Update neu aufbauen

Neu verarbeiten bei einer Verbindung liest das Postfach noch einmal und baut die Beschreibung jedes Vorgangs neu auf, den noch niemand von Hand geändert hat. So bekommen ältere Mail-Vorgänge ihr Layout, und ihr Absender wird geprüft, damit es dort „Immer laden“ geben kann.

Wie es ausgehendes SMTP ergänzt

Beide Richtungen sind unabhängig und werden getrennt eingestellt:

  • Eingehend (diese Seite): IMAP-Abruf, eingestellt im Adminbereich (MongoDB). Macht aus empfangenen Mails Vorgänge.
  • Ausgehend (E-Mail & SMTP): das SMTP-Relay, über das Hinata Mails zu Verifizierung, Passwort-Reset und Benachrichtigungen sendet.

Du kannst jede Richtung allein nutzen. Eine reine Statusseite sendet vielleicht nur, eine Eingangsadresse empfängt vielleicht nur. Die meisten Produktivinstallationen nutzen beides: SMTP für die Mails an Nutzer und den Eingang für Supportanfragen.

Verwandte Seiten