Back to app
Docs
Documentation
BenutzerhandbuchDomain verifizierenWas ist CNAME-Delegation?

Domain verifizieren

Schritt-für-Schritt-Anleitung zum Hinzufügen einer Domain und zur Durchführung der Verifizierung.

Überblick

Bevor QuietLS SSL-Zertifikate für Ihre Domain verwalten kann, müssen Sie nachweisen, dass Sie deren Inhaber sind. Die Domain-Verifizierung ist ein einmaliger Vorgang: Sie erstellen einen speziellen DNS-Eintrag (einen CNAME), der auf QuietLS verweist, und QuietLS prüft, ob dieser Eintrag vorhanden ist. Sobald die Verifizierung erfolgreich ist, ändert sich der Status Ihrer Domain auf Aktiv und Sie können loslegen.

Eine ausführlichere Erklärung des zugrundeliegenden Mechanismus finden Sie unter Was ist CNAME-Delegation?.

Voraussetzungen

  • Ein Domainname, über den Sie verfügen (z. B. example.com).
  • Zugriff auf die DNS-Einstellungen Ihrer Domain — in der Regel über Ihren Domain-Registrar oder DNS-Anbieter (Cloudflare, Route 53, Namecheap, GoDaddy usw.).

Schritt 1: Domain hinzufügen

  1. Melden Sie sich im QuietLS-Dashboard an.
  2. Navigieren Sie zu Domains und klicken Sie auf Domain hinzufügen.
  3. Geben Sie Ihren Domainnamen ein (z. B. example.com oder *.example.com für eine Wildcard-Domain).
  4. Klicken Sie auf Hinzufügen.

Ihre Domain erscheint in der Liste mit dem Status Verifizierung ausstehend.

Schritt 2: CNAME-Eintrag kopieren

Nach dem Hinzufügen der Domain generiert QuietLS einen eindeutigen Verifizierungseintrag für Sie. Öffnen Sie den Verifizierungsdialog (klicken Sie auf Verifizieren neben Ihrer Domain) und Sie sehen zwei Werte:

TypNameWert
CNAME_pki-validation.example.com<token>.verification.quietls.com
  • Name — immer _pki-validation. gefolgt von Ihrer Domain.
  • Wert — ein eindeutiges Token, das speziell für Ihr Konto und diese Domain generiert wurde.
Nutzen Sie die Kopier-Buttons im Dashboard, um Tippfehler zu vermeiden.

Schritt 3: CNAME beim DNS-Anbieter erstellen

Melden Sie sich bei Ihrem DNS-Anbieter an und erstellen Sie einen neuen CNAME-Eintrag mit Name und Wert aus Schritt 2.

Allgemeine Anleitung

  1. Navigieren Sie zur DNS-Verwaltungsseite.
  2. Fügen Sie einen neuen Eintrag vom Typ CNAME hinzu.
  3. Tragen Sie im Feld Name (oder Host) den Wert _pki-validation ein (einige Anbieter hängen Ihre Domain automatisch an; andere erfordern den vollständigen Namen _pki-validation.example.com).
  4. Fügen Sie im Feld Wert (oder Verweist auf / Ziel) den Token-Wert ein, z. B. a1b2c3d4e5f6...verification.quietls.com.
  5. Speichern Sie den Eintrag.

Für Cloudflare-Nutzer

Wenn Sie Cloudflare nutzen, stellen Sie sicher, dass der Proxy-Schalter auf Nur DNS (graues Wolken-Symbol) eingestellt ist. Proxied-Einträge (orangefarbene Wolke) werden nicht korrekt aufgelöst, und die Verifizierung schlägt fehl.

Schritt 4: Verifizieren

Sie haben zwei Möglichkeiten:

Sofort verifizieren: Klicken Sie auf die Schaltfläche Jetzt verifizieren im Dashboard. QuietLS führt sofort eine DNS-Abfrage durch und zeigt Ihnen das Ergebnis an.

Auf automatische Verifizierung warten: QuietLS prüft automatisch im Hintergrund nach Ihrem CNAME-Eintrag — einmal pro Stunde, bis zu 5 Stunden nach dem Hinzufügen der Domain. Wird der Eintrag bei einer dieser Prüfungen gefunden, wird Ihre Domain automatisch verifiziert.

Was passiert nach der Verifizierung

Sobald der CNAME-Eintrag erkannt wird und mit dem erwarteten Wert übereinstimmt:

  • Der Status Ihrer Domain ändert sich von Verifizierung ausstehend zu Aktiv.
  • Ein Verifiziert am-Zeitstempel wird gespeichert.
  • Die Domain ist nun bereit für die Verwaltung von SSL-Zertifikaten.

Wenn Sie eine Wildcard-Domain hinzugefügt haben (z. B. *.example.com), werden alle zuvor hinzugefügten Subdomains (wie api.example.com, cdn.example.com) automatisch als untergeordnete Domains der Wildcard zugeordnet.

Fehlerbehebung

„CNAME-Eintrag nicht gefunden"

Mögliche UrsacheWas Sie tun können
DNS-PropagierungsverzögerungDNS-Änderungen können bis zu 24–48 Stunden dauern, bis sie global propagiert sind, obwohl die meisten Anbieter innerhalb von Minuten aktualisieren. Warten Sie und versuchen Sie es erneut, oder lassen Sie die automatische Verifizierung den Eintrag finden.
Falscher EintragsnameÜberprüfen Sie, dass der Name genau _pki-validation.example.com lautet. Einige Anbieter erfordern nur _pki-validation (sie ergänzen die Domain automatisch).
Falscher EintragswertKopieren Sie den Wert direkt aus dem Dashboard über den Kopier-Button. Beim Token wird die Groß-/Kleinschreibung nicht berücksichtigt, aber der vollständige Wert muss exakt übereinstimmen.
Cloudflare-Proxy aktiviertWenn Sie Cloudflare nutzen, schalten Sie den CNAME auf Nur DNS um (graue Wolke). Proxied-Einträge sind bei CNAME-Abfragen nicht sichtbar.
Falscher EintragstypStellen Sie sicher, dass Sie einen CNAME-Eintrag erstellt haben, keinen TXT-, A- oder AAAA-Eintrag.

Verifizierung erfolgreich, aber Status hat sich nicht geändert

Dies bedeutet in der Regel, dass das Dashboard noch nicht aktualisiert wurde. Laden Sie die Seite neu oder navigieren Sie weg und zurück zur Domain-Liste.

Wildcard-Domain übernimmt keine Subdomains

Subdomains werden nur dann automatisch zugeordnet, wenn die Wildcard-Domain zum ersten Mal erstellt wird. Wenn Sie Subdomains nach der Wildcard hinzufügen, werden sie nicht automatisch verknüpft. Durch erneutes Hinzufügen werden sie der Wildcard-Überdomain zugeordnet.