Artikel mendalam tentang teknologi yang membentuk masa depan.

Kebocoran Secret Agen AI: Scanning vs Containment

Kebocoran secret agen AI coding lewat allowlist 'Don't ask again': bandingkan secret scanning vs containment dan guardrail agar kredensial tidak ikut ter-commit.

Papan sakelar mekanis dengan satu tuas berlabel posisi yang mengarahkan kabel bercahaya, sebagian cahayanya tumpah keluar dari panel
Permission allowlist terasa seperti kontrol, tapi diam-diam mengarsipkan setiap perintah yang pernah Anda setujui, termasuk secret di dalamnya.

Peneliti keamanan baru saja menemukan password, token API, dan kredensial cloud yang tersimpan di lebih dari seribu file GitHub publik. Bukan di file .env yang berantakan, tapi di pengaturan agen coding AI. Biang keroknya adalah pola senyap di balik kebocoran secret agen AI coding: developer menyetujui perintah seperti curl -H "Authorization: Bearer sk-...", klik "Don't ask again", dan seluruh perintah, termasuk token-nya, ditulis ke file pengaturan lokal. Commit file itu, dan secret-nya sudah publik. Saya sudah bertahun-tahun menggeluti keamanan infrastruktur, dan ini salah satu kelas kebocoran yang paling mudah dihindari yang pernah saya lihat. Sekaligus ini kelas yang benar-benar baru, karena file yang membocorkannya tidak ada dua tahun lalu.

Dua pertahanan yang biasa dipakai tim adalah secret scanning (deteksi kebocoran, lalu bersih-bersih) dan containment (pastikan secret tidak pernah menyentuh agen atau repo sejak awal). Keduanya perlu. Tapi tidak ada yang cukup kalau berdiri sendiri. Tulisan ini membandingkan keduanya secara langsung, kapan masing-masing menang dan di mana masing-masing gagal, lalu ditutup dengan apa yang benar-benar akan saya terapkan di tim yang memakai Claude Code, Cursor, atau agen apa pun dengan permission allowlist.

Satu hal yang perlu diluruskan dulu: ini bukan argumen menentang tool agentic coding. Saya memakainya setiap hari dan tidak akan kembali. Permission prompt, yaitu saat agen bertanya "boleh saya jalankan ini?", adalah salah satu mekanisme keamanan terbaik yang dikirim tool-tool ini. Masalahnya ada pada apa yang terjadi setelah Anda bilang "ya": di mana jawaban "ya" itu dicatat, dan apa saja isinya.

Bagaimana Allowlist Berubah Jadi Penyimpan Secret

Untuk memahami mode kegagalannya, perlu dilihat dulu apa yang sebenarnya disimpan oleh "Don't ask again". Saat CLI agentic meminta izin menjalankan perintah, implementasi naif menyimpan seluruh string perintah di aturan permission. Bukan pola. Bukan hash. String literal yang Anda setujui.

Jadi saat developer menyetujui aws s3 cp s3://bucket/backup.sql . --profile prod, itu tidak masalah. Tapi kalau yang disetujui adalah psql postgresql://admin:hunter2@db.internal/myapp atau curl -u deploy:APIKEY123 https://.../deploy, kredensialnya langsung tersimpan di .claude/settings.local.json atau konfigurasi setara. File pengaturan ini memang dirancang untuk tetap lokal. Claude Code bahkan otomatis menambahkannya ke gitignore saat tool itu sendiri yang membuat file. Tapi kalau developer membuat file itu secara manual, atau memaksanya masuk dengan force-add, atau gitignore global mereka tidak mencakupnya, satu git add . dan satu push kemudian file itu sudah ada di GitHub. Itulah rantai di balik 1.122 file yang ditemukan peneliti.

Perhatikan betapa banyak mata rantai di situ yang masing-masing terlihat wajar. Menyetujui perintah dengan kredensial inline adalah hal yang sudah dilakukan developer secara interaktif selama puluhan tahun tanpa konsekuensi: perintahnya jalan, shell history menyimpannya secara lokal, dan tidak ada yang peduli. Klik "Don't ask again" juga rasional, karena kelelahan menghadapi prompt itu nyata, dan daya tarik utama agen-agen ini justru berkurangnya gangguan. Bahkan git add . masih bisa dibenarkan ketika tool sudah bilang file itu lokal. Insiden ini tidak disebabkan oleh satu tindakan ceroboh. Ia disebabkan oleh sistem tempat lima tindakan yang tampak tidak berbahaya tersusun menjadi kredensial publik. Ini jenis kegagalan keamanan yang paling sulit diperbaiki, karena tidak ada orang yang merasa sedang melakukan kesalahan.

