Skip to main content

Audit Keselamatan Yabanin

Imbasan CVE Kebergantungan​

Alat: govulncheck (pengimbas kerentanan Go) Tarikh: 2026-07-23 Hasil: 0 kerentanan dalam kod yang boleh dicapai.

KerentananPakejStatusTindakan
GO-2026-4316go-chi/chi/v5 v5.2.3DibetulkanDinaik taraf kepada v5.2.4
GO-2026-5932golang.org/x/crypto/openpgpTidak dipanggilPakej tidak diimport dalam pangkalan kod; transitif sahaja

Perintah Imbasan​

govulncheck ./...

Model Ancaman​

Permukaan Serangan​

KomponenPendedahanVektor Serangan
Gerbang (:8082)Internet awamBrute-force kunci API, suntikan prompt, SSRF melalui URL huluan
Pentadbir (:8086)Dalaman sahajaRampasan sesi, CSRF, peningkatan keistimewaan
Papan pemuka (:3000)Dalaman sahajaXSS, pintasan pengesahan
PostgreSQL (:5432)Rangkaian dalamanSuntikan SQL, kehabisan sambungan
Redis (:6379)Rangkaian dalamanKeracunan cache, penghitungan kunci
Pengelas (:8080)Dalaman sahajaPenyalahgunaan model, kebocoran maklumat
API PentadbirDalaman sahajaIDOR, penugasan massa, pengusikan log audit

Kawalan Keselamatan​

Pengesahan & Kebenaran​

  • Kunci API: dicincang SHA-256, disimpan dalam jadual api_keys, diselesaikan melalui cache Redis
  • Sesi pentadbir: kuki bertandatangan HMAC dengan sokongan putaran
  • Laluan root sahaja: Operasi pentadbir (pengurusan organisasi, siram cache, harga) memerlukan is_root=true
  • Pengasingan pasukan: Kunci API terikat pada pasukan; penguatkuasaan senarai putih bagi setiap kunci/pasukan

Pengesahan Input​

  • Pengesahan permintaan: pkg/validation/openai/ mengesahkan semua permintaan masuk
  • Suntikan SQL: Semua pertanyaan menggunakan pgx berparameter (tiada penyambungan rentetan)
  • Perlindungan SSRF: pkg/ssrf/ mengesahkan URL huluan terhadap senarai benarkan
  • Suntikan prompt: wujud secara semula jadi dalam trafik LLM; sejak program OUTPLAY (2026-10) boleh dikurangkan dengan kawalan ikut serta — pengesan suntikan deterministik, mod pengawal, dan langkah saluran dasar (lihat security-owasp-llm.md, LLM01). Tanpa kawalan itu didayakan, postur asal ("tidak dikurangkan") masih terpakai.

Perlindungan Data​

  • Penyuntingan PII: penerbit Redis menyunting kunci API, token, rahsia daripada muatan peristiwa (redactPII)
  • Pelucutan kelayakan URL: redactSensitiveURL mengalih keluar kelayakan daripada URL huluan yang dilog
  • Penyulitan semasa rehat: Kunci API penyedia disulitkan dengan AES-256-GCM (pkg/encryption/)
  • Pengurusan rahsia: rahsia Docker (/run/secrets/), bukan pemboleh ubah persekitaran

Keselamatan Rangkaian​

  • Kontena baca sahaja: Semua perkhidmatan berjalan dengan sistem file read_only: true
  • Tiada keistimewaan baharu: security_opt: no-new-privileges:true pada semua kontena
  • Rangkaian dalaman: Perkhidmatan berkomunikasi melalui rangkaian jambatan app-internal
  • tmpfs sahaja: Laluan tulis terhad kepada /tmp dalam kontena baca sahaja

Had Kadar​

  • Gerbang: Had kadar bagi setiap IP melalui token bucket
  • Log masuk pentadbir: 5 percubaan setiap 15 minit (loginLimiter)
  • API pentadbir: 1000 permintaan seminit (rateLimiter)

Jejak Audit​

  • Log audit: Semua mutasi pentadbir dilog dengan pelaku, IP, tindakan, sumber
  • Log permintaan: Setiap permintaan API dikekalkan dengan metadata organisasi/pasukan/kos/model
  • Kekalan strim: Strim Redis menyediakan jejak peristiwa tahan lama sebelum penulisan DB

Penguatkuasaan Bajet (bajet ejen)​

  • Had keras: Permintaan memulangkan HTTP 429 apabila bajet pasukan (bulanan) atau ejen (harian) dilampaui
  • Had lembut: Dilog tetapi dibenarkan
  • Gagal tertutup: Ralat stor bajet menafikan permintaan (503) — perbelanjaan tidak sekali-kali dibenarkan semasa stor bajet tidak tersedia

Penyebaran Pembatalan Kunci​

