PrijavaRezervirajte predstavitev

Poglavje 2.16

Varnost in omrežje

Kaj namestitev spusti noter in ven, kako njene storitve druga drugi dokažejo svojo identiteto ter nadzorne nastavitve, ki jih upravljavec določi ali podeduje za prijavo in podatkovno zbirko.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

17 min branja

Pri varnostnem pregledu v organizaciji Harrow Port Authority so Tomásu Reillyju najprej postavili eno vprašanje: kaj zapusti gručo? Njegov odgovor je šel na eno stran. Nič v imenskem prostoru nexus ne doseže ničesar zunaj njega, razen poizvedb sistema domenskih imen (DNS), aplikacijskega programskega vmesnika (API) Kubernetes za nekaj delovnih obremenitev in obsegov naslovov, ki jih Harrow navede v svoji datoteki z vrednostmi. Ni telemetrije in ni klicev domov. Pregled se je nato premaknil na prijavo in podatkovno bazo, kar je približno vrstni red, ki mu sledi to poglavje.

Omrežni pravilniki

Omrežni pravilniki so privzeto vklopljeni (networkPolicy.enabled: true), grafikona Helm pa začne s pravilnikom, ki zavrne vse, in nazaj doda le tisto, kar Nexus potrebuje:

Pravilnik Kaj omogoča
nexus-default-deny Nič. Izbere vsak pod v imenskem prostoru v obeh smereh.
nexus-in-namespace Podi Nexus, ki komunicirajo med seboj, in poizvedbe DNS na kube-dns v kube-system na vratih 53.
nexus-token-review Pregledovalci žetonov (nexus-probitas in nexus-orchestrator) ter opravilo (Job) za hrambo ključev, ki dosegajo strežnik API Kubernetes na vratih 6443 ali 443. Noben drug pod nima priklopljenega žetona API.
nexus-ingress-controller Imenski prostor vhodnega krmilnika (ingress controller), ki dosega tri javne storitve in nič drugega.
nexus-operator-egress Podi, ki dosegajo obsege naslovov v networkPolicy.externalEgressCIDRs. Izriše se le, ko ta seznam ni prazen.

Dva strežnika OpenBao sta za svojim lastnim pravilnikom. Označena sta kot del shrambe ključev in ne kot del sistema Nexus, zato pravilo znotraj imenskega prostora do njiju ne seže. Z njima lahko komunicira le nexus-keys in njegova opravila (med njimi opravilo za hrambo), z odklepalnikom (unsealer) pa lahko komunicira le shramba ključev.

Pravilnike oblikujejo tri vrednosti:

# 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 imenski prostor vhodnega krmilnika pred tremi javnimi gostitelji. Privzeta vrednost, kube-system, ustreza distribuciji k3s, ki tam namesti Traefik. Harrow poganja svoj lastni krmilnik v ingress-nginx.

apiServerCIDRs so naslovi strežnika API Kubernetes kot obsegi brezrazrednega meddomenskega usmerjanja (CIDR) /32. Če ostane prazno, jih grafikona ob namestitvi prebere iz končnih točk (Endpoints) kubernetes. helm template nima gruče za branje, zato mu jih je treba podati, sicer se ustavi z napako "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".

externalEgressCIDRs navaja vse zunaj imenskega prostora, kar mora Nexus klicati. Prazno pomeni nič. Harrow navaja svoj poštni posrednik in podomrežje svojih strežnikov modelov. Če povežete gostovanega ponudnika modelov, storitev za prijavo v podjetju zunaj gruče ali vir podatkov, njegovi obsegi prav tako spadajo sem. Če katerega pozabite, je to običajen razlog, da ključ, ki deluje na prenosniku, odpove na namestitvi: klic nikoli ne zapusti gruče.

