ilhamdev commited on
Commit
2ebb4db
·
1 Parent(s): f9a7db9

docs: add cloudflare turnstile configuration guidelines

Browse files
Files changed (2) hide show
  1. .env.example +7 -1
  2. 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. **Tanpa Akses Chat**: Aplikasi ini hanya memanggil API `SetGroupPhoto` (untuk foto profil) dan tidak membaca kontak maupun riwayat obrolan Anda.
 
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