Postur Keselamatan Yabanin
Halaman ini ialah titik masuk kepada model keselamatan Yabanin: siapa yang boleh mengesahkan melalui permukaan yang mana, bagaimana rahsia disimpan, di mana saluran dasar berada sebagai lapisan kawalan, dan bagaimana rantaian bekalan dijaga. Dapatan terperinci dan sejarah model ancaman ada dalam security-audit.md; pemetaan OWASP Top-10 untuk Aplikasi LLM ada dalam security-owasp-llm.md.
Permukaan pengesahan
| Permukaan | Kelayakan | Mekanisme | Kod |
|---|---|---|---|
| Konsol pentadbir (tempatan) | e-mel + kata laluan | cincang bcrypt (kos 12); percubaan log masuk sentiasa menjalankan kerja bcrypt (masa disamakan); kuki sesi bertandatangan HMAC dengan tamat tempoh + masa dikeluarkan | pkg/adminauth/auth.go, pkg/adminauth/hash.go |
| SSO pentadbir — OIDC | IdP huluan | Authorization Code + PKCE (S256), token CSRF state, nonce, pemetaan pengguna gagal tertutup | pkg/adminauth/oidc.go, sso-oidc.md |
| SSO pentadbir — SAML 2.0 | IdP huluan | endpoint ACS, AuthnRequests bertandatangan, cache ulangan penegasan (setiap ID penegasan diterima sekali) | pkg/adminauth/saml.go, sso-saml.md |
| Peruntukan SCIM 2.0 | token pembawa berskop organisasi | dipasang pada router awam di bawah pengawal pembawa sendiri (bukan sesi pentadbir); carian token melalui SHA-256 (indeks unik, tiada perbandingan rahsia dalam SQL) + perbandingan masa malar | services/admin/handlers/scim.go, pkg/adminstore/scim.go |
| Pengesahan JWT gerbang | JWT luaran | kunci dipilih mengikut kid daripada JWKS yang dikonfigurasi organisasi sahaja; iss/aud/exp/nbf dikuatkuasakan; tuntutan org menjadi konteks org permintaan dan tuntutan label kunci menjadi label kunci yang dikunci; kunci simetri yang ditanam dalam JWKS ditolak; jika JWKS tidak dapat dihubungi, gerbang gagal tertutup (503, keusangan terhad) | pkg/gateway/auth_jwt.go |
Kunci API gerbang (yab_*) | kunci pembawa | disimpan sebagai cincang SHA-256; diselesaikan melalui cache Redis yang dikunci oleh sha256(plaintext) dengan entri bertandatangan HMAC (CacheSigner) — penyerang Redis tidak boleh memalsukan hasil penyelesaian | pkg/auth/resolver.go, pkg/auth/sessionkeys.go |
Kunci ejen (yag_*) | kunci pembawa | cincangan yang sama; semantik prinsipal ejen (panggilan alat, bajet, tag tugasan) | pkg/auth/agentkey.go, agent-governance.md |
Penyebaran pembatalan dihadkan dan disahkan oleh ujian: setiap laluan pembatalan
membersihkan cache penyelesaian kongsi, jadi kunci yang dibatalkan ditolak serta-merta dengan
Redis, atau dalam YABANIN_ORG_RESOLVER_TTL (lalai 300 s) tanpanya —
security-audit.md, "Penyebaran Pembatalan Kunci".
Serangan brute-force dan penyalahgunaan: log masuk pentadbir dihadkan kepada 5 percubaan / 15 min,
API pentadbir kepada 1000 permintaan/min, dengan pengehad disokong Redis
(pkg/adminauth/ratelimit_redis.go); gerbang menggunakan had token-bucket
per IP. Mutasi pentadbir direkodkan dalam jurnal audit berantai cincang
(pkg/auditlog: row_hash = sha256(prev_hash || payload)), dan laluan
istimewa memerlukan middleware root sahaja.
Rahsia dalam simpanan
- Sampul
enc:. Kunci penyedia (BYOK) dan kelayakan huluan MCP disimpan sebagai teks sifer AES-256-GCM dengan awalan versienc:. Penulisan gagal tertutup: tanpa penyulit yang dikonfigurasi, penulisan ditolak — kunci yang tiada tidak sekali-kali boleh merosot secara senyap kepada teks biasa. Kunci lemah (pendek, heks entropi rendah) ditolak semasa pembinaan (pkg/encryption/encryption.go). - Kunci induk KMS. Penyedia
local(kunci induk env/file,YABANIN_KMS_LOCAL_KEY) danfiledisambungkan; penyediaawsgagal tertutup melainkan dikonfigurasi (pkg/kms/factory.go). - Dicincang, tidak boleh dipulihkan. Kunci API/ejen ialah cincang SHA-256; token pembawa SCIM diselesaikan melalui carian cincang dengan pengesahan masa malar; kata laluan pentadbir ialah bcrypt. Tiada laluan teks biasa untuk mana-mana ini.
- Bacaan bertopeng. Setiap API yang memulangkan rahsia memulangkan baris bertopeng
(
secret_last4,has_secret); teks biasa wujud hanya sebagai argumen panggilan ke dalam kaedah store/resolve dan tidak sekali-kali dilog atau disiri (mcp-gateway.md §6). - Pengasingan organisasi. Jadual yang membawa rahsia tertakluk kepada kontrak RLS
pengasingan organisasi (
ENABLE+FORCE, GUCapp.current_orgdisemat setiap transaksi); baris organisasi asing tidak kelihatan dan tidak boleh ditulis. - Rahsia pelaksanaan (
session_key,cache_hmac,pg_uri, kunci KMS) diperuntukkan sebagai rahsia Docker (/run/secrets/), bukan pemboleh ubah persekitaran; putaran ialah runbook yang didokumenkan (ops/secrets-rotation.md).
Saluran dasar sebagai lapisan kawalan
Saluran Dasar (YPP) ialah titik penguatkuasaan bagi kawalan peringkat kandungan: pengesan PII/rahsia/suntikan, mutator penyuntingan dan pseudonimisasi, pengimbas luaran, hakim LLM, semakan skema output dan penstriman. Sifat yang menjadikannya kawalan dan bukan ciri:
- Mati secara lalai, dimiliki pentadbir. Jika
YABANIN_POLICY_MODEtidak ditetapkan, masa jalan tidak sekali-kali dibina; tiada konfigurasi dasar per permintaan (dibekalkan SDK), jadi klien tidak boleh memintas dasar pentadbir. - Lalai gagal tertutup. Ralat langkah menafikan secara lalai (
on_error: fail_closed);fail_openialah pilihan eksplisit per langkah. Tindakan yang tidak diketahui dinilai sebagai tolak. - Bayang → kuatkuasa. Dasar dilancarkan dalam mod bayang (rekod sahaja, tidak sekali-kali mengubah), dengan log keputusan (pengekalan 90 hari, kandungan dicincang) dan metrik per dasar sebagai permukaan semakan. Suis pemati seluruh proses menurunkan segala-galanya kepada bayang dalam satu langkah.
- Egress terhad. Langkah panggilan keluar memerlukan senarai benarkan operator
(
YABANIN_POLICY_CALLOUT_ALLOW_HOSTS); setiap dail dijaga SSRF dengan DNS yang disemat (tiada tetingkap pengikatan semula), tiada lencongan, tiada cubaan semula, pemutus litar per URL.
Pemetaan OWASP LLM Top-10 (security-owasp-llm.md) memperincikan mengikut risiko apa yang diliputi lapisan ini dan apa yang tidak.
Rantaian bekalan
- Pengimbasan CVE kebergantungan dalam pintu kualiti.
make analyze-securitymenjalankango mod verify+govulncheckperingkat simbol; semakan yang sama ialah pintu kualiti (scripts/quality/dep_audit.py), jadi CVE yang boleh dicapai menggagalkan binaan, bukan sekadar laporan. Versi penganalisis disemat (make install-analysis-tools); triaj dapatan menggunakanscripts/security/govulncheck-classify.sh. Hasil imbasan semasa: security-audit.md. - Dasar kebergantungan. Kebergantungan Go baharu melalui semakan + pintu kualiti yang sama seperti perubahan kod; pengimbas mengelaskan dapatan mengikut kebolehcapaian, dan dapatan "tidak dipanggil" direkodkan dengan justifikasi itu dan bukannya disenyapkan.
- Rantaian bekalan masa jalan. Kontena berjalan baca sahaja dengan
no-new-privileges pada rangkaian jambatan dalaman; perkhidmatan mengikat antara muka
dalaman, dan egress ke hos yang dibekalkan pengguna sentiasa melalui pengawal
senarai benarkan SSRF (
pkg/ssrf). - Asal usul dasar/prompt/model. Dasar diselaraskan daripada git dan merekod SHA git semakan yang mengisytiharkan; prompt hakim dan sumber prompt-studio diversikan; kelayakan model boleh dihadkan per organisasi dengan langkah senarai putih model. Pepohon npm papan pemuka/tapak dan imej asas Docker berada di luar pengimbasan Go — sempadan yang diketahui dan didokumenkan (security-owasp-llm.md, LLM03).
Tindak balas insiden
Runbook: tindak balas insiden, pengelasan keterukan, putaran rahsia, amaran tempahan bajet, dan runbook pengeluaran.