Velik zaobljen okvir z oznako "namespace nexus (default deny)". Znotraj njega je gruča majhnih okvirjev "console", "nexus-auth", "gateway", "other Nexus services", povezanih z dvosmernimi puščicami z oznako "in-namespace". V enem kotu znotraj je ločeno obrobljen okvir "key store: openbao, openbao-unsealer" s puščicami samo iz "nexus-keys" in "custody Job". Zunaj velikega okvirja: na levi "ingress controller namespace" s puščicami samo v tri javne storitve; na vrhu "kube-dns (port 53)"; zgoraj desno "Kubernetes API server (apiServerCIDRs)", dosežen samo iz pregledovalcev žetonov; na desni "externalEgressCIDRs: mail relay, model servers", dosežen iz podov Nexus. Vsaka druga puščica navzven je narisana prečrtano in označena z "refused".
Kaj omrežni pravilniki dovoljujejo v imenski prostor nexus in iz njega.

Znotraj izdelka stran Kam lahko gredo klici (Where calls can leave) navaja vsako zunanje mesto, ki ga Nexus lahko doseže, zakaj je tam in kdo ga je dodal. Vse drugo je zavrnjeno s kodo, ki imenuje pravilo. Na strani se zavrnitev glasi EGRESS_DENIED. Rezidenčnost deluje na enak način eno raven višje: v izdaji Enterprise možnost Kje živijo podatki (Where data lives) določa regijo za vsako vrsto podatkov, organizacija pa lahko svoj promet umetne inteligence (UI) zaklene na ponudnike iz EU, tako da usmerjevalnik zavrne vse drugo (glejte poglavje 2.14, Ponudniki in modeli UI). Aplikacija, ki poskuša doseči naslov, ki ga njen manifest ni nikoli deklariral, je ustavljena na robu z EGRESS_NOT_DECLARED.

Kam lahko gredo klici
Kam lahko gredo klici
Kam lahko gredo klici. Vsak dovoljeni cilj navaja, kdo ga je dodal in zakaj; vse drugo je zavrnjeno, današnje zavrnitve pa so navedene s pravilom, ki jih je ustavilo.

Identiteta storitev lokalnega overitelja potrdil

Nexus deluje brez mreže storitev (service mesh). Grafikona ima vrednost istio.enabled, ki je privzeto nastavljena na false, in ni razloga za njen vklop. Storitve druga drugi dokazujejo svojo identiteto z vzajemnim TLS (mTLS): varnostjo transportne plasti (TLS), kjer obe strani pokažeta potrdilo. Potrdila prihajajo od lokalnega overitelja potrdil (CA), ki ga grafikona ustvari prek orodja cert-manager v1.21.3, in ničesar drugega ni treba nameščati.

Veriga je kratka. Samopodpisani izdajatelj, nexus-selfsigned, podpiše potrdilo CA nexus-local-ca, ključ ECDSA (algoritem digitalnega podpisa z eliptičnimi krivuljami) P-256, ki velja deset let. cert-manager ga obnovi 30 dni pred potekom. Drugi izdajatelj z istim imenom z njim podpiše vse drugo.

Vsaka storitev, ki kliče storitev, ki zahteva vzajemni TLS, dobi svoje odjemalsko potrdilo v objektu Secret, poimenovanem po njenem storitvenem računu (<service-account>-client-tls). Potrdilo nosi identiteto SPIFFE storitve kot svoje ime URI:

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

Storitev, ki jo kliče, preveri to potrdilo glede na lokalni CA in iz njega prebere, kdo je klicatelj. Vsaka delovna obremenitev zaupa overitelju CA prek datoteke ca.crt v objektu Secret svojega lastnega potrdila. Noben pod ne priklopi zasebnega ključa overitelja CA in noben ConfigMap ne nosi overitelja CA. nexus-probitas sam streže TLS iz nexus-probitas-tls, 90-dnevnega potrdila, ki se obnovi 15 dni pred potekom.

