InloggenBriefing plannen

Hoofdstuk 2.16

Beveiliging en netwerken

Wat een installatie binnenlaat en naar buiten stuurt, hoe haar services aan elkaar bewijzen wie ze zijn, en de beheersmaatregelen die een beheerder instelt of overneemt voor aanmelding en de database.

Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

17 minuten leestijd

Bij de beveiligingsbeoordeling van Harrow Port Authority werd Tomás Reilly eerst één vraag gesteld: wat verlaat het cluster? Zijn antwoord paste op één pagina. Niets in de nexus-namespace bereikt iets daarbuiten, behalve Domain Name System (DNS)-zoekopdrachten, de Kubernetes application programming interface (API) voor een paar workloads, en de adresbereiken die Harrow in het bijbehorende values-bestand vermeldt. Er is geen telemetrie en geen 'call home'. De beoordeling ging daarna verder met het aanmelden en de database, wat ongeveer de volgorde is die dit hoofdstuk volgt.

Netwerkbeleid

Netwerkbeleidsregels staan standaard aan (networkPolicy.enabled: true), en de chart begint met een 'deny-all'-beleid en voegt alleen weer toe wat Nexus nodig heeft:

Beleid Wat het toestaat
nexus-default-deny Niets. Het selecteert elke pod in de namespace, in beide richtingen.
nexus-in-namespace Nexus-pods die met elkaar communiceren, en DNS-zoekopdrachten naar kube-dns in kube-system op poort 53.
nexus-token-review De token-reviewers (nexus-probitas en nexus-orchestrator) en de key-custody Job die de Kubernetes API-server bereiken op 6443 of 443. Geen enkele andere pod heeft het API-token gekoppeld.
nexus-ingress-controller De namespace van de ingress-controller die de drie openbare services bereikt en niets anders.
nexus-operator-egress Pods die de adresbereiken in networkPolicy.externalEgressCIDRs bereiken. Wordt alleen gerenderd wanneer die lijst niet leeg is.

De twee OpenBao-servers vallen onder hun eigen beleid. Ze zijn gelabeld als onderdeel van de sleutelopslag en niet als onderdeel van Nexus, zodat de regel binnen de namespace hen niet bereikt. Alleen nexus-keys en de bijbehorende jobs (waaronder de custody Job) kunnen met hen communiceren, en alleen de sleutelopslag kan met de unsealer communiceren.

Drie waarden geven vorm aan het beleid:

# 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 is de namespace van de ingress-controller vóór de drie openbare hosts. De standaardwaarde, kube-system, past bij k3s, dat daar Traefik meelevert. Harrow draait een eigen controller in ingress-nginx.

apiServerCIDRs zijn de adressen van de Kubernetes API-server als /32 Classless Inter-Domain Routing (CIDR)-bereiken. Indien leeg gelaten, leest de chart deze uit de kubernetes Endpoints tijdens de installatie. helm template heeft geen cluster om uit te lezen, dus moeten ze worden opgegeven; anders stopt het met "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".

externalEgressCIDRs vermeldt alles buiten de namespace dat Nexus moet aanroepen. Leeg betekent niets. Harrow vermeldt zijn mailrelay en het subnet van zijn modelservers. Als u een gehoste modelprovider, een bedrijfsaanmeldservice buiten het cluster of een gegevensbron verbindt, horen die bereiken hier ook thuis. Het vergeten van een bereik is de gebruikelijke reden waarom een sleutel die op een laptop werkt, op de installatie faalt: de aanroep verlaat het cluster nooit.

Een groot afgerond kader met het label "namespace nexus (default deny)". Daarin een cluster van kleine kaders "console", "nexus-auth", "gateway", "other Nexus services" verbonden door pijlen in twee richtingen met het label "in-namespace". In een hoek binnenin een apart omlijnd kader "key store: openbao, openbao-unsealer" met alleen pijlen vanuit "nexus-keys" en "custody Job". Buiten het grote kader: links "ingress controller namespace" met pijlen naar alleen de drie openbare services; bovenaan "kube-dns (port 53)"; rechtsboven "Kubernetes API server (apiServerCIDRs)" alleen bereikt vanuit de token-reviewers; rechts "externalEgressCIDRs: mail relay, model servers" bereikt vanuit Nexus-pods. Elke andere uitgaande pijl is doorgestreept getekend, met het label "refused".
Wat het netwerkbeleid in en uit de nexus-namespace toestaat.

