osFoundry / Platform
Konfigurasi konektor
Sumber otoritatif untuk setiap koneksi — scope, secret, konfigurasi OAuth.
Apa itu
Konfigurasi konektor adalah bagian dari osFoundry Studio yang mendefinisikan dan menyimpan cara workspace-mu terhubung ke segala hal di luarnya: API, tool, dan layanan yang diakses oleh agen dan aplikasimu. Setiap konektor menyimpan gambaran lengkap satu koneksi dalam satu catatan otoritatif: konfigurasi klien OAuth-nya, scope persis yang boleh digunakan koneksi itu, endpoint yang diajaknya berkomunikasi, serta secret atau token yang dipakainya untuk autentikasi. Alih-alih menempelkan kredensial yang sama ke sebuah chat di sini, sebuah agen di sana, dan sebuah aplikasi di tempat lain, satu konfigurasi konektor menjadi satu-satunya tempat koneksi itu didefinisikan, dan semua hal di workspace merujuk padanya.
Karena osFoundry adalah workspace desktop yang local-first dan bring-your-own-key (BYOK), secret di dalam konfigurasi konektor adalah kunci dan token milikmu sendiri, bukan sesuatu yang disewa lewat reseller, dan bisa tetap berada di perangkatmu alih-alih menumpang di server orang lain. Ketika sebuah koneksi membutuhkan OAuth, konfigurasi konektor adalah tempat detail klien dan redirect diatur serta scope yang diberikan dicatat, sehingga kamu bisa melihat persis akses apa yang telah diberikan pada sebuah koneksi tanpa perlu menebak. Ketika sebuah token perlu dirotasi atau sebuah scope perlu dipersempit, kamu mengubahnya sekali di konfigurasi konektor dan setiap chat, agen, serta aplikasi yang memakai koneksi itu langsung mengikuti perubahannya.
Desain sumber tunggal itulah intinya. Koneksi cenderung berserakan: kunci berbeda untuk layanan yang sama, token yang terlupakan, izin yang tidak jelas. Penataan yang tersebar sekaligus menjadi beban pemeliharaan dan risiko keamanan. Menjaga scope, secret, dan konfigurasi OAuth tetap menyatu dalam satu catatan konektor berarti kamu selalu punya jawaban akurat atas pertanyaan apa yang terhubung, dengan akses apa, dan memakai kredensial yang mana, yang justru merupakan pertanyaan penting saat kamu mengaudit akses, menyerahkan workspace ke rekan tim, atau mencabut sesuatu dengan terburu-buru.
Kemampuan utama
- Definisikan setiap koneksi eksternal satu kali sebagai konfigurasi konektor, lalu rujuk dari chat, agen, atau aplikasi mana pun di workspace
- Simpan konfigurasi klien OAuth dan catat scope persis yang telah diberikan pada sebuah koneksi
- Simpan kunci API, token, dan secret secara local-first di perangkatmu dengan model bring-your-own-key, tanpa markup reseller
- Rotasi token atau persempit scope di satu tempat dan buat setiap pengguna koneksi itu mengikuti perubahannya
- Lihat sekilas apa yang terhubung, dengan kredensial apa, dan akses apa yang sebenarnya dimiliki tiap koneksi
Kasus penggunaan
- Developer solo: menghubungkan agen ke API pihak ketiga dengan satu konfigurasi konektor berisi scope yang tepat, alih-alih menempelkan kunci ke setiap prompt
- Team lead yang peduli privasi: menjaga seluruh secret workspace tetap di perangkat lewat konfigurasi konektor dan mengaudit scope OAuth yang diberikan sebelum membagikan akses
- Pengelola otomasi: merotasi token yang akan kedaluwarsa di satu konfigurasi konektor, dan setiap aplikasi serta agen yang bergantung pada koneksi itu tetap berjalan
Pertanyaan yang sering diajukan
Di mana secret dalam konfigurasi konektor sebenarnya disimpan?
osFoundry adalah workspace desktop yang local-first, jadi secret konektor, yaitu kunci API dan token milikmu sendiri di bawah model bring-your-own-key, bisa tetap berada di perangkatmu alih-alih di server hosting. Tidak ada reseller yang menyisip di antara kamu dan layanan yang kamu hubungi.
Apa saja isi konfigurasi konektor selain secret?
Konfigurasi konektor adalah catatan otoritatif untuk satu koneksi: konfigurasi klien OAuth-nya, scope spesifik yang diberikan padanya, endpoint yang diajaknya berkomunikasi, dan kredensial yang dipakainya untuk autentikasi. Menyatukan semuanya itulah yang membuatmu bisa melihat persis akses apa yang dimiliki sebuah koneksi.
Kalau aku mengubah sebuah koneksi, apakah harus memperbaruinya di setiap tempat yang memakainya?
Tidak. Karena semuanya merujuk pada satu konfigurasi konektor, memperbarui token atau menyesuaikan scope di sana akan mengalir ke setiap chat, agen, dan aplikasi yang memakai koneksi itu. Sumber kebenaran tunggal itulah alasan konfigurasi konektor ada, bukan menggandakan kredensial di tiap penggunaan.