# Özel giriş alan adı kurulumu

`login.acme.com` gibi bir özel alan adı, ortamınızın tüm son kullanıcı yüzeylerini sunar: barındırılan giriş, hesap portalı, Yönetici Portalı, OIDC ve OAuth uçları, SSO, SAML ve SCIM ile e-postalardaki bağlantılar. Kendi uygulamanızın alan adı KeenAuth tarafından barındırılmaz. `development` ortamında özel alan adı yoktur.

## Başlamadan önce

- Ad en az üç etiketten oluşmalıdır (alt alan adı), çünkü alan adının kökünde CNAME kurulamaz.
- Ad IDNA2008 A-etiketine çevrilir ve küçük harfe indirilir. `keenauth.app`, `keenauth.com` ya da bunların alt alanları olamaz; Public Suffix List'teki bir sonek de olamaz.
- Bir ad platform genelinde tektir. Serbest bırakılan ad, başka bir hesap ekleyebilmeden önce 30 gün karantinada tutulur.
- Free plan: bir alan adı ve hesapta doğrulanmış ödeme kartı gerekir. Ortam başına birden çok alan adı Enterprise özelliğidir.
- Hesap başına günde (UTC) en çok 10 alan adı eklenebilir. Reddedilen denemeler de sayılır.

## Adım 1: alan adını ekleyin

[Özel alan adı ekle](/docs/api/management/custom-domains/create) çağrısını yapın. Alan adı `pending_dns` durumunda başlar ve yanıt yayımlanacak DNS kayıtlarını listeler.

## Adım 2: iki DNS kaydı yayımlayın

| Tür | Ad | Değer |
|---|---|---|
| TXT | `_akp-verify.<hostname>` | `idp-verify=<26 karakter base32 token>` |
| CNAME | `<hostname>` | `<ortam-slug>.<bölge>.edge.keenauth.app` |

TXT kaydını alan adı etkinleştikten sonra da DNS'te kalıcı olarak tutun. Bu kayıt sahiplik kanıtıdır: alan adı el değiştirirse önceki sahip sayfayı sunmaya devam edemez.

İki kayıt da görünmelidir. Denetim 72 saat boyunca 5 dakikada bir, ardından 30 gün boyunca saatlik çalışır. Durmuş bir denetimi yeniden başlatmak için [Özel alan adını doğrula](/docs/api/management/custom-domains/verify) çağrısını yapın.

## Adım 3: CAA kayıtlarını denetleyin

Alan adında ya da üst alanlarından birinde CAA kaydı varsa, KeenAuth'un kullandığı iki ACME sertifika otoritesine de izin vermelidir. Aksi halde alan adı `caa_blocked` hata nedeniyle `pending_dns` durumuna döner ve pano eklenecek CAA satırını aynen gösterir. CAA kaydı yoksa bir şey yapmanız gerekmez.

## Sertifika ve yaşam döngüsü

TLS sertifikasını KeenAuth alır ve yeniler. Sertifikanın kalan ömrü 30 günün altına inince yenilenir. Yenileme 7 gün boyunca başarısız olursa `custom_domain.certificate_renewal_failed` olayı ve e-posta alırsınız. Olay teslimi henüz yok; Faz 6A'da web kancalarıyla gelir.

| Durum | Anlamı | Sonraki |
|---|---|---|
| `pending_dns` | Eklendi; TXT ve CNAME kayıtları bekleniyor | İkisi de görülünce: `issuing` |
| `issuing` | Sertifika alınıyor | Alındı: `active`. CAA engeli: `caa_blocked` ile `pending_dns`. 72 saatte alınamadı: `certificate_failed` ile `pending_dns` |
| `active` | Hizmette | Günlük denetim başarısız: `degraded` |
| `degraded` | TXT ya da CNAME kaydı bir gün ya da daha uzun süredir bulunamıyor; alan adı hizmet vermeye devam eder | Düzeldi: `active`. 7 gün düzelmedi: `disabled` |
| `disabled` | Hizmet dışı; sertifika silinir ve bu host'taki oturumlar geçersiz olur | `:verify` ile yeniden başlatırsınız: `pending_dns` |
| `released` | Alan adı ya da ortam silindi | 30 gün karantinadan sonra ad yeniden eklenebilir |

Etkin bir alan adı 24 saatte bir denetlenir. Bir şey değiştiğinde haberdar olmak için `custom_domain.verified`, `custom_domain.activated`, `custom_domain.degraded` ve `custom_domain.disabled` olaylarına abone olun. Bu olaylar henüz yok; teslim Faz 6A'da web kancaları ve olay API'siyle gelir.

## Birincil alan adı ve kaldırma

Ortamın alan adlarından biri birincildir; e-posta bağlantıları onu kullanır. Değiştirmek için [Özel alan adını birincil yap](/docs/api/management/custom-domains/make-primary) çağrısını kullanın. Ortamın issuer'ı birincil alan adını izliyorsa birincil alan adını değiştirmek issuer'ı değiştirir ve en az 7 gün sonraya planlanan bir işlemdir.

Birincil alan adı ya da issuer olan alan adı silinemez (`409 custom_domain_in_use`); önce başka bir birincil alan adı seçin. Passkey rpId olarak kullanılan bir alan adı da silinemez ve devre dışı bırakılamaz (`409 domain_in_use_by_rp_id`).

## Bir ortamda birden çok alan adı

Enterprise'ta bir ortamın birden çok doğrulanmış alan adı olabilir. Her alan adının kendi oturum çerezi vardır, bu yüzden alan adları arasında sessiz SSO yoktur. Alan adları arasında passkey kullanımı rpId seçimine ve ilişkili kökenler listesine bağlıdır; liste en çok 5 kayıtlı alan etiketi içerir ve yalnız aynı ortamın `active` alan adlarını alır. Her uygulama her alan adında kendi markasını gösterebilir; bkz. [Giriş sayfalarınıza marka uygulayın](/docs/guides/branding).