Binnen het product vermeldt de pagina Waar aanroepen naartoe mogen elke externe locatie die Nexus mag bereiken, waarom deze er staat en wie deze heeft toegevoegd. Al het andere wordt geweigerd met een code die de regel noemt. Op de pagina luidt de weigering EGRESS_DENIED. Gegevensresidentie werkt op dezelfde manier een niveau hoger: op Enterprise stelt Waar gegevens zich bevinden de regio in voor elk soort gegevens, en een organisatie kan haar verkeer voor kunstmatige intelligentie (AI) vergrendelen op EU-providers, zodat de router al het andere weigert (zie hoofdstuk 2.14, AI-providers en -modellen). Een app die een adres probeert te bereiken dat nooit in zijn manifest is gedeclareerd, wordt aan de rand tegengehouden met EGRESS_NOT_DECLARED.

Waar aanroepen naartoe mogen
Waar aanroepen naartoe mogen
Waar aanroepen naartoe mogen. Elke toegestane bestemming vermeldt wie deze heeft toegevoegd en waarom; al het andere wordt geweigerd, en de weigeringen van vandaag worden vermeld met de regel die ze heeft tegengehouden.

Service-identiteit van de lokale certificaatautoriteit

Nexus draait zonder een service mesh. De chart heeft een istio.enabled-waarde, deze staat standaard op false, en er is geen reden om deze in te schakelen. Services bewijzen in plaats daarvan aan elkaar wie ze zijn met mutual TLS (mTLS): Transport Layer Security (TLS) waarbij beide uiteinden een certificaat tonen. De certificaten zijn afkomstig van een lokale certificeringsinstantie (CA) die de chart aanmaakt via cert-manager v1.21.3, en er hoeft niets anders te worden geïnstalleerd.

De keten is kort. Een zelfondertekende uitgever, nexus-selfsigned, ondertekent het CA-certificaat nexus-local-ca, een ECDSA (Elliptic Curve Digital Signature Algorithm) P-256-sleutel die tien jaar geldig is. cert-manager vernieuwt deze 30 dagen voordat hij verloopt. Een tweede uitgever met dezelfde naam ondertekent al het andere hiervan.

Elke service die een service aanroept waarvoor mutual TLS vereist is, krijgt zijn eigen clientcertificaat in een Secret dat is vernoemd naar zijn serviceaccount (<service-account>-client-tls). Het certificaat bevat de SPIFFE-identiteit van de service als URI-naam:

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

De aangeroepen service controleert dat certificaat bij de lokale CA en leest daaruit af wie de aanroeper is. Elke workload vertrouwt de CA via de ca.crt in het Secret van zijn eigen certificaat. Geen enkele pod koppelt de privésleutel van de CA, en geen enkele ConfigMap bevat de CA. nexus-probitas levert zelf TLS vanuit nexus-probitas-tls, een certificaat van 90 dagen dat 15 dagen voor afloop wordt vernieuwd.

De openbare rand is gescheiden, en tls.mode bepaalt dit:

  • existing: een door u gemaakt TLS Secret, genoemd in tls.existingSecret.
  • cert-manager: certificaten van een ClusterIssuer die u beheert, genoemd in tls.clusterIssuer.
  • none: TLS eindigt vóór de ingress, op uw eigen loadbalancer. De browser moet de console nog steeds via HTTPS bereiken (zie hoofdstuk 2.17, Probleemoplossing).

De aanmeldsessie zelf is afhankelijk van HTTPS. De console accepteert een aanmelding alleen vanaf zijn eigen origin, https://<hosts.console>, bewaart de sessie in een __Host--cookie dat is gemarkeerd als Secure, en de passkey van de eerste beheerder heeft een pagina met een geldig certificaat nodig. Een browser op gewoon HTTP, of achter een certificaatwaarschuwing, kan zich helemaal niet aanmelden.

De datalaag binnen het cluster communiceert standaard zonder TLS met de services (dataTier.postgres.sslmode: disable), omdat dat verkeer onder het bovenstaande beleid binnen de namespace blijft. Een externe Postgres gebruikt verify-full of verify-ca, met de CA van de server in het Secret van de opslag, zoals hoofdstuk 2.11, Variaties: externe opslag, TLS en ingress, beschrijft.

Telemetrie staat uit

Er verlaat geen telemetrie een installatie. telemetry.enabled kan alleen false zijn: het schema van de chart weigert elke andere waarde. De eigen rapportage van de datalaag is eveneens uitgeschakeld, zodat Neo4j geen gebruiksrapport verzendt en Qdrant geen telemetrie verzendt.

Beheersmaatregelen voor registratie

nexus-auth heeft twee controles voor het screenen van mensen die zich registreren, en beide staan op elke installatie uit.

