Secrets: kunci yang dibutuhkan kode situs Anda

#Apa itu secret

Secret adalah nilai yang diberi nama. Nilainya biasanya berupa kunci API: kata sandi yang dipakai satu program untuk berbicara dengan program lain, seperti kunci yang diberikan layanan surat. Namanya adalah cara kode situs Anda memintanya, misalnya MAILING_LIST_KEY.

Bagian situs Anda yang membaca rahasia berjalan di server, di balik rute-rutenya (alamat di bawah /api/ yang menjalankan kode, bukan menampilkan halaman). Nilainya tetap di sana. Nilai itu tidak ada di halaman situs, tidak dikirim ke browser pengunjung, dan tidak ada di kode yang dapat Anda unduh.

Setelah disimpan, sebuah nilai tidak akan pernah bisa ditampilkan lagi oleh siapa pun, termasuk Anda. Studio hanya menyimpan nama, siapa yang menyimpan, dan kapan. Simpan salinan Anda sendiri di tempat aman, misalnya pengelola kata sandi.

Anda hanya membutuhkan secret saat kode situs Anda sendiri bekerja dengan sesuatu yang memerlukan kunci. Situs brosur dengan formulir kontak tidak memerlukannya.

#Sebelum Anda mulai

• Publikasikan situs satu kali. Rahasia hanya disimpan di situs yang dipublikasikan, tidak pernah oleh studio. Sebelum publikasi pertama, halaman menampilkan Publish the site first dan belum ada yang bisa ditambahkan.
• Periksa peran Anda. Editor, Admin, dan Owner dapat menambah, mengubah, dan menghapus secret. Viewer melihat nama dan waktu penyimpanan masing-masing.
• Pilih nama. Huruf, angka, dan garis bawah, diawali huruf, hingga 128 karakter. Huruf kapital dengan garis bawah adalah gaya yang lazim. Nama yang diawali BRIKS_ disediakan untuk studio.
• Perhatikan batasnya. Satu nilai bisa sampai 5 KB, cukup untuk kunci atau sertifikat apa pun. Satu proyek menampung hingga 100 secret, termasuk milik studio itu sendiri.

#Tambah rahasia

#Impor beberapa sekaligus dari file .env

File .env adalah file teks biasa berisi baris NAME=value, satu baris untuk setiap rahasia. Pengembang sering menyimpannya. Jika Anda punya, Anda bisa memasukkan semua barisnya sekaligus.

#Mengubah atau menghapus secret

Perubahan langsung sampai ke situs live: Anda akan melihat The live site has it now, atau untuk penghapusan, The live site no longer has it. Jika rahasianya banyak, kotak Search secrets membantu menemukan satu rahasia berdasarkan namanya. Tabel menampilkan Name dan Last saved setiap rahasia, beserta siapa yang menyimpannya.

Beberapa baris memiliki tag Managed. Studio mengaturnya untuk layanannya sendiri, seperti email situs, dan baris itu tidak bisa diubah atau dihapus di sini.

#Cara build menggunakan secret

Kode situs Anda membaca rahasia berdasarkan namanya setiap kali dijalankan, jadi sebuah build tidak pernah membutuhkan nilainya. Saat Anda meminta studio menghubungkan situs ke layanan lain, seperti daftar surel atau model AI, kodenya membaca kunci layanan itu dengan nama yang jelas, seperti MAILING_LIST_KEY. Anda menambahkan nilainya di sini, dengan nama tersebut.

#Diminta kunci sebelum build

• Perubahan pada situs yang sudah dipublikasikan. Saat permintaan Anda menghubungkan layanan lain, status menampilkan Checking which keys this needs sejenak. Jika situs belum memiliki nilai untuk sebuah kunci, studio bertanya sebelum membuat. Kartu di percakapan memiliki kolom untuk setiap kunci, hingga 3 untuk satu perubahan. Tempel nilainya dan tekan Save and build: nilai itu langsung masuk ke Secrets situs, tidak pernah ke percakapan, dan perubahan dimulai. Tekan Add it later untuk membuat tanpa nilai itu.
• Pesan yang dikirim saat menunggu ikut masuk ke perubahan. Kunci yang sudah Anda simpan atau yang Anda pilih untuk ditambahkan nanti tidak akan ditanyakan lagi: jika pesan baru Anda menghubungkan layanan lain, hanya kuncinya yang ditanyakan, setelah kartu pertama selesai.
• Situs baru. Secrets membutuhkan situs yang sudah dipublikasikan, jadi build pertama belum bisa menerima kunci. Di antara pertanyaannya sebelum membangun, agen bisa menanyakan apakah koneksi dibangun sekarang dan kunci ditambahkan setelah situs live, atau bagian itu ditinggalkan dulu.
• Di Telegram, kartu memiliki tombol untuk setiap kunci yang membuka Secrets di studio, dan Build untuk melanjutkan. Kunci tidak pernah dikirim lewat chat.