Jaminan (dikemas kini): dengan Redis dikonfigurasi (perkhidmatan pentadbir berkongsi Redis gerbang), kelayakan api_keys / agent_keys yang dibatalkan ditolak serta-merta — setiap laluan pembatalan (nyahaktif, padam, putar, batal ejen, pengalihan keluar bajet) membersihkan org:resolve:<sha256(key_hash)> daripada cache kongsi, jadi penyelesaian seterusnya mengenai DB dan menafikan. Tanpa Redis batas merosot kepada YABANIN_ORG_RESOLVER_TTL saat (lalai 300s).

  • Penyelesai organisasi gerbang (pkg/auth) menyimpan hasil penyelesaian yang berjaya dalam cache Redis, dikunci oleh sha256(plaintext), selama OrgResolverTTL saat. Perkhidmatan pentadbir kini berkongsi Redis itu dan membersihkan entri cache pada setiap laluan pembatalan (gagal lembut: kegagalan pembersihan melog amaran dan batas TTL terpakai). Apabila Redis tiada, TTL ialah batas penyebaran.
  • Batas itu oleh itu tepat: stale window ≤ OrgResolverTTL. Ujian jam palsu dalam pkg/auth/resolver_revocation_test.go menyemat kedua-dua pinggir — kunci yang dibatalkan masih diselesaikan pada TTL−1s dan ditolak pada TTL, bagi kedua-dua laluan kunci API dan kunci ejen, dan TTL yang dihantar ke Redis sama dengan batas yang dikonfigurasi (mengetatkan pemboleh ubah persekitaran mengetatkan batas).
  • Mitigasi untuk pematian yang lebih pantas: batalkan dan siram kunci Redis org:resolve:<sha256> yang sepadan (memerlukan akses Redis kongsi); jika tidak, rancang tindak balas insiden sekitar TTL yang dikonfigurasi. Tetapkan YABANIN_ORG_RESOLVER_TTL rendah (cth. 30) bagi pelaksanaan dengan pusing ganti kunci yang tinggi atau SLA pembatalan yang ketat, dengan kos satu bacaan pasangan DB tambahan bagi setiap kunci bagi setiap tetingkap.
  • Entri cache ditandatangani HMAC (CacheSigner), jadi penyerang dengan akses Redis tidak boleh memalsukan hasil penyelesaian yang sah bagi kunci yang tidak pernah dikeluarkan; mereka hanya boleh mengekalkan identiti yang sudah dikeluarkan hidup dalam batas yang sama.
  • Nota: entri yang ditulis sebelum pembetulan pembatalan kunci menggunakan pengekodan ejen 3 medan yang bacaan cachenya salah mengatribusikan id ejen kepada slot pasukan; ia luput dalam satu TTL (≤300s) dan ditulis semula dalam format 4 medan yang betul.

Senarai Semak Keselamatan Pra-Pelancaran​

  • Imbasan kebergantungan: 0 kerentanan yang boleh dicapai
  • Semua kontena berjalan baca sahaja dengan no-new-privileges
  • Rahsia disimpan sebagai rahsia Docker (bukan pemboleh ubah persekitaran)
  • Semua pertanyaan SQL menggunakan pernyataan berparameter
  • URL huluan disahkan terhadap corak SSRF
  • PII disunting daripada strim peristiwa dan log
  • Kunci API penyedia disulitkan semasa rehat
  • Laluan pentadbir dilindungi dengan middleware root sahaja
  • Had kadar pada gerbang dan log masuk pentadbir
  • Pengelogan audit pada semua mutasi pentadbir
  • Penamatan TLS di pengimbang beban (konfigurasi sebelum pelancaran)
  • Dasar CORS untuk papan pemuka (hadkan kepada asal yang diketahui)
  • Prosedur putaran rahsia didokumenkan (lihat runbook)

Cadangan​

  1. TLS: Tamatkan TLS di pengimbang beban (nginx/ALB). Gerbang dan pentadbir mendengar pada HTTP biasa di belakang LB.
  2. CORS: Tambah pengepala Access-Control-Allow-Origin yang dihadkan kepada domain papan pemuka.
  3. Putaran rahsia: Putar session_key, cache_hmac, dan pg_uri setiap suku tahun.
  4. WAF: Pertimbangkan Cloudflare/AWS WAF untuk perlindungan DDoS di hadapan gerbang.
  5. Ujian penembusan: Jadualkan ujian penembusan luaran sebelum kerja pematuhan SOC2.

Program OUTPLAY 2026-10 — Tambahan Model Ancaman​

Tarikh: 2026-10-08 (lorong OP-24). Skop: Saluran Dasar (YPP) dan permukaan kelayakan/pengagregat MCP yang dihantar oleh program OUTPLAY (docs/plans/OUTPLAY-PLAN-2026-10-06.md, dalaman). Tambahan ini merekodkan model ancaman baharu dan kawalan pampasan; bahagian di atas kekal sah. Pemetaan penuh bagi setiap risiko (OWASP Top-10 untuk Aplikasi LLM → kawalan, dengan sempadan liputan yang jujur) ada dalam security-owasp-llm.md.

