Özellikler
Güvenlik ve kimlik
Giriş yöntemleri, iki adımlı doğrulama, geçiş anahtarları, LDAP ve tek oturum açma, roller ve rol sınırları, kullanıcı adına oturum ve adresin ilk kanıtı.
Bu sayfada
Giriş yöntemleri
Kimlik doğrulama better-auth ile yapılır: parola, geçiş anahtarı (passkey) ve iki adımlı doğrulama. E-posta koduyla ve giriş bağlantısıyla giriş de vardır, ikisi de varsayılan olarak kapalıdır.
İki adımlı doğrulama Hesabım → Güvenlik'ten açılır:
- Doğrulayıcı uygulama (TOTP), kurulumda QR kod ve elle girilecek anahtarla.
- 10 yedek kod; her biri bir kez kullanılır.
- SMS ya da e-posta kodu; kod 5 dakika geçerlidir.
- "Bu cihaza güven" seçilirse o tarayıcıda 30 gün ikinci adım sorulmaz.
- 10 hatalı denemeden sonra doğrulama 15 dakika kilitlenir.
Geçiş anahtarıyla giriş iki adımlı doğrulamanın yerini tutar. İki adımlı doğrulaması açık bir hesap e-posta koduyla ya da giriş bağlantısıyla giremez.
Dizin ve tek oturum açma
- LDAP / Active Directory: Ayarlar → Dizin. Salt okuma servis hesabı kişiyi e-postasıyla bulur, ardından kişinin kendi parolasıyla bind denenir. Gruplar rollere eşlenebilir. Dizin hesabının parolası panelde değiştirilemez.
- OpenID Connect ile tek oturum açma: Keycloak, Entra ID, Okta, Google ve authentik. Sağlayıcıya kaydedilecek yönlendirme adresi
https://<panel>/api/auth/callback/oidcbiçimindedir. Roller her girişte gruplara göre güncellenir.
Dizin ve SSO hesapları yalnızca kendi yollarından girer. Oturumları, kullanılsa da, açıldıktan SESSION_TTL_HOURS saat sonra biter. Dizin ya da SSO ayarını kaydeden kişinin izinleri, o kaynaktan giren her hesabın izinlerini kapsamalıdır; admin rolüne yalnızca yöneticiler eşleyebilir.
Bu hesapların kişisel API anahtarları yalnızca hesap, kaynağında son DIRECTORY_TOKEN_DAYS gün içinde (varsayılan 30) doğrulanmışsa kabul edilir. Dizinin artık listelemediği hesabın anahtarları uykuya alınır.
Roller, izinler ve rol sınırları
Yetki izinler üzerinden verilir; rol, izinlerin adlandırılmış bir kümesidir. Bir kullanıcının birden fazla rolü olabilir ve kişiye özel izin eklenip çıkarılabilir. Hazır roller Yönetici (her izin, değiştirilemez), Müşteri, Operatör, Destek ve Denetçi'dir; yenilerini siz oluşturursunuz.
Rol, izinlerin yanında sınırlar da taşır:
- Kota: en fazla sunucu, vCPU, RAM, disk.
- Sunucu başına anlık görüntü, firewall ve SSH anahtarı sayısı.
- Saatte başlatılabilen işlem sayısı.
- Oturumun en uzun süresi ve iki adımlı doğrulama zorunluluğu.
- Sipariş verilebilecek konumlar ve giriş yapılabilecek IP adresleri.
Kullanıcı adına oturum
Personel, izni varsa, bir kullanıcının adına oturum açabilir. Bu oturum hesapta kalıcı iz bırakamaz: geçiş anahtarı, bağlı hesap, parola, iki adım, webhook ve fatura e-postası değiştirilemez; hesap bayiden ayrılamaz ve devredilen sunucu kabul edilemez. Oturum bir saat sonra ve onu açan personelin yetkisi kalktığında biter.
Adresin ilk kanıtı
Kayıtla açılan hesabın e-posta adresi doğrulanmaz. Adresi kanıtlanmamış bir hesap adresini ilk kez kanıtladığında (giriş bağlantısı, e-posta kodu ya da postayla parola sıfırlama) hesapta önceden kurulmuş olanlar bir kez silinir: bağlı girişler, diğer oturumlar, API anahtarları, geçiş anahtarları, webhook'lar, kayıtlı SSH anahtarları ve kayıtlı kartlar. Sunucular, imajlar, bakiye ve talepler kalır. Gerekçesi, hesabı adresin sahibinin açmamış olabileceğidir.
Diğer korumalar
- CSRF koruması, hız sınırları, istek gövdesi sınırları ve ana anahtarla şifrelenen sırlar.
- Mükerrer işlem koruması:
Idempotency-Key, sunucu başına tek açık işlem ve çift tıklamada ikinci isteğin reddi. - Proxmox'ta her istek VM'in beklenen adını taşır; yeniden kullanılan bir VM numarası başka bir sunucuya işlem yaptırmaz.
- SMS ve e-posta gönderen her yol hesap ve hedef başına sınırlıdır.
- CAPTCHA: Cloudflare Turnstile, reCAPTCHA v2/v3 ve hCaptcha.
- Oturum bittiğinde ve aynı tarayıcıda panel başkası için açıldığında tarayıcıdaki taslaklar, son açılanlar ve yarım sipariş silinir.
Panelin güvenlik denetiminin neyi kapsadığını ve neyi kapsamadığını ayrı bir yazıda anlattık: Güvenlik denetimi neyi kapsadı, neyi kapsamadı.
Kaynak: docs/auth.md.
Kurulum komutu
curl -fsSL https://lightningvm.app/install.sh | sudo shUbuntu 22.04 / 24.04 / 26.04. Gereksinimler ve seçenekler