Onboarding (Aplikasi macOS)

​

Onboarding (Aplikasi macOS)

Dokumen ini mendeskripsikan alur onboarding penggunaan pertama kali yang saat ini berlaku. Tujuannya adalah memberikan pengalaman “hari ke-0” yang lancar: memilih tempat Gateway dijalankan, menghubungkan autentikasi, menjalankan wizard, dan membiarkan agen melakukan bootstrap pada dirinya sendiri. Untuk ringkasan umum mengenai jalur onboarding lainnya, lihat Ringkasan Onboarding.

1. Setujui peringatan macOS

   
2. Setujui izin untuk menemukan jaringan lokal

   
3. Selamat datang dan pemberitahuan keamanan

   
4. Lokal vs Jarak Jauh (Remote)

   

   Di mana Gateway dijalankan?

   • Mac ini (Lokal saja): onboarding dapat menjalankan alur OAuth dan menulis kredensial secara lokal.
   • Jarak Jauh/Remote (melalui SSH/Tailnet): onboarding tidak menjalankan OAuth secara lokal; kredensial harus sudah ada di host gateway.
   • Konfigurasi nanti: lewati pengaturan dan biarkan aplikasi tidak terkonfigurasi.

   Tip autentikasi Gateway:

   • Wizard kini membuat token bahkan untuk loopback, sehingga klien WS lokal harus melakukan autentikasi.
   • Jika Anda menonaktifkan autentikasi, proses lokal apa pun dapat terhubung; gunakan ini hanya pada mesin yang sepenuhnya Anda percayai.
   • Gunakan token untuk akses multi-mesin atau bind non-loopback.
5. Izin (Permissions)

   

   Onboarding meminta izin TCC yang diperlukan untuk:

   • Otomatisasi (AppleScript)
   • Notifikasi
   • Aksesibilitas
   • Perekaman Layar
   • Mikrofon
   • Pengenalan Ucapan
   • Kamera
   • Lokasi
6. CLI

7. Chat Onboarding (sesi khusus)

   Setelah pengaturan, aplikasi akan membuka sesi chat onboarding khusus sehingga agen dapat memperkenalkan dirinya dan memandu langkah-langkah selanjutnya. Hal ini menjaga agar panduan penggunaan pertama kali terpisah dari percakapan normal Anda. Lihat Bootstrapping untuk mengetahui apa yang terjadi pada host gateway selama pemuatan agen pertama kali.