Dokumentation

Alles, was Sie für den Einstieg in parseal benötigen.

Schnellstart

In 3 Schritten ist parseal einsatzbereit:

  1. 1
    Konto erstellen & Organisation anlegen

    Nach der Registrierung werden Sie durch die Org-Erstellung geführt. Sie erhalten automatisch zwei E-Mail-Adressen (rua + ruf).

  2. 2
    DNS-Eintrag setzen

    Fügen Sie für jede Domain, die Sie überwachen möchten, einen TXT-Eintrag hinzu:

    _dmarc.ihredomain.de. IN TXT "v=DMARC1; p=none;
      rua=mailto:dmarc-xxxxx-rua@app.parseal.ai;
      ruf=mailto:dmarc-xxxxx-ruf@app.parseal.ai;
      fo=1"
  3. 3
    Reports beobachten

    Innerhalb von 24–48 Stunden erscheinen die ersten Reports im Dashboard. KI-Agenten analysieren automatisch.

Self-Hosting

parseal ist vollständig MIT-lizenziert. Docker Compose startet alle Services:

git clone https://github.com/parseal/parseal
cd parseal
cp .env.example .env   # Secrets befüllen
docker compose up -d

Services: Next.js (3000), SMTP-Receiver (25/587), Python-Parser (8001), BullMQ-Worker, PostgreSQL, Redis.

DNS-Konfiguration

Jede Organisation erhält zwei einzigartige E-Mail-Adressen:

  • rua: Aggregate Reports (täglich/wöchentlich)
  • ruf: Forensic Reports (bei Fehlern, optional)

Diese Adressen werden im Dashboard unter E-Mail-Setup angezeigt. Der DNS-Eintrag muss auf _dmarc.ihredomain.de gesetzt werden.

KI-Agenten

DmarcAnalysisAgent

Wird nach jedem eingehenden Report ausgelöst. Analysiert Bestehensquoten, identifiziert unbekannte Absender und gibt einen Risk-Score aus.

AlertRulesAgent

On-Demand-Agent. Analysiert historische Report-Daten und schlägt optimierte Alert-Regeln vor.

ReportSummaryAgent

Läuft jeden Montag um 08:00 UTC. Erstellt einen strukturierten Digest der letzten 7 Tage und versendet ihn per E-Mail.

API-Referenz

parseal bietet eine REST-API. API-Schlüssel werden unter Einstellungen → API-Schlüssel generiert.

GET/api/orgs
POST/api/orgs
GET/api/orgs/[slug]/domains
POST/api/orgs/[slug]/domains
POST/api/orgs/[slug]/domains/[id]/verify
GET/api/orgs/[slug]/reports
POST/api/orgs/[slug]/upload