Verzió 1.0.0-alpha.1legújabb
2.16. fejezet
Biztonság és hálózat
Mit enged be és ki egy telepítés, hogyan igazolják a szolgáltatásai egymásnak a kilétüket, és milyen vezérlőket állít be vagy örököl az üzemeltető a bejelentkezéshez és az adatbázishoz.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

A Harrow Port Authority biztonsági felülvizsgálata során Tomás Reillynek először egyetlen kérdést tettek fel: mi hagyja el a fürtöt? A válasza ráfért egy oldalra. A nexus névtérből semmi sem ér el semmit azon kívül, kivéve a tartománynévrendszerbeli (DNS) lekérdezéseket, a Kubernetes alkalmazásprogramozási felületét (API) néhány munkaterhelés esetében, valamint azokat a címtartományokat, amelyeket a Harrow felsorol a saját values fájljában. Nincs telemetria és nincs hazatelefonálás. A felülvizsgálat ezután rátért a bejelentkezésre és az adatbázisra, ami nagyjából megegyezik azzal a sorrenddel, amelyet ez a fejezet is követ.
Hálózati házirendek
A hálózati szabályzatok alapértelmezés szerint be vannak kapcsolva (networkPolicy.enabled: true), a chart pedig egy mindent tiltó szabályzatból indul ki, és csak azt engedélyezi újra, amire a Nexusnak szüksége van:
| Szabályzat | Mit tesz lehetővé |
|---|---|
nexus-default-deny |
Semmit. A névtér minden podját kiválasztja, mindkét irányban. |
nexus-in-namespace |
A Nexus podok egymás közötti kommunikációját, valamint a DNS-lekérdezéseket a kube-system névtérben lévő kube-dns felé az 53-as porton. |
nexus-token-review |
A tokenellenőrzőket (nexus-probitas és nexus-orchestrator) és a kulcsőrzési (key-custody) Jobot, amint elérik a Kubernetes API-kiszolgálót a 6443-as vagy a 443-as porton. Egyetlen másik podhoz sincs felcsatolva az API-token. |
nexus-ingress-controller |
Az ingress vezérlő névterét, amint eléri a három nyilvános szolgáltatást, és semmi mást. |
nexus-operator-egress |
A podokat, amint elérik a networkPolicy.externalEgressCIDRs listában szereplő címtartományokat. Csak akkor jön létre, ha ez a lista nem üres. |
A két OpenBao kiszolgáló saját szabályzat mögött helyezkedik el. Címkéjük szerint a kulcstároló részét képezik, nem pedig a Nexusét, így a névtéren belüli szabály nem terjed ki rájuk. Csak a nexus-keys és a hozzá tartozó feladatok (köztük a kulcsőrzési Job) kommunikálhatnak velük, az unsealerrel pedig kizárólag a kulcstároló kommunikálhat.
Három érték határozza meg a szabályzatokat:
# 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/24A ingressNamespace a három nyilvános állomás előtt álló ingress vezérlő névtere. Az alapértelmezett érték, a kube-system, a k3s-hez illeszkedik, amely oda telepíti a Traefiket. A Harrow a saját vezérlőjét a ingress-nginx névtérben futtatja.
A apiServerCIDRs a Kubernetes API-kiszolgáló címeit tartalmazza /32 osztály nélküli tartományok közötti útválasztási (CIDR) tartományokként. Ha üresen hagyja, a chart telepítéskor a kubernetes Endpoints objektumból olvassa ki őket. A helm template parancsnak nincs fürtje, amelyből olvashatna, ezért ezeket meg kell adni neki, különben a következő üzenettel leáll: "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".
A externalEgressCIDRs felsorol mindent a névtéren kívül, amit a Nexusnak meg kell hívnia. Az üres érték azt jelenti, hogy semmit. A Harrow itt adja meg a levelezési továbbítóját (mail relay) és a modellkiszolgálói alhálózatát. Ha hosztolt modellszolgáltatót, a fürtön kívüli vállalati bejelentkezési szolgáltatást vagy adatforrást csatlakoztat, annak tartományai is ide tartoznak. Ha egyet kifelejt, az a leggyakoribb oka annak, hogy egy laptopon működő kulcs a telepített rendszeren hibát jelez: a hívás soha nem hagyja el a fürtöt.
A terméken belül a Hová indulhatnak hívások (Where calls can leave) oldal felsorol minden olyan külső helyet, amelyet a Nexus elérhet, azt, hogy miért szerepel ott, és hogy ki adta hozzá. Minden mást elutasít a rendszer egy olyan kóddal, amely megnevezi a szabályt. Az oldalon az elutasítás EGRESS_DENIED formában jelenik meg. Az adatok tárolási helye (residency) egy szinttel feljebb ugyanígy működik: az Enterprise kiadásban a Hol élnek az adatok (Where data lives) oldal állítja be a régiót az egyes adattípusokhoz, és egy szervezet az európai uniós szolgáltatókra korlátozhatja a mesterséges intelligenciával (AI) kapcsolatos forgalmát, így az útválasztó minden mást elutasít (lásd a 2.14. fejezetet, AI-szolgáltatók és -modellek). Az olyan alkalmazást, amely a jegyzékfájljában (manifest) nem deklarált címet próbál elérni, a rendszer a peremen megállítja a EGRESS_NOT_DECLARED kóddal.
Szolgáltatás-azonosság a helyi hitelesítésszolgáltatótól (CA)
A Nexus service mesh nélkül fut. A chart rendelkezik egy istio.enabled értékkel, amelynek alapértelmezése false, és nincs ok a bekapcsolására. A szolgáltatások ehelyett kölcsönös TLS (mTLS) használatával igazolják egymásnak a kilétüket: ez olyan szállítási rétegbeli biztonság (Transport Layer Security, TLS), amelynél mindkét fél felmutat egy tanúsítványt. A tanúsítványok egy helyi hitelesítésszolgáltatótól (CA) származnak, amelyet a chart hoz létre a cert-manager v1.21.3 segítségével, és semmi mást nem kell telepíteni.
A lánc rövid. Egy önaláírt kibocsátó, a nexus-selfsigned írja alá a nexus-local-ca CA-tanúsítványt, amely egy tíz évig érvényes ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 kulcs. A cert-manager a lejárta előtt 30 nappal megújítja. Egy második, azonos nevű kibocsátó ír alá minden mást ebből a tanúsítványból.
Minden olyan szolgáltatás, amely kölcsönös TLS-t igénylő szolgáltatást hív meg, saját ügyféltanúsítványt kap egy olyan Secret objektumban, amely a szolgáltatásfiókjáról (<service-account>-client-tls) van elnevezve. A tanúsítvány URI-névként tartalmazza a szolgáltatás SPIFFE-azonosítóját:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
A meghívott szolgáltatás ellenőrzi ezt a tanúsítványt a helyi CA alapján, és kiolvassa belőle, hogy ki a hívó. Minden munkaterhelés a saját tanúsítványának Secret objektumában található ca.crt révén bízik meg a CA-ban. Egyetlen pod sem csatolja fel a CA privát kulcsát, és egyetlen ConfigMap sem tartalmazza a CA-t. A nexus-probitas maga szolgálja ki a TLS-t a nexus-probitas-tls tanúsítványból, amely egy 90 napos tanúsítvány, és a lejárta előtt 15 nappal újul meg.
A nyilvános perem különálló, és a tls.mode határozza meg:
existing: egy Ön által készített TLS Secret, amelynek neve atls.existingSecretértékben van megadva.cert-manager: egy Ön által futtatott ClusterIssuer által kiállított tanúsítványok, amelynek neve atls.clusterIssuerértékben van megadva.none: a TLS az ingress előtt, az Ön saját terheléselosztóján ér véget. A böngészőnek továbbra is HTTPS-en keresztül kell elérnie a konzolt (lásd a 2.17. fejezetet, Hibaelhárítás).
Maga a bejelentkezési munkamenet a HTTPS-től függ. A konzol csak a saját eredetéből (origin), a https://<hosts.console> címről fogad el bejelentkezést, a munkamenetet egy Secure jelölésű __Host- sütiben tárolja, az első rendszergazda hozzáférési kulcsához (passkey) pedig érvényes tanúsítvánnyal rendelkező oldalra van szükség. Egy sima HTTP-t használó, vagy tanúsítványra vonatkozó figyelmeztetés mögött lévő böngésző egyáltalán nem tud bejelentkezni.
A fürtön belüli adatréteg alapértelmezés szerint TLS nélkül kommunikál a szolgáltatásokkal (dataTier.postgres.sslmode: disable), mivel ez a forgalom a fenti szabályzatok értelmében a névtéren belül marad. Egy külső Postgres a verify-full vagy a verify-ca beállítást használja, a kiszolgáló CA-jával a tároló Secret objektumában, ahogyan azt a 2.11. fejezet, Változatok: külső tárolók, TLS és ingress leírja.
A telemetria ki van kapcsolva
Semmilyen telemetria nem hagyja el a telepített rendszert. A telemetry.enabled értéke csak false lehet: a chart sémája minden más értéket elutasít. Az adatréteg saját jelentéskészítése szintén ki van kapcsolva, így a Neo4j nem küld használati jelentést, és a Qdrant sem küld telemetriát.
Regisztrációs korlátozások
A nexus-auth két vezérlővel rendelkezik a regisztráló személyek szűrésére, és minden telepítésen mindkettő ki van kapcsolva.
A CAPTCHA vezérlő minden regisztrációt ellenőriz egy interneten hosztolt szolgáltatással. Egy telepített rendszer a regisztrációkor soha nem függ az internettől, ezért a chart ezt kikapcsolja. A hálózati szűrőnek két GeoLite2 adatbázisra van szüksége ahhoz, hogy megítélje, honnan érkezik a regisztráció. Ezek licenchez kötött letöltések, amelyek nem szerepelnek a nexus-auth rendszerképben, és a chart sem csatolja fel őket, valamint nincs olyan érték, amellyel a szűrőt be lehetne kapcsolni. Amiről így lemond, az az adatközponti és tárhelyszolgáltatói hálózatokból érkező regisztrációk szűrése.
Amit helyette kap, az a jóváhagyás. Egy ismeretlen személy regisztrációja visszatartásra kerül, amíg egy rendszergazda jóvá nem hagyja, addig pedig az illető a 403 SIGNUP_REQUIRES_APPROVAL választ kapja. Egyik kapcsoló sem változtat ezen.
Sebességkorlátok és token-élettartamok
# harrow-values.yaml (Helm values): sign-in service
auth:
rateLimitPerMinute: 5000
accessTokenTTL: 15m
refreshTokenTTL: 12h
proxy:
trustedCIDRs: "10.244.0.0/16"A auth.rateLimitPerMinute a legtöbb kérés, amelyet egy bejelentkezett személy egy perc alatt intézhet a nexus-auth felé, mielőtt az a 429 kóddal válaszolna. Minden személy ugyanazt a korlátot kapja, és a platform saját szolgáltatásnév-azonosítója (service principal) nem számít bele ebbe. Az alapértelmezett 5000-es érték körülbelül másodpercenként 83 kérést jelent egy fiókból, ami bőségesen elegendő az emberek és a parancsfájlok számára. Csökkentse a szigorításhoz, vagy növelje az intenzív automatizáláshoz. Az értéke 1 vagy annál nagyobb egész szám. A bejelentkezéskori nyers erő (brute-force) támadások elleni védelem (a fiók zárolása és a második faktoros próbálkozások korlátozása) ettől független, és nem itt kell beállítani.
A korlátot túllépő hívó RATE_LIMITED választ kap egy Retry-After fejléccel, a törzs pedig tartalmazza a korlátot és a várakozási időt. Az Enterprise kiadásban a rendszergazdák finomabb korlátokat állíthatnak be a Beállítások (Settings) Sebességkorlátok (Rate limits) oldalán: percenkénti kérések és egyidejű feladatok számát az egyes parancsfájlkulcsokhoz vagy alkalmazásokhoz, illetve az egyes egységekhez. A korlátját túllépő hívót a rendszer várakozásra kéri, és soha nem szakítja meg a kapcsolatát. A visszavont korlát visszavált az egység korlátjára, majd az alapértelmezettre.
A auth.accessTokenTTL és a auth.refreshTokenTTL állítja be, hogy meddig érvényes egy hozzáférési token (access token) és egy frissítési token (refresh token). A hozzáférési tokent tartsa egy órán vagy annál rövidebb időn. A Plugin SDK-val – a Nexus-bővítmények szoftverfejlesztő készletével – készült beépülő modulok JWT_LIFETIME_EXCEEDED kóddal elutasítják az egy óránál hosszabb élettartamú munkamenet-tokeneket.
A proxy.trustedCIDRs nevezi meg azokat a proxyugrásokat (hops), amelyek X-Forwarded-For fejlécét a nexus-auth hitelesnek fogadja el. Az alapértelmezett 10.42.0.0/16 a k3s podhálózata, ahol a Traefik fut. Más disztribúció esetén állítsa ezt az ingress vezérlője podhálózatára. Ha az érték hibás, a nexus-auth minden kérést úgy lát, mintha az az ingress vezérlőtől érkezne, így az alábbi címszabályok csak ezt a címet látnák. Egy nem megbízható ugrástól származó eltérő X-Forwarded-For soha nem nyit új sebességkorlát-ablakot.
Vállalati bejelentkezés
A felhasználók hozzáférési kulccsal (passkey), illetve a Google-on vagy a GitHubon keresztül jelentkeznek be, a vállalati bejelentkezés pedig a negyedik mód. A rendszergazda soha nem jelentkezik be csupán jelszóval: a második ellenőrzés egy hozzáférési kulcs.
A Community kiadás egy vállalati bejelentkezést tartalmaz az OpenID Connecten (OIDC) keresztül, saját beállítási képernyővel és teszteredménnyel. Az Enterprise kiadás ezt kiegészíti a Security Assertion Markup Language (SAML) támogatásával, a mindenki számára történő kötelezővé tétellel, valamint a címtárszinkronizálással a System for Cross-domain Identity Management (SCIM) révén.
A vállalati bejelentkezést csak akkor lehet kötelezővé tenni, ha a rendszergazda sorrendben elvégzett négy dolgot: csatlakoztatta a bejelentkezési szolgáltatást, igazolta a tartományt, bejelentkezett rajta keresztül a saját fiókjával, és megnevezett egy vészhelyzeti fiókot. Addig a Kötelezővé tétel (Require it) gomb inaktív marad, az oldal pedig a COMPANY_SIGNIN_STEPS_MISSING kóddal jelzi, hogy mely lépések hiányoznak. A bejelentkezési szolgáltatás módosítása törli a tesztet, így az új szolgáltatást újra le kell tesztelni.
Amikor a vállalati bejelentkezési szolgáltatás nem válaszol, a bejelentkezési oldalon a IDP_UNREACHABLE (503) üzenet jelenik meg. A már bejelentkezett személyek bejelentkezve maradnak. A rendszergazdák használhatják a vészhelyzeti rendszergazdai bejelentkezést, amelyhez a széfben tartott zárolt kódra és a rendszergazda hozzáférési kulcsára van szükség. Minden használat bekerül az auditnaplóba azzal együtt, hogy ki és honnan használta, a rendszer azonnal értesít róla minden rendszergazdát, a hozzáférés pedig 4 óra elteltével vagy a vállalati bejelentkezés helyreállásakor véget ér.
A szervezetben mindenki ugyanarra a konzolra jelentkezik be, és ott végzi a napi munkáját; a tulajdonosok és a rendszergazdák az adminisztrációs oldalakat is látják. Az a tag, aki megnyit egy ilyen oldalt, a Nem rendszergazda (Not an administrator) oldalt kapja, amelyen a sorok ki vannak szürkítve, és láthatók azon személyek nevei, akik módosíthatják azokat (NOT_AN_ADMINISTRATOR).
Gyanús bejelentkezések és címszabályok
Az Enterprise kiadásban a Gyanús bejelentkezések (Suspicious sign-ins) oldal felsorolja azokat a jelszavas bejelentkezéseket, amelyek újnak vagy szokatlannak tűntek: egy új helyet vagy eszközt, illetve az adott napon korábban megadott hibás jelszavakat. Mindegyiknél feltünteti, hogy mit tett a Nexus, legyen az egy második ellenőrzés kérése vagy a bejelentkezés letiltása. Valaki minden sorra a Nem ő volt (Not them) lehetőséggel válaszol, ami megszünteti az adott személy bejelentkezéseit, vagy az Ő volt (It was them) lehetőséggel.
Az Engedélyezett és letiltott címek (Addresses allowed and blocked) oldal két listát tartalmaz. Az engedélyezett tartományok az egyetlen olyan helyek, ahonnan a tulajdonosok és a rendszergazdák bejelentkezhetnek; ha nincs megadva egy sem, bárhonnan bejelentkezhetnek. A tagokat ez nem érinti. A letiltott címek olyan helyek, ahonnan senki sem jelentkezhet be. Minden bejegyzés rögzíti, hogy ki adta hozzá, és mikor jár le. A rendszer minden módosítást először az Ön saját aktuális címével tesztel, és ha a módosítás kizárná Önt, a rendszer elutasítja azt, és semmit sem ment el. Egy tartomány szűkítése azonnal megszünteti azon rendszergazdák bejelentkezéseit, akiket az már nem enged be.
Kulcsok és tanúsítványok
Minden szervezet adatait a saját kulcsa védi, amelyet egy Ön által választott őrző tárol: egy hardveres biztonsági modul vagy egy szoftver. A Kulcsok (Keys) oldal megmutatja a szervezeti kulcs verzióit, és azt, hogy mikor esedékes a következő kulcsforgatás. Egy verzió azután is olvasható marad, hogy már nem ő az aktuális, egészen addig, amíg már semmi sincs vele titkosítva. Maguk a kulcsok soha nem jelennek meg, csak az ujjlenyomatuk.
A Nexus a kulcs megsemmisítésével töröl. A Kulcsok és törlés (Keys and erasure) oldalon a Törlés (Erase) megsemmisíti egy személy vagy egy teljes szervezet kulcsát, ami mindenhol olvashatatlanná tesz mindent, amit az zárolt, beleértve a biztonsági mentéseket is. A művelet nem vonható vissza, ezért írásos indoklást és egy második személy jóváhagyását kéri. Egy nyugtát hagy maga után, amely rögzíti, hogy mit és ki törölt, de a tartalmat soha.
A Hamarosan lejáró kulcsok (Keys about to run out) oldal felsorolja a hamarosan lejáró szolgáltatói tokeneket és tanúsítványokat, azt, hogy ki és mikor kap figyelmeztetést, valamint azt, hogy mi áll le, ha az egyik lejár. A futó munkák nem állnak le, az AI-útválasztó pedig átvált egy másik kulcsra.
Négy szemes jóváhagyások
Az Enterprise kiadásban a szabályzatok visszatarthatják az érzékeny módosításokat egy második személy jóváhagyására várva. A Négy szem elvű jóváhagyások (Four-eyes approvals) oldal felsorol minden várakozó kérelmet azzal együtt, hogy ki kérte, miért, hány jóváhagyásra van szüksége, és mikor jár le. Senki sem hagyhatja jóvá a saját kérelmét (TRUST_APPROVAL_SELF_APPROVAL), egy már elbírált kérelem pedig APPROVAL_ALREADY_DECIDED választ ad. A kérelem elutasításához indoklás szükséges. Az a kérelem, amelyről senki sem dönt időben, lejár, és semmi sem változik. Azt, hogy mely módosítások várakoznak itt, azok a szabályzatok határozzák meg, amelyek második személyt írnak elő: a biztonsági mentés visszaállítása és a felhasználói helyek (seats) hozzáadása két olyan példa, amely ezen útmutató más részein szerepel.
Más felhasználó nézetének megtekintése
A szervezeten belüli támogatás néha azt jelenti, hogy úgy kell látni egy oldalt, ahogyan azt egy kolléga látja. Az Enterprise kiadásban a Megtekintés az ő szemszögükből (See it as they do) funkció egy második ellenőrzés és írásos indoklás után 30 percre csak olvasható nézetet biztosít a rendszergazdának a konzolról, pontosan úgy, ahogyan azt az adott tag látja. A tag erről értesítést kap. A személyes elemei (levelek, jegyzetfüzetek, közvetlen üzenetek és az, amire az asszisztens emlékszik a számára) soha nem jelennek meg, a teljes időtartam alatt egy szalagcím látható felül, és minden bekerül az auditnaplóba.
A nagy változtatások külön megállítást kapnak. Mielőtt a rendszer elmentene egy széles körű hatásokkal járó módosítást, a Mielőtt ez a változás megtörténik (Before this change happens) átfedő ablak felsorolja, hogy mi fog elromlani, mi igényel figyelmet, és mi marad érintetlen. A módosítás nincs letiltva. Csak elég komollyá van téve ahhoz, hogy átgondolják, az Enterprise kiadásban pedig egy érzékeny módosítás egy második személyre is vár.
Auditnaplók megőrzése és továbbítása (streaming)
Az auditnapló rögzíti, hogy ki mit tett, a legújabbaktól kezdve, és szűrhető, valamint exportálható. A Community kiadás 30 napot őriz meg, és táblázatfájlt exportál. Az Enterprise kiadás addig őrzi meg, ameddig a megőrzési szabályzata előírja a Beállítások (Settings) alatti Megőrzés és elengedés (Keeping and letting go) oldalon, és folyamatosan továbbítja (streameli) a biztonsági felügyeleti rendszerébe. Az elutasítások is rögzítésre kerülnek, így az a személy is nyomot hagy egy sor formájában, akinek nemet mondott a rendszer, akárcsak az, aki sikerrel járt. A mögötte lévő irányítási rekordok szervezetenként láncolva vannak, így minden szervezet ellenőrizheti a saját szeletét anélkül, hogy bárki másét látná.
Adatbázis-szerepkörök
A Nexus soha nem futtatja a szolgáltatásait adatbázis-szuperfelhasználóként (superuser). A bootstrap hook – amely a konzol előtér-kiszolgáló háttérrendszerének (BFF) egyszeri kiépítési lépését leszámítva az egyetlen olyan rész, amely birtokolja a fürt szuperfelhasználóját – a következő szerepköröket hozza létre:
| Szerepkör | Mi ez |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Birtokolja a nexus adatbázist és minden olyan objektumot, amelyet a migrációk létrehoznak, továbbá létrehozza a migrációk által megnevezett szerepköröket. |
nexus_runtime |
Egy csoport, amely nem tud bejelentkezni. Kapcsolódási és sémahasználati jogot biztosít, táblajogosultságokat azonban nem. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
Minden szolgáltatás saját bejelentkezése: NOSUPERUSER NOBYPASSRLS, a nexus_runtime tagja, amely a saját migrációi révén jogosultságot kap a saját tábláira, és semmi másra. |
nexus_ledger_reader |
Egyetlen táblát olvas, a kiadási főkönyvet (release ledger), a wait-for-schema init tárolók számára. Nincs más jogosultsága. |
Mivel egyetlen szolgáltatási szerepkör sem birtokolja a tábláit, és egyik sem kerülheti meg a sorszintű biztonságot (row-level security, RLS), minden RLS-szabályzat érvényes minden szolgáltatáskapcsolatra. A nexus-auth tábláin a sorszintű biztonság kényszerítve van, így még a tulajdonosukra is vonatkozik. Ha a kiszolgálóján már létezik egy nexus nevű szerepkör SUPERUSER vagy BYPASSRLS attribútummal, a bootstrap megtagadja a folytatást: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Távolítsa el ezt az attribútumot, vagy használjon másik kiszolgálót.




