Panduan Aktivasi Facebook Login

Panduan ini menjelaskan cara mengaktifkan Facebook Login untuk Hexflate.

Alur Konfigurasi

Create Facebook App
        ↓
Add Facebook Login Use Case
        ↓
Customize Use Case (Permissions)
        ↓
Lengkapi App Requirements
        ↓
Publish App (Live Mode)
        ↓
Konfigurasi di Hexaflate Portal (Server Config)
        ↓
Tambahkan OAuth Redirect URI di Facebook

Prasyarat

Pastikan sebelum mulai:

Hexaflate Server sudah aktif
Akses ke Hexaflate Portal (Web Report)
Akses ke Meta for Developers Dashboard

Bagian 1: Buat Facebook App

Langkah 1: Akses Meta for Developers

Buka https://developers.facebook.com
Login dengan akun Facebook
Klik My Apps → Create App

Langkah 2: Pilih App Type

Pilih:

Consumer

Klik Next.

Langkah 3: Isi Informasi Dasar

Field	Keterangan
App Name	Nama aplikasi
App Contact Email	Email aktif
Business Account	Opsional

Klik Create App.

Bagian 2: Tambahkan Facebook Login Use Case

Langkah

Di Dashboard App, klik Add use cases
Pilih Facebook Login
Klik Add

Bagian 3: Customize Facebook Login Use Case

Lokasi Menu

Use cases
 └── Facebook Login
     └── Customize
         └── Permissions and features

Permission yang Diperlukan

Permission	Keterangan	Status
public_profile	Default profile fields	Automatically granted
email	Primary email address	Ready for testing

⚠️ JANGAN menambahkan permission lain - hanya public_profile dan email yang diperlukan.

Bagian 4: Lengkapi App Requirements

Lokasi

App settings
 └── Basic

Wajib Diisi

App Contact Email - Email valid & aktif
Privacy Policy URL - Gunakan Web Report Privacy Policy URL
User Data Deletion URL - Halaman untuk request penghapusan data
App Icon - 1024×1024 PNG
Category - Business and Utility / Finance / Productivity

Bagian 5: App Mode → Live

Setelah semua requirement terpenuhi:

Dashboard
 └── Publish
     └── Switch App Mode → Live

Bagian 6: Dapatkan App ID & App Secret

Lokasi:

App settings → Basic

Salin:

App ID
App Secret

⚠️ App Secret bersifat rahasia - jangan share ke siapapun

Bagian 7: Konfigurasi di Hexaflate Portal

Langkah 1: Buka Server Config

Login ke Hexaflate Portal
Buka menu Server Config

Langkah 2: Tambahkan Facebook OAuth Config

Tambahkan 3 konfigurasi berikut:

Key	Value	Keterangan
`FACEBOOK_APP_ID`	`123456789012345`	App ID dari Facebook Developer
`FACEBOOK_APP_SECRET`	`abcdef1234567890abcdef1234567890`	App Secret dari Facebook Developer
`FACEBOOK_REDIRECT_URI`	`https://your-api.com/oauth/facebook/redirect`	URL redirect OAuth (lihat catatan)

Catatan untuk FACEBOOK_REDIRECT_URI

Format: https://{your-server-domain}/oauth/facebook/redirect

Contoh:

https://api.hexflate.com/oauth/facebook/redirect
https://server.yourdomain.com/oauth/facebook/redirect

Penting: URI ini harus menggunakan HTTPS dan domain yang valid.

Bagian 8: Tambahkan OAuth Redirect URI di Facebook

Langkah 1: Buka Facebook Login Settings

Use cases
 └── Facebook Login
     └── Customize
         └── Settings

Langkah 2: Tambahkan Valid OAuth Redirect URIs

Cari field Valid OAuth Redirect URIs
Tambahkan URI yang sama dengan FACEBOOK_REDIRECT_URI di Server Config
Klik Save Changes

Contoh:

https://api.hexflate.com/oauth/facebook/redirect

⚠️ URI harus persis sama dengan yang dikonfigurasi di Server Config.

Bagian 9: Aktifkan Facebook Login di Web Report

Langkah

Login ke Hexflate Report (Web Report Admin) sebagai Super Admin
Buka menu Security Management
Pilih tab Priority Settings atau App Rules
Cari toggle: Facebook Login
Aktifkan toggle tersebut
Klik Save untuk menyimpan perubahan

Bagian 10: Testing

Test di Development Mode

Sebelum App Live, hanya user berikut yang bisa test:

Developer
Admin
Tester (tambahkan di Facebook App → Roles)

Test di Live Mode

Setelah App Live, semua user bisa menggunakan Facebook Login.

Troubleshooting

Error: "Facebook login not configured"

Penyebab: Server Config belum diisi atau salah.

Solusi:

Pastikan FACEBOOK_APP_ID, FACEBOOK_APP_SECRET, dan FACEBOOK_REDIRECT_URI sudah diisi di Server Config
Restart server jika diperlukan

Error: "Failed to authenticate with Facebook"

Penyebab: OAuth Redirect URI tidak cocok.

Solusi:

Pastikan FACEBOOK_REDIRECT_URI di Server Config persis sama dengan yang ada di Facebook App Settings
Pastikan menggunakan HTTPS

Error: "App not active"

Penyebab: Facebook App masih dalam Development Mode.

Solusi:

Lengkapi semua App Requirements
Switch App Mode ke Live

Login berhasil tapi email kosong

Penyebab: User Facebook tidak punya email atau tidak memberikan izin.

Solusi: Ini normal. Aplikasi akan meminta nomor telepon untuk verifikasi OTP.

Final Checklist

Catatan Penting

App Secret sangat rahasia - hanya simpan di Server Config
Jika App kembali ke Development Mode, login publik akan gagal
Email dari Facebook bisa kosong - aplikasi akan fallback ke OTP via nomor telepon