Přihlásit seDomluvit prezentaci

Kapitola 2.16

Zabezpečení a sítě

Co instalace vpouští dovnitř a ven, jak si její služby navzájem prokazují svou identitu a jaké ovládací prvky pro přihlašování a databázi operátor nastavuje nebo dědí.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

17 min čtení

Bezpečnostní prověrka organizace Harrow Port Authority položila Tomási Reillymu nejprve jedinou otázku: co opouští cluster? Jeho odpověď se vešla na jednu stránku. Nic v jmenném prostoru nexus nekomunikuje s ničím mimo něj, kromě dotazů do systému doménových jmen (DNS), aplikačního programovacího rozhraní (API) systému Kubernetes pro několik úloh a rozsahů adres, které organizace Harrow uvádí ve svém souboru hodnot. Neodesílá se žádná telemetrie a nedochází k žádnému volání domů. Prověrka se poté přesunula k přihlašování a databázi, což je zhruba pořadí, kterého se drží i tato kapitola.

Síťové zásady

Síťové politiky jsou ve výchozím nastavení zapnuté (networkPolicy.enabled: true) a chart začíná politikou zakazující veškerý provoz (deny-all) a zpětně povoluje pouze to, co Nexus potřebuje:

Politika Co umožňuje
nexus-default-deny Nic. Vybere každý pod ve jmenném prostoru, a to v obou směrech.
nexus-in-namespace Vzájemnou komunikaci podů systému Nexus a dotazy DNS na kube-dns v kube-system na portu 53.
nexus-token-review Ověřovače tokenů (nexus-probitas a nexus-orchestrator) a úlohu správy klíčů (key-custody Job), které přistupují k serveru Kubernetes API na portu 6443 nebo 443. Žádný jiný pod nemá připojený token API.
nexus-ingress-controller Jmenný prostor ingress kontroleru, který přistupuje ke třem veřejným službám a k ničemu jinému.
nexus-operator-egress Pody přistupující k rozsahům adres v networkPolicy.externalEgressCIDRs. Vykreslí se pouze tehdy, když tento seznam není prázdný.

Dva servery OpenBao jsou chráněny vlastní politikou. Jsou označeny štítkem jako součást úložiště klíčů, a nikoli jako součást systému Nexus, takže pravidlo pro provoz uvnitř jmenného prostoru se na ně nevztahuje. Komunikovat s nimi může pouze služba nexus-keys a její úlohy (mezi nimi i úloha správy klíčů) a s nástrojem pro odemykání (unsealer) může komunikovat pouze úložiště klíčů.

Podobu politik určují tři 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/24

ingressNamespace je jmenný prostor ingress kontroleru před třemi veřejnými hostiteli. Výchozí hodnota, kube-system, odpovídá distribuci k3s, která tam provozuje Traefik. Organizace Harrow provozuje svůj vlastní kontroler v ingress-nginx.

apiServerCIDRs jsou adresy serveru Kubernetes API uvedené jako rozsahy /32 Classless Inter-Domain Routing (CIDR). Pokud zůstanou prázdné, chart je při instalaci načte z objektu Endpoints kubernetes. Příkaz helm template nemá k dispozici žádný cluster, ze kterého by mohl číst, takže mu tyto hodnoty musí být předány, jinak se zastaví s chybou „networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read“.

externalEgressCIDRs uvádí vše mimo jmenný prostor, co musí Nexus volat. Prázdná hodnota znamená nic. Organizace Harrow zde uvádí svůj poštovní relay server a podsíť svých modelových serverů. Pokud připojíte hostovaného poskytovatele modelů, firemní přihlašovací službu mimo cluster nebo zdroj dat, patří sem i jejich rozsahy. Opomenutí některého z nich je obvyklým důvodem, proč klíč, který funguje na notebooku, selže v instalaci: volání nikdy neopustí cluster.

