Skip to main content

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​

PermukaanKelayakanMekanismeKod
Konsol pentadbir (tempatan)e-mel + kata laluancincang bcrypt (kos 12); percubaan log masuk sentiasa menjalankan kerja bcrypt (masa disamakan); kuki sesi bertandatangan HMAC dengan tamat tempoh + masa dikeluarkanpkg/adminauth/auth.go, pkg/adminauth/hash.go
SSO pentadbir — OIDCIdP huluanAuthorization Code + PKCE (S256), token CSRF state, nonce, pemetaan pengguna gagal tertutuppkg/adminauth/oidc.go, sso-oidc.md
SSO pentadbir — SAML 2.0IdP huluanendpoint ACS, AuthnRequests bertandatangan, cache ulangan penegasan (setiap ID penegasan diterima sekali)pkg/adminauth/saml.go, sso-saml.md
Peruntukan SCIM 2.0token pembawa berskop organisasidipasang 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 malarservices/admin/handlers/scim.go, pkg/adminstore/scim.go
Pengesahan JWT gerbangJWT luarankunci 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 pembawadisimpan sebagai cincang SHA-256; diselesaikan melalui cache Redis yang dikunci oleh sha256(plaintext) dengan entri bertandatangan HMAC (CacheSigner) — penyerang Redis tidak boleh memalsukan hasil penyelesaianpkg/auth/resolver.go, pkg/auth/sessionkeys.go
Kunci ejen (yag_*)kunci pembawacincangan 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 versi enc:. 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) dan file disambungkan; penyedia aws gagal 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, GUC app.current_org disemat 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_MODE tidak 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_open ialah 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-security menjalankan go mod verify + govulncheck peringkat 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 menggunakan scripts/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.