Memasangkan klien desktop dengan akun Anda

Ikhtisar

Agar klien Whisperer macOS dapat bekerja dengan sesi, langganan, dan basis pengetahuan Anda, Anda perlu memasangkannya dengan akun Anda satu kali. Memasang aplikasi saja tidak memberikan akses — perangkat perlu diotorisasi (otorisasi perangkat).

Pemasangan dibangun di atas alur kode sekali pakai yang aman: aplikasi memulai proses masuk, Anda melakukan autentikasi di browser, menerima kode sekali pakai, dan browser mengembalikan Anda ke aplikasi. Kode tersebut bersifat sekali pakai dan berlaku selama 30 menit.

Kapan digunakan

  • Tepat setelah memasang klien dan menyelesaikan wizard izin.
  • Saat masuk di komputer baru atau yang dipasang ulang.
  • Saat aplikasi berhenti mengenali akun Anda (Anda keluar dari semua perangkat, mengubah kata sandi, dll.) dan perlu dipasangkan kembali.

Langkah demi langkah

  1. Mulai proses masuk di aplikasi. Buka Whisperer di Mac Anda dan mulai proses masuk/pemasangan. Aplikasi meminta kode sekali pakai dari server (POST /v1/auth/desktop/code) dan membuka halaman web pemasangan di browser Anda — /app/connect.
  2. Masuk ke akun Anda di browser. Di halaman /app/connect, masuk dengan e-mail dan kata sandi Anda. Jika Anda belum memiliki akun — daftar dan konfirmasikan e-mail Anda (lihat Registrasi dan masuk). Masuk tidak dapat dilakukan sampai e-mail Anda dikonfirmasi.
  3. Konfirmasikan pemasangan perangkat. Setelah masuk, dasbor web menautkan kode sekali pakai ke akun Anda.
  4. Kembali ke aplikasi. Browser secara otomatis mengarahkan Anda kembali ke Whisperer melalui skema whisperer://auth?code=...&state=.... Jika muncul perintah sistem "Buka di Whisperer?" — konfirmasikan.
  5. Tunggu pertukaran kode menjadi token. Aplikasi menukar kode sekali pakai dengan token akses dan menyimpannya di penyimpanan aman (terenkripsi). Setelah itu, klien terpasang dengan akun Anda.
  6. Verifikasi. Pastikan aplikasi menampilkan akun dan paket Anda. Sekarang Anda dapat memulai sesi.

Tangkapan layar

📸 [Tangkapan layar: layar pemulaian proses masuk di klien macOS]

📸 [Tangkapan layar: halaman web /app/connect dengan formulir masuk]

📸 [Tangkapan layar: perintah sistem macOS "Buka di Whisperer?" (skema whisperer://)]

Kesalahan umum

  • Kode kedaluwarsa. Kode sekali pakai berlaku selama 30 menit. Jika Anda terlalu lama atau terganggu, pemasangan tidak akan selesai. Solusi: kembali ke aplikasi dan mulai proses masuk lagi — kode baru akan diterbitkan.
  • Browser tidak kembali ke aplikasi. Jika pengalihan skema whisperer:// tidak berjalan secara otomatis, pastikan Whisperer terpasang di folder "Applications" dan ulangi proses masuk. Saat muncul perintah sistem untuk membuka aplikasi — konfirmasikan.
  • Masuk gagal — e-mail belum dikonfirmasi. Anda tidak dapat masuk sampai e-mail Anda dikonfirmasi dengan kode 6 digit. Konfirmasikan e-mail Anda dan coba lagi.
  • Beberapa tab /app/connect. Membuka beberapa halaman pemasangan sekaligus merusak alur. Tutup tab tambahan dan jalankan pemasangan lagi dari aplikasi.
  • Akun dibekukan atau diblokir. Jika status akun adalah frozen/banned, pemasangan tidak akan selesai — hubungi dukungan.

Praktik terbaik

  • Jalankan pemasangan tepat setelah instalasi, tanpa penundaan — dengan begitu Anda akan dengan nyaman berada dalam batas waktu TTL 30 menit kode.
  • Buka halaman /app/connect hanya di satu tab.
  • Jika Anda mengubah kata sandi atau keluar dari semua perangkat, pasangkan klien lagi — token lama dibatalkan (token_version).
  • Jangan memasukkan kode sekali pakai secara manual dan jangan membagikan tautan whisperer://auth?... — itu adalah rahasia untuk perangkat Anda.

Artikel terkait