Velký zaoblený rámeček označený „namespace nexus (default deny)“. Uvnitř něj je shluk malých rámečků „console“, „nexus-auth“, „gateway“, „other Nexus services“ spojených obousměrnými šipkami označenými „in-namespace“. V jednom rohu uvnitř je samostatně ohraničený rámeček „key store: openbao, openbao-unsealer“, ke kterému vedou šipky pouze z „nexus-keys“ a „custody Job“. Mimo velký rámeček: vlevo „ingress controller namespace“ se šipkami vedoucími pouze do tří veřejných služeb; nahoře „kube-dns (port 53)“; vpravo nahoře „Kubernetes API server (apiServerCIDRs)“, ke kterému vedou šipky pouze z ověřovačů tokenů; vpravo „externalEgressCIDRs: mail relay, model servers“, ke kterému vedou šipky z podů systému Nexus. Každá další šipka směřující ven je nakreslena přeškrtnutá a označená „refused“.
Co síťové politiky povolují směrem do jmenného prostoru nexus a ven z něj.

Uvnitř produktu stránka Kam mohou odcházet volání uvádí každé externí místo, se kterým se může Nexus spojit, proč tam je a kdo ho přidal. Vše ostatní je odmítnuto s kódem, který jmenuje dané pravidlo. Na stránce se odmítnutí zobrazí jako EGRESS_DENIED. Rezidence dat funguje stejným způsobem o úroveň výš: v edici Enterprise stránka Kde jsou uložena data nastavuje region pro každý druh dat a organizace může uzamknout svůj provoz umělé inteligence (AI) na poskytovatele z EU, takže směrovač odmítne cokoli jiného (viz kapitola 2.14, Poskytovatelé a modely AI). Aplikace, která se pokusí spojit s adresou, již její manifest nikdy nedeklaroval, je zastavena na okraji sítě s kódem EGRESS_NOT_DECLARED.

Kam mohou odcházet volání
Kam mohou odcházet volání
Kam mohou odcházet volání. Každý povolený cíl uvádí, kdo jej přidal a proč; vše ostatní je odmítnuto a dnešní odmítnutí jsou vypsána spolu s pravidlem, které je zastavilo.

Identita služeb z místní certifikační autority

Nexus běží bez technologie service mesh. Chart má hodnotu istio.enabled, jejíž výchozí nastavení je false, a není důvod ji zapínat. Služby si místo toho navzájem prokazují svou identitu pomocí oboustranného TLS (mTLS): protokolu Transport Layer Security (TLS), kde obě strany předkládají certifikát. Certifikáty pocházejí z místní certifikační autority (CA), kterou chart vytváří prostřednictvím nástroje cert-manager v1.21.3, a není třeba instalovat nic dalšího.

Řetězec je krátký. Vydavatel podepsaný sám sebou (self-signed), nexus-selfsigned, podepisuje certifikát CA nexus-local-ca, což je klíč ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 platný po dobu deseti let. Nástroj cert-manager jej obnovuje 30 dní před vypršením platnosti. Druhý vydavatel se stejným názvem jím pak podepisuje vše ostatní.

Každá služba, která volá službu vyžadující oboustranné TLS, získá svůj vlastní klientský certifikát v objektu Secret pojmenovaném podle jejího servisního účtu (<service-account>-client-tls). Certifikát nese identitu SPIFFE dané služby jako svůj název URI:

spiffe://cluster.local/ns/<namespace>/sa/<service-account>

Volaná služba zkontroluje tento certifikát vůči místní CA a přečte z něj, kdo je volajícím. Každá úloha důvěřuje certifikační autoritě prostřednictvím položky ca.crt v objektu Secret svého vlastního certifikátu. Žádný pod nepřipojuje soukromý klíč CA a žádný objekt ConfigMap certifikační autoritu neobsahuje. Služba nexus-probitas poskytuje TLS sama z nexus-probitas-tls, což je 90denní certifikát obnovovaný 15 dní před vypršením platnosti.