Javni rob je ločen in o njem odloča tls.mode:

  • existing: objekt TLS Secret, ki ste ga ustvarili, imenovan v tls.existingSecret.
  • cert-manager: potrdila izdajatelja ClusterIssuer, ki ga upravljate, imenovanega v tls.clusterIssuer.
  • none: TLS se konča pred vhodom (ingress), na vašem lastnem izravnalniku obremenitve. Brskalnik mora še vedno doseči konzolo prek protokola HTTPS (glejte poglavje 2.17, Odpravljanje težav).

Sama prijavna seja je odvisna od protokola HTTPS. Konzola sprejme prijavo le iz svojega lastnega izvora, https://<hosts.console>, hrani sejo v piškotku __Host- z oznako Secure, pristopni ključ (passkey) prvega skrbnika pa potrebuje stran z veljavnim potrdilom. Brskalnik na navadnem protokolu HTTP ali za opozorilom o potrdilu se sploh ne more prijaviti.

Podatkovna plast znotraj gruče privzeto komunicira s storitvami brez TLS (dataTier.postgres.sslmode: disable), ker ta promet ostane znotraj imenskega prostora pod zgoraj navedenimi pravilniki. Zunanji Postgres uporablja verify-full ali verify-ca z overiteljem CA strežnika v objektu Secret shrambe, kot opisuje poglavje 2.11, Različice: zunanje shrambe, TLS in vhod (ingress).

Telemetrija je izklopljena

Nobena telemetrija ne zapusti namestitve. telemetry.enabled je lahko le false: shema grafikone zavrne katero koli drugo vrednost. Lastno poročanje podatkovne plasti je prav tako izklopljeno, tako da Neo4j ne pošilja poročil o uporabi in Qdrant ne pošilja telemetrije.

Nadzor registracije

nexus-auth ima dva kontrolnika za preverjanje oseb, ki se registrirajo, in oba sta izklopljena na vsaki namestitvi.

Kontrolnik CAPTCHA preveri vsako registracijo z gostovano storitvijo na internetu. Namestitev pri registraciji nikoli ni odvisna od interneta, zato ga grafikona izklopi. Omrežno preverjanje potrebuje dve podatkovni bazi GeoLite2 za presojo, od kod prihaja registracija. Gre za licenčne prenose, ki niso niti v sliki nexus-auth niti jih grafikona ne priklopi, in ni vrednosti, s katero bi preverjanje vklopili. Čemur se odpoveste, je preverjanje registracij iz podatkovnih centrov in omrežij gostovanja.

Namesto tega dobite odobritev. Registracija neznanca je zadržana, dokler je skrbnik ne odobri, do takrat pa oseba dobi odgovor 403 SIGNUP_REQUIRES_APPROVAL. Nobeno stikalo tega ne spremeni.

Omejitve hitrosti in življenjska doba žetonov

# 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 največje število zahtev, ki jih lahko ena prijavljena oseba pošlje storitvi nexus-auth v eni minuti, preden ta odgovori z 429. Vsaka oseba dobi enako omejitev, lastni storitveni princip platforme pa se vanjo ne šteje. Privzeta vrednost 5000 je približno 83 na sekundo z enega računa, kar je dovolj za ljudi in skripte. Znižajte jo za zaostritev ali jo zvišajte za obsežno avtomatizacijo. Je celo število 1 ali več. Zaščita pred surovo silo pri prijavi (zaklepanje računa in omejitve poskusov drugega faktorja) je ločena in se ne nastavlja tukaj.

Klicatelj, ki preseže omejitev, dobi RATE_LIMITED z glavo Retry-After, telo pa nosi omejitev in čas čakanja. V izdaji Enterprise skrbniki nastavijo natančnejše omejitve v razdelku Nastavitve, Omejitve hitrosti (Settings, Rate limits): zahteve na minuto in sočasna opravila, za vsak ključ skripta ali aplikacijo in za vsako enoto. Klicatelj, ki preseže svojo omejitev, je naprošen, naj počaka, in ni nikoli odrezan. Umaknjena omejitev se vrne na omejitev enote, nato na privzeto.