Model ancaman saluran (pkg/pipeline, pkg/policystore)​

Saluran ialah penghantar pemeriksaan/mutasi boleh atur cara atas trafik gerbang (pipeline.md). Permukaan serangannya sendiri, dan kawalannya:

PermukaanAncamanKawalan
Enjin syarat (pkg/pipeline/script: expr lalai, lua, starlark)syarat dasar menjadi vektor DoS/pelariansyarat dikompil sekali semasa muatan dasar (sumber tidak sah = ralat muatan, tidak sekali-kali langkau senyap); expr bebas gelung mengikut reka bentuk; lua berjalan dalam kotak pasir dengan bajet arahan; timeout bagi setiap langkah menghadkan setiap enjin; ralat syarat mengikut on_error (lalai gagal tertutup). Dasar dikarang pentadbir dan diselaraskan git — bukan input klien
Langkah panggilan keluar (pkg/pipeline/callout)SSRF melalui URL pengimbas; eksfiltrasi data melalui unjuranlangkah dikompil hanya apabila YABANIN_POLICY_CALLOUT_ALLOW_HOSTS ditetapkan (kosong = gagal tertutup); pengawal SSRF menyemat jawapan DNS dan menolak alamat terpelihara pada masa dail (tetingkap pengikatan semula ditutup); tiada lencongan, tiada cubaan semula, pemutus litar bagi setiap URL, timeout bagi setiap langkah; unjuran expose menghadkan apa yang keluar (metadata tidak sekali-kali keluar); max_response_bytes mengehadkan balasan
Hakim LLM (pkg/pipeline/llmjudge)rekursi saluran (hakim memanggil gerbang, memasuki semula saluran, menguatkan kos)pengecualian keras: panggilan hakim yang dibuat gerbang membawa meta judge=true dan X-Yabanin-Judge: true; panggilan dalaman dikecualikan, manakala mana-mana permintaan masuk yang membentangkan pengepala itu (apa-apa nilai, termasuk kosong atau pendua) ditolak dengan 400 judge_reentry_unsupported selepas pengesahan (pipeline.md §6.2); prompt hakim ialah sumber berversi; suhu disemat pada 0; keyakinan yang ditinggalkan dikira sebagai 1.0 (gagal tertutup)
Komposisi keputusanlangkah bermasalah menyeludup allow melepasi tolakskala ketegasan tetap tolak > topeng > bendera > benarkan; kesatuan merentas dasar yang dilampirkan dengan keputusan paling ketat; tindakan yang tidak diketahui dinilai sebagai tolak; tolak pertama memintas litar
Mutasi penstrimanpenulisan terkoyak membocorkan nilai pra-penggantian merentas sempadan ketulanpintu awalan (64 token / 500 ms) menolak sebelum pelepasan; bawaan ketulan memegang padanan separa; transform berjalan sebelum penulis cache (pipeline.md §7)
Log keputusankandungan sensitif kekal melalui dapatanbukti disimpan dicincang; kandungan pengguna yang dipetik kekal hanya dalam pengekalan bayang/nyahpepijat; pengekalan 90 hari (migrasi 0009)

Model ancaman kelayakan MCP (pkg/mcpagg, migrasi 0007)​

Dirumuskan daripada mcp-gateway.md §6, §8 (R4) — postur R4 seperti yang dihantar: rahsia wujud hanya sebagai sampul disulitkan enc: (penulisan gagal tertutup), di bawah RLS pengasingan organisasi; bacaan memulangkan baris bertopeng sahaja (secret_last4/has_secret); setiap langkah CRUD/status mendarat dalam jurnal audit berantai cincang; teks biasa terhad (8 KiB) dan tidak sekali-kali dilog. Sesuatu kelayakan tidak sekali-kali boleh meluaskan egress: semakan senarai benarkan SSRF pada URL pelayan mendahului penyelesaian kelayakan pada setiap seruan. Aliran kelayakan bagi setiap pengguna (hantar/putar, mula/panggil balik OAuth) memerlukan geran yang didayakan — geran ialah siling bagi setiap langkah aliran.

Perubahan postur berbanding audit 2026-07​

Audit Julai merekodkan "suntikan prompt: tidak dikurangkan". Program menambah mitigasi ikut serta (mod pengawal, pengesan suntikan, langkah dasar, semakan pasca hasil alat) sambil mengekalkan postur lalai tidak berubah: setiap permukaan baharu dihantar dalam keadaan mati (YABANIN_POLICY_MODE, YABANIN_MCP_GATEWAY, mod pengawal semuanya lalai mati/tidak dipasang), dan tombol egress lalai kepada gagal tertutup. Pelaksanaan yang tidak dikonfigurasi berkelakuan seperti sebelumnya.