reCAPTCHA

Oturum açma, kayıt ve parola sıfırlama Google reCAPTCHA ile nasıl korunur?

Bu özellik ayaka-notes/ayakaleaf-pro tarafından geliştirilmiştir ve v6.4.0 sürümünden itibaren kullanılabilir.

E-posta ve parola ile oturum açma, LDAP ile oturum açma, kayıt ve parola sıfırlama bir Google reCAPTCHA v2 (görünmez) isteyebilir. Varsayılan olarak kapalıdır. Çoğu kullanıcı hiçbir şey görmez: denetim, düğmeye bastıklarında çalışır ve Google yalnızca isteği şüpheli bulduğunda bir resimli doğrulama gösterir. SAML ve OIDC ile oturum açmalar ve bir yöneticinin oluşturduğu hesaplar bundan etkilenmez.

1. reCAPTCHA yönetim konsolunda reCAPTCHA v2, Invisible reCAPTCHA badge türünde bir anahtar oluşturun ve örneğinizin alan adını ekleyin. Bir alan adı, alt alan adlarını da kapsar; ör. example.com, latex.example.com adresini kapsar.
2. İki anahtarı config/variables.env dosyasında ayarlayın ve bin/up komutunu çalıştırın:

RECAPTCHA_SITE_KEY=<site key>
RECAPTCHA_SECRET_KEY=<secret key>

Değişken	Varsayılan	Amaç
RECAPTCHA_SITE_KEY	Ayarlanmamış	Oturum açma, LDAP ile oturum açma, kayıt ve parola sıfırlama için captcha’yı açar.
RECAPTCHA_SECRET_KEY	Ayarlanmamış	Aynı reCAPTCHA anahtarının gizli anahtarı; sunucu tarafından yanıtları denetlemek için kullanılır.
RECAPTCHA_ENDPOINT	https://www.google.com/recaptcha/api/siteverify	Sunucunun yanıtları denetlediği yer. www.google.com adresine erişilemediği yerlerde https://www.recaptcha.net/recaptcha/api/siteverify kullanın.
CAPTCHA_TRUSTED_USERS	Ayarlanmamış	Sunucunun captcha’yı denetlemeden geçirdiği, virgülle ayrılmış e-postalar.
CAPTCHA_TRUSTED_USERS_REGEX	Ayarlanmamış	Bu tür e-postalar için bir düzenli ifade; e-postanın tamamıyla eşleşmelidir.
DEVICE_HISTORY_SECRET	Ayarlanmamış	64 onaltılık karakter, ör. openssl rand -hex 32 ile üretilmiş. Bir e-postayla oturum açmış bir tarayıcının o e-posta için 90 gün boyunca captcha’yı atlamasını sağlar. Ayarlanmazsa her oturum açmada captcha istenir.

• Sayfalar reCAPTCHA betiğini, www.google.com adresinin engellendiği yerlerde de çalışan www.recaptcha.net adresinden yükler.
• Kayıt ve parola sıfırlama her seferinde sorar. LDAP ile oturum açma da DEVICE_HISTORY_SECRET ayarlı olsa bile her seferinde sorar: e-posta değil, kullanıcı adı gönderir.
• Oturum açma denemeleri ayrıca hız sınırlamasına tabi olmaya devam eder: IP adresi başına dakikada 20 deneme ve e-posta başına 2 dakikada 10 deneme.
• Ayakaleaf Pro yalnızca Google’ın yanıtı kabul edip etmediğini denetler. reCAPTCHA v3 puanları ve eşikleri desteklenmez; ne zaman doğrulama gösterileceğine Google karar verir.
• Henüz bir anahtarınız yokken denemek için Google’ın test anahtarlarını kullanın: her denetim başarılı olur ve bileşen bir uyarı gösterir; bu nedenle bunları üretimde kullanmayın.