Versio 1.0.0-alpha.1uusin
Luku 2.16
Tietoturva ja verkko
Mitä asennus päästää sisään ja ulos, kuinka sen palvelut todistavat identiteettinsä toisilleen sekä hallintakeinot, jotka ylläpitäjä asettaa tai perii kirjautumista ja tietokantaa varten.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Harrow Port Authorityn tietoturvakatselmus esitti Tomás Reillylle ensimmäiseksi yhden kysymyksen: mikä poistuu klusterista? Hänen vastauksensa mahtui yhdelle sivulle. Mikään nexus-nimiavaruudessa ei tavoita mitään sen ulkopuolelta lukuun ottamatta nimipalveluhakuja (Domain Name System, DNS), Kubernetesin ohjelmointirajapintaa (application programming interface, API) muutamille työkuormille sekä osoitealueita, jotka Harrow luettelee values-tiedostossaan. Telemetriaa tai yhteydenottoja kotiin ei ole. Tämän jälkeen katselmus siirtyi kirjautumiseen ja tietokantaan, mikä vastaa suurin piirtein tämän luvun järjestystä.
Verkkokäytännöt
Verkkokäytännöt ovat oletusarvoisesti päällä (networkPolicy.enabled: true), ja kaavio lähtee kaiken estävästä käytännöstä (deny-all) ja palauttaa vain sen, mitä Nexus tarvitsee:
| Käytäntö | Mitä se sallii |
|---|---|
nexus-default-deny |
Ei mitään. Se valitsee jokaisen podin nimiavaruudessa, molempiin suuntiin. |
nexus-in-namespace |
Toistensa kanssa keskustelevat Nexus-podit ja DNS-haut kohteeseen kube-dns nimiavaruudessa kube-system portissa 53. |
nexus-token-review |
Valtuustietojen tarkistajat (nexus-probitas ja nexus-orchestrator) ja avainten säilytyksen Job (key-custody Job), jotka ottavat yhteyden Kubernetesin API-palvelimeen portissa 6443 tai 443. Millekään muulle podille ei ole liitetty API-valtuustietoa. |
nexus-ingress-controller |
Ingress-ohjaimen nimiavaruus, joka tavoittaa kolme julkista palvelua eikä mitään muuta. |
nexus-operator-egress |
Podit, jotka tavoittavat osoitealueet kohdassa networkPolicy.externalEgressCIDRs. Luodaan vain, kun kyseinen luettelo ei ole tyhjä. |
Kaksi OpenBao-palvelinta ovat oman käytäntönsä takana. Ne on merkitty osaksi avainsäilöä eikä osaksi Nexusta, joten nimiavaruuden sisäinen sääntö ei koske niitä. Vain nexus-keys ja sen ajot (mukaan lukien säilytyksen Job) voivat keskustella niiden kanssa, ja vain avainsäilö voi keskustella lukituksen avaajan (unsealer) kanssa.
Kolme arvoa muovaavat käytäntöjä:
# 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 on kolmen julkisen palvelimen edessä olevan ingress-ohjaimen nimiavaruus. Oletusarvo, kube-system, sopii k3s-ympäristöön, joka toimittaa Traefikin sinne. Harrow ajaa omaa ohjaintaan nimiavaruudessa ingress-nginx.
apiServerCIDRs ovat Kubernetesin API-palvelimen osoitteet /32-muotoisina CIDR-alueina (Classless Inter-Domain Routing). Jos kohta jätetään tyhjäksi, kaavio lukee ne kubernetes- päätepisteistä (Endpoints) asennuksen yhteydessä. Komennolla helm template ei ole klusteria luettavanaan, joten ne on annettava sille, ja muuten se pysähtyy virheeseen "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".
externalEgressCIDRs luettelee kaiken nimiavaruuden ulkopuolella olevan, johon Nexuksen on otettava yhteyttä. Tyhjä tarkoittaa ei mitään. Harrow luettelee siinä sähköpostivälityspalvelimensa ja mallipalvelimiensa aliverkon. Jos yhdistätte ulkoisen mallitarjoajan, klusterin ulkopuolisen yrityskirjautumispalvelun tai tietolähteen, myös sen osoitealueet kuuluvat tähän. Yhdenkin unohtaminen on tavallisin syy siihen, miksi kannettavalla tietokoneella toimiva avain epäonnistuu asennuksessa: kutsu ei koskaan poistu klusterista.
Tuotteen sisällä Mihin kutsut voivat lähteä -sivu luettelee jokaisen ulkopuolisen kohteen, johon Nexus voi ottaa yhteyttä, miksi se on siellä ja kuka sen lisäsi. Kaikki muu hylätään koodilla, joka nimeää säännön. Sivulla hylkäys näkyy muodossa EGRESS_DENIED. Tietojen sijainti toimii samalla tavalla yhtä tasoa ylempänä: Enterprise-versiossa Missä tiedot sijaitsevat -sivu asettaa alueen kullekin tietotyypille, ja organisaatio voi lukita tekoälyliikenteensä (artificial intelligence, AI) EU-tarjoajiin, jolloin reititin hylkää kaiken muun (katso luku 2.14, Tekoälytarjoajat ja -mallit). Sovellus, joka yrittää tavoittaa osoitetta, jota sen manifesti ei koskaan ilmoittanut, pysäytetään reunalla koodilla EGRESS_NOT_DECLARED.
Palvelun identiteetti paikalliselta varmentajalta
Nexus toimii ilman palveluverkkoa (service mesh). Kaaviossa on arvo istio.enabled, sen oletusarvo on false, eikä ole mitään syytä kytkeä sitä päälle. Palvelut todistavat sen sijaan henkilöllisyytensä toisilleen molemminpuolisella TLS:llä (mTLS): kyseessä on Transport Layer Security (TLS), jossa molemmat osapuolet esittävät varmenteen. Varmenteet tulevat paikalliselta varmentajalta (certificate authority, CA), jonka kaavio luo cert-manager v1.21.3:n kautta, eikä mitään muuta tarvitse asentaa.
Ketju on lyhyt. Itse allekirjoitettu myöntäjä, nexus-selfsigned, allekirjoittaa CA-varmenteen nexus-local-ca, joka on kymmenen vuotta voimassa oleva ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 -avain. cert-manager uusii sen 30 päivää ennen sen vanhenemista. Toinen samanniminen myöntäjä allekirjoittaa kaiken muun sen pohjalta.
Jokainen palvelu, joka kutsuu molemminpuolista TLS:ää vaativaa palvelua, saa oman asiakasvarmenteensa Secret-objektissa, joka on nimetty sen palvelutilin mukaan (<service-account>-client-tls). Varmenne sisältää palvelun SPIFFE-identiteetin URI-nimenään:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Palvelu, jota se kutsuu, tarkistaa kyseisen varmenteen paikallista CA:ta vasten ja lukee siitä, kuka kutsuja on. Jokainen työkuorma luottaa CA:han oman varmenteensa Secret-objektissa olevan ca.crt-tiedon kautta. Mikään pod ei liitä CA:n yksityistä avainta, eikä mikään ConfigMap sisällä CA:ta. nexus-probitas tarjoaa itse TLS:n kohteesta nexus-probitas-tls, joka on 90 päivän varmenne ja joka uusitaan 15 päivää ennen sen vanhenemista.
Julkinen reuna on erillinen, ja sen määrittää tls.mode:
existing: luomanne TLS Secret -objekti, joka on nimetty kohdassatls.existingSecret.cert-manager: varmenteet ajamastanne ClusterIssuer-objektista, joka on nimetty kohdassatls.clusterIssuer.none: TLS päättyy ennen ingressiä, omalla kuormantasaimellanne. Selaimen on silti tavoitettava konsoli HTTPS:n yli (katso luku 2.17, Vianmääritys).
Itse kirjautumisistunto riippuu HTTPS:stä. Konsoli hyväksyy kirjautumisen vain omasta alkuperästään, https://<hosts.console>, pitää istunnon Secure-merkityssä __Host--evästeessä, ja ensimmäisen pääkäyttäjän avainkoodi (passkey) vaatii sivun, jolla on kelvollinen varmenne. Pelkkää HTTP:tä käyttävä tai varmennevaroituksen takana oleva selain ei voi kirjautua lainkaan.
Klusterin sisäinen tietokerros keskustelee palveluiden kanssa oletusarvoisesti ilman TLS:ää (dataTier.postgres.sslmode: disable), koska kyseinen liikenne pysyy nimiavaruuden sisällä yllä olevien käytäntöjen mukaisesti. Ulkoinen Postgres käyttää arvoa verify-full tai verify-ca, jossa palvelimen CA on tietovaraston Secret-objektissa, kuten luku 2.11, Muunnelmat: ulkoiset tietovarastot, TLS ja ingress, kuvaa.
Telemetria on pois päältä
Asennuksesta ei lähde telemetriaa. telemetry.enabled voi olla vain false: kaavion skeema hylkää minkä tahansa muun arvon. Myös tietokerroksen oma raportointi on kytketty pois päältä, joten Neo4j ei lähetä käyttöraporttia eikä Qdrant lähetä telemetriaa.
Rekisteröitymisen hallinta
nexus-auth sisältää kaksi tarkistusta rekisteröityvien henkilöiden seulontaan, ja molemmat ovat pois päältä jokaisessa asennuksessa.
CAPTCHA-tarkistus tarkistaa jokaisen rekisteröitymisen internetissä toimivalla ulkoisella palvelulla. Asennus ei ole koskaan riippuvainen internetistä rekisteröitymishetkellä, joten kaavio kytkee sen pois päältä. Verkkoseulonta tarvitsee kaksi GeoLite2-tietokantaa arvioidakseen, mistä rekisteröityminen tulee. Ne ovat lisensoituja latauksia, joita ei ole nexus-auth-levykuvassa eikä kaavio liitä niitä, eikä seulonnan päälle kytkemiseksi ole asetusta. Se, mistä luovutte, on konesali- ja webhotelliverkoista tulevien rekisteröitymisten seulonta.
Sen sijaan saatte hyväksyntämenettelyn. Tuntemattoman henkilön rekisteröityminen jää odottamaan pääkäyttäjän hyväksyntää, ja siihen asti henkilölle vastataan 403 SIGNUP_REQUIRES_APPROVAL. Kumpikaan kytkin ei muuta tätä.
Nopeusrajoitukset ja tunnisteiden elinkaaret
# harrow-values.yaml (Helm values): sign-in service
auth:
rateLimitPerMinute: 5000
accessTokenTTL: 15m
refreshTokenTTL: 12h
proxy:
trustedCIDRs: "10.244.0.0/16"auth.rateLimitPerMinute on enimmäismäärä pyyntöjä, jonka yksi sisäänkirjautunut henkilö voi tehdä palvelulle nexus-auth minuutissa ennen kuin se vastaa 429. Jokainen henkilö saa saman rajan, eikä alustan omaa palveluidentiteettiä (service principal) lasketa mukaan siihen. Oletusarvo 5000 on noin 83 pyyntöä sekunnissa yhdeltä tililtä, mikä on runsaasti ihmisille ja komentosarjoille. Laskekaa sitä tiukentaaksenne rajaa tai nostakaa sitä raskasta automaatiota varten. Arvon on oltava kokonaisluku, joka on vähintään 1. Väsytyshyökkäysten esto (brute-force protection) kirjautumisen yhteydessä (tilin lukitus ja toisen vaiheen tunnistusyritysten rajat) on erillinen, eikä sitä aseteta tässä.
Rajan ylittävä kutsuja saa vastauksen RATE_LIMITED otsaketiedolla Retry-After, ja viestin runko sisältää rajan sekä odotusajan. Enterprise-versiossa pääkäyttäjät asettavat tarkempia rajoja kohdassa Asetukset, Nopeusrajat: pyyntöjä minuutissa ja samanaikaisia ajoja, jokaiselle komentosarja-avaimelle tai sovellukselle sekä jokaiselle yksikölle. Rajansa ylittänyttä kutsujaa pyydetään odottamaan, eikä yhteyttä koskaan katkaista kokonaan. Poistettu raja palautuu yksikön rajaan ja sen jälkeen oletusarvoon.
auth.accessTokenTTL ja auth.refreshTokenTTL asettavat käyttövaltuustiedon (access token) ja päivitysvaltuustiedon (refresh token) elinajan. Pitäkaa käyttövaltuustiedon elinaika korkeintaan yhdessä tunnissa. Nexus-laajennusten ohjelmistokehityspaketilla (Plugin SDK) rakennetut liitännäiset hylkäävät istuntovaltuustiedon, joka on voimassa yli tunnin, koodilla JWT_LIFETIME_EXCEEDED.
proxy.trustedCIDRs nimeää välityspalvelinhypyt, joiden X-Forwarded-For-otsaketietoon nexus-auth luottaa. Oletusarvo, 10.42.0.0/16, on k3s-pod-verkko, jossa sen Traefik toimii. Toisessa jakelussa asettakaa se ingress-ohjaimenne pod-verkoksi. Jos se on väärin, nexus-auth näkee jokaisen pyynnön tulevan ingress-ohjaimelta, jolloin alla olevat osoitesäännöt näkisivät vain kyseisen osoitteen. Eri X-Forwarded-For-arvo ei-luotetusta hypystä ei koskaan avaa uutta nopeusrajoitusikkunaa.
Yrityksen kirjautuminen
Käyttäjät kirjautuvat sisään avainkoodilla (passkey) tai Googlen tai GitHubin kautta, ja yrityskirjautuminen on neljäs tapa. Pääkäyttäjä ei koskaan kirjaudu sisään pelkällä salasanalla: toinen tarkistus on avainkoodi.
Community-versio sisältää yhden yrityskirjautumisen OpenID Connectin (OIDC) kautta, jolla on oma määritysnäkymänsä ja testituloksensa. Enterprise-versio lisää Security Assertion Markup Languagen (SAML), pakotuksen kaikille sekä hakemistosynkronoinnin System for Cross-domain Identity Managementin (SCIM) kautta.
Yrityskirjautuminen voidaan vaatia vasta, kun pääkäyttäjä on tehnyt neljä asiaa järjestyksessä: yhdistänyt kirjautumispalvelun, todistanut verkkotunnuksen omistajuuden, kirjautunut sen kautta omalla tilillään ja nimennyt yhden hätäkäyttötilin. Siihen asti Vaadi sitä -painike pysyy suljettuna, ja sivu kertoo, mitkä vaiheet puuttuvat koodilla COMPANY_SIGNIN_STEPS_MISSING. Kirjautumispalvelun vaihtaminen nollaa testin, joten uusi palvelu on testattava uudelleen.
Kun yrityskirjautumispalvelu lakkaa vastaamasta, kirjautumissivu näyttää koodin IDP_UNREACHABLE (503). Jo sisäänkirjautuneet henkilöt pysyvät kirjautuneina. Pääkäyttäjät voivat käyttää pääkäyttäjän hätäkirjautumista, joka vaatii kassakaapissa säilytettävän sinetöidyn koodin ja pääkäyttäjän avainkoodin. Jokainen käyttökerta kirjataan tarkastuslokiin tiedoilla siitä, kuka sitä käytti ja mistä, ilmoitetaan välittömästi jokaiselle pääkäyttäjälle, ja se päättyy 4 tunnin kuluttua tai kun yrityskirjautuminen palaa toimintaan.
Kaikki organisaatiossa kirjautuvat samaan konsoliin ja tekevät päivittäisen työnsä siellä; omistajat ja pääkäyttäjät näkevät myös hallintasivut. Jäsen, joka avaa yhden näistä sivuista, saa Ei pääkäyttäjä -sivun, jonka rivit ovat harmaana ja jossa näkyvät niiden henkilöiden nimet, jotka voivat muuttaa niitä (NOT_AN_ADMINISTRATOR).
Epäilyttävät kirjautumiset ja osoitesäännöt
Enterprise-versiossa Epäilyttävät kirjautumiset luettelee salasanakirjautumiset, jotka vaikuttivat uusilta tai epätavallisilta: uusi paikka tai laite, tai väärät salasanat aiemmin samana päivänä. Jokaisen kohdalla kerrotaan, mitä Nexus teki, olipa se sitten toisen tarkistuksen pyytäminen tai kirjautumisen estäminen. Joku vastaa jokaiselle riville valinnalla Ei ollut hän, mikä päättää kyseisen henkilön kirjautumisistunnot, tai Se oli hän.
Sallitut ja estetyt osoitteet sisältää kaksi luetteloa. Sallitut alueet ovat ainoita paikkoja, joista omistajat ja pääkäyttäjät voivat kirjautua sisään; jos niitä ei ole, he voivat kirjautua mistä tahansa. Tämä ei vaikuta jäseniin. Estetyt osoitteet ovat paikkoja, joista kukaan ei voi kirjautua sisään. Jokainen merkintä tallentaa, kuka sen lisäsi ja milloin esto poistuu. Jokainen muutos testataan ensin omaa nykyistä osoitettanne vasten, ja muutos, joka lukitsisi teidät ulos, hylätään tallentamatta mitään. Alueen tiukentaminen päättää välittömästi niiden pääkäyttäjien kirjautumisistunnot, joita se ei enää päästä sisään.
Avaimet ja varmenteet
Jokaisen organisaation tiedot lukitaan sen omalla avaimella, jota hallinnoi valitsemanne säilyttäjä: turvamoduuli (hardware security module) tai ohjelmisto. Avaimet-sivu näyttää organisaatioavaimen versiot ja sen, milloin seuraava kierto on määrä suorittaa. Versio pysyy luettavana sen jälkeen, kun se lakkaa olemasta nykyinen versio, kunnes mitään ei ole enää salattu sen alaisuudessa. Itse avaimia ei koskaan näytetä, vain niiden sormenjäljet.
Avaimen tuhoaminen on tapa, jolla Nexus poistaa tietoja pysyvästi. Avaimet ja tietojen poisto -sivulla Poista tuhoaa yhden henkilön tai koko organisaation avaimen, mikä tekee kaikesta sen lukitsemasta lukukelvotonta kaikkialla, varmuuskopiot mukaan lukien. Toimintoa ei voi kumota, joten se pyytää kirjallisen perustelun ja toisen henkilön vahvistuksen. Siitä jää kuitti, johon kirjataan, mitä poistettiin ja kenen toimesta, ei koskaan itse sisältöä.
Vanhentumassa olevat avaimet luettelee pian päättyvät palveluntarjoajien valtuustiedot ja varmenteet, kenelle niistä varoitetaan ja milloin, sekä mitä pysähtyy, jos jokin niistä vanhenee. Käynnissä oleva työ ei pysähdy, ja tekoälyreititin siirtyy käyttämään varalla olevaa toista avainta.
Neljän silmän hyväksynnät
Enterprise-versiossa käytännöt voivat asettaa arkaluonteiset muutokset odottamaan toista henkilöä. Kahden henkilön hyväksynnät luettelee jokaisen odottavan pyynnön sekä sen, kuka pyysi, miksi, kuinka monta hyväksyntää se vaatii ja milloin se raukeaa. Kukaan ei voi hyväksyä omaa pyyntöään (TRUST_APPROVAL_SELF_APPROVAL), ja jo päätetty pyyntö vastaa APPROVAL_ALREADY_DECIDED. Pyynnön hylkääminen vaatii perustelun. Pyyntö, josta kukaan ei päätä ajoissa, raukeaa, eikä mikään muutu. Se, mitkä muutokset odottavat täällä, määräytyy toista henkilöä vaativien käytäntöjen mukaan: varmuuskopion palauttaminen ja käyttöoikeuksien lisääminen ovat kaksi esimerkkiä muualla tässä oppaassa.
Toisen käyttäjän näkymän tarkastelu
Tuki organisaation sisällä tarkoittaa joskus sivun näkemistä siten kuin kollega sen näkee. Enterprise-versiossa Näe se kuten he näkevät antaa pääkäyttäjälle vain luku -näkymän konsoliin sellaisena kuin yksi jäsen sen näkee, 30 minuutin ajaksi, toisen tarkistuksen ja kirjallisen perustelun jälkeen. Jäsenelle ilmoitetaan asiasta. Heidän yksityisiä kohteitaan (sähköpostia, muistikirjoja, suoria viestejä ja sitä, mitä avustaja muistaa heitä varten) ei koskaan näytetä, yläreunassa on banneri koko ajan, ja kaikki kirjataan tarkastuslokiin.
Suuret muutokset saavat oman pysäytyksensä. Ennen kuin laajoja vaikutuksia sisältävä muutos tallennetaan, Ennen kuin tämä muutos tapahtuu -peittokuva luettelee, mikä hajoaa, mikä vaatii huomiota ja mihin muutos ei vaikuta. Muutosta ei estetä. Siitä tehdään riittävän huomattava harkittavaksi, ja Enterprise-versiossa arkaluonteinen muutos odottaa myös toista henkilöä.
Auditointilokien säilytys ja suoratoisto
Tarkastusloki kirjaa, kuka teki mitä, uusin ensin, ja sitä voidaan suodattaa ja viedä. Community-versio säilyttää 30 päivää ja vie taulukkolaskentatiedoston. Enterprise-versio säilyttää sitä niin kauan kuin säilytyskäytäntönne määrää Asetukset-kohdan Säilyttäminen ja poistaminen -sivulla, ja suoratoistaa sen tietoturvan valvontajärjestelmäänne. Myös hylkäykset kirjataan, joten henkilö, jolle vastattiin kieltävästi, jättää rivin siinä missä onnistunutkin henkilö. Taustalla olevat hallintotietueet ketjutetaan organisaatiokohtaisesti, joten jokainen organisaatio voi tarkistaa oman osuutensa näkemättä muiden tietoja.
Tietokantaroolit
Nexus ei koskaan aja palveluitaan tietokannan pääkäyttäjänä (superuser). Käynnistyskoukku (bootstrap hook), joka on ainoa klusterin pääkäyttäjää hallussaan pitävä osa konsolin BFF-palvelun (backend for frontend) kertaluonteisen valmisteluvaiheen lisäksi, luo nämä roolit:
| Rooli | Mikä se on |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Omistaa nexus-tietokannan ja jokaisen objektin, jonka migraatiot luovat, ja luo roolit, jotka migraatiot nimeävät. |
nexus_runtime |
Ryhmä, joka ei voi kirjautua sisään. Se myöntää yhteys- ja skeemankäyttöoikeudet, mutta ei tauluoikeuksia. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
Jokaisen palvelun oma kirjautumistunnus: NOSUPERUSER NOBYPASSRLS, joka on ryhmän nexus_runtime jäsen ja jolle sen omat migraatiot ovat myöntäneet oikeudet sen omiin tauluihin eikä mihinkään muuhun. |
nexus_ledger_reader |
Lukee yhden taulun, julkaisukirjanpidon (release ledger), wait-for-schema-alustuskontteja (init containers) varten. Ei muita oikeuksia. |
Koska mikään palvelurooli ei omista taulujaan eikä yksikään voi ohittaa rivitason tietoturvaa (row-level security, RLS), jokainen RLS-käytäntö koskee jokaista palveluyhteyttä. Rivitason tietoturva on pakotettu palvelun nexus-auth tauluissa, joten jopa niiden omistaja on sidottu siihen. Jos palvelimellanne on jo rooli nimeltä nexus, jolla on määrite SUPERUSER tai BYPASSRLS, käynnistysprosessi kieltäytyy jatkamasta: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Poistakaa kyseinen määrite tai käyttäkää toista palvelinta.




