Giriş sayfalarınızı markalayın
Markalama; barındırılan giriş sayfasının, hesap portalının ve e-postaların görünümünü değiştirir. Ayarlar şu sırayla devralınır: platform varsayılanı, ortam, uygulama, kuruluş. Her belirteç, onu tanımlayan en özel düzeydeki değeri alır.
Neleri ayarlayabilirsiniz
- Renkler:
color.primary,color.primary_contrast,color.background,color.surface,color.text,color.text_muted,color.border,color.link,color.focus_ring,color.errorvecolor.success; sRGB onaltılık değer olarak. Açık ve koyu tema için ayrı değerler vardır;modedeğerilight,darkveyasystemolabilir. - Yazı tipleri: izin verilen yazı tipi listesinden
font.bodyvefont.headingya da yüklenmiş bir yazı tipi;font.size_base14 ile 18 px arası. - Şekil:
radius.card0 ile 24 px arası veradius.control0 ile 16 px arası. - Yerleşim:
center,split_leftveyasplit_right. - Görseller:
logo,logo_height(24 ile 80 px arası),faviconvebackground_image(yalnızcasplit_*yerleşimiyle).
Kuruluşlar yalnızca logo ve color.primary belirteçlerini geçersiz kılabilir. Bir kuruluşun markası, kuruluş bağlamı doğrulandığında gösterilir; örneğin geçerli bir davetiyeden veya kuruluş seçicisinden sonra. Tek başına bir organization parametresi sayfanın görünümünü değiştirmez.
Kontrast koruması
Kaydettiğinizde KeenAuth bu çiftleri açık ve koyu tema için ayrı ayrı denetler:
| Çift | Asgari oran |
|---|---|
| Arka plan üzerinde metin | 4,5:1 |
Arka plan üzerinde color.link |
4,5:1 |
color.primary üzerinde color.primary_contrast |
4,5:1 |
| Arka plan üzerinde denetim kenarlığı | 3:1 |
Arka plan üzerinde odak halkası (color.focus_ring) |
3:1 |
Asgari değerin altında kalan bir çift, Management API tarafından 422 brand_contrast_insufficient (RFC 9457) ile reddedilir. Hata gövdesi alanı belirtir ve koşulu sağlayan en yakın rengi önerir; öneri tonu ve kromayı korur, yalnızca parlaklığı değiştirir. Kontrol paneli aynı öneriyi tek tıkla sunar. Başarısız olan bir değer yayımlanamaz. Hata biçimi için bkz. Markayı yayımlama.
Özel CSS (Startup planı) kontrastı düşürebilir; KeenAuth bunu düzeltmez. Önizleme taraması sorunları kontrol panelinde uyarı olarak bildirir; özel CSS ile yapılan değişikliklerin uyumluluğu sizin sorumluluğunuzdadır.
Varlıklar
Görselleri ve yazı tiplerini POST /v1/branding/assets ile yükleyin. Görseller en fazla 1 MB, yazı tipleri en fazla 300 KB olabilir. PNG, JPEG ve WebP kabul edilir; ICO yalnızca favicon için, WOFF2 yalnızca yazı tipleri için kabul edilir. SVG reddedilir. Görseller PNG olarak yeniden kodlanır, en fazla 1024×1024 px boyutuna küçültülür ve meta verileri kaldırılır. Bir ortam 200 dosya ve 50 MB barındırabilir.
Özel CSS ve şablonlar
Startup planı ve üzeri planlarda özel CSS ve sayfa şablonu ekleyebilirsiniz. Sayfanın güvenlik açısından kritik bölümleri, CSS'inizin gizleyemeyeceği ya da örtemeyeceği korumalı bir katmanda çizilir: onay ekranlarındaki uygulama adı ve doğrulanmış kaynak, istenen izinlerin listesi, izin ver ve reddet düğmeleri, güvenlik uyarıları, ortam şeridi ve yasal bağlantılar. Müşteri JavaScript'i hiçbir planda çalışmaz.
Mantıksal CSS özelliklerini kullanın (margin-left yerine margin-inline-start); fiziksel özellikler reddedilir, böylece stilleriniz sağdan sola dillerde de çalışır. Bkz. Diller ve sağdan sola yazım.
KeenAuth işareti
Barındırılan giriş sayfası, hesap portalı ve e-postalar, korumalı katmanda küçük bir "KeenAuth tarafından güvence altına alınmıştır" satırı gösterir. Business ve Enterprise planlarında ile development ortamlarında bu satır gösterilmez. Plan, her sayfa veya e-posta çizildiğinde denetlenir; bu nedenle plan değişirse satır geri gelir. Özel CSS ve metin geçersiz kılmaları bu satırı gizleyemez veya değiştiremez.
Yayımlama
Değişiklikler taslak olarak kaydedilir ve yayımladığınızda canlıya geçer. Önceki sürümler listelenebilir ve geri alınabilir. API sayfaları /docs/api/management/branding/ altındadır; başlangıç noktası Markayı yayımlama sayfasıdır.