Saya pernah melihat kesalahan persis seperti ini di lapangan, jauh sebelum ada agen. Seorang team lead di fintech yang saya konsultasikan punya allowed_commands.sh untuk bot helper CI, idenya sama, dibuat manual. Seseorang menyetujui satu perintah migrasi database dengan DSN inline. Enam bulan kemudian repo itu dibuka ke publik, dan DSN tersebut ada di riwayat git sebuah file yang tidak ada yang terpikir untuk diaudit karena "bukan config". File itu memang config. Hanya saja tidak kelihatan seperti config.

Inilah inti masalahnya: permission allowlist adalah file konfigurasi yang secara tidak sengaja menangkap secret operasional. Tidak ada yang memeriksanya untuk mencari secret karena tidak ada yang menganggapnya sebagai file yang membawa secret. Kebijakan secret management Anda kemungkinan besar mencakup .env, credentials.yml, mungkin state Terraform. Hampir pasti tidak mencakup .claude/settings.local.json atau konfigurasi .cursor/. Kami pernah menulis tentang titik buta yang mirip di audit API client sebagai credential vault. Tool yang Anda pakai setiap hari diam-diam menumpuk secret di tempat yang tidak disebut kebijakan Anda.

Dan kategori ini terus membesar. Setiap tool agentic yang diluncurkan beberapa tahun terakhir punya variannya sendiri: allowlist, trusted directory, approval yang diingat, konfigurasi server MCP dengan token inline. Masing-masing adalah path file baru yang tidak disebut oleh kebijakan, gitignore, maupun konfigurasi scanner Anda. Insiden berikutnya akan berupa kesalahan yang sama di file dengan nama berbeda.

Secret Scanning vs Containment: Dua Pertahanan

Ini perbandingan yang akan saya bahas di sisa tulisan ini:

  • Deteksi dulu (secret scanning): pre-commit hook, scanner repo seperti gitleaks dan trufflehog, push protection dari GitHub atau GitLab, plus pemindaian riwayat berkala. Anggap secret pasti bocor; tangkap cepat lalu rotate.
  • Containment dulu (jaga secret tetap di luar): secret hanya masuk ke command lewat environment variable, CLI password manager, atau kredensial berumur pendek; agen dijalankan di sandbox atau VM sementara; file pengaturan lokal di-gitignore secara global. Dirancang agar tidak ada yang bisa bocor.

Deteksi adalah operasi bersih-bersih. Containment adalah properti desain. Keduanya gagal ke arah yang berlawanan: scanning punya false negative dan selalu berjalan setelah kejadian; containment punya biaya adopsi dan bertabrakan dengan kenyamanan developer. Mana yang menang bergantung pada mode kegagalan mana yang bisa Anda toleransi.

Ada juga asimetri dalam cara keduanya menurun seiring waktu. Scanning menurun dengan halus: secret yang terlewat memang buruk, tapi yang berhasil ditangkap tetap tertangkap, dan rule-nya terus membaik. Containment menurun lewat pengecualian. Setiap kali developer mengakali friksinya, misalnya "sekali ini saja, saya tempel token-nya langsung", propertinya melemah, dan tidak ada log yang mencatat pelemahan itu. Anda baru tahu containment-nya gagal sama seperti Anda tahu pintu dibiarkan terbuka: ketika ada yang mengeceknya. Inilah alasan keduanya harus dipakai bersama dan bukan dianggap rival, tapi juga alasan saya memberi bobot berbeda pada keduanya. Bagian berikut menjelaskan mengapa scanning, meski jawaban default industri, adalah yang lebih lemah untuk kelas kebocoran ini.

Secret Scanning: Kelebihan dan Batasan Keras

Secret scanning unggul saat kebocoran sudah terjadi atau hampir terjadi, dan mengingat sifat manusia, itu sering terjadi. Push protection dari GitHub memblokir format token yang sudah dikenal saat push. gitleaks di pre-commit hook menangkap cukup banyak sebelum keluar dari laptop. Kalau Anda hanya melakukan satu hal dari artikel ini, lakukan ini:

# .pre-commit-config.yaml
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.18.4
hooks:
- id: gitleaks