Omejitve hitrosti
Omejitve hitrosti
Omejitve hitrosti na ključ in enoto. En skript ponavlja poskuse prehitro in se upočasnjuje; stran prikazuje odgovor 429, ki ga vidi skript, in omogoča skrbniku, da zviša njegovo omejitev z navedbo razloga.

auth.accessTokenTTL in auth.refreshTokenTTL določata, kako dolgo živita žeton za dostop in žeton za osvežitev. Žeton za dostop naj bo nastavljen na eno uro ali manj. Vtičniki, zgrajeni s kompletom Plugin SDK (kompletom za razvoj programske opreme za razširitve Nexus), zavrnejo sejni žeton, ki živi dlje kot eno uro, z JWT_LIFETIME_EXCEEDED.

proxy.trustedCIDRs imenuje skoke posredniškega strežnika (proxy), katerih glavi X-Forwarded-For nexus-auth verjame. Privzeta vrednost, 10.42.0.0/16, je omrežje podov k3s, kjer teče njegov Traefik. Na drugi distribuciji jo nastavite na omrežje podov vašega vhodnega krmilnika. Če je napačna, nexus-auth vidi vsako zahtevo, kot da prihaja od vhodnega krmilnika, zato bi spodnja pravila za naslove videla le ta naslov. Drugačen X-Forwarded-For iz nezaupanja vrednega skoka nikoli ne odpre novega okna omejitve hitrosti.

Podjetniška prijava

Ljudje se prijavijo s pristopnim ključem (passkey) ali prek storitev Google ali GitHub, prijava v podjetju pa je četrti način. Skrbnik se nikoli ne prijavi le z geslom: drugo preverjanje je pristopni ključ.

Izdaja Community vključuje eno prijavo v podjetju prek protokola OpenID Connect (OIDC) z lastnim nastavitvenim zaslonom in rezultatom preizkusa. Izdaja Enterprise dodaja jezik Security Assertion Markup Language (SAML), uveljavitev za vse in sinhronizacijo imenika prek sistema System for Cross-domain Identity Management (SCIM).

Prijavo v podjetju je mogoče zahtevati šele, ko skrbnik po vrsti opravi štiri stvari: poveže storitev za prijavo, dokaže domeno, se prijavi prek nje s svojim računom in imenuje en račun za nujne primere. Do takrat gumb Zahtevaj (Require it) ostane zaprt, stran pa s kodo COMPANY_SIGNIN_STEPS_MISSING pove, kateri koraki manjkajo. Sprememba storitve za prijavo počisti preizkus, zato je treba novo storitev znova preizkusiti.

Prijava v podjetju
Podjetniška prijava
Prijavo v podjetju je mogoče zahtevati šele, ko jo skrbnik preizkusi s svojim računom in imenuje račun za nujne primere. Vsak korak mora biti opravljen, preden se odpre zadnji.

Ko storitev za prijavo v podjetju preneha odgovarjati, prijavna stran prikaže IDP_UNREACHABLE (503). Ljudje, ki so že prijavljeni, ostanejo prijavljeni. Skrbniki lahko uporabijo prijavo skrbnika v sili, ki potrebuje zapečateno kodo, shranjeno v sefu, in skrbnikov pristopni ključ. Vsaka uporaba se zapiše v revizijski dnevnik s podatkom, kdo jo je uporabil in od kod, je takoj oznanjena vsakemu skrbniku ter se konča po 4 urah ali ko se prijava v podjetju vrne.

Vsi v organizaciji se prijavijo v isto konzolo in tam opravljajo svoje vsakodnevno delo; lastniki in skrbniki vidijo tudi skrbniške strani. Član, ki odpre eno od teh strani, dobi stran Niste skrbnik (Not an administrator), kjer so vrstice osivljene in so navedena imena oseb, ki jih lahko spremenijo (NOT_AN_ADMINISTRATOR).

