Własna domena
Serwuj logowanie z własnej domeny zamiast z domyślnego hosta platformy.
Uwaga dotycząca planu: Własne domeny są dostępne w planie Essential i wyższych. Zobacz Plany i dodatki. W niższych planach logowanie jest serwowane z domyślnego hosta platformy.
Uwaga: Własnej domeny nie konfiguruje się w Admin Console. Konfiguracja odbywa się w osobnym portalu, przez który zarządzana jest Twoja instancja. Ta strona wyjaśnia, co zmienia własna domena i co przygotować przed konfiguracją.
Domyślnie Twój tenant jest osiągalny pod hostem zarządzanym przez platformę. Dzięki własnej domenie Twoi użytkownicy logują się pod nazwą hosta, która należy do Ciebie, na przykład auth.yourcompany.com, więc strony logowania, odnośniki w wiadomościach e-mail platformy i punkty końcowe OIDC korzystają z Twojej własnej domeny. Dzięki temu całość pozostaje spójna z resztą Twojej usługi.
Co przygotować
| Pozycja | Szczegóły |
|---|---|
| Dedykowana nazwa hosta | Subdomena używana wyłącznie do logowania, na przykład auth.yourcompany.com. Nie używaj ponownie nazwy hosta istniejącej witryny. |
| Dostęp do strefy DNS | Dla nazwy hosta publikowane są dwa rekordy: CNAME, który kieruje ruch do platformy, oraz rekord TXT, który dowodzi posiadania domeny. Dokładne nazwy hostów i wartości są pokazywane w trakcie konfiguracji. |
| Certyfikat TLS (opcjonalnie) | Tylko wtedy, gdy chcesz użyć własnego certyfikatu zamiast zarządzanego. Przygotuj pełny łańcuch certyfikatów PEM i pasujący klucz prywatny. Certyfikat musi obejmować nazwę hosta i nie może być wygasły. |
Jak przebiega konfiguracja
Kroki następują w ustalonej kolejności:
- Rejestracja domeny. Nazwa hosta zostaje zapisana dla Twojej instancji.
- Weryfikacja posiadania. Publikujesz rekord TXT i CNAME u swojego dostawcy DNS. Weryfikacja udaje się, gdy rekordy się rozpropagują, co zwykle zajmuje kilka minut.
- Wybór certyfikatu. Albo zarządzany certyfikat jest wystawiany i odnawiany automatycznie, albo dostarczasz własny certyfikat wraz z kluczem prywatnym.
- Aktywacja domeny. Domena zostaje wpięta na brzegu sieci, a logowanie przechodzi na nią. Aktywacja trwa chwilę i może na krótko przerwać aktywne sesje.
Po aktywacji
- Strony logowania, pytania o drugi składnik, ekran zgody i portal użytkownika końcowego są serwowane z Twojej domeny.
- Wystawca OIDC i wszystkie punkty końcowe korzystają z nowej nazwy hosta. Aplikacje, które czytają dokument discovery, przejmują to automatycznie; wszystko, co ma zakodowane na stałe adresy URL punktów końcowych, wymaga aktualizacji.
- Odnośniki w wiadomościach e-mail platformy wskazują nową nazwę hosta.
- Zostaw rekordy DNS na miejscu tak długo, jak domena jest w użyciu. Ich usunięcie psuje logowanie.
Rozwiązywanie problemów
- Weryfikacja posiadania nie dochodzi do końca. Zmiany w DNS potrzebują kilku minut, czasem dłużej, aby się rozpropagować. Sprawdź, czy host i wartość rekordu dokładnie odpowiadają temu, co pokazuje konfiguracja, bez dodatkowych znaków.
- Konflikt CNAME. Upewnij się, że dla tej samej nazwy hosta nie istnieje rekord A ani AAAA.
- Certyfikat odrzucony. W trybie własny certyfikat certyfikat musi być prawidłowym łańcuchem PEM, musi pasować do klucza prywatnego, musi obejmować nazwę hosta (CN albo SAN) i nie może być wygasły.
- Logowanie nadal korzysta ze starego hosta. Aktywacja jest ostatnim krokiem i jest oddzielona od weryfikacji. Zanim przełączysz swoich użytkowników, sprawdź, czy domena jest pokazywana jako aktywna.