Spaces:
Running on Zero
Running on Zero
docs: add cloudflare turnstile configuration guidelines
Browse files- .env.example +7 -1
- README.md +25 -1
.env.example
CHANGED
|
@@ -1,2 +1,8 @@
|
|
| 1 |
PAIRING_NUMBER="628xxxxxxxx"
|
| 2 |
-
PFP_PATH="pfp.jpg"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
PAIRING_NUMBER="628xxxxxxxx"
|
| 2 |
+
PFP_PATH="pfp.jpg"
|
| 3 |
+
PORT="7860"
|
| 4 |
+
|
| 5 |
+
# Cloudflare Turnstile (Anti-Bot Security)
|
| 6 |
+
# Dapatkan gratis di Cloudflare Dashboard -> Turnstile
|
| 7 |
+
TURNSTILE_SITE_KEY=""
|
| 8 |
+
TURNSTILE_SECRET_KEY=""
|
README.md
CHANGED
|
@@ -77,11 +77,35 @@ Anda juga bisa menjalankan seluruh web app (Backend + Frontend) secara langsung
|
|
| 77 |
|
| 78 |
---
|
| 79 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 80 |
## 🔒 Privasi & Keamanan
|
| 81 |
|
| 82 |
1. **Tidak Ada Database Permanen**: Menggunakan SQLite sementara (`file:sess_<uuid>.db`) yang dihapus secara permanen seketika proses selesai.
|
| 83 |
2. **Auto-Logout Seketika**: Kode secara eksplisit memanggil `client.Logout()` ke server WhatsApp setelah foto berhasil diunggah, memastikan sesi tertaut di HP Anda langsung terputus.
|
| 84 |
-
3. **
|
|
|
|
| 85 |
|
| 86 |
---
|
| 87 |
|
|
|
|
| 77 |
|
| 78 |
---
|
| 79 |
|
| 80 |
+
## 🛡️ Cloudflare Turnstile (Perlindungan Anti-Bot)
|
| 81 |
+
|
| 82 |
+
Aplikasi ini dilengkapi dengan **Cloudflare Turnstile** untuk mencegah serangan bot, spam pembuatan sesi WhatsApp, dan menjaga server Hugging Face Spaces tetap stabil.
|
| 83 |
+
|
| 84 |
+
### Cara Mengaktifkan Cloudflare Turnstile:
|
| 85 |
+
1. Buka [Cloudflare Dashboard](https://dash.cloudflare.com/) > menu **Turnstile**.
|
| 86 |
+
2. Klik **Add site**:
|
| 87 |
+
- **Site name**: `WA Full Profile Picture`
|
| 88 |
+
- **Domain**: Masukkan domain frontend Vercel Anda (misal `wa-pfp.vercel.app`) dan domain lokal `localhost`.
|
| 89 |
+
- **Widget Mode**: Pilih **Managed** (Sangat direkomendasikan - verifikasi pintar tanpa tebak-gambar rumit).
|
| 90 |
+
3. Salin **Site Key** dan **Secret Key**.
|
| 91 |
+
4. Di Hugging Face Space Anda:
|
| 92 |
+
- Buka menu **Settings** > **Variables and secrets**.
|
| 93 |
+
- Tambahkan **Secret**:
|
| 94 |
+
- `TURNSTILE_SECRET_KEY` = *(Secret Key Anda)*
|
| 95 |
+
- Tambahkan **Variable**:
|
| 96 |
+
- `TURNSTILE_SITE_KEY` = *(Site Key Anda)*
|
| 97 |
+
5. **Selesai!** Frontend di Vercel secara otomatis mendeteksi konfigurasi tersebut via endpoint `/config` dari Hugging Face dan langsung merender widget Turnstile di atas tombol proses tanpa perlu redeploy Vercel.
|
| 98 |
+
|
| 99 |
+
> 💡 **Mode Dev / Pengujian Lokal:** Jika `TURNSTILE_SECRET_KEY` dikosongkan (misal saat dijalankan di komputer lokal), backend secara otomatis masuk ke **Dev/Bypass Mode** sehingga Anda tetap bisa melakukan pengujian tanpa harus menyiapkan akun Cloudflare terlebih dahulu.
|
| 100 |
+
|
| 101 |
+
---
|
| 102 |
+
|
| 103 |
## 🔒 Privasi & Keamanan
|
| 104 |
|
| 105 |
1. **Tidak Ada Database Permanen**: Menggunakan SQLite sementara (`file:sess_<uuid>.db`) yang dihapus secara permanen seketika proses selesai.
|
| 106 |
2. **Auto-Logout Seketika**: Kode secara eksplisit memanggil `client.Logout()` ke server WhatsApp setelah foto berhasil diunggah, memastikan sesi tertaut di HP Anda langsung terputus.
|
| 107 |
+
3. **Perlindungan Anti-Bot**: Dilindungi Cloudflare Turnstile dengan validasi token *single-use* sebelum sesi WhatsApp whatsmeow dialokasikan.
|
| 108 |
+
4. **Tanpa Akses Chat**: Aplikasi ini hanya memanggil API `SetGroupPhoto` (untuk foto profil) dan tidak membaca kontak maupun riwayat obrolan Anda.
|
| 109 |
|
| 110 |
---
|
| 111 |
|