Fehlerbehebung für White Label-DNS

Die meisten DNS-Probleme bei White Label Lite haben eine von vier Ursachen: Der Eintrag fehlt, sein Wert weicht von der Branding-Tabelle ab, ein Proxy ist aktiviert oder der Zertifikatschritt benötigt Aufmerksamkeit.

Beginnen Sie mit der Tabelle DNS for your brand auf der Registerkarte Branding der Domain. Sie ist die maßgebliche Quelle für Ihren Hostnamen und das Ziel. Kopieren Sie kein CNAME-Ziel aus einem älteren Artikel, einem anderen Konto oder einem DNS-Prüftool.

Schneller Weg

1. Öffnen Sie Branding und kopieren Sie Host, Typ und Wert der betroffenen Adresse.
2. Erstellen oder korrigieren Sie diesen Eintrag bei dem DNS-Anbieter, der die aktive DNS-Zone hostet.
3. Belassen Sie den Eintrag im reinen DNS-Modus, wenn der Anbieter eine Proxyoption bietet.
4. Kehren Sie zu Branding zurück und wählen Sie Verify DNS. Geben Sie die Adresse erst weiter, wenn ihr Status Active lautet.

DNS ohne Terminal prüfen

Vergleichen Sie vor jeder weiteren Fehlersuche den Eintrag bei Ihrem DNS-Anbieter mit der Zeile in Branding:

• Host oder Name
• Type, bei einem Markenhost für Dashboard oder Webmail CNAME
• Value oder Target
• Die Proxyeinstellung, die bei einem über Cloudflare verwalteten Markenhost deaktiviert sein muss

Verwenden Sie nach dem Speichern des Eintrags die Aktion Verify DNS in Branding. Damit wird eine neue Prüfung in die Warteschlange gestellt und die Seite zeigt den resultierenden Status an.

Für eine unabhängige Prüfung können Sie einen öffentlichen DNS-Abfragedienst verwenden oder Ihren DNS-Anbieter bitten, den vollständigen Hostnamen als CNAME abzufragen. Die Antwort muss exakt mit dem aktuellen Value-Feld in Branding übereinstimmen. Ein öffentliches Prüftool kann seine Sicht bestätigen, aber den Plattformstatus Active nicht ersetzen.

Sie benötigen kein Terminal, um diese Einrichtung abzuschließen. Falls Sie eines verwenden, fragen Sie den vollständigen Hostnamen ab und vergleichen Sie den zurückgegebenen CNAME mit dem in Branding angezeigten Wert.

Status lautet „Pending DNS“

Pending DNS bedeutet, dass die Plattform den erwarteten Eintrag für diesen Host noch nicht gefunden hat. Wählen Sie nach der Korrektur eines Eintrags Verify DNS und kehren Sie nach der Statusaktualisierung zur Registerkarte Branding zurück. Führen Sie diese Prüfungen der Reihe nach durch:

Sie haben den falschen DNS-Anbieter bearbeitet. Prüfen Sie, welcher Anbieter für das DNS Ihrer Domain autoritativ ist. Möglicherweise bearbeiten Sie das Bedienfeld des Registrars, während die aktive DNS-Zone an anderer Stelle gehostet wird.

Das CNAME-Ziel ist nicht aktuell. Kopieren Sie Value oder Target aus der Branding-Tabelle. Entfernen Sie einen alten, widersprüchlichen Eintrag für denselben Hostnamen erst, nachdem Sie sichergestellt haben, dass kein anderer Dienst ihn nutzt.

Der Eintragstyp ist falsch. Ein Dashboard- oder Webmailhost benötigt den in Branding angezeigten CNAME-Eintrag. Ein A- oder AAAA-Eintrag unter demselben Hostnamen kann das erwartete Ergebnis verhindern.

Der Hostname wurde in der falschen Form eingegeben. Manche Anbieter erwarten nur das Präfix, beispielsweise dashboard, andere den vollständigen Hostnamen. Beachten Sie den Feldhinweis des Anbieters und vergleichen Sie den resultierenden Eintrag mit dem in Branding angezeigten Host.

Wenn der Eintrag übereinstimmt, lassen Sie ihn bestehen und verwenden Sie erneut Verify DNS. Wiederholtes Ändern eines korrekten Eintrags kann die Zeit verlängern, bis alle DNS-Resolver dieselbe Antwort sehen.

Die orange Cloudflare-Wolke verhindert die SSL-Bereitstellung

Wenn Sie Cloudflare als DNS-Anbieter verwenden, sehen Sie neben jedem Eintrag ein Wolkensymbol. Eine orange Wolke bedeutet, dass Cloudflare die Anfrage über einen Proxy leitet. Ein CNAME für ein Marken-Dashboard oder -Webmail muss sich im reinen DNS-Modus befinden, damit die Plattform ihn prüfen und das Zertifikat ausstellen kann.

Korrektur: Wählen Sie die Wolke neben dem CNAME des betroffenen Markenhosts aus, bis sie grau ist, und speichern Sie den Eintrag. Kehren Sie zu Branding zurück und wählen Sie Verify DNS.

Dies gilt für den Eintrag des Markenhosts, nicht automatisch für jeden anderen Eintrag der Domain. Wenn ein anderer Anbieter eine Proxy- oder CDN-Option besitzt, deaktivieren Sie diese für den CNAME, sofern die Branding-Tabelle keine anderen Anweisungen enthält.

Status lautet „SSL could not be issued“ und erwähnt CAA

Ein CAA-Eintrag legt fest, welche Zertifikatanbieter ein Zertifikat für Ihre Domain ausstellen dürfen. Ändern Sie ihn nur, wenn der Branding-Status oder der Support CAA ausdrücklich als Ursache angibt.

