# Security Policy (Bosanski) 🌐 **Languages:** 🇺🇸 [English](../../../SECURITY.md) · 🇪🇹 [am](../am/SECURITY.md) · 🇸🇦 [ar](../ar/SECURITY.md) · 🇦🇿 [az](../az/SECURITY.md) · 🇧🇬 [bg](../bg/SECURITY.md) · 🇧🇩 [bn](../bn/SECURITY.md) · 🇨🇿 [cs](../cs/SECURITY.md) · 🇩🇰 [da](../da/SECURITY.md) · 🇩🇪 [de](../de/SECURITY.md) · 🇬🇷 [el](../el/SECURITY.md) · 🇪🇸 [es](../es/SECURITY.md) · 🇪🇪 [et](../et/SECURITY.md) · 🇮🇷 [fa](../fa/SECURITY.md) · 🇫🇮 [fi](../fi/SECURITY.md) · 🇫🇷 [fr](../fr/SECURITY.md) · 🇮🇪 [ga](../ga/SECURITY.md) · 🇮🇳 [gu](../gu/SECURITY.md) · 🇳🇬 [ha](../ha/SECURITY.md) · 🇮🇱 [he](../he/SECURITY.md) · 🇮🇳 [hi](../hi/SECURITY.md) · 🇭🇷 [hr](../hr/SECURITY.md) · 🇭🇺 [hu](../hu/SECURITY.md) · 🇦🇲 [hy](../hy/SECURITY.md) · 🇮🇩 [id](../id/SECURITY.md) · 🇳🇬 [ig](../ig/SECURITY.md) · 🇮🇹 [it](../it/SECURITY.md) · 🇯🇵 [ja](../ja/SECURITY.md) · 🇬🇪 [ka](../ka/SECURITY.md) · 🇰🇭 [km](../km/SECURITY.md) · 🇮🇳 [kn](../kn/SECURITY.md) · 🇰🇷 [ko](../ko/SECURITY.md) · 🇱🇹 [lt](../lt/SECURITY.md) · 🇱🇻 [lv](../lv/SECURITY.md) · 🇮🇳 [ml](../ml/SECURITY.md) · 🇮🇳 [mr](../mr/SECURITY.md) · 🇲🇾 [ms](../ms/SECURITY.md) · 🇲🇹 [mt](../mt/SECURITY.md) · 🇲🇲 [my](../my/SECURITY.md) · 🇳🇵 [ne](../ne/SECURITY.md) · 🇳🇱 [nl](../nl/SECURITY.md) · 🇳🇴 [no](../no/SECURITY.md) · 🇮🇳 [or](../or/SECURITY.md) · 🇮🇳 [pa](../pa/SECURITY.md) · 🇵🇭 [phi](../phi/SECURITY.md) · 🇵🇱 [pl](../pl/SECURITY.md) · 🇵🇹 [pt](../pt/SECURITY.md) · 🇧🇷 [pt-BR](../pt-BR/SECURITY.md) · 🇷🇴 [ro](../ro/SECURITY.md) · 🇷🇺 [ru](../ru/SECURITY.md) · 🇱🇰 [si](../si/SECURITY.md) · 🇸🇰 [sk](../sk/SECURITY.md) · 🇸🇮 [sl](../sl/SECURITY.md) · 🇷🇸 [sr](../sr/SECURITY.md) · 🇸🇪 [sv](../sv/SECURITY.md) · 🇰🇪 [sw](../sw/SECURITY.md) · 🇮🇳 [ta](../ta/SECURITY.md) · 🇮🇳 [te](../te/SECURITY.md) · 🇹🇭 [th](../th/SECURITY.md) · 🇹🇷 [tr](../tr/SECURITY.md) · 🇺🇦 [uk-UA](../uk-UA/SECURITY.md) · 🇵🇰 [ur](../ur/SECURITY.md) · 🇺🇿 [uz](../uz/SECURITY.md) · 🇻🇳 [vi](../vi/SECURITY.md) · 🇳🇬 [yo](../yo/SECURITY.md) · 🇨🇳 [zh-CN](../zh-CN/SECURITY.md) · 🇹🇼 [zh-TW](../zh-TW/SECURITY.md) --- ## Prijavljivanje ranjivosti Ako otkrijete sigurnosnu ranjivost u OmniRouteu, prijavite je na odgovoran način: 1. **NEMOJTE** otvarati javni GitHub problem 2. Koristite [GitHub sigurnosna upozorenja](https://github.com/diegosouzapw/OmniRoute/security/advisories/new) 3. Uključite: opis, korake za reprodukciju i potencijalni utjecaj ## Vremenski okvir odgovora | Faza | Cilj | | -------------------- | ------------------------- | | Potvrda prijema | 48 sati | | Trijaža i procjena | 5 radnih dana | | Objavljivanje zakrpe | 14 radnih dana (kritično) | ## Podržane verzije | Verzija | Status podrške | | ------- | --------------------------------------------------------- | | 3.9.x | 🗓️ Planirano — LTS linija (`stable/v3`), pogledajte ispod | | 3.8.x | ✅ Aktivna | | 3.7.x | ✅ Sigurnosna | | < 3.7.0 | ❌ Nije podržana | ## Period LTS podrške (v3.9.x) Nakon verzije 3.8.59 sljedeća verzija je **3.9.0**, koja otvara liniju dugoročne podrške na grani `stable/v3` (pogledajte [`ROADMAP.md`](ROADMAP.md) → "Faza 3 — v3.9.0 LTS"). - **Šta prima `stable/v3`:** ispravke grešaka, sigurnosne zakrpe i ažuriranja pružalaca usluga. Nove funkcionalnosti idu u v4 kanal; LTS linija stavlja stabilnost na prvo mjesto. `npm install omniroute` (`latest` dist-tag) ostaje na v3 tokom cijelog v4 ciklusa. - **Trajanje perioda:** ``. Trajanje perioda nakon v4.0 GA (kada se `latest` prebaci na v4) **još nije odlučeno**; ovaj odjeljak se ažurira kada održavalac to objavi. Do tada nemojte pretpostavljati datum završetka. - **Prijavljivanje ranjivosti u LTS liniji:** isti kanal kao i za bilo koju drugu verziju — privatno [GitHub sigurnosno upozorenje](https://github.com/diegosouzapw/OmniRoute/security/advisories/new), nikada javni problem. Navedite koju ste verziju testirali (naprimjer `3.9.2`); ispravke se primjenjuju na `stable/v3` i prenose unaprijed na v4. - **Sigurnosna osnova u trenutku izdvajanja LTS-a:** izmjereno stanje skenera, provjere zaštite ruta i dokazi za javne vjerodajnice zabilježeni su u [`docs/security/LTS_SECURITY_BASELINE.md`](docs/security/LTS_SECURITY_BASELINE.md). --- ## Sigurnosna arhitektura OmniRoute implementira višeslojni sigurnosni model: ``` Zahtjev → CORS → Autorizacijski tok (klasifikacija → pravila → primjena) → Zaštitne mjere (maskiranje PII-ja, ubrizgavanje upita, vizuelni most) → Ograničivač stope → Prekidač kola → Period hlađenja → Blokada modela → Pružalac usluge ``` ### 🔐 Autentifikacija i autorizacija | Funkcionalnost | Implementacija | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Prijava na nadzornu ploču** | Autentifikacija zasnovana na lozinki s JWT tokenima (HttpOnly kolačići) | | **Autentifikacija API ključem** | HMAC-potpisani ključevi s CRC provjerom valjanosti | | **OAuth 2.0 + PKCE** | OAuth putem preglednika/uređaja, specifičan za pružaoca, koristi PKCE gdje je podržan; Devin vjerodajnice samo za uvoz obrađuju se zasebno. | | **Osvježavanje tokena** | Automatsko osvježavanje OAuth tokena prije isteka | | **Sigurni kolačići** | `AUTH_COOKIE_SECURE=true` za HTTPS okruženja | | **Autorizacijski tok** | Klasifikacija ruta (PUBLIC / CLIENT_API / MANAGEMENT) — pogledajte `docs/architecture/AUTHZ_GUIDE.md` | | **Nivoi zaštite ruta** | Model s 3 nivoa za upravljačke rute (LOCAL_ONLY / ALWAYS_PROTECTED / MANAGEMENT) — pogledajte `docs/security/ROUTE_GUARD_TIERS.md` | | **MCP s opsegom manage** | Udaljeni pristup `/api/mcp/*` zaštićen je API ključevima s opsegom `manage`; `/api/cli-tools/runtime/*` ostaje ograničen isključivo na povratnu petlju. Pogledajte ROUTE_GUARD_TIERS | | **MCP opsezi** | 32 detaljna opsega (read:health, write:combos, execute:completions itd.) — pogledajte `docs/frameworks/MCP-SERVER.md` | ### 🛡️ Šifriranje podataka u mirovanju Svi osjetljivi podaci pohranjeni u SQLiteu šifrirani su pomoću **AES-256-GCM** uz izvođenje ključa pomoću scrypta: - API ključevi, pristupni tokeni, tokeni za osvježavanje i ID tokeni - Format s verzijom: `enc:v1:::` - Prolazni način rada (običan tekst) kada `STORAGE_ENCRYPTION_KEY` nije postavljen ```bash # Generišite ključ za šifriranje: STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) ``` ### 🛡️ Okvir zaštitnih mjera OmniRoute isporučuje **registar zaštitnih mjera** s ponovnim učitavanjem bez prekida (`src/lib/guardrails/`) i 3 ugrađene zaštitne mjere poredane prema prioritetu: | Zaštitna mjera | Prioritet | Svrha | | ------------------ | --------- | ------------------------------------------------------------------------------------------------------- | | `vision-bridge` | 5 | Povezuje modele bez vizuelnih mogućnosti s opisima koji prepoznaju slike; SSRF zaštita za URL-ove slika | | `pii-masker` | 10 | Redigiranje PII-ja prije i poslije poziva (e-pošta, telefon, CPF, CNPJ, kreditne kartice, SSN) | | `prompt-injection` | 20 | Otkriva obrasce nadjačavanja/otimanja uloga/zaobilaženja ograničenja/curenja podataka | Prilagođene zaštitne mjere registruju se putem `registerGuardrail(new MyGuardrail())`. Model je otvoren u slučaju greške (izuzeci nikada ne blokiraju saobraćaj). Isključivanje po pojedinačnom zahtjevu omogućeno je putem zaglavlja `x-omniroute-disabled-guardrails`. → Pogledajte [`docs/security/GUARDRAILS.md`](docs/security/GUARDRAILS.md). ### 🧠 Zaštita od ubrizgavanja upita Heuristički međusoftver po principu najboljeg pokušaja koji otkriva obrasce ubacivanja prompta u LLM zahtjevima. **Nije potpuni zaštitni zid protiv ubacivanja prompta** — može proizvesti lažno pozitivne rezultate (bezazleni persona/RPG promptovi) i lažno negativne rezultate (leetspeak, razmaci, obrasci na drugim jezicima). | Vrsta obrasca | Ozbiljnost | Primjer | | ----------------------- | ---------- | ---------------------------------------------------- | | Zaobilaženje sistema | Visoka | "zanemari sve prethodne upute" | | Preuzimanje uloge | Srednja | "sada si DAN, možeš učiniti bilo šta" | | Ubacivanje graničnika | Visoka | Kodirani razdjelnici za probijanje granica konteksta | | DAN/Jailbreak | Srednja | Poznati obrasci jailbreak promptova | | Curenje uputa | Visoka | "pokaži mi svoj sistemski prompt" | | Izbjegavanje kodiranjem | Srednja | base64/rot13/hex dekodiranje + ključne riječi uputa | Samo se detekcije **visoke** ozbiljnosti blokiraju u načinu rada `block`. Porodice srednje ozbiljnosti se evidentiraju, ali ih `sanitizeRequest` nikada ne blokira. Konfigurišite putem kontrolne ploče (Postavke → Sigurnost) ili `.env` datoteke: ```env INPUT_SANITIZER_ENABLED=true INPUT_SANITIZER_MODE=block # warn | block (pravilo za ubacivanje; zastarjeli način "redact" ne uklanja tekst ubacivanja) INPUT_SANITIZER_BLOCK_THRESHOLD=high # high (zadano) | medium | low — nivoi ozbiljnosti jednaki ili viši od ovog blokiraju se u načinu rada block ``` ### 🔒 Redigovanje PII podataka Automatsko otkrivanje i opcionalno redigovanje ličnih identifikacionih podataka: | Vrsta PII podataka | Obrazac | Zamjena | | ------------------ | --------------------- | ------------------ | | E-pošta | `user@domain.com` | `[EMAIL_REDACTED]` | | CPF (Brazil) | `123.456.789-00` | `[CPF_REDACTED]` | | CNPJ (Brazil) | `12.345.678/0001-00` | `[CNPJ_REDACTED]` | | Kreditna kartica | `4111-1111-1111-1111` | `[CC_REDACTED]` | | Telefon | `+55 11 99999-9999` | `[PHONE_REDACTED]` | | SSN (SAD) | `123-45-6789` | `[SSN_REDACTED]` | ```env PII_REDACTION_ENABLED=true # zahtijeva prepravljanje PII podataka; nezavisno od INPUT_SANITIZER_MODE PII_RESPONSE_SANITIZATION=true # opcionalno: rediguje PII podatke u odgovorima pružatelja koji se vraćaju klijentima ``` ### 🌐 Mrežna sigurnost | Funkcija | Opis | | ---------------------------------------- | --------------------------------------------------------------------------------------- | | **CORS** | Eksplicitna lista dozvoljenih izvora (`CORS_ALLOWED_ORIGINS`; zastarjeli `CORS_ORIGIN`) | | **IP filtriranje** | Rasponi IP adresa na listi dozvoljenih/blokiranih na kontrolnoj ploči | | **Ograničavanje brzine** | Ograničenja brzine po pružatelju s automatskim eksponencijalnim odgađanjem | | **Zaštita od naglog naviranja zahtjeva** | Mutex + zaključavanje po vezi sprečavaju kaskadne greške 502 | | **TLS otisak** | Lažiranje TLS otiska nalik pregledniku radi smanjenja otkrivanja botova | | **CLI otisak** | Redoslijed zaglavlja/tijela po pružatelju radi podudaranja s izvornim CLI potpisima | ### 🔌 Otpornost i dostupnost | Funkcija | Opis | | ----------------------------- | --------------------------------------------------------------------------------- | | **Prekidač strujnog kruga** | 3 stanja (Zatvoreno → Otvoreno → Poluotvoreno) po pružatelju, pohranjeno u SQLite | | **Idempotentnost zahtjeva** | Prozor od 5 sekundi za deduplikaciju identičnih zahtjeva | | **Eksponencijalno odgađanje** | Automatski ponovni pokušaj sa sve dužim odgodama | | **Kontrolna ploča zdravlja** | Praćenje zdravlja pružatelja u stvarnom vremenu | ### 📋 Usklađenost | Funkcija | Opis | | ------------------------------- | -------------------------------------------------------------------------- | | **Zadržavanje zapisa** | Automatsko čišćenje nakon `CALL_LOG_RETENTION_DAYS` | | **Isključivanje evidentiranja** | Oznaka `noLog` za pojedinačni API ključ onemogućava evidentiranje zahtjeva | | **Dnevnik revizije** | Administrativne radnje prate se u tabeli `audit_log` | | **MCP revizija** | Evidentiranje revizije zasnovano na SQLiteu za sve pozive MCP alata | | **Zod validacija** | Svi API ulazi validiraju se pomoću Zod v4 shema pri učitavanju modula | --- ## Obavezne varijable okruženja Sve tajne moraju biti postavljene prije pokretanja servera. Server će se **odmah zaustaviti** ako nedostaju ili nisu dovoljno sigurne. ```bash # OBAVEZNO — server se neće pokrenuti bez ovih vrijednosti: JWT_SECRET=$(openssl rand -base64 48) # najmanje 32 znaka API_KEY_SECRET=$(openssl rand -hex 32) # najmanje 16 znakova # PREPORUČENO — omogućava šifriranje podataka u mirovanju: STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) ``` Server aktivno odbija poznate nesigurne vrijednosti kao što su `changeme`, `secret` ili `password`. --- ## Sigurnost Dockera - Koristite korisnika koji nije root u produkciji - Montirajte tajne kao volumene samo za čitanje - Nikada ne kopirajte `.env` datoteke u Docker slike - Koristite `.dockerignore` da biste isključili osjetljive datoteke - Postavite `AUTH_COOKIE_SECURE=true` kada se aplikacija nalazi iza HTTPS-a ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ --read-only \ -p 20128:20128 \ -v omniroute-data:/app/data \ -e JWT_SECRET="$(openssl rand -base64 48)" \ -e API_KEY_SECRET="$(openssl rand -hex 32)" \ -e STORAGE_ENCRYPTION_KEY="$(openssl rand -hex 32)" \ diegosouzapw/omniroute:latest ``` --- ## Zavisnosti - Redovno pokrećite `npm audit` (`npm run audit:deps` obuhvata glavni dio + electron) - Održavajte zavisnosti ažuriranim - Projekt koristi `husky` + `lint-staged` za provjere prije potvrđivanja izmjena (lint-staged + check-docs-sync + check:any-budget:t11) - CI proces pokreće ESLint sigurnosna pravila pri svakom slanju izmjena (`no-eval`, `no-implied-eval`, `no-new-func` = greška) - Konstante pružalaca usluga provjeravaju se prilikom učitavanja modula pomoću Zoda (`src/shared/validation/schemas.ts`) - Koriste se biblioteke koje su sigurne prema zadanim postavkama: `dompurify` / `isomorphic-dompurify` (XSS), `jose` (JWT), `better-sqlite3` (nema rizika od SQLi-ja zahvaljujući parametriziranim upitima), `bcryptjs` (heširanje lozinki) ## Stroga sigurnosna pravila Ova pravila provode alati i pregledavaoci: 1. **Nikada ne potvrđujte tajne u repozitorij** — `.env` je isključen iz Gita; `.env.example` je predložak (bez doslovnih vrijednosti, samo komentari — pogledajte PUBLIC_CREDS.md u nastavku) 2. **Nikada ne koristite `eval()`, `new Function()` ili implicitni eval** — ESLint to provodi 3. **Nikada ne zaobilazite Husky kuke** (`--no-verify`, `--no-gpg-sign`) bez izričitog odobrenja operatera 4. **Nikada ne pišite sirovi SQL u rutama** — uvijek koristite `src/lib/db/` (parametrizirano) 5. **Uvijek provjeravajte ulazne podatke pomoću Zoda** — `src/shared/validation/schemas.ts` 6. **Uvijek sanitizirajte zaglavlja nadređenog servera** — lista zabrana nalazi se u `src/shared/constants/upstreamHeaders.ts` 7. **Šifrirajte pristupne podatke u mirovanju** — AES-256-GCM putem `src/lib/db/encryption.ts` 8. **Javni OAuth identifikatori nadređenih servisa putem `resolvePublicCred()`** — nikada ne ugrađujte doslovne vrijednosti `AIza…` / `GOCSPX-…` / `…apps.googleusercontent.com` u izvorni kôd. Pogledajte [`docs/security/PUBLIC_CREDS.md`](docs/security/PUBLIC_CREDS.md). 9. **Odgovori o greškama putem `buildErrorBody()` / `sanitizeErrorMessage()`** — nikada ne stavljajte sirove vrijednosti `err.stack` / `err.message` u tijela HTTP / SSE / executor / MCP odgovora. Pogledajte [`docs/security/ERROR_SANITIZATION.md`](docs/security/ERROR_SANITIZATION.md). 10. **Vrijednosti u vrijeme izvršavanja za `exec()` / `spawn()` putem opcije `env`** — nikada ne interpolirajte vanjske putanje ili nepouzdane vrijednosti kao nizove u skripte koje se prosljeđuju ljusci. Referenca: `src/mitm/cert/install.ts::updateNssDatabases`. 11. **Dajte prednost bibliotekama koje su sigurne prema zadanim postavkama** — pogledajte [tldrsec/awesome-secure-defaults](https://github.com/tldrsec/awesome-secure-defaults) (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink). Koristite ih prije nego što razvijete vlastito rješenje. ## Nalazi skenera lanca snabdijevanja (Socket.dev / Snyk / slično) > **Napomena o opsegu:** `socket.yml` u korijenu repozitorija samo oblikuje `projectIgnorePaths` za Socket.dev skeniranje objavljenog npm artefakta nakon objavljivanja, koje se obavlja na strani registra — to nije obavezna CI/PR kontrola spajanja. Nijedan radni tok u `.github/workflows`, nijedna `package.json` skripta i nijedan `Makefile` cilj ne pokreće Socket.dev. Objavljeni `omniroute` npm artefakt sadrži Next.js međuverziju `output: "standalone"`, što znači da svaki obrađivač ruta — uključujući dokumentovane privilegovane funkcionalnosti (MITM, Zed uvoz, Cloud Sync, ugrađeni nadzornik servisa) — završava u minificiranim segmentima `.next/server/*.js`. Heuristički skeneri lanca snabdijevanja često porede obrasce iz tih segmenata s potpisima zlonamjernog softvera. Konfiguracija skenera koju koristimo nalazi se u datoteci [`socket.yml`](socket.yml) u korijenu repozitorija (Socket.dev GitHub App format v2 — pogledajte ). Ona eksplicitno isključuje direktorije koji se ne distribuiraju (`tests/`, `_tasks/`, `_references/`, `_ideia/`, `_mono_repo/`, `docs/` itd.), tako da skener izvještava samo o putanjama koda koje zaista dospijevaju do korisnika objavljenog paketa — samo skeniranje pokreće Socket GitHub App čitanjem te datoteke, a ne radni tok u ovom repozitoriju. Za svaku kategoriju nalaza održavamo potvrdu održavaoca za pojedinačni nalaz: - **[`docs/security/SOCKET_DEV_FINDINGS.md`](docs/security/SOCKET_DEV_FINDINGS.md)** — mapa pojedinačnih nalaza: izvorna datoteka ↔ označeni segment ↔ ponašanje ↔ ublažavanje primijenjeno u v3.8.6. - Blokovi `SECURITY-AUDITOR-NOTE:` u izvornom kodu, na mjestu svake označene funkcije, upućuju na isti dokument. Za korisnike čiji proces ne može ublažiti upozorenje: izgradite pomoću `OMNIROUTE_BUILD_PROFILE=minimal npm run build`. Time se četiri osjetljiva modula zamjenjuju zamjenskim implementacijama koje tokom izvršavanja vraćaju HTTP 503 `feature-disabled`, tako da privilegovane putanje koda fizički nisu prisutne u paketu. Recept za objavljivanje potražite u [`docs/security/SOCKET_DEV_FINDINGS.md`](docs/security/SOCKET_DEV_FINDINGS.md). ## Reference - [`docs/architecture/AUTHZ_GUIDE.md`](docs/architecture/AUTHZ_GUIDE.md) — proces autorizacije - [`docs/security/GUARDRAILS.md`](docs/security/GUARDRAILS.md) — okvir zaštitnih mehanizama - [`docs/security/COMPLIANCE.md`](docs/security/COMPLIANCE.md) — zapisnik revizije i zadržavanje - [`docs/security/PUBLIC_CREDS.md`](docs/security/PUBLIC_CREDS.md) — **obavezni** obrazac za javne pristupne podatke nadređenih servisa - [`docs/security/ERROR_SANITIZATION.md`](docs/security/ERROR_SANITIZATION.md) — **obavezni** obrazac za odgovore o greškama - [`docs/security/SOCKET_DEV_FINDINGS.md`](docs/security/SOCKET_DEV_FINDINGS.md) — potvrda održavaoca za nalaze skenera lanca snabdijevanja - [`docs/architecture/RESILIENCE_GUIDE.md`](docs/architecture/RESILIENCE_GUIDE.md) — prekidač strujnog kola + period hlađenja + blokada - [`docs/security/STEALTH_GUIDE.md`](docs/security/STEALTH_GUIDE.md) — TLS identifikacija otiska (pravna/etička napomena) - [`CLAUDE.md`](CLAUDE.md) — stroga pravila za AI agente - [tldrsec/awesome-secure-defaults](https://github.com/tldrsec/awesome-secure-defaults) — odabrane biblioteke sa sigurnim zadanim postavkama