Backend dan data
Rahasia dan kunci API
Simpan kunci pribadi yang dibutuhkan aplikasimu untuk berhubungan dengan layanan lain, jaga tetap aman, dan pahami bagaimana kunci itu sampai ke pratinjau dan aplikasimu yang sudah tayang.
Rahasia adalah nilai pribadi yang dibutuhkan aplikasimu, tapi tidak boleh dilihat orang lain. Biasanya berupa kunci API atau token: kode mirip kata sandi yang diberikan layanan seperti penyedia peta, cuaca, atau SMS supaya aplikasimu bisa memakainya.
Rahasia bukan bagian dari kode aplikasimu. Buildliy menyimpannya terpisah dalam keadaan terenkripsi, lalu memberikannya ke server aplikasimu saat aplikasi berjalan. Dengan begitu, rahasia tidak pernah muncul di kodemu, di GitHub, atau di halaman yang diunduh pengunjung.
Bagaimana rahasia dijaga tetap aman
- Terenkripsi saat disimpan. Buildliy mengenkripsi setiap rahasia sebelum menyimpannya.
- Hanya untuk server. Hanya kode server aplikasimu yang bisa membaca rahasia. Rahasia tidak pernah dikirim ke browser pengunjung.
- Tidak pernah ditampilkan lagi. Setelah kamu menyimpan rahasia, kamu tidak bisa melihat nilainya lagi, hanya bisa menggantinya.
- Hanya untuk pemilik. Hanya pemilik proyek yang bisa melihat dan mengubah rahasia di Kelola → Rahasia. Anggota tim bisa menjawab kartu kunci dari AI di aplikasi bersama, tapi tidak bisa mengganti kunci yang sudah disimpan orang lain.
Saat AI meminta kunci
Kalau fitur yang kamu minta butuh kunci, AI berhenti sebentar dan menampilkan kartu di chat. Ada dua jenis.
Kartu Hubungkan, untuk layanan yang ada di daftar Konektor Buildliy, seperti Resend, Twilio, Airtable, atau SendGrid. Klik Hubungkan diikuti nama layanannya untuk menambahkan kuncimu. Buildliy memeriksa dulu apakah kuncinya berfungsi di layanan itu sebelum menyimpannya, menjaganya tetap terenkripsi, dan menyimpannya di akunmu supaya bisa kamu pakai juga di aplikasi-aplikasimu yang lain. Begitu terhubung, AI melanjutkan pembuatan. Kalau kamu pernah menghubungkan layanan itu tapi belum diaktifkan untuk aplikasi ini, tombolnya bertuliskan Lanjutkan dengan diikuti nama layanannya. Kalau layanan sudah terhubung dan aktif untuk aplikasi ini, AI langsung memakainya dan kamu tidak melihat kartu. Lewati dulu menutup kartu tanpa menghubungkan apa pun: AI membalas bahwa kamu bisa menghubungkan layanannya kapan saja dari halaman Konektor, lalu menunggu pesanmu berikutnya. Lihat Konektor.
Kartu kunci, untuk kunci jenis lain. Kartu ini menampilkan pertanyaan dari AI, nama yang akan dipakai untuk kunci itu di Disimpan sebagai (misalnya WEATHER_API_KEY), dan kotak untuk menempelkan kuncinya.
Ambil kunci dari layanannya
Masuk ke situs web layanannya dan salin kunci API kamu. Pertanyaan di kartu biasanya menjelaskan kunci itu untuk apa.
Tempelkan ke kartu
Tempelkan kunci ke dalam kotak. Klik ikon mata kalau kamu ingin memeriksa apa yang kamu tempel, lalu sembunyikan lagi sebelum kamu membagikan layarmu.
Klik Simpan
Kunci disimpan dalam keadaan terenkripsi. Seperti tertulis di kartu: "Tersimpan dengan aman dan terenkripsi. Tidak pernah muncul di chat atau di kode aplikasimu. Kamu bisa mengubahnya nanti di Kelola → Rahasia." (Anggota tim melihat "Pemilik proyek bisa mengubahnya nanti.") Setelah itu AI lanjut membuat aplikasimu dengan kunci tersebut.
Kalau kamu klik Lewati, tidak ada yang disimpan dan AI lanjut tanpa kunci itu. Fitur yang membutuhkannya tidak akan berfungsi sampai kamu menambahkan kuncinya di Kelola → Rahasia.
Menerima pembayaran diatur dengan cara yang berbeda. Lihat Terima pembayaran.
Jangan tempel kunci ke chat
Semua yang kamu ketik di kotak chat tersimpan di percakapanmu dan dibaca oleh AI, dan tidak disembunyikan atau dienkripsi seperti rahasia. Selalu pakai kartu kunci atau Kelola → Rahasia.
Kalau kamu tidak sengaja menempel kunci
Buildliy memantau kotak chat untuk mencari kunci rahasia, seperti kunci rahasia Stripe, token GitHub, atau alamat database beserta kata sandinya. Pesan yang berisi kunci tidak dikirim. Sebagai gantinya, kartu berjudul Ini sepertinya kunci rahasia muncul di atas kotak chat, begitu kamu menempel kuncinya atau menekan kirim. Kartu itu menampilkan jenis kuncinya, dengan sebagian besar isinya disembunyikan, dan menawarkan:
- Simpan sebagai rahasia: menyimpannya di Kelola → Rahasia dengan nama yang ada di Simpan sebagai, misalnya
STRIPE_SECRET_KEY. Kamu bisa mengubah namanya. Kalau kuncinya milik layanan yang ada di daftar Konektor, kamu bisa memilih antara Simpan sebagai konektor … kamu (Buildliy memeriksa apakah kuncinya berfungsi dan menyimpannya di akunmu, jadi aplikasimu yang lain juga bisa memakainya) dan Simpan sebagai rahasia untuk aplikasi ini. Di ruang kerja bersama, kamu perlu mencentang kotak dulu untuk memastikan bahwa anggota tim yang membuat di aplikasi ini boleh memakai koneksinya. - Ubah pesan: menaruh kursormu di kuncinya supaya bisa kamu hapus. Selama kunci masih ada di dalamnya, pesan tetap tidak akan terkirim.
- Ini bukan kunci — kirim saja: mengirim pesanmu apa adanya, untuk saat-saat langka ketika kartunya keliru.
Setelah tersimpan, kunci di pesanmu berubah menjadi [saved as STRIPE_SECRET_KEY], sehingga kamu bisa mengirim bagian pesan lainnya dengan aman. Hanya pemilik proyek yang bisa menyimpannya: anggota tim melihat Hapus kuncinya, dan kartu meminta mereka agar pemilik menambahkannya di Kelola → Rahasia. Di halaman beranda, sebelum aplikasimu ada, kartu menawarkan untuk mengeluarkan kuncinya dulu.
Kunci yang memang dimaksudkan untuk publik, seperti kunci publishable Stripe (pk_…), tidak ditandai. Kalau kamu melampirkan file Word, Excel, atau teks yang berisi kunci rahasia, kuncinya disembunyikan dari AI.
Kalau sebuah kunci terlanjur terkirim di chat, anggap kunci itu sudah bocor. Buka situs web layanannya, buat kunci baru dan hapus yang lama, lalu simpan kunci baru itu di Kelola → Rahasia.
Tambah, ubah, atau hapus rahasia sendiri
Buka Rahasia
Buka tab Kelola dan pilih Rahasia.
Isi Tambah rahasia baru
Di bawah Tambah rahasia baru, isi Nama dengan huruf kapital dan garis bawah, seperti
WEATHER_API_KEY, lalu Nilai, dan Deskripsi (boleh dikosongkan) supaya kamu ingat rahasia itu untuk apa.Simpan
Klik Simpan. Rahasianya muncul di bawah Rahasia tersimpan.
Namanya harus sama dengan yang dipakai kode aplikasimu. Kalau kamu tidak yakin, tanyakan ke AI nama apa yang dia harapkan.
Widget cuaca membaca kuncinya dari rahasia dengan nama apa?
- Ubah rahasia. Klik ikon panah melingkar (Ganti rahasia ini), tempel nilai barunya, lalu klik Ganti. Di layar yang lebih lebar, kolom Pergantian menghitung berapa kali sebuah rahasia sudah diganti.
- Simpan dengan nama yang sudah ada. Menyimpan rahasia dengan nama yang sudah tersimpan akan menggantikan nilai lamanya. Buildliy bertanya dulu: pratinjaumu langsung beralih ke nilai yang baru, sedangkan aplikasimu yang sudah terbit tetap memakai yang lama sampai kamu menerbitkannya lagi. Kamu memilih Pakai yang lama atau Ganti.
- Hapus rahasia. Klik ikon tempat sampah (Hapus rahasia ini) dan konfirmasi. Aplikasimu tidak bisa lagi memakainya: pratinjaumu langsung, dan aplikasimu yang sudah terbit saat kamu menerbitkannya berikutnya.
Rahasia di pratinjau dan di aplikasimu yang sudah tayang
- Pratinjaumu otomatis menerima rahasia yang baru, diubah, atau dihapus. Kamu tidak perlu membuat ulang.
- Aplikasimu yang sudah terbit menerima rahasianya saat kamu menerbitkan. Setelah mengubah rahasia, terbitkan lagi supaya situs live kamu memakai nilai yang baru. Saat aplikasimu sudah tayang, pesan yang kamu lihat setelah melakukan perubahan di Kelola → Rahasia, atau setelah menyimpan kunci dari kartu di chat, mengingatkanmu untuk menerbitkan ulang.
Rahasia dan konektor
Keduanya menyimpan kunci dengan aman. Bedanya ada pada tempat penyimpanan dan siapa yang bisa memakainya.
| Konektor | Rahasia | |
|---|---|---|
| Tempat penyimpanan | Di akun Buildliy kamu | Di satu aplikasi |
| Dipakai oleh | Semua aplikasimu sendiri secara bawaan (matikan untuk satu aplikasi di Kelola → Konektor); aplikasi yang dibagikan ke timmu hanya setelah kamu mengaktifkannya di sana | Hanya aplikasi ini |
| Diperiksa sebelum disimpan | Ya, Buildliy menguji kunci dengan layanannya | Tidak |
| Paling cocok untuk | Layanan di daftar Konektor yang kamu pakai di beberapa aplikasi | Kunci jenis lain, atau kunci yang berbeda untuk satu aplikasi saja |
Kalau rahasia dan konektor punya nama yang sama, rahasia yang dipakai untuk aplikasi itu. Ini cara mudah untuk memakai kunci yang berbeda di satu aplikasi.
Kunci yang ditambahkan Buildliy untukmu
Beberapa fitur menambahkan rahasia untukmu. Kalau aplikasimu memakai AI di aplikasimu, kamu akan melihat BUILDLIY_API_KEY dan BUILDLIY_API_URL. Kalau aplikasimu menerima pembayaran, kamu akan melihat BUILDLIY_API_KEY dan BUILDLIY_WEBHOOK_SECRET. Kalau aplikasimu memungkinkan pengunjung mengunggah file atau melaporkan errornya, kamu akan melihat BUILDLIY_API_KEY dan BUILDLIY_API_URL. Kalau aplikasimu punya tugas terjadwal, kamu akan melihat BUILDLIY_CRON_SECRET. Jangan ubah atau hapus kunci-kunci ini, karena fitur-fitur tersebut akan berhenti berfungsi.
Terkait
Masih bingung? Baca FAQ atau hubungi kami.