De CAPTCHA-controle controleert elke registratie met een gehoste service op het internet. Een installatie is bij registratie nooit afhankelijk van het internet, dus schakelt de chart dit uit. De netwerkscreening heeft twee GeoLite2-databases nodig om te beoordelen waar een registratie vandaan komt. Dit zijn gelicentieerde downloads die zich noch in de nexus-auth-image bevinden, noch door de chart worden gekoppeld, en er is geen waarde om de screening in te schakelen. Wat u opgeeft, is het screenen van registraties vanuit datacenter- en hostingnetwerken.

Wat u daarvoor in de plaats krijgt, is goedkeuring. De registratie van een onbekende wordt vastgehouden voor goedkeuring door een beheerder, en tot die tijd krijgt de persoon het antwoord 403 SIGNUP_REQUIRES_APPROVAL. Geen van beide schakelaars verandert dat.

Limieten en levensduur van tokens

# harrow-values.yaml (Helm values): sign-in service
auth:
  rateLimitPerMinute: 5000
  accessTokenTTL: 15m
  refreshTokenTTL: 12h
proxy:
  trustedCIDRs: "10.244.0.0/16"

auth.rateLimitPerMinute is het maximale aantal verzoeken dat één aangemelde persoon per minuut aan nexus-auth mag doen voordat deze antwoordt met 429. Elke persoon krijgt dezelfde limiet, en de eigen service principal van het platform telt hiervoor niet mee. De standaardwaarde van 5000 is ongeveer 83 per seconde vanaf één account, wat ruim voldoende is voor mensen en scripts. Verlaag het om het strenger te maken, of verhoog het voor zware automatisering. Het is een geheel getal van 1 of meer. Bescherming tegen brute-force bij het aanmelden (accountvergrendeling en limieten op pogingen voor de tweede factor) staat hier los van en wordt hier niet ingesteld.

Een aanroeper die een limiet overschrijdt, krijgt RATE_LIMITED met een Retry-After-header, en de body bevat de limiet en hoe lang er moet worden gewacht. Op Enterprise stellen beheerders fijnmazigere limieten in via Instellingen, Snelheidslimieten: verzoeken per minuut en gelijktijdige taken, voor elke scriptsleutel of app en voor elke eenheid. Een aanroeper die zijn limiet overschrijdt, wordt gevraagd te wachten en wordt nooit afgesloten. Een ingetrokken limiet valt terug op die van de eenheid, en vervolgens op de standaardwaarde.

Snelheidslimieten
Snelheidslimieten
Snelheidslimieten per sleutel en eenheid. Eén script probeert het te snel opnieuw en wordt vertraagd; de pagina toont het 429-antwoord dat het script ziet en laat een beheerder de limiet ervan verhogen met opgave van een reden.

auth.accessTokenTTL en auth.refreshTokenTTL stellen in hoe lang een toegangstoken en een vernieuwingstoken geldig blijven. Houd het toegangstoken op één uur of korter. Plug-ins die zijn gebouwd met de Plugin SDK, de softwareontwikkelingskit voor Nexus-extensies, weigeren een sessietoken dat langer dan een uur geldig is, met JWT_LIFETIME_EXCEEDED.

proxy.trustedCIDRs benoemt de proxy-hops waarvan nexus-auth de X-Forwarded-For-header vertrouwt. De standaardwaarde, 10.42.0.0/16, is het k3s-podnetwerk waar Traefik draait. Stel dit op een andere distributie in op het podnetwerk van uw ingress-controller. Als dit onjuist is, ziet nexus-auth elk verzoek als afkomstig van de ingress-controller, zodat de onderstaande adresregels alleen dat adres zouden zien. Een andere X-Forwarded-For van een niet-vertrouwde hop opent nooit een nieuw venster voor de snelheidslimiet.

Bedrijfsaanmelding

Mensen melden zich aan met een passkey of via Google of GitHub, en bedrijfsaanmelding is de vierde manier. Een beheerder meldt zich nooit aan met alleen een wachtwoord: de tweede controle is een passkey.

Community bevat één bedrijfsaanmelding via OpenID Connect (OIDC), met een eigen instelscherm en een testresultaat. Enterprise voegt Security Assertion Markup Language (SAML), afdwinging voor iedereen en adresboeksynchronisatie via het System for Cross-domain Identity Management (SCIM) toe.