Veřejný okraj sítě je oddělený a rozhoduje o něm hodnota tls.mode:

  • existing: objekt Secret pro TLS, který jste vytvořili, pojmenovaný v tls.existingSecret.
  • cert-manager: certifikáty z objektu ClusterIssuer, který provozujete, pojmenovaného v tls.clusterIssuer.
  • none: TLS končí před ingressem, na vašem vlastním load balanceru. Prohlížeč se musí ke konzoli přesto připojovat přes HTTPS (viz kapitola 2.17, Řešení potíží).

Samotná přihlašovací relace závisí na protokolu HTTPS. Konzole přijímá přihlášení pouze ze svého vlastního původu (origin), https://<hosts.console>, udržuje relaci v souboru cookie __Host- označeném příznakem Secure a přístupový klíč (passkey) prvního administrátora vyžaduje stránku s platným certifikátem. Prohlížeč využívající nezabezpečený protokol HTTP nebo nacházející se za varováním o certifikátu se nemůže přihlásit vůbec.

Datová vrstva uvnitř clusteru komunikuje se službami ve výchozím nastavení bez TLS (dataTier.postgres.sslmode: disable), protože tento provoz zůstává uvnitř jmenného prostoru pod ochranou výše uvedených politik. Externí databáze Postgres používá verify-full nebo verify-ca s certifikační autoritou serveru uloženou v objektu Secret daného úložiště, jak popisuje kapitola 2.11, Varianty: externí úložiště, TLS a ingress.

Telemetrie je vypnutá

Instalaci neopouští žádná telemetrie. Hodnota telemetry.enabled může být pouze false: schéma chartu jakoukoli jinou hodnotu odmítne. Vlastní hlášení datové vrstvy je rovněž vypnuto, takže Neo4j neodesílá žádná hlášení o využití a Qdrant neodesílá žádnou telemetrii.

Řízení registrací

Služba nexus-auth má dva ovládací prvky pro prověřování osob, které se registrují, a oba jsou v každé instalaci vypnuté.

Kontrola CAPTCHA ověřuje každou registraci pomocí hostované služby na internetu. Instalace není při registraci nikdy závislá na internetu, proto ji chart vypíná. Síťová prověrka potřebuje dvě databáze GeoLite2, aby mohla posoudit, odkud registrace přichází. Jedná se o licencované soubory ke stažení, které nejsou ani v obrazu služby nexus-auth, ani je nepřipojuje chart, a neexistuje žádná hodnota, kterou by šlo tuto prověrku zapnout. To, čeho se vzdáváte, je prověřování registrací ze sítí datových center a hostingů.

Místo toho získáváte schvalování. Registrace neznámé osoby je pozastavena, dokud ji neschválí administrátor, a do té doby systém této osobě odpovídá 403 SIGNUP_REQUIRES_APPROVAL. Žádný z přepínačů na tom nic nemění.

Limity požadavků a platnost tokenů

# 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ální počet požadavků, které může jedna přihlášená osoba vznést na službu nexus-auth za minutu, než služba odpoví 429. Každá osoba má stejný limit a vlastní servisní identita (service principal) platformy se do něj nezapočítává. Výchozí hodnota 5000 představuje přibližně 83 požadavků za sekundu z jednoho účtu, což je dostatečné pro lidi i skripty. Snižte ji pro zpřísnění, nebo ji zvyšte pro náročnou automatizaci. Jedná se o celé číslo od 1 výše. Ochrana proti útokům hrubou silou při přihlašování (uzamčení účtu a limity pokusů o druhý faktor) je oddělená a zde se nenastavuje.

Volající, který překročí limit, obdrží odpověď RATE_LIMITED s hlavičkou Retry-After a tělo zprávy obsahuje informaci o limitu a o tom, jak dlouho má čekat. V edici Enterprise nastavují administrátoři podrobnější limity na stránce Nastavení, Limity četnosti požadavků: počet požadavků za minutu a počet souběžných úloh pro každý klíč skriptu nebo aplikaci a pro každou jednotku. Volající, který překročí svůj limit, je požádán o vyčkání a nikdy není odpojen. Odebraný limit se vrátí na úroveň jednotky a poté na výchozí hodnotu.

