// 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.txteine 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 -X POST https://fixweb.app/api/v1/scans \
-H "Authorization: Bearer fxw_..." \
-H "content-type: application/json" \
-d '{"target":"https://example.com"}'