# Autentikasi, izin, dan kredensial aman

URL kanonis: https://sosoapi.ai/id/docs/authentication

Masuk dengan OAuth untuk agen, gunakan token akses pribadi di server Anda, dan pilih izin yang diperlukan setiap pemanggil.

## Pilih kredensial untuk pemanggil

Untuk agen, gunakan OAuth browser: pengguna masuk dan memilih akses, lalu CLI menyimpan dan memperbarui kredensialnya. Untuk skrip backend atau tugas CI, berikan token akses pribadi melalui VICKY_API_KEY. Jauhkan kredensial dari kode browser, repositori publik, prompt, screenshot, dan log bersama.

Contoh HTTP menggunakan SOSOAPI_ACCESS_TOKEN sebagai variabel lingkungan sisi server untuk nilai Bearer. Ini variabel contoh, bukan pengaturan CLI. Periksa kredensial yang tercantum untuk setiap operasi; token akses pribadi tidak dapat mengelola kunci API.

```
npx sosoapi auth login
```

```
npx sosoapi auth status
```

```
npx sosoapi auth logout
```

- [Referensi API lengkap](https://sosoapi.ai/id/docs/api)

## Cakupan dan kemampuan

Setiap permintaan memeriksa keanggotaan ruang kerja dan peran yang diperlukan operasi. OAuth terdelegasi juga membatasi akses pada ruang kerja dan kemampuan yang dipilih pengguna. agent:operate mencakup pembacaan dan persiapan, agent:publish mencakup penjadwalan dan publikasi, serta agent:engage mencakup penulisan komunitas. Mengelola kunci API memerlukan izin terpisah.

Token akses pribadi dibatasi oleh peran pemilik serta batas kemampuan atau ruang kerja yang tersimpan. Pilih hanya akses yang diperlukan integrasi; menghilangkan batas opsional dapat memberi kunci akses luas. Profil core dan full mengubah daftar alat yang terlihat, bukan izin. Akses publikasi berlanjut dalam cakupan yang diberikan tanpa persetujuan browser baru untuk setiap postingan.

## Penyimpanan dan pencabutan kredensial

CLI menyimpan kredensial dalam keychain sistem operasi jika tersedia, atau dalam file lokal yang hanya dapat dibaca pemiliknya. Token akses OAuth berlaku satu jam dan diperbarui oleh alur masuk. Gunakan auth status untuk mendiagnosis koneksi alih-alih menyalin file kredensial.

Cabut perangkat atau otorisasi di Pengaturan → Agents & API Access, atau jalankan auth logout untuk keluar dari perangkat lokal saat ini. Ini menghentikan akses berikutnya. Tidak mengurungkan postingan yang dipublikasikan atau membatalkan jadwal yang diterima SosoAPI; periksa dan kelola secara terpisah.

## Endpoint inisialisasi autentikasi

Keempat endpoint agent-auth mendokumentasikan protokol masuk. Gunakan CLI atau klien OAuth jarak jauh yang didukung untuk masuk; endpoint ini tidak tersedia melalui api post. Config, request, session, dan revoke-current menerima kredensial serta kolom berbeda. Ikuti skema setiap endpoint dan jauhkan kredensial sesi dari output serta log.

- [Referensi endpoint autentikasi](https://sosoapi.ai/id/docs/api)