Limity četnosti požadavků
Limity četnosti požadavků
Limity četnosti požadavků podle klíče a jednotky. Jeden skript opakuje pokusy příliš rychle a je zpomalován; stránka ukazuje odpověď 429, kterou skript vidí, a umožňuje administrátorovi zvýšit jeho limit s uvedením důvodu.

Hodnoty auth.accessTokenTTL a auth.refreshTokenTTL nastavují dobu platnosti přístupového tokenu (access token) a obnovovacího tokenu (refresh token). Dobu platnosti přístupového tokenu ponechte na jedné hodině nebo méně. Zásuvné moduly vytvořené pomocí sady Plugin SDK, což je sada pro vývoj softwaru určená pro rozšíření systému Nexus, odmítají token relace s dobou platnosti delší než jedna hodina s kódem JWT_LIFETIME_EXCEEDED.

proxy.trustedCIDRs jmenuje skoky proxy (proxy hops), jejichž hlavičce X-Forwarded-For služba nexus-auth důvěřuje. Výchozí hodnota, 10.42.0.0/16, je síť podů distribuce k3s, kde běží její Traefik. Na jiné distribuci ji nastavte na síť podů vašeho ingress kontroleru. Pokud je nastavena špatně, služba nexus-auth vidí každý požadavek, jako by přicházel z ingress kontroleru, takže níže uvedená pravidla adres by viděla pouze tuto adresu. Odlišná hlavička X-Forwarded-For z nedůvěryhodného skoku nikdy neotevře nové okno limitu četnosti požadavků.

Firemní přihlašování

Lidé se přihlašují pomocí přístupového klíče (passkey) nebo přes služby Google či GitHub a čtvrtým způsobem je firemní přihlášení. Administrátor se nikdy nepřihlašuje pouze heslem: druhou kontrolou je přístupový klíč.

Edice Community obsahuje jedno firemní přihlášení prostřednictvím protokolu OpenID Connect (OIDC) s vlastní obrazovkou nastavení a výsledkem testu. Edice Enterprise přidává protokol Security Assertion Markup Language (SAML), vynucení pro všechny uživatele a synchronizaci adresáře prostřednictvím protokolu System for Cross-domain Identity Management (SCIM).

Firemní přihlášení lze vyžadovat až poté, co administrátor provede v daném pořadí čtyři kroky: připojí přihlašovací službu, prokáže vlastnictví domény, přihlásí se přes ni svým vlastním účtem a určí jeden nouzový účet. Do té doby zůstává tlačítko Vyžadovat nepřístupné a stránka uvádí, které kroky chybí, pomocí kódu COMPANY_SIGNIN_STEPS_MISSING. Změna přihlašovací služby vymaže výsledek testu, takže novou službu je nutné otestovat znovu.

Firemní přihlášení
Firemní přihlašování
Firemní přihlášení lze vyžadovat až poté, co jej administrátor otestuje se svým vlastním účtem a určí nouzový účet. Každý krok musí být dokončen předtím, než se zpřístupní ten poslední.

Když firemní přihlašovací služba přestane odpovídat, přihlašovací stránka zobrazí IDP_UNREACHABLE (503). Lidé, kteří již jsou přihlášeni, zůstávají přihlášeni. Administrátoři mohou použít nouzové přihlášení administrátora, které vyžaduje zapečetěný kód uchovávaný v trezoru a přístupový klíč administrátora. Každé použití se zapíše do auditního protokolu s informací, kdo jej použil a odkud, je okamžitě oznámeno každému administrátorovi a skončí po 4 hodinách nebo ve chvíli, kdy se firemní přihlášení obnoví.

