> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# reCAPTCHA

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

> [!NOTE]
>
> Bu özellik [ayaka-notes/ayakaleaf-pro](https://github.com/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](https://www.google.com/recaptcha/admin) **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:

```text theme={null}
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ı](https://developers.google.com/recaptcha/docs/faq) kullanın: her denetim başarılı olur ve bileşen bir uyarı gösterir; bu nedenle bunları üretimde kullanmayın.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.