Lassen Sie den CNAME unverändert und prüfen Sie, ob die Domain bereits einen CAA-Eintrag besitzt. Ihr DNS-Anbieter kann ihn anzeigen, oder eine unabhängige DNS-Abfrage kann die Stammdomain prüfen.

Wenn der Eintrag den Zertifikataussteller der Plattform zulassen muss, fügen Sie den exakten CAA-Wert hinzu, den der Support bereitstellt oder der in den aktuellen Produkthinweisen angegeben ist. Löschen Sie keine unbeteiligten CAA-Einträge, nur um diesen Schritt abzuschließen. Mehrere CAA-Einträge können nebeneinander bestehen.

Für den aktuellen Zertifikatsablauf lautet der erforderliche Wert normalerweise:

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

Wenn Sie keine CAA-Einträge besitzen, fügen Sie nicht vorsorglich einen hinzu. Kehren Sie nach einer CAA-Änderung zu Branding zurück und wählen Sie Verify DNS.

Status lautet ohne Begründung „SSL could not be issued“

Der CNAME ist möglicherweise bereits korrekt. Löschen und erstellen Sie ihn nicht wiederholt neu. Gehen Sie stattdessen so vor:

1. Prüfen Sie, dass der Eintrag weiterhin mit Host und Ziel in Branding übereinstimmt und nicht über einen Proxy läuft.
2. Wählen Sie einmal Verify DNS.
3. Falls der Status unverändert bleibt, kontaktieren Sie den Support mit dem Hostnamen, dem angezeigten Status und einem Screenshot des DNS-Eintrags.

Zertifikatsarbeit lässt sich nicht durch Bearbeiten eines bereits korrekten CNAME lösen. Das Supportteam kann das Ergebnis auf der Plattform prüfen, ohne Sie um Zugangsdaten für Ihren DNS-Anbieter zu bitten.

Domain war aktiv, der Status hat sich geändert

Sobald ein Host Active ist, ist er betriebsbereit. Falls sich sein Status später ändert:

• Zurück zu „Pending DNS“: Vergleichen Sie den aktuellen CNAME mit der Branding-Tabelle. Der Eintrag wurde möglicherweise geändert, entfernt oder hinter einen Proxy gelegt.
• „SSL could not be issued“: Lassen Sie einen übereinstimmenden CNAME bestehen, wählen Sie Verify DNS und kontaktieren Sie den Support, falls der Status anhält.
• Off: Prüfen Sie, ob Branding für diese Domain ausgeschaltet wurde oder das White Label-Abonnement inaktiv ist. Wenn beides nicht zutrifft, kontaktieren Sie den Support.

Häufige Situationen

„Ich habe meinen CNAME geändert, aber der Status ist weiterhin ausstehend.“ Vergewissern Sie sich, dass Sie den autoritativen DNS-Anbieter bearbeitet haben und der neue CNAME exakt mit Branding übereinstimmt. Verwenden Sie dann Verify DNS. Wechseln Sie nicht zwischen Werten hin und her, während die Prüfung läuft.

„Ich habe den alten CNAME beim bisherigen Anbieter gelöscht, aber der neue wird nicht gefunden.“ Wenn Sie den DNS-Anbieter gewechselt haben, stellen Sie sicher, dass der Registrar die Domain an die Nameserver des neuen Anbieters delegiert. Bitten Sie andernfalls den Anbieter der autoritativen DNS-Zone, den Eintrag zu bestätigen.

„Meine Hauptwebsite verwendet einen Proxy. Darf der Markenhost ihn ebenfalls nutzen?“ Belassen Sie den Marken-CNAME im reinen DNS-Modus. Der Rest der Domain kann eigene Proxyeinstellungen verwenden, solange der in Branding angegebene Host nicht über den Proxy läuft.

„Kann ich einen Wildcard-CNAME verwenden?“ Konfigurieren Sie den konkreten Hostnamen aus Branding. Damit erhält die Plattform eine eindeutige Adresse zur Prüfung und zum Testen. Ersetzen Sie den in der Tabelle angegebenen Host nicht durch einen Wildcard-Eintrag.

„Ich möchte eine andere Subdomain verwenden.“ Ändern Sie die Bezeichnung auf der Registerkarte Branding der Domain und speichern Sie jeweils einen Host. Kopieren Sie den neuen CNAME aus der Tabelle, testen Sie den neuen Host erst nach Erreichen des Status Active und lassen Sie die alte Kundenadresse bis zum Abschluss des Wechsels verfügbar.

„Ein Netzwerk kann den neuen Eintrag nicht sehen.“ Testen Sie über ein anderes Netzwerk oder bitten Sie den betroffenen Kunden, es später erneut zu versuchen. Wenn die Branding-Tabelle Active meldet und der Host an anderer Stelle funktioniert, liegt die verbleibende Verzögerung wahrscheinlich im DNS-Cache dieses Netzwerks.

Nächste Schritte

• White Label Lite einrichten: die ursprünglichen Einrichtungsschritte, falls Sie noch nicht fertig sind.
• White Label Lite: häufige Fragen zu Preisen: Fragen zur Abrechnung.
• White Label Lite kündigen: was bei einer Kündigung mit Ihrer Domain geschieht.
• Empfohlene DNS-Einträge: ein umfassender Überblick über die von TrekMail verwendeten DNS-Einträge.

Wenn das Problem weiterhin besteht, öffnen Sie ein Supportticket und geben Sie Hostnamen, exakten Status aus Branding und DNS-Anbieter an. Fügen Sie einen Screenshot des Eintrags bei. Senden Sie keine Passwörter oder API-Token Ihres DNS-Anbieters.