--- title: "Secrets: kunci yang dibutuhkan kode situs Anda | Briks" url: https://briks.dev/id/docs/secrets description: "Simpan kunci API dan kata sandi untuk kode situs di server situs, bukan di halaman atau unduhan. Tambah, ubah, hapus, dan aturan yang Briks terapkan." last_updated: 2026-10-08 --- # Secrets: kunci yang dibutuhkan kode situs Anda Beberapa fitur memerlukan kunci, token, atau kata sandi untuk layanan lain. Secrets adalah tempat Anda menyimpan nilai-nilai itu, sehingga kode situs Anda dapat memakainya tanpa nilainya pernah tampil di halaman, file, atau studio. Halaman ini membahas cara menambah, mengubah, dan menghapusnya, serta aturan yang dipegang Briks. Baca 8 menit Dicocokkan dengan studio pada 8 Oktober 2026 ## 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. Di mana 1. Projects 2. Your project 3. Settings 4. Secrets ## 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 1. Tekan Add secret Di mana: Settings, Secrets Selama belum ada secret, tombol berada di tengah halaman. Setelah Anda punya, tombol ada di samping kotak pencarian di atas daftar. 2. Ketik namanya Di mana: Add a secret Masukkan di **Name**, persis seperti yang diminta fitur tersebut. Nama membedakan huruf besar dan kecil, jadi `MAILING_LIST_KEY` dan `Mailing_List_Key` adalah secret yang berbeda. 3. Tempel nilainya Di mana: Add a secret Tempel kunci ke **Value**. Dialog akan mengingatkan Anda: Once saved, the value is never shown again. Simpan salinan sendiri jika Anda membutuhkannya. 4. Simpan Di mana: Add a secret Tekan **Add secret**. Anda akan melihat, misalnya: MAILING\_LIST\_KEY was added. Situs yang tayang sudah memilikinya. ## 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. 1. Tekan Import .env Di mana: Settings, Secrets Dialog **Import a .env file** terbuka. 2. Berikan barisnya Di mana: Import a .env file Tempel baris-barisnya ke dalam kotak, jatuhkan file ke atasnya, atau tekan **Choose a file**. Ukuran file bisa sampai 256 KB. 3. Periksa pratinjau Di mana: Import a .env file Setiap nama diberi label **New**, atau **Replaces** jika rahasia dengan nama itu sudah ada dan akan menerima nilai baru. Baris yang tidak dapat dipakai dicantumkan sebagai dilewati, masing-masing dengan alasannya. 4. Impor Di mana: Import a .env file Tekan tombol impor, yang menghitung apa yang akan disimpan, seperti **Import 3 secrets**. Tidak ada yang disimpan sebelum Anda menekannya. ## Mengubah atau menghapus secret 1. Beri nilai baru Di mana: Settings, Secrets Buka tiga titik pada barisnya dan pilih **Edit value**. Dialognya berbunyi: The new value replaces the old one, which is never shown. Tempel nilai baru lalu tekan **Save value**. 2. Atau hapus Di mana: Settings, Secrets Pilih **Delete** sebagai gantinya. Dialog memperingatkan: Code on the site that reads it stops finding it. This cannot be undone. Tekan **Delete** untuk mengonfirmasi. 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](https://briks.dev/id/docs/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. Jangan pernah menempelkan kunci ke chat Kunci dengan bentuk yang tidak dikenali Briks tetap berada di dalam pesan, dan semua yang Anda ketik di chat studio disimpan dalam percakapan proyek. Simpan kunci di **Secrets** dan rujuk hanya dengan namanya. Hal yang sama berlaku untuk File Explorer: jangan mengetik kunci ke dalam file. 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](https://briks.dev/id/docs/site-address)), 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 Apa yang terjadi Seorang florist di Cork > Layanan surat mereka memperingatkan bahwa kunci yang disimpan sebagai `MAILING_LIST_KEY` muncul di utas email lama. Mereka membuat kunci baru di layanan surat itu, membuka **Settings**, **Secrets**, memilih **Edit value** pada `MAILING_LIST_KEY`, menempelkan kunci baru, lalu menekan **Save value**. MAILING\_LIST\_KEY sudah memiliki nilai barunya. Situs yang aktif kini memakainya. 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. ### Bisakah saya melihat nilai sebuah secret nanti? Tidak. Bukan Anda, bukan rekan tim, bukan Briks. Simpan salinan Anda sendiri saat menyimpannya. ### Apakah menambahkan secret mengubah situs saya dengan sendirinya? Tidak. Rahasia tidak berfungsi sampai kode situs membacanya dengan namanya. Minta studio membuatkan fitur yang menggunakannya. ### Apakah rahasia (secret) ada di kode yang saya unduh? Tidak. File unduhan berisi file milik situs itu sendiri, dan kunci tidak pernah ditulis ke dalamnya. ### Mengapa saya tidak bisa menambahkannya? Situs belum diterbitkan, atau peran Anda adalah Viewer. Halaman itu menjelaskan yang mana. ## Baca selanjutnya - [Mengerjakan proyek **Kode situs Anda** Telusuri, edit, dan publikasikan kode website Anda di File Explorer di semua paket. Paket berbayar: unduh zip versi apa pun, lihat yang tidak disertakan.](https://briks.dev/id/docs/code) - [Penerbitan dan domain **Alamat situs Anda** Setiap situs Briks mendapat alamat di briks.live. Cara nama dipilih, aturan bagi nama baru, cara mengubahnya, dan apa yang terjadi pada nama lama.](https://briks.dev/id/docs/site-address) - [Ruang kerja dan akun **Anggota dan peran** Undang orang lewat tautan email, beri tiap orang peran: Owner, Admin, Editor atau Viewer. Lihat hak akses tiap peran dan jumlah orang per paket.](https://briks.dev/id/docs/members-and-roles) - [Data dan otomatisasi **Log** Baca log build dan permintaan situs Anda sehari terakhir, saring menurut level atau status, lalu lacak formulir atau tugas yang gagal, atau halaman lambat.](https://briks.dev/id/docs/logs) Masih buntu? Tulis ke [hello@briks.dev](mailto:hello@briks.dev) dengan nama proyek Anda dan apa yang Anda harapkan terlihat. Tangkapan layar akan membantu.