Sumljive prijave in pravila za naslove

V izdaji Enterprise stran Sumljive prijave (Suspicious sign-ins) navaja prijave z geslom, ki so bile videti nove ali nenavadne: novo mesto ali naprava ali napačna gesla prej istega dne. Za vsako pove, kaj je Nexus naredil, bodisi da je zahteval drugo preverjanje bodisi blokiral prijavo. Nekdo odgovori na vsako vrstico z To niso bili oni (Not them), kar konča prijave te osebe, ali To so bili oni (It was them).

Stran Dovoljeni in blokirani naslovi (Addresses allowed and blocked) vsebuje dva seznama. Dovoljeni obsegi so edina mesta, od koder se lahko prijavijo lastniki in skrbniki; če ni nobenega, se lahko prijavijo od koder koli. Na člane to ne vpliva. Blokirani naslovi so mesta, od koder se ne more prijaviti nihče. Vsak vnos beleži, kdo ga je dodal in kdaj preneha veljati. Vsaka sprememba se najprej preizkusi glede na vaš trenutni naslov, in sprememba, ki bi vas zaklenila ven, je zavrnjena, ne da bi se kar koli shranilo. Zaostritev obsega takoj konča prijave skrbnikov, ki jih ne spusti več noter.

Dovoljeni in blokirani naslovi
Dovoljeni in blokirani naslovi
Pravila za naslove. Plošča na vrhu pove, kako pravila obravnavajo skrbničin lastni naslov, tako da je sprememba, ki bi jo zaklenila ven, zavrnjena, preden se shrani.

Ključi in potrdila

Podatki vsake organizacije so zaklenjeni z njenim lastnim ključem, ki ga hrani skrbnik hrambe po vaši izbiri: strojni varnostni modul ali programska oprema. Stran Ključi (Keys) prikazuje različice ključa organizacije in kdaj je na vrsti naslednja menjava. Različica ostane berljiva tudi po tem, ko ni več trenutna, dokler pod njo ni ovitega ničesar več. Sami ključi niso nikoli prikazani, le njihovi prstni odtisi.

Uničenje ključa je način, kako Nexus briše. Na strani Ključi in izbris (Keys and erasure) možnost Izbriši (Erase) uniči ključ ene osebe ali celotne organizacije, zaradi česar postane vse, kar je zaklenil, neberljivo povsod, vključno z varnostnimi kopijami. Tega ni mogoče razveljaviti, zato zahteva pisni razlog in drugo osebo. Pusti potrdilo, ki beleži, kaj je bilo izbrisano in kdo je to storil, nikoli pa vsebine.

Stran Ključi, ki bodo kmalu potekli (Keys about to run out) navaja žetone ponudnikov in potrdila, ki se kmalu iztečejo, kdo je opozorjen in kdaj ter kaj se ustavi, če kateri poteče. Delo v teku se ne ustavi, usmerjevalnik UI pa preklopi na drug ključ.

Odobritve po načelu štirih oči

V izdaji Enterprise lahko pravilniki zadržijo občutljive spremembe za drugo osebo. Stran Odobritve štirih oči (Four-eyes approvals) navaja vsako čakajočo zahtevo s podatkom, kdo je zaprosil, zakaj, koliko odobritev potrebuje in kdaj zapade. Nihče ne odobri svoje lastne zahteve (TRUST_APPROVAL_SELF_APPROVAL), zahteva, o kateri je že bilo odločeno, pa odgovori z APPROVAL_ALREADY_DECIDED. Zavrnitev zahteve potrebuje razlog. Zahteva, o kateri nihče ne odloči pravočasno, zapade in nič se ne spremeni. Katere spremembe čakajo tukaj, določajo pravilniki, ki zahtevajo drugo osebo: obnovitev varnostne kopije in dodajanje sedežev sta dva primera drugje v tem priročniku.

