Audit Keselamatan Yabanin
Imbasan CVE Kebergantungan
Alat: govulncheck (pengimbas kerentanan Go)
Tarikh: 2026-07-23
Hasil: 0 kerentanan dalam kod yang boleh dicapai.
| Kerentanan | Pakej | Status | Tindakan |
|---|---|---|---|
| GO-2026-4316 | go-chi/chi/v5 v5.2.3 | Dibetulkan | Dinaik taraf kepada v5.2.4 |
| GO-2026-5932 | golang.org/x/crypto/openpgp | Tidak dipanggil | Pakej tidak diimport dalam pangkalan kod; transitif sahaja |
Perintah Imbasan
govulncheck ./...
Model Ancaman
Permukaan Serangan
| Komponen | Pendedahan | Vektor Serangan |
|---|---|---|
| Gerbang (:8082) | Internet awam | Brute-force kunci API, suntikan prompt, SSRF melalui URL huluan |
| Pentadbir (:8086) | Dalaman sahaja | Rampasan sesi, CSRF, peningkatan keistimewaan |
| Papan pemuka (:3000) | Dalaman sahaja | XSS, pintasan pengesahan |
| PostgreSQL (:5432) | Rangkaian dalaman | Suntikan SQL, kehabisan sambungan |
| Redis (:6379) | Rangkaian dalaman | Keracunan cache, penghitungan kunci |
| Pengelas (:8080) | Dalaman sahaja | Penyalahgunaan model, kebocoran maklumat |
| API Pentadbir | Dalaman sahaja | IDOR, 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
pgxberparameter (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:
redactSensitiveURLmengalih 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:truepada semua kontena - Rangkaian dalaman: Perkhidmatan berkomunikasi melalui rangkaian jambatan
app-internal - tmpfs sahaja: Laluan tulis terhad kepada
/tmpdalam 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 olehsha256(plaintext), selamaOrgResolverTTLsaat. 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 dalampkg/auth/resolver_revocation_test.gomenyemat 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. TetapkanYABANIN_ORG_RESOLVER_TTLrendah (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
- TLS: Tamatkan TLS di pengimbang beban (nginx/ALB). Gerbang dan pentadbir mendengar pada HTTP biasa di belakang LB.
- CORS: Tambah pengepala
Access-Control-Allow-Originyang dihadkan kepada domain papan pemuka. - Putaran rahsia: Putar
session_key,cache_hmac, danpg_urisetiap suku tahun. - WAF: Pertimbangkan Cloudflare/AWS WAF untuk perlindungan DDoS di hadapan gerbang.
- 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:
| Permukaan | Ancaman | Kawalan |
|---|---|---|
Enjin syarat (pkg/pipeline/script: expr lalai, lua, starlark) | syarat dasar menjadi vektor DoS/pelarian | syarat 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 unjuran | langkah 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 keputusan | langkah bermasalah menyeludup allow melepasi tolak | skala 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 penstriman | penulisan terkoyak membocorkan nilai pra-penggantian merentas sempadan ketulan | pintu awalan (64 token / 500 ms) menolak sebelum pelepasan; bawaan ketulan memegang padanan separa; transform berjalan sebelum penulis cache (pipeline.md §7) |
| Log keputusan | kandungan sensitif kekal melalui dapatan | bukti 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.