Verzia 1.0.0-alpha.1najnovšia
Kapitola 2.16
Bezpečnosť a siete
Čo inštalácia prepúšťa dnu a von, ako si jej služby navzájom preukazujú identitu a aké ovládacie prvky nastavuje alebo dedí operátor pre prihlasovanie a databázu.
Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

Bezpečnostná previerka v Harrow Port Authority položila Tomásovi Reillymu ako prvú jedinú otázku: čo opúšťa klaster? Jeho odpoveď sa zmestila na jednu stranu. Nič v mennom priestore nexus nekomunikuje s ničím mimo neho, s výnimkou vyhľadávaní v systéme doménových mien (DNS), aplikačného programovacieho rozhrania (API) Kubernetes pre niekoľko pracovných záťaží a rozsahov adries, ktoré Harrow uvádza vo svojom súbore hodnôt. Neexistuje tu žiadna telemetria a žiadne volania domov. Previerka sa potom presunula k prihlasovaniu a databáze, čo je zhruba poradie, ktoré sleduje táto kapitola.
Sieťové politiky
Sieťové politiky sú predvolene zapnuté (networkPolicy.enabled: true) a chart začína politikou odmietnutia všetkého (deny-all) a späť pridáva len to, čo Nexus potrebuje:
| Politika | Čo umožňuje |
|---|---|
nexus-default-deny |
Nič. Vyberá každý pod v mennom priestore, v oboch smeroch. |
nexus-in-namespace |
Pody Nexus komunikujúce medzi sebou a vyhľadávania DNS na kube-dns v kube-system na porte 53. |
nexus-token-review |
Kontrolóri tokenov (nexus-probitas a nexus-orchestrator) a úloha (Job) správy kľúčov pristupujúca k API serveru Kubernetes na porte 6443 alebo 443. Žiadny iný pod nemá pripojený API token. |
nexus-ingress-controller |
Menný priestor ingress kontroléra pristupujúci k trom verejným službám a k ničomu inému. |
nexus-operator-egress |
Pody pristupujúce k rozsahom adries v networkPolicy.externalEgressCIDRs. Vykreslí sa len vtedy, keď tento zoznam nie je prázdny. |
Dva servery OpenBao sa nachádzajú za vlastnou politikou. Sú označené ako súčasť úložiska kľúčov a nie ako súčasť systému Nexus, takže pravidlo v rámci menného priestoru na ne nedosiahne. Komunikovať s nimi môže iba nexus-keys a jeho úlohy (medzi nimi aj úloha správy kľúčov) a iba úložisko kľúčov môže komunikovať s odomykačom (unsealer).
Politiky formujú tri hodnoty:
# harrow-values.yaml (Helm values): network policy
networkPolicy:
enabled: true
ingressNamespace: ingress-nginx
apiServerCIDRs:
- 10.40.0.10/32
externalEgressCIDRs:
- 10.40.30.25/32
- 10.40.20.0/24ingressNamespace je menný priestor ingress kontroléra pred tromi verejnými hostiteľmi. Predvolená hodnota, kube-system, vyhovuje systému k3s, ktorý tam dodáva Traefik. Harrow prevádzkuje svoj vlastný kontrolér v ingress-nginx.
apiServerCIDRs sú adresy API servera Kubernetes ako rozsahy /32 Classless Inter-Domain Routing (CIDR). Ak sa ponechajú prázdne, chart ich pri inštalácii načíta z objektov Endpoints kubernetes. helm template nemá žiadny klaster, z ktorého by mohol čítať, takže mu musia byť zadané, inak sa zastaví s chybou „networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read“.
externalEgressCIDRs uvádza všetko mimo menného priestoru, čo musí Nexus volať. Prázdna hodnota znamená nič. Harrow uvádza svoj poštový relé server (mail relay) a podsieť svojich modelových serverov. Ak pripojíte hostovaného poskytovateľa modelov, firemnú prihlasovaciu službu mimo klastra alebo zdroj údajov, jeho rozsahy patria tiež sem. Zabudnutie jedného z nich je zvyčajným dôvodom, prečo kľúč, ktorý funguje na prenosnom počítači, zlyhá na inštalácii: volanie nikdy neopustí klaster.
Vnútri produktu stránka Kam môžu odchádzať volania uvádza každé externé miesto, ktoré môže Nexus osloviť, prečo tam je a kto ho pridal. Všetko ostatné je odmietnuté s kódom, ktorý pomenúva príslušné pravidlo. Na stránke znie odmietnutie EGRESS_DENIED. Rezidencia údajov funguje rovnakým spôsobom o úroveň vyššie: vo verzii Enterprise stránka Kde sa nachádzajú údaje nastavuje región pre každý druh údajov a organizácia môže uzamknúť svoju prevádzku umelej inteligencie (AI) na poskytovateľov z EÚ, takže smerovač odmietne čokoľvek iné (pozri kapitolu 2.14, Poskytovatelia a modely AI). Aplikácia, ktorá sa pokúsi osloviť adresu, ktorú jej manifest nikdy nedeklaroval, je zastavená na okraji siete s kódom EGRESS_NOT_DECLARED.
Identita služieb z miestnej certifikačnej autority
Nexus beží bez technológie service mesh. Chart má hodnotu istio.enabled, predvolene nastavenú na false, a nie je dôvod ju zapínať. Služby si namiesto toho navzájom dokazujú svoju identitu pomocou vzájomného TLS (mTLS): Transport Layer Security (TLS), kde obe strany predložia certifikát. Certifikáty pochádzajú z lokálnej certifikačnej autority (CA), ktorú chart vytvára prostredníctvom cert-manager v1.21.3, a nie je potrebné inštalovať nič ďalšie.
Reťazec je krátky. Vydavateľ s vlastným podpisom (self-signed), nexus-selfsigned, podpisuje certifikát CA nexus-local-ca, čo je kľúč ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 platný desať rokov. cert-manager ho obnovuje 30 dní pred vypršaním platnosti. Druhý vydavateľ s rovnakým názvom ním podpisuje všetko ostatné.
Každá služba, ktorá volá službu vyžadujúcu vzájomné TLS, dostane svoj vlastný klientsky certifikát v objekte Secret pomenovanom podľa jej servisného účtu (<service-account>-client-tls). Certifikát nesie identitu SPIFFE danej služby ako svoj názov URI:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Volaná služba skontroluje tento certifikát voči lokálnej CA a prečíta z neho, kto je volajúci. Každá pracovná záťaž dôveruje CA prostredníctvom ca.crt v objekte Secret svojho vlastného certifikátu. Žiadny pod nepripája súkromný kľúč CA a žiadny ConfigMap nenesie CA. Samotný nexus-probitas poskytuje TLS z nexus-probitas-tls, čo je 90-dňový certifikát obnovovaný 15 dní pred vypršaním platnosti.
Verejný okraj siete je oddelený a rozhoduje o ňom tls.mode:
existing: objekt TLS Secret, ktorý ste vytvorili, pomenovaný vtls.existingSecret.cert-manager: certifikáty od vydavateľa ClusterIssuer, ktorého prevádzkujete, pomenovaného vtls.clusterIssuer.none: TLS končí pred ingressom, na vašom vlastnom vyvažovači záťaže (load balancer). Prehliadač musí stále pristupovať ku konzole cez HTTPS (pozri kapitolu 2.17, Riešenie problémov).
Samotná prihlasovacia relácia závisí od protokolu HTTPS. Konzola akceptuje prihlásenie iba zo svojho vlastného pôvodu (origin), https://<hosts.console>, udržiava reláciu v súbore cookie __Host- označenom ako Secure a prístupový kľúč (passkey) prvého správcu vyžaduje stránku s platným certifikátom. Prehliadač na nezabezpečenom protokole HTTP alebo za varovaním o certifikáte sa vôbec nedokáže prihlásiť.
Dátová vrstva v klastri komunikuje so službami predvolene bez TLS (dataTier.postgres.sslmode: disable), pretože táto prevádzka zostáva vnútri menného priestoru pod vyššie uvedenými politikami. Externý Postgres používa verify-full alebo verify-ca, s CA servera v objekte Secret úložiska, ako opisuje kapitola 2.11, Variácie: externé úložiská, TLS a ingress.
Telemetria je vypnutá
Inštaláciu neopúšťa žiadna telemetria. telemetry.enabled môže byť iba false: schéma chartu odmieta akúkoľvek inú hodnotu. Vlastné hlásenia dátovej vrstvy sú takisto vypnuté, takže Neo4j neposiela žiadne správy o používaní a Qdrant neposiela žiadnu telemetriu.
Kontrola registrácií
nexus-auth má dva ovládacie prvky na preverovanie ľudí, ktorí sa registrujú, a oba sú na každej inštalácii vypnuté.
Kontrola CAPTCHA overuje každú registráciu pomocou hostovanej služby na internete. Inštalácia pri registrácii nikdy nezávisí od internetu, takže chart ju vypína. Sieťové preverovanie potrebuje dve databázy GeoLite2, aby posúdilo, odkiaľ registrácia prichádza. Ide o licencované súbory na stiahnutie, ktoré nie sú ani v obraze nexus-auth, ani pripojené chartom, a neexistuje žiadna hodnota na zapnutie tohto preverovania. To, čoho sa vzdávate, je preverovanie registrácií zo sietí dátových centier a hostingov.
Namiesto toho získate schvaľovanie. Registrácia neznámej osoby je pozdržaná, kým ju neschváli správca, a dovtedy osoba dostáva odpoveď 403 SIGNUP_REQUIRES_APPROVAL. Žiadny z prepínačov to nemení.
Limity frekvencie požiadaviek a životnosť tokenov
# harrow-values.yaml (Helm values): sign-in service
auth:
rateLimitPerMinute: 5000
accessTokenTTL: 15m
refreshTokenTTL: 12h
proxy:
trustedCIDRs: "10.244.0.0/16"auth.rateLimitPerMinute je maximálny počet požiadaviek, ktoré môže jedna prihlásená osoba vykonať voči službe nexus-auth za minútu predtým, než odpovie 429. Každá osoba dostane rovnaký limit a vlastný servisný účet (service principal) platformy sa doň nezapočítava. Predvolená hodnota 5000 predstavuje približne 83 za sekundu z jedného účtu, čo je dostatok pre ľudí aj skripty. Znížte ju pre sprísnenie alebo ju zvýšte pre náročnú automatizáciu. Je to celé číslo s hodnotou 1 alebo viac. Ochrana proti útokom hrubou silou pri prihlasovaní (uzamknutie účtu a limity na pokusy druhého faktora) je oddelená a nenastavuje sa tu.
Volajúci, ktorý prekročí limit, dostane RATE_LIMITED s hlavičkou Retry-After a telo správy obsahuje limit a informáciu, ako dlho treba čakať. Vo verzii Enterprise nastavujú správcovia jemnejšie limity v časti Nastavenia, Limity frekvencie: požiadavky za minútu a súčasne bežiace úlohy, pre každý kľúč skriptu alebo aplikáciu a pre každú organizačnú jednotku. Volajúci, ktorý prekročí svoj limit, je požiadaný, aby počkal, a nikdy nie je odpojený. Odobratý limit sa vráti na úroveň jednotky a potom na predvolenú hodnotu.
auth.accessTokenTTL a auth.refreshTokenTTL určujú, ako dlho sú platné prístupový token a obnovovací token. Prístupový token ponechajte s platnosťou jednu hodinu alebo menej. Zásuvné moduly vytvorené pomocou Plugin SDK, softvérovej vývojovej sady pre rozšírenia systému Nexus, odmietajú token relácie, ktorý je platný dlhšie ako hodinu, s kódom JWT_LIFETIME_EXCEEDED.
proxy.trustedCIDRs menuje proxy skoky (hops), ktorých hlavičke X-Forwarded-For služba nexus-auth dôveruje. Predvolená hodnota, 10.42.0.0/16, je sieť podov k3s, v ktorej beží jej Traefik. Na inej distribúcii ju nastavte na sieť podov vášho ingress kontroléra. Ak je nastavená nesprávne, nexus-auth vníma každú požiadavku ako prichádzajúcu z ingress kontroléra, takže pravidlá adries uvedené nižšie by videli iba túto adresu. Iná hlavička X-Forwarded-For z nedôveryhodného skoku nikdy neotvorí nové okno limitu frekvencie.
Firemné prihlasovanie
Ľudia sa prihlasujú pomocou prístupového kľúča (passkey) alebo cez Google či GitHub, pričom firemné prihlásenie je štvrtým spôsobom. Administrátor sa nikdy neprihlasuje iba pomocou hesla: druhou kontrolou je prístupový kľúč.
Edícia Community zahŕňa jedno firemné prihlásenie cez OpenID Connect (OIDC) s vlastnou obrazovkou nastavenia a výsledkom testu. Edícia Enterprise pridáva Security Assertion Markup Language (SAML), vynútenie pre všetkých a synchronizáciu adresára cez System for Cross-domain Identity Management (SCIM).
Firemné prihlásenie je možné vyžadovať až vtedy, keď administrátor vykoná štyri kroky v tomto poradí: pripojí prihlasovaciu službu, potvrdí doménu, prihlási sa cez ňu vlastným účtom a určí jeden núdzový účet. Dovtedy zostáva tlačidlo Vyžadovať neaktívne a stránka uvádza, ktoré kroky chýbajú, pomocou kódu COMPANY_SIGNIN_STEPS_MISSING. Zmena prihlasovacej služby vymaže test, takže novú službu je potrebné otestovať znova.
Keď služba firemného prihlásenia prestane odpovedať, prihlasovacia stránka zobrazí IDP_UNREACHABLE (503). Ľudia, ktorí už sú prihlásení, zostávajú prihlásení. Administrátori môžu použiť núdzové prihlásenie administrátora, ktoré vyžaduje zapečatený kód uložený v trezore a prístupový kľúč administrátora. Každé použitie sa zapíše do audítorského záznamu s informáciou, kto ho použil a odkiaľ, okamžite sa oznámi každému administrátorovi a skončí po 4 hodinách alebo po obnovení firemného prihlásenia.
Každý v organizácii sa prihlasuje do rovnakej konzoly a vykonáva tam svoju každodennú prácu; vlastníci a administrátori vidia aj stránky administrácie. Člen, ktorý otvorí jednu z týchto stránok, uvidí stránku Nie ste administrátor so sivými riadkami a menami ľudí, ktorí ich môžu zmeniť (NOT_AN_ADMINISTRATOR).
Podozrivé prihlásenia a pravidlá pre adresy
V edícii Enterprise časť Podozrivé prihlásenia uvádza prihlásenia heslom, ktoré vyzerali ako nové alebo nezvyčajné: nové miesto alebo zariadenie, prípadne nesprávne heslá zadané skôr v ten deň. Pri každom z nich sa uvádza, čo Nexus urobil, či už išlo o vyžiadanie druhej kontroly alebo zablokovanie prihlásenia. Niekto na každý riadok odpovie možnosťou Neboli to oni, čo ukončí prihlásenia danej osoby, alebo Boli to oni.
Časť Povolené a blokované adresy obsahuje dva zoznamy. Povolené rozsahy sú jediné miesta, odkiaľ sa môžu prihlásiť vlastníci a administrátori; ak nie sú uvedené žiadne, prihlasujú sa odkiaľkoľvek. Členov sa to netýka. Blokované adresy sú miesta, odkiaľ sa neprihlási nikto. Každý záznam eviduje, kto ho pridal a kedy jeho platnosť skončí. Každá zmena sa najprv otestuje voči vašej vlastnej aktuálnej adrese a zmena, ktorá by vás vymkla, sa odmietne a nič sa neuloží. Sprísnenie rozsahu okamžite ukončí prihlásenia administrátorov, ktorých už dnu nepustí.
Kľúče a certifikáty
Údaje každej organizácie sú uzamknuté jej vlastným kľúčom, ktorý drží vami zvolený správca: hardvérový bezpečnostný modul alebo softvér. Stránka Kľúče zobrazuje verzie kľúča organizácie a termín nasledujúcej rotácie. Verzia zostáva čitateľná aj po tom, čo prestane byť aktuálna, až kým pod ňou nie je nič zabalené. Samotné kľúče sa nikdy nezobrazujú, iba ich odtlačky (fingerprints).
Zničenie kľúča je spôsob, akým Nexus vymazáva údaje. Na stránke Kľúče a vymazanie funkcia Vymazať zničí kľúč jednej osoby alebo celej organizácie, čím sa všetko, čo uzamkol, stane všade nečitateľným, vrátane záloh. Tento krok sa nedá vrátiť späť, preto vyžaduje písomný dôvod a druhú osobu. Zanechá potvrdenie, ktoré zaznamenáva, čo bolo vymazané a kým, nikdy nie samotný obsah.
Časť Kľúče s končiacou platnosťou uvádza tokeny poskytovateľov a certifikáty, ktorých platnosť čoskoro skončí, informáciu o tom, kto a kedy bude upozornený, a čo sa zastaví, ak platnosť niektorého z nich vyprší. Bežiaca práca sa nezastaví a AI smerovač (router) prepne na záložný kľúč.
Schvaľovanie štyrmi očami
V edícii Enterprise môžu politiky pozdržať citlivé zmeny pre druhú osobu. Časť Schválenia štyrmi očami uvádza každú čakajúcu žiadosť s informáciou, kto o ňu požiadal, prečo, koľko schválení potrebuje a kedy jej platnosť vyprší. Nikto neschvaľuje vlastnú žiadosť (TRUST_APPROVAL_SELF_APPROVAL) a žiadosť, o ktorej už bolo rozhodnuté, vráti APPROVAL_ALREADY_DECIDED. Zamietnutie žiadosti vyžaduje uvedenie dôvodu. Žiadosť, o ktorej nikto včas nerozhodne, prepadne a nič sa nezmení. To, ktoré zmeny tu čakajú, určujú politiky vyžadujúce druhú osobu: obnovenie zálohy a pridanie miest (seats) sú dva príklady uvedené inde v tejto príručke.
Zobrazenie pohľadu iného používateľa
Podpora v rámci organizácie niekedy znamená vidieť stránku tak, ako ju vidí kolega. V edícii Enterprise funkcia Vidieť to ako oni poskytuje administrátorovi pohľad na konzolu iba na čítanie tak, ako ju vidí jeden člen, na 30 minút, po druhej kontrole a uvedení písomného dôvodu. Člen je o tom informovaný. Jeho súkromné položky (pošta, poznámkové bloky, priame správy a to, čo si pre neho pamätá asistent) sa nikdy nezobrazia, v hornej časti je po celý čas umiestnený banner a všetko sa zaznamenáva do audítorského záznamu.
Veľké zmeny majú vlastnú pauzu. Pred uložením zmeny so širokým dosahom sa zobrazí prekryvná vrstva Predtým, ako táto zmena nastane, ktorá uvádza, čo sa pokazí, čo si vyžaduje pozornosť a čo zostane nedotknuté. Zmena nie je zablokovaná. Je len urobená dostatočne náročnou na to, aby ste sa nad ňou zamysleli, a v edícii Enterprise citlivá zmena navyše čaká na druhú osobu.
Uchovávanie a streamovanie auditných záznamov
Audítorský záznam eviduje, kto čo urobil, od najnovších záznamov, a je možné ho filtrovať a exportovať. Edícia Community uchováva záznamy 30 dní a exportuje súbor tabuľkového procesora. Edícia Enterprise ich uchováva tak dlho, ako určuje vaša politika uchovávania údajov na stránke Uchovávanie a mazanie v časti Nastavenia, a streamuje ich do vášho systému monitorovania bezpečnosti. Zaznamenávajú sa aj odmietnutia, takže osoba, ktorej bola akcia zamietnutá, zanechá riadok rovnako ako osoba, ktorá uspela. Záznamy riadenia (governance) na pozadí sú zreťazené pre každú organizáciu, takže každá organizácia si môže skontrolovať svoj vlastný výsek bez toho, aby videla záznamy kohokoľvek iného.
Databázové roly
Nexus nikdy nespúšťa svoje služby ako databázový superpoužívateľ (superuser). Zavádzací skript (bootstrap hook), ktorý je jedinou časťou držiacou superpoužívateľa klastra okrem jednorazového kroku zriadenia backendu pre frontend (BFF) konzoly, vytvára tieto roly:
| Rola | Čo to je |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Vlastní databázu nexus a každý objekt, ktorý migrácie vytvoria, a vytvára roly, ktoré migrácie menujú. |
nexus_runtime |
Skupina, ktorá sa nemôže prihlásiť. Udeľuje práva na pripojenie a používanie schémy, ale žiadne práva k tabuľkám. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
Vlastné prihlásenie každej služby: NOSUPERUSER NOBYPASSRLS, člen nexus_runtime, ktorému sú udelené práva k jeho vlastným tabuľkám prostredníctvom jeho vlastných migrácií a nič iné. |
nexus_ledger_reader |
Číta jednu tabuľku, účtovnú knihu vydaní (release ledger), pre init kontajnery wait-for-schema. Žiadne iné oprávnenie. |
Keďže žiadna rola služby nevlastní svoje tabuľky a žiadna nemôže obísť zabezpečenie na úrovni riadkov (RLS), každá politika RLS sa vzťahuje na každé pripojenie služby. Zabezpečenie na úrovni riadkov je na tabuľkách služby nexus-auth vynútené, takže sa ním musí riadiť aj ich vlastník. Ak rola s názvom nexus už na vašom serveri existuje s atribútom SUPERUSER alebo BYPASSRLS, zavádzací proces (bootstrap) odmietne pokračovať: „role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done.“ Odstráňte tento atribút alebo použite iný server.