Cukup sepuluh menit setup, dan kelas kebocoran spesifik dari cerita ini, yaitu token di file pengaturan yang ter-commit, sebagian besar akan hilang, karena gitleaks tidak peduli bahwa file itu berupa JSON pengaturan. Ia memindai isi, bukan nama file. Tambahkan regex untuk prefix token internal Anda jika punya.

Ada satu lapisan scanning lagi yang layak dimiliki tapi sering dilupakan tim: memindai mesin lokal Anda sendiri secara berkala untuk mencari secret yang belum di-commit. Hook di level repo hanya aktif saat commit atau push. File pengaturan yang tergeletak di disk selama tiga bulan sebelum seseorang menjalankan git add . adalah jendela tiga bulan di mana secret tinggal satu perintah dari publik. Job terjadwal, bahkan cron mingguan yang menjalankan gitleaks di dotfiles direktori home Anda, memperkecil jendela itu menjadi hitungan hari. Caranya jelek, tapi berhasil.

Namun scanning punya tiga batasan keras yang dibongkar dengan rapi oleh kasus Claude Code. Pertama, detektor berbasis entropi melewatkan secret dengan entropi rendah. Password seperti Winter2024! di connection string psql tidak akan memicu pengecekan entropi, dan kalau bukan format provider yang dikenal, tidak ada rule yang cocok. Peneliti menemukan banyak password biasa, bukan hanya kunci bergaya AWS. Kedua, scanning bersifat post-hoc di lapisan push. Push protection menghentikan push, dan itu bagus, tapi kalau ia tidak aktif, secret sudah ada di riwayat, dan riwayat itu abadi. Merotasi kredensial setelah bocor berarti memburu setiap tempat kredensial itu dipakai, dan saya belum pernah melihat pembersihan seperti itu selesai kurang dari sehari. Ketiga, scanning menciptakan rasa lengkap yang semu. Tim melihat centang hijau lalu berhenti memikirkan bagaimana secret mengalir. Seperti yang sudah kami tulis di tulisan kami tentang AI security scanner, scanner adalah jaring pengaman, bukan pengganti untuk tidak terjatuh.

Soal poin kedua, perlu jelas apa sebenarnya yang tercakup dalam "bersih-bersih" saat kredensial sudah masuk ke repo publik, karena tim sering meremehkannya. Rotasi adalah bagian paling mudah: cabut token, terbitkan yang baru, perbarui secret store. Bagian yang sulit adalah arkeologinya: setiap pipeline deploy, cron job, laptop developer, dan integrasi pihak ketiga yang memakai kredensial lama harus ditemukan dan diperbarui. Satu yang terlewat berarti outage di waktu yang paling buruk. Lalu ada masalah cerminannya: kalau repo publik, Anda harus menganggap secret sudah di-scrape dalam hitungan menit. Bot pencuri kredensial memantau event stream GitHub terus-menerus. Saat scanner Anda memberi peringatan, secret mungkin sudah di-clone, diindeks, dan mungkin sudah dicoba ke endpoint produksi Anda. Deteksi memberi Anda kesadaran. Ia tidak memberi Anda keamanan.

Meski begitu, saya ingin adil pada scanning, karena ia terlalu mudah diabaikan dalam debat seperti ini. Untuk organisasi besar dengan ratusan repo dan ribuan developer, scanning adalah satu-satunya lapisan yang bisa diskalakan tanpa mengubah perilaku. Anda tidak bisa melatih keluar dari kebocoran dalam skala itu, tapi Anda bisa menutup sebagian besarnya dengan push protection. Kalau Anda platform team yang menentukan di mana minggu pertama usaha dihabiskan, jawabannya adalah scanning: murah, terpusat, dan menangkap token provider berentropi tinggi yang paling merusak. Hanya jangan salah mengiranya sebagai solusi utuh.

Jaring ikan berlubang besar ditarik dari air gelap, sebagian besar ikan bercahaya kabur lewat celah, sementara beberapa tertangkap
Scanning menangkap secret yang dikenalinya. Password berentropi rendah dan format baru bisa lolos.

Containment: Env Var, Sandbox, dan Kredensial Berumur Pendek