Odobritve štirih oči
Odobritve po načelu štirih oči
Spremembe, ki čakajo na drugo osebo. Vsaka zahteva prikazuje, kdo je zaprosil in kdaj zapade, oseba, ki je zaprosila, pa nima gumba Odobri (Approve) na svoji lastni zahtevi.

Vpogled v pogled drugega uporabnika

Podpora znotraj organizacije včasih pomeni videti stran tako, kot jo vidi sodelavec. V izdaji Enterprise možnost Poglej, kot vidijo oni (See it as they do) skrbniku omogoči pogled konzole samo za branje, kot jo vidi en član, za 30 minut, po drugem preverjanju in pisnem razlogu. Član je o tem obveščen. Njegovi zasebni elementi (pošta, beležnice, neposredna sporočila in tisto, kar si pomočnik zapomni zanj) niso nikoli prikazani, čez vrh je ves čas pasica in vse se beleži v revizijski dnevnik.

Velike spremembe dobijo svoj premor. Preden se sprememba s širokimi učinki shrani, prekrivno okno Preden se ta sprememba zgodi (Before this change happens) navede, kaj se pokvari, kaj zahteva pozornost in na kaj to ne vpliva. Sprememba ni blokirana. Narejena je dovolj zahtevna, da o njej razmislite, v izdaji Enterprise pa občutljiva sprememba počaka še na drugo osebo.

Hramba in pretakanje revizijskih sledi

Revizijski dnevnik beleži, kdo je kaj naredil, od najnovejšega naprej, in ga je mogoče filtrirati ter izvoziti. Izdaja Community hrani 30 dni in izvozi datoteko preglednice. Izdaja Enterprise ga hrani tako dolgo, kot določa vaš pravilnik o hrambi na strani Ohranjanje in opuščanje (Keeping and letting go) pod Nastavitvami (Settings), in ga pretaka v vaš sistem za varnostno spremljanje. Zabeležene so tudi zavrnitve, tako da oseba, ki je bila zavrnjena, pusti vrstico prav tako kot oseba, ki je uspela. Zapisi o upravljanju za tem so veriženi po organizacijah, tako da lahko vsaka organizacija preveri svoj del, ne da bi videla del katere koli druge.

Vloge v podatkovni zbirki

Nexus nikoli ne poganja svojih storitev kot superuporabnik podatkovne baze. Zagonski kavelj (bootstrap hook), ki je edini del, ki ima pravice superuporabnika gruče, razen enkratnega koraka priprave zaledja za začelje (BFF) konzole, ustvari te vloge:

Vloga Kaj to je
nexus_migrator LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Je lastnik podatkovne baze nexus in vsakega objekta, ki ga ustvarijo migracije, ter ustvari vloge, ki jih imenujejo migracije.
nexus_runtime Skupina, ki se ne more prijaviti. Podeljuje povezavo in uporabo sheme ter nobenih pravic za tabele.
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills Lastna prijava vsake storitve: NOSUPERUSER NOBYPASSRLS, član nexus_runtime, ki mu njegove lastne migracije podelijo njegove lastne tabele in nič drugega.
nexus_ledger_reader Bere eno tabelo, glavno knjigo izdaj (release ledger), za inicializacijske vsebnike wait-for-schema. Nobene druge pravice.

Ker nobena storitvena vloga ni lastnica svojih tabel in nobena ne more zaobiti varnosti na ravni vrstic (RLS), vsak pravilnik RLS velja za vsako storitveno povezavo. Varnost na ravni vrstic je vsiljena na tabelah storitve nexus-auth, tako da velja celo za njihovega lastnika. Če vloga z imenom nexus že obstaja na vašem strežniku z SUPERUSER ali BYPASSRLS, zagonski proces zavrne nadaljevanje: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Odstranite ta atribut ali uporabite drug strežnik.