• Bahasa Indonesia

      • Autentikasi: Feishu / Lark

      Pengantar

      Plugin Feishu / Lark memungkinkan pengguna masuk ke NocoBase dengan akun Feishu atau Lark, dengan opsi login otomatis.

      Mengaktifkan plugin

      Feishu / Lark adalah plugin komersial. Instal dan aktifkan di manajer plugin bersama plugin Autentikasi pengguna.

      Membuat aplikasi di platform terbuka

      Masuk ke platform terbuka Feishu dan buat aplikasi internal perusahaan (untuk Lark gunakan platform terbuka Lark). Catat App ID dan App Secret.

      Login tidak memerlukan izin API tambahan. Untuk sinkronisasi kontak, lihat Menyinkronkan data pengguna dari Feishu.

      Mengonfigurasi URL pengalihan

      Di Pengaturan keamanan → URL pengalihan aplikasi, tambahkan URL callback yang ditampilkan NocoBase:

      https://domain-anda/api/feishu:redirect

      Cara termudah adalah menyalin URL pengalihan yang tampil di halaman konfigurasi autentikator NocoBase.

      Warning

      Jika NocoBase dijalankan di sub-path (mis. APP_PUBLIC_PATH=/nocobase/), URL callback memuat prefiks, mis. https://domain-anda/nocobase/api/feishu:redirect. URL pada daftar putih platform harus sama persis dengan URL sebenarnya.

      Menambahkan autentikasi Feishu di NocoBase

      Buka Autentikasi pengguna dan tambahkan autentikator Feishu / Lark:

      BidangKeterangan
      Pendaftaran otomatisMembuat akun saat login pertama. Aktif secara bawaan.
      WilayahFeishu China atau Lark Global.
      App ID / App SecretKredensial aplikasi Feishu. Mendukung variabel lingkungan dan secret.
      OriginAlamat publik situs, mis. https://example.com. Hanya protokol dan domain, tanpa path (garis miring akhir opsional); kosong berarti memakai alamat permintaan saat ini.
      Bidang pengenal unikKunci identitas pengguna, lihat di bawah.
      Login otomatisLogin senyap saat membuka aplikasi di dalam Feishu, lihat di bawah.

      Memilih bidang pengenal unik

      BidangKeterangan
      union_idDisarankan. Stabil dan sama untuk semua aplikasi akun pengembang yang sama.
      open_idUnik per aplikasi; berubah saat berganti aplikasi.
      user_idUnik dalam tenant; dapat bentrok pada skenario multi-tenant.
      mobile / emailDapat berubah dan bisa kosong; tidak cocok sebagai pengenal.

      Pertahankan pilihan ini setelah ada pengguna masuk. Jika memakai sinkronisasi data, pilih bidang yang sama di sumber sinkronisasi.

      Login dan pendaftaran otomatis

      Pengguna menekan tombol Feishu / Lark di halaman login untuk menyelesaikan OAuth. Dengan pendaftaran otomatis:

      • Pengguna dicocokkan atau dibuat berdasarkan bidang pengenal unik;
      • Telepon, email, dan nama panggilan hanya diisi saat profil kosong; nilai yang ada tidak pernah ditimpa.

      Login otomatis

      Dengan Login otomatis, membuka aplikasi di klien Feishu memulai OAuth tanpa menekan tombol. Hanya satu autentikator Feishu yang dapat mengaktifkannya dalam satu waktu.

      Syarat:

      • URL callback tercantum dalam daftar putih URL pengalihan;
      • Aplikasi sudah dipublikasikan dan pengguna berada dalam cakupan ketersediaan;
      • Aplikasi dibuka di dalam klien Feishu.

      Penggunaan pertama menampilkan satu kali halaman persetujuan; setelahnya senyap. Membuka di peramban sistem tidak memicu login otomatis — ini perilaku yang diharapkan.

      Pintasan workbench Feishu (opsional)

      Konfigurasikan beranda desktop/seluler di Fitur aplikasi → Aplikasi web agar pengguna membuka NocoBase langsung dari workbench Feishu. URL harus sama dengan alamat NocoBase sebenarnya (termasuk prefiks sub-path).