# Własna domena

Serwuj logowanie z własnej domeny zamiast z domyślnego hosta platformy.

Requires: customDomain

> **Uwaga dotycząca planu:** Własne domeny są dostępne w planie Essential i wyższych. Zobacz [Plany i dodatki](https://dts-identity.com/pl/docs/getting-started/plans-and-addons.md). 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:

1. **Rejestracja domeny.** Nazwa hosta zostaje zapisana dla Twojej instancji.
2. **Weryfikacja posiadania.** Publikujesz rekord TXT i CNAME u swojego dostawcy DNS. Weryfikacja udaje się, gdy rekordy się rozpropagują, co zwykle zajmuje kilka minut.
3. **Wybór certyfikatu.** Albo zarządzany certyfikat jest wystawiany i odnawiany automatycznie, albo dostarczasz własny certyfikat wraz z kluczem prywatnym.
4. **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](https://dts-identity.com/pl/docs/quickstarts.md), 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.

## Zobacz też

- [Wygląd](https://dts-identity.com/pl/docs/branding/appearance.md)
- [Przegląd sekcji Branding](https://dts-identity.com/pl/docs/branding.md)