Containment menang di setiap tempat di mana secret akan ditulis begitu saja, dan inilah tepatnya tempat kasus ini terjadi. Kalau kredensial tidak pernah muncul sebagai string literal di perintah, allowlist tidak punya apa pun yang berbahaya untuk disimpan. Perintah yang disetujui menjadi curl -H "Authorization: Bearer $DEPLOY_TOKEN" ..., dan file pengaturan hanya berisi nama variabel yang tidak berbahaya. Dua aturan cukup untuk menutup sebagian besar kasus:

  • Secret hanya masuk ke command lewat environment variable atau indirection ($TOKEN, $(op read ...), atau file konfigurasi yang dibaca agen saat runtime), tidak pernah sebagai nilai literal.
  • Direktori konfigurasi lokal agen (.claude/, .cursor/, .aider*) masuk ke gitignore global mesin (~/.config/git/ignore), bukan hanya per-repo, sehingga tidak ada project yang bisa meng-commit-nya.
# Global gitignore covers every repo on this machine
git config --global core.excludesFile ~/.config/git/ignore
cat >> ~/.config/git/ignore <<'EOF'
.claude/
.cursor/
.aider*
.env*
EOF

Kenapa global, bukan per-repo? Ada dua alasan. Pertama, gitignore per-repo hanya ada kalau seseorang ingat menambahkannya ke setiap repo baru, dan repo baru justru dibuat saat tidak ada yang sedang memikirkan kebersihan keamanan. Kedua, gitignore global adalah kebijakan mesin, bukan kebijakan project. Ia tidak bisa tanpa sengaja dihapus dalam pull request yang "merapikan gitignore", dan saya benar-benar pernah melihat itu terjadi. Versi per-repo melindungi repo. Versi global melindungi developer, dan developer adalah unit yang rawan bocor di sini.

Aturan env var layak diperiksa sama ketatnya, karena ia punya mode kegagalan yang halus: shell profile. Kalau developer "menyelesaikan" kebutuhan env var dengan mengekspor DEPLOY_TOKEN=sk-... di .bashrc, Anda hanya memindahkan secret dari satu dotfile yang tidak ditinjau ke dotfile lain. Aturan ini harus berakhir di secrets backend sungguhan, seperti 1Password CLI, direnv yang membaca dari penyimpanan terenkripsi, atau cloud secrets manager dengan aws ssm atau op inject saat awal sesi. Agen mendapat variabelnya; disk tidak pernah mendapat nilainya. Ini hanya satu lapis indirection tambahan, dan di situlah bedanya containment dengan sekadar kosmetik.

Versi containment yang lebih kuat adalah yang saya sebut sandboxing sungguhan: jalankan agen di VM atau container sementara per task, di jaringan terisolasi, dengan proxy di depan API eksternal. Ada satu setup praktisi yang saya kagumi: sebuah API proxy diletakkan di antara agen dan kunci SaaS berhak penuh. Operasi baca lewat, operasi tulis membutuhkan ketukan dari ponsel. Itu defense in depth yang dikerjakan dengan benar. Bahkan agen yang sepenuhnya terkompromi dengan --dangerously-skip-permissions hanya bisa menyentuh apa yang diizinkan proxy. Kami sudah membahas trade-off yang lebih luas di containment vs monitoring untuk agen AI; kasus ini adalah argumen untuk containment.

Kredensial berumur pendek adalah separuh lain dari versi kuat, dan sering diremehkan karena ia memperkecil blast radius bahkan saat semua lapisan lain gagal. Access key AWS statis yang bocor ke GitHub berlaku sampai ada yang menyadarinya. Kredensial OIDC dengan TTL satu jam yang bocor ke GitHub hanyalah sebuah entri log. Kalau cloud provider Anda mendukung workload identity federation, dan semua provider besar mendukungnya, kredensial agen seharusnya kedaluwarsa lebih cepat daripada proses incident response Anda sempat mengadakan rapat.

Biaya jujur dari containment adalah friksi. CLI password manager berarti prompt sidik jari di tengah task. VM sementara berarti waktu setup dan latensi cold start di setiap run. Proxy yang di-scope berarti ada yang harus membangun dan merawatnya. Untuk developer solo di proyek sampingan, sandboxing penuh terlalu berlebihan, dan versi gitignore global ditambah env var sudah tepat. Untuk tim yang agennya menyentuh kredensial produksi, friksi itu adalah harga untuk tidak menjadi pengumuman breach berikutnya.

Lapisan Tengah: Memperbaiki Allowlist Itu Sendiri