Bedrijfsaanmelding kan pas verplicht worden gesteld nadat een beheerder vier dingen in deze volgorde heeft gedaan: de aanmeldservice verbinden, het domein bewijzen, er zelf met het eigen account via aanmelden en één noodaccount opgeven. Tot die tijd blijft de knop Verplicht stellen gesloten en vermeldt de pagina welke stappen ontbreken met de code COMPANY_SIGNIN_STEPS_MISSING. Het wijzigen van de aanmeldservice wist de test, zodat een nieuwe service opnieuw moet worden getest.

Bedrijfsaanmelding
Bedrijfsaanmelding
Bedrijfsaanmelding kan pas verplicht worden gesteld nadat een beheerder deze met het eigen account heeft getest en een noodaccount heeft opgegeven. Elke stap moet zijn voltooid voordat de laatste wordt geopend.

Wanneer de bedrijfsaanmeldservice niet meer reageert, toont de aanmeldpagina IDP_UNREACHABLE (503). Mensen die al zijn aangemeld, blijven aangemeld. Beheerders kunnen de noodaanmelding voor beheerders gebruiken, waarvoor de verzegelde code die in de kluis wordt bewaard en de passkey van de beheerder nodig zijn. Elk gebruik wordt in het auditlogboek geschreven met wie het heeft gebruikt en waarvandaan, wordt onmiddellijk aan elke beheerder gemeld, en eindigt na 4 uur of wanneer de bedrijfsaanmelding terugkeert.

Iedereen in een organisatie meldt zich aan bij dezelfde console en doet daar het dagelijkse werk; eigenaren en beheerders zien ook de beheerpagina's. Een lid dat een van die pagina's opent, krijgt de pagina Geen beheerder te zien, met uitgegrijsde rijen en de namen van de mensen die deze kunnen wijzigen (NOT_AN_ADMINISTRATOR).

Verdachte aanmeldingen en adresregels

Op Enterprise vermeldt Verdachte aanmeldingen wachtwoordaanmeldingen die er nieuw of ongebruikelijk uitzagen: een nieuwe plaats of nieuw apparaat, of onjuiste wachtwoorden eerder die dag. Voor elk geval staat er wat Nexus heeft gedaan, of dat nu het vragen om een tweede controle was of het blokkeren van de aanmelding. Iemand beantwoordt elke rij met Zij waren het niet, wat de aanmeldingen van die persoon beëindigt, of Zij waren het wel.

Toegestane en geblokkeerde adressen bevat twee lijsten. De toegestane bereiken zijn de enige plaatsen waarvandaan eigenaren en beheerders zich mogen aanmelden; als er geen zijn, kunnen ze zich overal aanmelden. Leden worden niet beïnvloed. De geblokkeerde adressen zijn plaatsen waarvandaan niemand zich aanmeldt. Elke vermelding legt vast wie deze heeft toegevoegd en wanneer deze vervalt. Elke wijziging wordt eerst getest tegen uw eigen huidige adres, en een wijziging die u zou buitensluiten, wordt geweigerd zonder dat er iets wordt opgeslagen. Het aanscherpen van een bereik beëindigt onmiddellijk de aanmeldingen van de beheerders die er niet langer door worden binnengelaten.

Toegestane en geblokkeerde adressen
Toegestane en geblokkeerde adressen
De adresregels. Het paneel bovenaan geeft aan wat de regels doen met het eigen adres van de beheerder, zodat een wijziging die haar zou buitensluiten, wordt geweigerd voordat deze wordt opgeslagen.

Sleutels en certificaten

De gegevens van elke organisatie worden vergrendeld met een eigen sleutel, die wordt beheerd door een beheerder die u kiest: een hardwarebeveiligingsmodule of software. De pagina Sleutels toont de versies van de organisatiesleutel en wanneer de volgende rotatie gepland staat. Een versie blijft leesbaar nadat deze niet meer actueel is, totdat er niets meer mee is versleuteld. De sleutels zelf worden nooit getoond, alleen hun vingerafdrukken.

Het vernietigen van een sleutel is de manier waarop Nexus gegevens wist. Op Sleutels en wissen vernietigt Wissen de sleutel van één persoon of van een hele organisatie, waardoor alles wat ermee was vergrendeld overal onleesbaar wordt, inclusief back-ups. Dit kan niet ongedaan worden gemaakt, dus wordt er om een schriftelijke reden en een tweede persoon gevraagd. Het laat een bewijs achter waarin wordt vastgelegd wat er is gewist en door wie, nooit de inhoud.

Sleutels die bijna verlopen vermeldt providertokens en certificaten die binnenkort aflopen, wie er wordt gewaarschuwd en wanneer, en wat er stopt als er een verloopt. Lopend werk stopt niet en de AI-router valt terug op een andere sleutel.

