Langsung ke konten utama

Membuat pengguna administrator

Penerapan Overleaf Toolkit:
Overleaf Toolkit
Penerapan docker-compose.yml lama (legacy):
Legacy docker-compose
Perintah ini akan membuat pengguna dengan alamat email yang diberikan jika pengguna tersebut belum ada, dan menjadikannya administrator. Output perintah menyertakan URL yang dapat Anda kunjungi untuk mengatur kata sandi pengguna ini dan masuk untuk pertama kalinya.
Untuk pendekatan terprogram, Anda dapat menggunakan skrip yang sama untuk membuat pengguna biasa maupun administrator. Untuk pengguna biasa, hilangkan flag —admin.
Jika Anda menggunakan akun internal untuk autentikasi dan perlu menaikkan pengguna yang sudah ada menjadi admin instans atau mencabut izin admin, lakukan hal berikut:
1

Melalui UI Admin

  • Masuk sebagai administrator yang sudah ada.
  • Klik Admin -> Manage Users.
  • Cari pengguna lalu klik namanya.
  • Klik ikon pensil.
  • Aktifkan atau nonaktifkan Admin.
  • Klik Save untuk menyelesaikan.

Menghapus pengguna

Secara umum, sebaiknya jangan menghapus akun kecuali akun tersebut tidak lagi diperlukan. Menghapus akun akan menghilangkan akun dan menyebabkan kolaborator kehilangan akses ke proyek. Untuk mencegah pengguna login sambil tetap menyimpan datanya, nonaktifkan akun sebagai gantinya. Secara default, akun dihapus secara lunak (soft-delete). Untuk informasi tentang menghapus pengguna secara permanen dari instans Anda, lihat ENABLE_CRON_RESOURCE_DELETION di panduan Variabel lingkungan.
Akun dihapus secara lunak (soft-delete) secara default. Lihat ENABLE_CRON_RESOURCE_DELETION untuk perilaku penghapusan permanen.

Melalui Admin -> Manage Users

1
  • Masuk sebagai administrator.
  • Klik Admin -> Manage Users.
  • Cari pengguna lalu centang kotak di samping namanya.
  • Klik ikon tempat sampah.
  • Klik Delete account untuk mengonfirmasi.

Melalui baris perintah

Akun pengguna (beserta proyek-proyeknya) dapat dihapus menggunakan perintah berikut. Penerapan Overleaf Toolkit:
Overleaf Toolkit
Penerapan docker-compose.yml lama (legacy):
Legacy docker-compose
Skrip penghapusan menggunakan opsi force yang ditanamkan langsung (hard-coded) untuk memastikan penghapusan tetap berjalan meskipun email penghapusan akun gagal dikirim (misalnya, ketika email pengguna sudah tidak aktif).
Opsi —skip-email dapat digunakan untuk mencegah pengiriman email pemberitahuan kepada pengguna yang dihapus.

Memulihkan pengguna yang dihapus secara lunak

Jika pengguna hanya dihapus sementara (soft delete), Anda dapat memulihkan akunnya beserta proyek yang ikut terhapus bersamanya. Proyek yang dihapus sendiri oleh pengguna tetap terhapus.
1
  • Masuk sebagai administrator.
  • Klik Admin -> Manage Users.
  • Cari pengguna yang ingin Anda pulihkan.
  • Klik Display deleted users.
  • Klik ikon panah di baris pengguna.
  • Klik Restore untuk mengonfirmasi.
Ketika ENABLE_CRON_RESOURCE_DELETION diatur ke true, akun yang dihapus secara lunak dapat dipulihkan dalam jangka waktu 90 hari. Setelah 90 hari, pemulihan akun tidak lagi dimungkinkan.

Menghitung pengguna

Anda dapat memperoleh jumlah pengguna melalui UI admin di https://you-instance-url/admin/user#license. Untuk pemeriksaan dan ekspor terprogram, contoh-contoh berikut mungkin membantu. Jumlah total pengguna:
Total number of users
Jumlah total pengguna menggunakan endpoint metrik:
Num active users from metrics
Jumlah total pengguna aktif (contoh: pengguna yang aktif dalam 365 hari terakhir):
Total number of active users

Memperbarui informasi akun pengguna

Cara pembaruan akun dilakukan bergantung pada apakah SSO diaktifkan.
  • Jika SSO tidak digunakan:
    • Administrator dapat mengubah informasi akun pengguna melalui Admin -> Manage Users (email, nama depan, nama belakang, dan membuat tautan reset kata sandi).
    • Pengguna biasa dapat memperbarui detail mereka sendiri melalui Account -> Account Settings (termasuk mengubah kata sandi dan membuat token autentikasi Git).
  • Jika SSO digunakan:
    • Ayakaleaf Pro dapat dikonfigurasi untuk memperbarui nama depan dan nama belakang pengguna saat login berdasarkan sistem autentikasi.
    • Ketika OVERLEAF_SAML_UPDATE_USER_DETAILS_ON_LOGIN atau OVERLEAF_LDAP_UPDATE_USER_DETAILS_ON_LOGIN bernilai true, formulir detail pengguna di https://your-instance-url/user/settings dinonaktifkan dan nama depan/belakang hanya dapat diatur di sistem manajemen identitas Anda.
Untuk detail lebih lanjut, lihat:

Tanya Jawab

Jawaban: Tidak ada HTTP API untuk ini. Buat akun dengan skrip create-user di atas (tanpa --admin), atau di Admin → Manage Users dengan Create account. Jika EXTERNAL_AUTH diatur, formulir tersebut memiliki opsi Log in with SSO, yang membuat akun tanpa kata sandi lokal dan tanpa email atau tautan aktivasi: dialog tertutup setelah Create. Pada login LDAP, SAML, atau OIDC pertama, pengguna mendapatkan akun yang sudah ada dengan email yang sama alih-alih akun baru, lihat Akun dan kata sandi.
Jawaban: Tidak. Tidak ada ekspor atau impor akun pengguna, baik di Admin → Manage Users maupun sebagai skrip. Akun disimpan di MongoDB, jadi cadangkan dan pulihkan akun dengan cadangan MongoDB. Skrip export-user-projects.mjs mengekspor proyek pengguna sebagai file zip, bukan akunnya, lihat Mengekspor proyek.
Jawaban: Tautan yang ditampilkan oleh create-user berlaku selama 7 hari, dan tautan ini berfungsi tanpa SMTP karena Anda menyalinnya dari output. Untuk mendapatkan tautan baru, jalankan create-user lagi dengan email yang sama. Untuk akun yang sudah ada, perintah ini hanya menampilkan tautan baru, tetapi juga mengatur flag admin akun agar sesuai dengan --admin, jadi tetap sertakan --admin saat Anda menjalankannya untuk administrator.Admin juga dapat memperoleh tautan reset tanpa email: di Admin → Manage Users, klik ikon gembok di baris pengguna, lalu Send reset link, dan salin tautan dari dialog. Tautan berlaku selama 1 jam, lihat Mengirim tautan aktivasi atau reset.Atau atur kata sandi secara langsung: klik nama pengguna, lalu ikon pensil, masukkan New password minimal 8 karakter, dan klik Save. Akun yang hanya login melalui LDAP, SAML, atau OIDC tidak dapat memperoleh kata sandi dengan cara mana pun.

Terakhir diperbarui 4 bulan yang lalu Halaman dokumentasi ini berisi tautan ke panduan eksternal dan halaman konfigurasi. Semua tautan dan parameter kueri dipertahankan seperti pada konten aslinya.
Terakhir diubah pada 13 November 2026