Skip to Content

Benutzerdefinierte Domain

Die Anmeldung über Ihre eigene Domain statt über den Standard-Plattform-Host ausliefern.

RequirescustomDomain

Plan-Hinweis: Benutzerdefinierte Domains sind ab dem Essential-Plan verfügbar. Siehe Plans & add-ons. Auf niedrigeren Stufen wird die Anmeldung über den Standard-Plattform-Host ausgeliefert.

Hinweis: Eine benutzerdefinierte Domain wird nicht in der Admin Console konfiguriert. Die Einrichtung erfolgt im separaten Portal, über das Ihre Instanz verwaltet wird. Diese Seite erklärt, was eine benutzerdefinierte Domain verändert und was Sie vor der Einrichtung vorbereiten.

Standardmäßig ist Ihr Tenant über einen plattformverwalteten Host erreichbar. Mit einer benutzerdefinierten Domain melden sich Ihre Benutzer über einen Hostnamen an, der Ihnen gehört, zum Beispiel auth.yourcompany.com, sodass die Anmeldeseiten, die Links in Plattform-E-Mails und die OIDC-Endpunkte alle Ihre eigene Domain verwenden. Das hält das Erlebnis konsistent mit dem Rest Ihres Dienstes.

Was Sie vorbereiten

PunktDetails
Ein dedizierter HostnameEine Subdomain, die ausschließlich für die Anmeldung verwendet wird, etwa auth.yourcompany.com. Verwenden Sie nicht den Hostnamen einer bestehenden Website.
Zugriff auf die DNS-ZoneFür den Hostnamen werden zwei Einträge veröffentlicht: ein CNAME, der den Datenverkehr zur Plattform leitet, und ein TXT-Eintrag, der den Besitz der Domain nachweist. Die genauen Hostnamen und Werte werden während der Einrichtung angezeigt.
Ein TLS-Zertifikat (optional)Nur, wenn Sie ein eigenes Zertifikat statt eines verwalteten verwenden möchten. Halten Sie die vollständige PEM-Zertifikatskette und den passenden privaten Schlüssel bereit. Das Zertifikat muss den Hostnamen abdecken und darf nicht abgelaufen sein.

Wie die Einrichtung abläuft

Die Schritte laufen in einer festen Reihenfolge ab:

  1. Domain registriert. Der Hostname wird für Ihre Instanz hinterlegt.
  2. Besitz verifiziert. Sie veröffentlichen den TXT- und den CNAME-Eintrag bei Ihrem DNS-Anbieter. Die Verifizierung gelingt, sobald sich die Einträge verbreitet haben, was in der Regel wenige Minuten dauert.
  3. Zertifikat gewählt. Entweder wird ein verwaltetes Zertifikat automatisch ausgestellt und erneuert, oder Sie stellen Ihr eigenes Zertifikat samt privatem Schlüssel bereit.
  4. Domain aktiviert. Die Domain wird am Edge eingebunden, und die Anmeldung wird darauf umgestellt. Die Aktivierung dauert einen Moment und kann aktive Sitzungen kurz unterbrechen.

Nach der Aktivierung

  • Die Anmeldeseiten, die Multi-Faktor-Abfragen, der Zustimmungsbildschirm und das Endbenutzer-Portal werden über Ihre Domain ausgeliefert.
  • Der OIDC-Issuer und alle Endpunkte verwenden den neuen Hostnamen. Anwendungen, die das Discovery-Dokument einlesen, übernehmen das automatisch; alles mit fest codierten Endpunkt-URLs muss angepasst werden.
  • Links in Plattform-E-Mails verweisen auf den neuen Hostnamen.
  • Lassen Sie die DNS-Einträge bestehen, solange die Domain in Verwendung ist. Werden sie entfernt, ist die Anmeldung gestört.

Fehlerbehebung

  • Die Besitzverifizierung wird nicht abgeschlossen. DNS-Änderungen brauchen einige Minuten, manchmal länger, bis sie sich verbreitet haben. Prüfen Sie, ob Host und Wert des Eintrags exakt dem entsprechen, was die Einrichtung anzeigt, ohne zusätzliche Zeichen.
  • CNAME-Konflikt. Stellen Sie sicher, dass für denselben Hostnamen kein A- oder AAAA-Eintrag existiert.
  • Zertifikat abgelehnt. Im Modus eigenes Zertifikat muss das Zertifikat eine gültige PEM-Kette sein, zum privaten Schlüssel passen, den Hostnamen abdecken (CN oder SAN) und darf nicht abgelaufen sein.
  • Die Anmeldung läuft weiterhin über den alten Host. Die Aktivierung ist der letzte Schritt und von der Verifizierung getrennt. Prüfen Sie, ob die Domain als aktiv angezeigt wird, bevor Sie Ihre Benutzer umstellen.

Siehe auch

Auf dieser Seite