Všichni v organizaci se přihlašují do stejné konzole a vykonávají tam svou každodenní práci; vlastníci a administrátoři vidí také stránky správy. Člen, který otevře některou z těchto stránek, uvidí stránku Nejste administrátor se zašedlými řádky a jmény osob, které je mohou měnit (NOT_AN_ADMINISTRATOR).

Podezřelá přihlášení a pravidla pro adresy

V edici Enterprise uvádí stránka Podezřelá přihlášení přihlášení heslem, která vypadala jako nová nebo neobvyklá: nové místo či zařízení nebo chybná hesla zadaná dříve téhož dne. U každého z nich je uvedeno, co systém Nexus udělal, ať už šlo o vyžádání druhé kontroly, nebo o zablokování přihlášení. Někdo pak u každého řádku odpoví buď možností Nebyl(a) to on(a), což ukončí přihlášení dané osoby, nebo Byl(a) to on(a).

Stránka Povolené a blokované adresy obsahuje dva seznamy. Povolené rozsahy představují jediná místa, odkud se mohou přihlašovat vlastníci a administrátoři; pokud nejsou zadány žádné, mohou se přihlašovat odkudkoli. Členů se toto omezení netýká. Blokované adresy jsou místa, odkud se nemůže přihlásit nikdo. U každého záznamu je uvedeno, kdo jej přidal a kdy omezení skončí. Každá změna je nejprve otestována vůči vaší vlastní aktuální adrese a změna, která by vás vymkla, je odmítnuta a nic se neuloží. Zpřísnění rozsahu okamžitě ukončí přihlášení těch administrátorů, které již nový rozsah nepouští dovnitř.

Povolené a blokované adresy
Povolené a blokované adresy
Pravidla adres. Štítek nahoře uvádí, jak pravidla vyhodnocují vlastní adresu administrátorky, takže změna, která by ji vymkla, je odmítnuta ještě před uložením.

Klíče a certifikáty

Data každé organizace jsou uzamčena jejím vlastním klíčem, který spravuje vámi zvolený správce (custodian): hardwarový bezpečnostní modul (HSM) nebo software. Stránka Klíče zobrazuje verze klíče organizace a termín příští rotace. Verze zůstává čitelná i poté, co přestane být aktuální, dokud pod ní není zabaleno již vůbec nic. Samotné klíče se nikdy nezobrazují, pouze jejich otisky (fingerprints).

Zničení klíče je způsob, jakým Nexus maže data. Na stránce Klíče a výmaz funkce Vymazat zničí klíč jedné osoby nebo celé organizace, čímž se vše, co tento klíč uzamkl, stane všude nečitelným, včetně záloh. Tento krok nelze vrátit zpět, proto vyžaduje písemný důvod a druhou osobu. Zanechá potvrzení, které zaznamenává, co bylo vymazáno a kým, ale nikdy ne samotný obsah.

Stránka Klíče před vypršením platnosti uvádí tokeny poskytovatelů a certifikáty, kterým brzy skončí platnost, kdo a kdy bude varován a co se zastaví, pokud některý z nich propadne. Běžící práce se nezastaví a směrovač AI přejde na záložní klíč.

Schvalování čtyřma očima

V edici Enterprise mohou politiky pozdržet citlivé změny pro schválení druhou osobou. Stránka Schvalování čtyř očí uvádí každou čekající žádost s informací o tom, kdo o ni požádal, proč, kolik schválení potřebuje a kdy propadne. Nikdo nemůže schválit svou vlastní žádost (TRUST_APPROVAL_SELF_APPROVAL) a na žádost, o které již bylo rozhodnuto, systém odpoví APPROVAL_ALREADY_DECIDED. Zamítnutí žádosti vyžaduje uvedení důvodu. Žádost, o které nikdo včas nerozhodne, propadne a nic se nezmění. Které změny zde čekají, určují politiky vyžadující druhou osobu: obnovení zálohy a přidání licenčních míst (seats) jsou dva příklady uvedené na jiném místě této příručky.