Vier-ogengoedkeuringen

Op Enterprise kan beleid gevoelige wijzigingen vasthouden voor een tweede persoon. Vier-ogengoedkeuringen vermeldt elk wachtend verzoek met wie het heeft aangevraagd, waarom, hoeveel goedkeuringen het nodig heeft en wanneer het verloopt. Niemand keurt het eigen verzoek goed (TRUST_APPROVAL_SELF_APPROVAL), en een verzoek waarover al is beslist, antwoordt met APPROVAL_ALREADY_DECIDED. Voor het afwijzen van een verzoek is een reden nodig. Een verzoek waarover niemand op tijd beslist, verloopt en er verandert niets. Welke wijzigingen hier wachten, wordt bepaald door het beleid dat om een tweede persoon vraagt: het herstellen van een back-up en het toevoegen van licenties zijn twee voorbeelden elders in deze gids.

Vier-ogengoedkeuringen
Vier-ogengoedkeuringen
Wijzigingen die wachten op een tweede persoon. Elk verzoek toont wie het heeft aangevraagd en wanneer het verloopt, en de persoon die het heeft aangevraagd, heeft geen knop Goedkeuren bij het eigen verzoek.

Zien wat iemand anders ziet

Ondersteuning binnen een organisatie betekent soms dat u een pagina moet zien zoals een collega die ziet. Op Enterprise geeft Bekijk het zoals zij een beheerder gedurende 30 minuten een alleen-lezen weergave van de console zoals één lid die ziet, na een tweede controle en een schriftelijke reden. Het lid wordt op de hoogte gebracht. Hun privé-items (e-mail, notitieblokken, directe berichten en wat de assistent voor hen onthoudt) worden nooit getoond, er staat de hele tijd een banner bovenaan en alles wordt vastgelegd in het auditlogboek.

Grote wijzigingen krijgen een eigen pauzemoment. Voordat een wijziging met brede gevolgen wordt opgeslagen, vermeldt het venster Voordat deze wijziging plaatsvindt wat er kapotgaat, wat aandacht nodig heeft en wat ongewijzigd blijft. De wijziging wordt niet geblokkeerd. Ze wordt drempelverhogend genoeg gemaakt om over na te denken, en op Enterprise wacht een gevoelige wijziging ook op een tweede persoon.

Bewaring en streaming van auditlogboeken

Het auditlogboek legt vast wie wat heeft gedaan, het nieuwste eerst, en kan worden gefilterd en geëxporteerd. Community bewaart 30 dagen en exporteert een spreadsheetbestand. Enterprise bewaart het zo lang als uw bewaarbeleid aangeeft, op de pagina Bewaren en loslaten onder Instellingen, en streamt het naar uw systeem voor beveiligingsmonitoring. Weigeringen worden ook vastgelegd, zodat een persoon die nul op het rekest kreeg net zo goed een rij achterlaat als een persoon die slaagde. De achterliggende governancerecords zijn per organisatie gekoppeld, zodat elke organisatie haar eigen deel kan controleren zonder dat van iemand anders te zien.

Databaserollen

Nexus voert zijn services nooit uit als een database-superuser. De bootstrap-hook, het enige onderdeel dat de cluster-superuser bevat afgezien van de eenmalige inrichtingsstap van de backend for frontend (BFF) van de console, maakt deze rollen aan:

Rol Wat het is
nexus_migrator LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Is eigenaar van de nexus-database en elk object dat door de migraties wordt aangemaakt, en maakt de rollen aan die in de migraties worden genoemd.
nexus_runtime Een groep die zich niet kan aanmelden. Deze verleent rechten voor verbinding en schemagebruik, en geen tabelrechten.
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills De eigen aanmelding van elke service: NOSUPERUSER NOBYPASSRLS, een lid van nexus_runtime, krijgt via de eigen migraties rechten op de eigen tabellen en niets anders.
nexus_ledger_reader Leest één tabel, het release-grootboek, voor de wait-for-schema init-containers. Geen andere rechten.

Omdat geen enkele servicerol eigenaar is van zijn tabellen en geen enkele rol beveiliging op rijniveau (Row-Level Security, RLS) kan omzeilen, is elk RLS-beleid van toepassing op elke serviceverbinding. Beveiliging op rijniveau wordt afgedwongen op de tabellen van nexus-auth, zodat zelfs de eigenaar eraan wordt gehouden. Als er al een rol met de naam nexus op uw server bestaat met SUPERUSER of BYPASSRLS, weigert de bootstrap verder te gaan: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Verwijder dat attribuut of gebruik een andere server.