Menjalankan server

Administrasi dan pengaturan

Halaman admin, pengiriman kode pendaftaran (SMS dan email), nilai pengaturan server, pencadangan, dan keamanan — referensi untuk operator.

Server dilengkapi halaman admin yang dibuka lewat peramban. Di sana Anda melihat status server, menentukan cara pengiriman kode pendaftaran dan masuk, serta mengelola pengguna dan bot. Dokumen ini adalah referensi yang merangkum halaman admin dan nilai pengaturan server di satu tempat. Jika Anda perlu memasang server terlebih dahulu, lihat Instalasi server.

Tampilan halaman admin berbahasa Korea. Karena itu, saat dokumen ini menyebut tab, tombol, atau pengaturan, label Koreanya dicantumkan di dalam kurung agar mudah ditemukan.

Membuka halaman admin

Halaman admin berada di /admin/ pada port HTTP admin (8080 dalam susunan produksi) dan hanya terbuka di server itu sendiri (127.0.0.1). Operator masuk lewat tunnel SSH.

# di komputer Anda (biarkan tetap berjalan)
ssh -N -L 8080:127.0.0.1:8080 <pengguna>@<server>
# peramban: http://localhost:8080/admin/

# token (di server)
sudo cat /srv/pabal/pabal_server/data/admin-token

Masukkan token, lalu tekan Buka (열기). Peramban mengingat token itu, dan Anda bisa menghapusnya dengan Hapus token (토큰 지우기) di kanan atas. Jika ingin menentukan token sendiri, berikan TELEGRAM_ADMIN_TOKEN (minimal 16 karakter) — dengan begitu berkas token tidak ditulis.

Isi setiap tab

Tindakan berbahaya (keluar, blokir, pembatalan kode) baru dijalankan jika ditekan dua kali.

Kode pendaftaran dan masuk

Saat seseorang memasukkan nomor telepon di aplikasi, server membuat kode dan mengirimkannya dengan cara yang dipilih di tab Pengaturan (설정).

• Dengan cara email, pendaftaran baru boleh memakai alamat apa saja, dan alamat itu menjadi email login akun tersebut. Akun yang sudah ada hanya menerima kode di email login yang terdaftar — ini mencegah orang masuk dengan memasukkan alamatnya sendiri untuk nomor milik orang lain. Akun lama yang tidak punya email login akan dikirimi lewat SMS (jika sudah diatur) atau lewat halaman admin sebagai gantinya. Email login bisa diisikan di tab Pengguna (사용자).
• Pengiriman berlangsung di belakang, sehingga aplikasi langsung beralih ke layar kode. Hasil pengiriman (berhasil atau gagal beserta alasannya) muncul di tab Kode pendaftaran.
• Pendaftaran (memasukkan nama) hanya bisa dilakukan setelah kode dimasukkan dengan benar. Kode yang salah hanya diterima sebanyak batas yang diizinkan; setelah itu, kode yang benar pun ditolak.

Pengaturan — pendaftaran dan masuk

Pengaturan — SMS

Di dalam teks pesan Anda bisa memasukkan {code} (kode) dan {minutes} (masa berlaku). Nilai bawaan: [파발] 인증 코드: {code} (artinya "[Pabal] Kode verifikasi: {code}"). Setelah menyimpan, periksa dengan Kirim uji (테스트 발송).

Pengaturan — email (SMTP)

Alamat pengirim (보내는 주소) harus alamat yang boleh dipakai mengirim oleh akun SMTP tersebut. Subjek (제목) dan isi (본문) juga bisa memakai {code} dan {minutes}.

Mengelola pengguna

• Keluar dari semua perangkat (모든 기기 로그아웃): memutus semua status masuk (auth key) akun tersebut. Dipakai untuk pengguna yang kehilangan perangkatnya.
• Blokir nomor (번호 차단): nomor itu tidak bisa menerima kode, dan akun dengan nomor itu langsung dikeluarkan dari semua perangkat. Sama dengan daftar Blokir nomor telepon (전화번호 차단) di tab Pengaturan (설정).
• Email login (로그인 이메일): diperlukan agar akun yang sudah ada bisa masuk lewat email saat memakai cara email.
• @BotFather adalah bot di dalam server, jadi tidak bisa dikeluarkan.

Mengelola bot

Di tab Bot (봇) Anda bisa melihat cara tersambung setiap bot — apakah tersambung lewat MTProto, apakah memanggil getUpdates lewat HTTP dalam 1 menit terakhir, serta apa alamat webhook-nya dan apakah sedang gagal (beserta alasannya). Jika jumlah update yang menunggu terus bertambah, program bot sedang berhenti atau webhook-nya sedang gagal. Penghapusan bot dan penerbitan ulang token dilakukan oleh pembuat bot di @BotFather.

Variabel lingkungan

Server membaca berkas pengaturan (server-config.json) lalu menimpanya dengan variabel lingkungan. Berkas compose produksi sudah menetapkan nilai-nilai di bawah, jadi biasanya Anda cukup mengubah .env.

Berkas data

Catatan keamanan

• Jangan buka port admin langsung ke internet. Caddy dalam susunan produksi memblokir jalur administrasi seperti /admin, /health, dan /metrics dengan 404.
• Semua permintaan data admin memerlukan Authorization: Bearer <token>, dan halaman dari situs lain tidak bisa membacanya.
• Nilai rahasia SMS dan SMTP hanya ada di operations.json; halaman dan API hanya memberi tahu "Tersimpan" (저장됨). Jika kolom nilai rahasia dibiarkan kosong saat menyimpan, nilai lama tetap dipakai.
• Token dan nilai rahasia tidak dicetak ke log, dan nomor telepon di log disamarkan. Alamat Bot API (yang memuat token) juga tidak dicatat ke log.
• Auth key tersimpan di DB, jadi siapa pun yang bisa mengakses DB dapat membuka lalu lintas pengguna. Jaga DB dan cadangannya seketat kunci RSA.

Keterbatasan

• Kode yang sedang menunggu dan catatan terbaru ada di memori, jadi hilang saat server dimulai ulang (cukup minta lagi dari aplikasi).
• Pengiriman sungguhan oleh penyedia SMS harus diperiksa dengan akun masing-masing penyedia. Server menyusun permintaan sesuai dokumentasi setiap penyedia.
• Yang belum ada: penghapusan akun, penghapusan paksa bot, melihat isi pesan, melihat log, dan grafik.