#Dibutuhkan oleh situs

Setelah setiap publikasi, Briks membaca nama secret apa saja yang diminta kode situs itu sendiri. Yang belum memiliki nilai ditampilkan paling atas di halaman ini, dengan tag Needed by the site. Tekan Add value pada salah satunya dan formulir terbuka dengan namanya sudah terisi. Selama sebuah nama belum memiliki nilai, bagian situs yang memakainya tidak berfungsi.

Balasan untuk pembuatan atau perubahan juga menyebutkan namanya, misalnya: Situs membaca MAILING_LIST_KEY, yang belum memiliki nilai: tambahkan di Project Settings → Secrets. Setiap nama punya tombolnya sendiri, seperti Add MAILING_LIST_KEY, yang membuka halaman ini dengan nama yang sudah terisi. Kalimat yang sama muncul di notifikasi, dan di Telegram saat memberi tahu Anda bahwa pembuatan selesai.

#Kunci yang ditempel di pesan

Briks mengenali bentuk umum kunci dan token layanan. Kunci yang ditempel di chat studio, deskripsi proyek baru, brief proyek, pesan ke agen atau instruksinya, Ask AI di Visual Editor, atau chat dengan bot akan dihapus sebelum pesan disimpan atau dibaca, lalu diganti dengan [key removed: add it in Settings → Secrets]. Studio langsung memberi tahu: A key was removed from your message so it isn't stored. Add it in Project Settings → Secrets. Balasannya memiliki tombol Open Secrets menuju halaman ini. Di utas agen yang bekerja di setiap proyek, Open Secrets menampilkan daftar proyek Anda agar Anda bisa memilih proyek yang membutuhkan kunci itu. Sesuatu yang harus diingat agen akan ditolak jika berisi kunci.

Sebelum situs dipublikasikan, Briks membaca kodenya sendiri untuk mencari kunci yang tertulis di dalam file: nilai yang tampak seperti kunci dari bentuknya, dan nilai yang diberikan pada apa pun yang bernama seperti key, token, atau password. Jika menemukannya, build dikembalikan agar nilai tersebut dihapus dan rahasianya dibaca lewat nama.

#Aturan keamanan yang diterapkan Briks

• Nilai dikirim langsung ke sisi server situs yang dipublikasikan, dalam keadaan terenkripsi. Studio tidak pernah menyimpannya, tidak menampilkannya lagi, dan tidak menuliskannya ke lognya.
• Nilainya tidak pernah muncul di halaman situs, di browser pengunjung, atau di kode yang Anda unduh.
• Hanya Editor, Admin, dan Owner yang dapat menambah, mengubah, atau menghapus secret.
• Nama yang diawali BRIKS_ milik studio, dan secret terkelola tidak dapat diubah.
• Satu proyek dapat melakukan hingga 60 perubahan pada secret-nya per menit. Lewat dari itu Anda akan melihat: That is a lot of changes at once. Wait a minute and try again.

#Saat sebuah rahasia hilang

Secret terikat pada alamat situs. Jika Anda mengubah alamat (lihat Alamat situs Anda), secret tetap berada pada alamat lama. Pesan studio mencantumkannya dan meminta Anda memasukkannya lagi di Settings, Secrets, dan setiap baris menampilkan Not on the site · enter again. Pilih Edit value pada masing-masing, lalu tempel nilainya.

Jika kode situs meminta rahasia yang tidak ada, bagian situs tersebut menjawab: Part of this site is not set up yet. Periksa bahwa namanya cocok persis, termasuk huruf kapital, dan bahwa barisnya tidak bertuliskan Not on the site.

#Contoh kasus: mengganti kunci yang bocor

Baru setelah itu mereka menghapus kunci lama di layanan email massal, sehingga situs tidak pernah sedetik pun tanpa kunci yang berfungsi. Tidak ada yang perlu dibangun ulang, karena kode meminta kunci dengan namanya.