FixWeb

// docs / domains

Domains

A domain is a verified hostname you own. Verifying once unlocks owner-depth scans, scheduled re-scans, and live website monitoring on that hostname.

Domain verifizieren

FĂŒge unter Dashboard → Domains einen Hostname hinzu. WĂ€hle eine von zwei Verifizierungsmethoden:

  • DNS TXT — fĂŒge unter _fixweb.<hostname> einen Record mit dem von uns generierten Token hinzu. Wir lösen ihn von unserem Server aus erneut auf, nicht von deinem, damit SPF / DMARC-Einstellungen nicht stören. Typische Propagation: 1-5 Minuten; wir prĂŒfen 10 Minuten lang alle 30 Sekunden erneut.
  • HTTP-Datei — hoste unter /.well-known/fixweb-verification.txt eine kleine Textdatei mit dem Token. Wir rufen sie ĂŒber HTTPS ĂŒber den SSRF-geschĂŒtzten Request-Pfad ab.

Verifizierungen werden tĂ€glich vom domain-reverify-Cron erneut geprĂŒft. Wenn eine zuvor verifizierte Domain den Token nicht mehr auflöst (z. B. weil du den DNS-Record entfernt hast), wird die Verifizierung widerrufen und aktive Scans dagegen fallen auf verify_required zurĂŒck, bis du ihn wieder hinzufĂŒgst.

Geplante Neu-Scans Pro+

Der Pro-Plan kann eine verifizierte Domain mit einer Kadenz von ≄3h erneut scannen; der Unlimited-Plan mit ≄1h. Öffne Dashboard → Domains → Zeitplan, aktiviere den Schalter und wĂ€hle eine Kadenz:

  • 1 Stunde — nur im Unlimited-Plan verfĂŒgbar
  • 3h, 6h, 12h, tĂ€glich, alle 2 Tage, wöchentlich

Bei jedem Cron-Tick (alle 15 min) nimmt der Scheduler fĂ€llige ZeitplĂ€ne auf, claimt sie ĂŒber ein optimistisches compare-and-swap auf next_run_at (damit zwei Crons nicht doppelt einreihen), erhöht deinen Scan-Usage-ZĂ€hler und reiht einen frischen passiven Scan ein. Der Scan ĂŒbernimmt deine Domain-Verifizierungs-Attestation. Du musst also nicht pro Lauf neu bestĂ€tigen; deaktiviere den Zeitplan, um sie zu widerrufen.

Nach Abschluss wird die Scan-abgeschlossen-E-Mail ĂŒber die Einstellung scheduled_scan_email verschickt (verwaltbar unter Konto → Einstellungen).

Live-Bedrohungserkennung Unlimited+

Der Unlimited-Plan ĂŒberwacht automatisch jede verifizierte Domain auf drei Signale zwischen geplanten Scans:

  • Certificate transparency — alle 30 Minuten fragen wir crt.sh nach neuen Zertifikaten ab, die deinen Hostname oder eine Subdomain enthalten. Neue Zertifikate lösen einen new_certificate-Alert aus.
  • DNS diff — alle 30 Minuten lösen wir A, AAAA, MX, TXT, NS, CNAME auf und vergleichen mit dem letzten Snapshot. Änderungen lösen einen dns_change-Alert aus.
  • Threat-intel — jede Stunde prĂŒfen wir Spamhaus DBL und URLhaus auf Listings des Apex-Hostnamens. Listings lösen einen threat_intel_listing-Alert aus.

Alerts deduplizieren ĂŒber eine Content-Hash-Signatur, damit dieselbe erneut erkannte Änderung nicht erneut feuert. Du kannst Alerts unter Dashboard → Domains → [domain] → Monitor ansehen / verwerfen. E-Mail-Benachrichtigungen folgen der Einstellung threat_alert_email.

Snapshot-Aufbewahrung

Monitor-Snapshots werden nach 7 Tagen automatisch bereinigt, außer der jeweils neuesten Baseline pro (domain, signal-type)-Paar. Diese bleibt unabhĂ€ngig vom Alter, damit der nĂ€chste Diff korrekt ist. Verworfene Alerts werden nach 90 Tagen gelöscht.

Aus API oder MCP auslösen

Domain-Verwaltung ist derzeit nur ĂŒber die UI möglich: keine API-OberflĂ€che fĂŒr Verifizierung oder ZeitplanĂ€nderungen. Um per API einen Scan gegen eine bereits verifizierte Domain zu starten, verwende POST /api/v1/scans:

curl
curl -X POST https://fixweb.app/api/v1/scans \
  -H "Authorization: Bearer fxw_..." \
  -H "content-type: application/json" \
  -d '{"target":"https://example.com"}'
Domains — Docs · FixWeb