Schvalování čtyř očí
Schvalování čtyřma očima
Změny čekající na druhou osobu. U každé žádosti je uvedeno, kdo o ni požádal a kdy propadne, a osoba, která o ni požádala, nemá u své vlastní žádosti tlačítko Schválit.

Pohled očima jiného uživatele

Podpora uvnitř organizace někdy znamená vidět stránku tak, jak ji vidí kolega. V edici Enterprise poskytuje funkce Vidět to jako oni administrátorovi pohled na konzoli pouze pro čtení přesně tak, jak ji vidí jeden ze členů, a to na dobu 30 minut po druhé kontrole a uvedení písemného důvodu. Člen je o tom informován. Jeho soukromé položky (pošta, zápisníky, přímé zprávy a to, co si pro něj pamatuje asistent) se nikdy nezobrazují, po celou dobu je v horní části zobrazen banner a vše se zaznamenává do auditního protokolu.

Velké změny mají svou vlastní pauzu. Než se uloží změna s rozsáhlými dopady, překryvné okno Než tato změna proběhne vypíše, co přestane fungovat, co vyžaduje pozornost a čeho se změna nedotkne. Změna není zablokována. Je pouze učiněna dostatečně náročnou na to, abyste se nad ní zamysleli, a v edici Enterprise citlivá změna navíc čeká na druhou osobu.

Uchovávání a streamování auditních záznamů

Auditní protokol zaznamenává, kdo co udělal, od nejnovějších záznamů po nejstarší, a lze jej filtrovat a exportovat. Edice Community uchovává záznamy po dobu 30 dnů a exportuje soubor tabulkového procesoru. Edice Enterprise je uchovává tak dlouho, jak určuje vaše politika uchovávání dat na stránce Uchovávání a mazání v části Nastavení, a streamuje je do vašeho systému bezpečnostního monitoringu. Zaznamenávají se i odmítnutí, takže osoba, které byl přístup odepřen, zanechá v protokolu řádek stejně jako osoba, která uspěla. Záznamy o správě a řízení (governance) na pozadí jsou zřetězeny pro každou organizaci zvlášť, takže každá organizace si může zkontrolovat svůj vlastní výřez, aniž by viděla záznamy kohokoli jiného.

Databázové role

Nexus nikdy nespouští své služby pod účtem databázového superuživatele. Zaváděcí (bootstrap) hook, což je jediná část, která drží oprávnění superuživatele clusteru kromě jednorázového kroku zřízení (provisioning) backendu pro frontend (BFF) konzole, vytváří tyto role:

Role Co to je
nexus_migrator LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Vlastní databázi nexus a každý objekt, který migrace vytvoří, a vytváří role, které migrace jmenují.
nexus_runtime Skupina, která se nemůže přihlásit. Uděluje oprávnění k připojení a používání schématu, ale žádná práva k tabulkám.
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills Vlastní přihlašovací účet každé služby: NOSUPERUSER NOBYPASSRLS, člen skupiny nexus_runtime, kterému jeho vlastní migrace udělují práva k jeho vlastním tabulkám a k ničemu jinému.
nexus_ledger_reader Čte jednu tabulku, knihu vydání (release ledger), pro inicializační kontejnery wait-for-schema. Žádné další oprávnění nemá.

Protože žádná role služby nevlastní své tabulky a žádná nemůže obejít zabezpečení na úrovni řádků (RLS), vztahuje se každá politika RLS na každé připojení služby. Zabezpečení na úrovni řádků je na tabulkách služby nexus-auth vynuceno, takže se jím musí řídit i jejich vlastník. Pokud na vašem serveru již existuje role s názvem nexus s atributem SUPERUSER nebo BYPASSRLS, zaváděcí proces (bootstrap) odmítne pokračovat: „role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done.“ Odeberte tento atribut nebo použijte jiný server.