Ada opsi ketiga yang dimiliki vendor tool, bukan Anda: jangan simpan perintah literal. Aturan permission yang menyimpan curl -H "Authorization: Bearer *" sebagai pola, dengan nilai argumen disensor, sama bergunanya untuk pencocokan dan tidak membawa secret. Tim Claude Code sudah menyatakan sedang mempertimbangkan pencegahan kelas persis seperti ini, dan arah yang mereka rekomendasikan adalah auto permission mode yang tidak mengharuskan Anda mengelola daftar allow/deny sama sekali. Itu naluri yang benar. Setiap allowlist yang dikelola manual adalah insiden masa depan dengan timestamp yang belum bisa Anda lihat.

Pencocokan pola bukan makan siang gratis, perlu dipahami. Glob seperti curl * cocok dengan perintah deploy yang jinak sama baiknya dengan perintah exfiltration yang jahat, jadi sensor yang agresif menukar risiko kebocoran dengan risiko keluasan approval. Desain yang tepat mungkin bersifat struktural, bukan tekstual: simpan binary mana dan flag mana yang disetujui, jangan pernah nilai argumennya. Dengan begitu pencocokannya tetap presisi (ya untuk curl dengan header, tidak untuk curl yang mengirim pipe ke domain baru) tanpa menyimpan apa pun tempat kredensial bisa bersembunyi. Vendor akan sampai ke sana; insentifnya sekarang sudah berupa bukti lebih dari seribu file publik.

Sampai vendor merilisnya, Anda bisa mendekatinya dengan kebersihan: jalankan scanner secara berkala terhadap file pengaturan lokal itu sendiri. Satu baris seperti gitleaks detect --no-git --source ~/.claude .claude mengaudit file persis yang menjadi inti cerita ini, sebelum file itu mendekati repo mana pun. Tambahkan ke script setup dotfiles Anda dan biayanya nol.

Rekomendasi Saya: Containment sebagai Default, Scanning sebagai Jaring Pengaman

Kalau harus memilih satu, pilih containment. Kebocoran yang tidak pernah terjadi selalu lebih baik daripada kebocoran yang terdeteksi cepat. Scanning adalah yang Anda andalkan saat containment gagal, dan ia pasti akan gagal, karena suatu saat seseorang akan menempelkan connection string ke chat jam 1 pagi. Tapi scanning seharusnya jadi exception handler, bukan kebijakan utama.

Secara konkret, untuk tim yang sedang menggelar tool agentic coding kuartal ini, urutannya dari yang paling murah:

  1. Gitignore global untuk direktori konfigurasi agen di setiap mesin developer. Lima menit, dan langsung menghilangkan kebocoran file pengaturan yang ter-commit.
  2. Aturan: secret hanya lewat env var atau CLI password manager, jangan pernah inline di command. Masukkan ke onboarding, bukan wiki yang tidak ada yang baca.
  3. gitleaks sebagai pre-commit hook plus push protection di forge. Ini jaring pengaman untuk semua hal di atas.
  4. Kredensial berumur pendek dan ber-scope untuk apa pun yang disentuh agen (kredensial cloud OIDC alih-alih kunci statis), supaya kebocoran kedaluwarsa dalam hitungan jam.
  5. Untuk agen yang punya akses produksi: sandbox sementara plus API proxy yang membatasi apa yang bisa dilakukan kredensial agen.

Perhatikan urutannya. Dua item termurah adalah containment, dan keduanya menghapus seluruh kelas insiden, bukan sekadar mengecilkan probabilitasnya. Item scanning ada di urutan ketiga, bukan pertama, bukan karena tidak penting, tapi karena ia adalah jaring di bawah trapeze, dan jaring dipasang setelah Anda memeriksa talinya. Item keempat dan kelima adalah tempat Anda berhenti bertahan dari kecelakaan dan mulai bertahan dari kompromi, dan di sanalah tool agentic menuju, entah kita merencanakannya atau tidak.

Benteng dengan gerbang kecil, di belakangnya ada dinding kedua dan brankas terkunci di tengah
Containment berlapis: meski dinding luar jebol, brankas di dalam tidak menyimpan apa pun yang statis dan layak dicuri.

Dua item pertama saja sudah akan mencegah hampir setiap file dalam dataset peneliti. Di situlah bagian yang menjengkelkan dari insiden ini: ini bukan serangan canggih. Ini jenis file baru yang membawa kesalahan lama, dan perbaikannya adalah kebersihan yang sama yang kita khotbahkan sejak commit .env pertama, diterapkan pada direktori yang belum disebut kebijakan siapa pun.

Perbarui kebijakan Anda. Agen tidak akan pergi ke mana-mana, dan tombol "Don't ask again" juga tidak.