Log indBook en briefing

Kapitel 2.16

Sikkerhed og netværk

Hvad en installation lukker ind og ud, hvordan dens tjenester beviser deres identitet over for hinanden, og de kontroller en operatør indstiller eller arver for login og databasen.

Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

17 minutters læsetid

Harrow Port Authoritys sikkerhedsgennemgang stillede først Tomás Reilly ét spørgsmål: Hvad forlader klyngen? Hans svar kunne være på én side. Intet i nexus-navnerummet kontakter noget uden for det, bortset fra opslag i Domain Name System (DNS), Kubernetes' application programming interface (API) for nogle få workloads samt de adresseområder, Harrow angiver i sin values-fil. Der er ingen telemetri, og intet ringer hjem. Gennemgangen gik derefter videre til login og databasen, hvilket nogenlunde er den rækkefølge, dette kapitel følger.

Netværkspolitikker

Netværkspolitikker er slået til som standard (networkPolicy.enabled: true), og chartet tager udgangspunkt i en afvis-alt-politik og tilføjer kun det, Nexus har brug for:

Politik Hvad den tillader
nexus-default-deny Intet. Den vælger hver pod i navnerummet i begge retninger.
nexus-in-namespace Nexus-pods, der taler med hinanden, og DNS-opslag til kube-dns i kube-system på port 53.
nexus-token-review Token-kontrollanterne (nexus-probitas og nexus-orchestrator) og nøgleopbevaringsjobbet (key-custody Job), der kontakter Kubernetes API-serveren på 6443 eller 443. Ingen anden pod har API-tokenet monteret.
nexus-ingress-controller Ingress-controllerens navnerum, der kontakter de tre offentlige tjenester og intet andet.
nexus-operator-egress Pods, der kontakter adresseområderne i networkPolicy.externalEgressCIDRs. Genereres kun, når den liste ikke er tom.

De to OpenBao-servere ligger bag deres egen politik. De er mærket som en del af nøglelageret og ikke som en del af Nexus, så reglen for trafik internt i navnerummet når dem ikke. Kun nexus-keys og dets jobs (herunder opbevaringsjobbet) kan tale med dem, og kun nøglelageret kan tale med unsealeren.

Tre værdier former politikkerne:

# 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 er navnerummet for ingress-controlleren foran de tre offentlige værter. Standarden, kube-system, passer til k3s, som leverer Traefik dér. Harrow kører sin egen controller i ingress-nginx.

apiServerCIDRs er Kubernetes API-serverens adresser som /32 Classless Inter-Domain Routing (CIDR)-områder. Hvis feltet efterlades tomt, læser chartet dem fra kubernetes Endpoints under installationen. helm template har ingen klynge at læse fra, så de skal angives dér, og ellers stopper det med "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".

externalEgressCIDRs angiver alt uden for navnerummet, som Nexus skal kalde. Tom betyder intet. Harrow angiver sit mail-relay og undernettet for sine modelservere. Hvis De tilslutter en hostet modeludbyder, en virksomheds-logintjeneste uden for klyngen eller en datakilde, hører dens områder også til her. At glemme et område er den sædvanlige årsag til, at en nøgle, der virker på en bærbar computer, fejler på installationen: Kaldet forlader aldrig klyngen.

En stor boks med afrundede hjørner mærket "namespace nexus (default deny)". Inde i den er der en gruppe små bokse "console", "nexus-auth", "gateway", "other Nexus services" forbundet med dobbeltrettede pile mærket "in-namespace". I det ene hjørne indeni er der en separat indrammet boks "key store: openbao, openbao-unsealer" med pile kun fra "nexus-keys" og "custody Job". Uden for den store boks: til venstre "ingress controller namespace" med pile kun ind i de tre offentlige tjenester; øverst "kube-dns (port 53)"; øverst til højre "Kubernetes API server (apiServerCIDRs)", som kun nås fra token-kontrollanterne; til højre "externalEgressCIDRs: mail relay, model servers", som nås fra Nexus-pods. Enhver anden pil udad er tegnet overstreget og mærket "refused".
Hvad netværkspolitikkerne tillader ind og ud af nexus-navnerummet.

Inde i produktet viser siden Hvor kald må gå ud hvert eksternt sted, Nexus må kontakte, hvorfor det står der, og hvem der har tilføjet det. Alt andet afvises med en kode, der navngiver reglen. På siden vises afvisningen som EGRESS_DENIED. Dataplacering fungerer på samme måde ét niveau højere oppe: På Enterprise angiver Hvor data bor regionen for hver enkelt datatype, og en organisation kan låse sin trafik for kunstig intelligens (AI) til EU-udbydere, så routeren afviser alt andet (se kapitel 2.14, AI-udbydere og -modeller). En app, der forsøger at kontakte en adresse, som dens manifest aldrig har erklæret, stoppes ved kanten med EGRESS_NOT_DECLARED.

Hvor kald må gå ud
Hvor kald må gå ud
Hvor kald må gå ud. Hver tilladt destination angiver, hvem der har tilføjet den og hvorfor; alt andet afvises, og dagens afvisninger vises med den regel, der stoppede dem.

Tjenesteidentitet fra den lokale certifikatudsteder

Nexus kører uden et service mesh. Chartet har en istio.enabled-værdi, den er som standard sat til false, og der er ingen grund til at slå den til. Tjenester beviser i stedet, hvem de er over for hinanden, med gensidig TLS (mTLS): Transport Layer Security (TLS), hvor begge ender fremviser et certifikat. Certifikaterne kommer fra en lokal certifikatautoritet (CA), som chartet opretter via cert-manager v1.21.3, og intet andet behøver at blive installeret.

Kæden er kort. En selvsigneret udsteder, nexus-selfsigned, signerer CA-certifikatet nexus-local-ca, en ECDSA (Elliptic Curve Digital Signature Algorithm) P-256-nøgle, der er gyldig i ti år. cert-manager fornyer det 30 dage før udløb. En anden udsteder med samme navn signerer alt andet ud fra det.

Hver tjeneste, der kalder en tjeneste, som kræver gensidig TLS, får sit eget klientcertifikat i en Secret opkaldt efter dens servicekonto (<service-account>-client-tls). Certifikatet bærer tjenestens SPIFFE-identitet som sit URI-navn:

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

Den tjeneste, den kalder, kontrollerer dette certifikat op imod den lokale CA og aflæser ud fra det, hvem kalderen er. Hvert workload stoler på CA'en gennem ca.crt i den Secret, der hører til dets eget certifikat. Ingen pod monterer CA'ens private nøgle, og ingen ConfigMap indeholder CA'en. nexus-probitas leverer selv TLS fra nexus-probitas-tls, et 90-dages certifikat, der fornyes 15 dage før udløb.

Den offentlige kant er adskilt herfra, og tls.mode bestemmer den:

  • existing: en TLS Secret, De selv har oprettet, navngivet i tls.existingSecret.
  • cert-manager: certifikater fra en ClusterIssuer, De selv driver, navngivet i tls.clusterIssuer.
  • none: TLS slutter før ingressen på Deres egen load balancer. Browseren skal stadig kontakte konsollen over HTTPS (se kapitel 2.17, Fejlfinding).

Selve loginsessionen afhænger af HTTPS. Konsollen accepterer kun et login fra sin egen oprindelse (origin), https://<hosts.console>, gemmer sessionen i en __Host--cookie markeret som Secure, og den første administrators adgangsnøgle (passkey) kræver en side med et gyldigt certifikat. En browser på almindelig HTTP eller bag en certifikatadvarsel kan slet ikke logge ind.

Datalaget i klyngen taler som standard med tjenesterne uden TLS (dataTier.postgres.sslmode: disable), fordi den trafik forbliver inde i navnerummet under politikkerne ovenfor. En ekstern Postgres bruger verify-full eller verify-ca med serverens CA i lagerets Secret, som beskrevet i kapitel 2.11, Variationer: eksterne lagre, TLS og ingress.

Telemetri er slået fra

Ingen telemetri forlader en installation. telemetry.enabled kan kun være false: Chartets skema afviser enhver anden værdi. Datalagets egen rapportering er også slået fra, så Neo4j sender ingen brugsrapport, og Qdrant sender ingen telemetri.

Kontroller for tilmelding

nexus-auth har to kontroller til at screene personer, der tilmelder sig, og begge er slået fra på enhver installation.

CAPTCHA-kontrollen tjekker hver tilmelding med en hostet tjeneste på internettet. En installation er aldrig afhængig af internettet ved tilmelding, så chartet slår den fra. Netværksscreeningen kræver to GeoLite2-databaser for at vurdere, hvor en tilmelding kommer fra. De er licenserede downloads, som hverken ligger i nexus-auth-imaget eller monteres af chartet, og der findes ingen værdi til at slå screeningen til. Det, De giver afkald på, er screeningen af tilmeldinger fra datacenter- og hostingnetværk.

Det, De får i stedet, er godkendelse. En fremmeds tilmelding tilbageholdes, indtil en administrator godkender den, og indtil da får personen svaret 403 SIGNUP_REQUIRES_APPROVAL. Ingen af indstillingerne ændrer på det.

Hastighedsgrænser og levetid for 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 er det maksimale antal forespørgsler, en indlogget person må foretage til nexus-auth på et minut, før den svarer 429. Hver person får den samme grænse, og platformens egen service principal tæller ikke med i den. Standarden på 5000 svarer til omkring 83 i sekundet fra én konto, hvilket er rigeligt til personer og scripts. Sænk den for at stramme til, eller hæv den ved tung automatisering. Det er et helt tal på 1 eller derover. Brute-force-beskyttelse ved login (kontospærring og grænser for forsøg med anden faktor) er separat og indstilles ikke her.

En kalder over en grænse får RATE_LIMITED med en Retry-After-header, og brødteksten angiver grænsen, og hvor længe der skal ventes. På Enterprise fastsætter administratorer mere finkornede grænser under Indstillinger, Hastighedsgrænser: forespørgsler i minuttet og samtidige jobs for hver scriptnøgle eller app og for hver enhed. En kalder, der overskrider sin grænse, bliver bedt om at vente og bliver aldrig afbrudt. En trukket grænse falder tilbage på enhedens grænse og derefter på standarden.

Hastighedsgrænser
Hastighedsgrænser
Hastighedsgrænser pr. nøgle og enhed. Et script prøver igen for hurtigt og bliver bremset; siden viser det 429-svar, scriptet ser, og lader en administrator hæve dets grænse med en begrundelse.

auth.accessTokenTTL og auth.refreshTokenTTL angiver, hvor længe et adgangstoken og et opdateringstoken (refresh token) lever. Hold adgangstokenet på en time eller derunder. Plugins bygget med Plugin SDK, softwareudviklingssættet til Nexus-udvidelser, afviser et sessionstoken, der lever længere end en time, med JWT_LIFETIME_EXCEEDED.

proxy.trustedCIDRs navngiver de proxy-hop, hvis X-Forwarded-For-header nexus-auth stoler på. Standarden, 10.42.0.0/16, er k3s-podnetværket, hvor dets Traefik kører. På en anden distribution skal De sætte den til Deres ingress-controllers podnetværk. Hvis den er forkert, ser nexus-auth enhver forespørgsel som kommende fra ingress-controlleren, så adressereglerne nedenfor kun ville se den adresse. En anden X-Forwarded-For fra et utroværdigt hop åbner aldrig et nyt vindue for hastighedsgrænser.

Virksomhedslogin

Personer logger ind med en adgangsnøgle (passkey) eller via Google eller GitHub, og virksomheds-login er den fjerde måde. En administrator logger aldrig ind med en adgangskode alene: Den anden kontrol er en adgangsnøgle.

Community inkluderer ét virksomheds-login via OpenID Connect (OIDC) med sit eget opsætningsskærmbillede og et testresultat. Enterprise tilføjer Security Assertion Markup Language (SAML), håndhævelse for alle samt katalogsynkronisering via System for Cross-domain Identity Management (SCIM).

Virksomheds-login kan først kræves, når en administrator har gjort fire ting i rækkefølge: tilsluttet logintjenesten, bevist domænet, logget ind via den med sin egen konto og udpeget én nødkonto. Indtil da forbliver knappen Kræv det lukket, og siden fortæller, hvilke trin der mangler, med koden COMPANY_SIGNIN_STEPS_MISSING. Hvis logintjenesten ændres, nulstilles testen, så en ny tjeneste skal testes igen.

Virksomheds-login
Virksomhedslogin
Virksomheds-login kan først kræves, efter at en administrator har testet det med sin egen konto og udpeget en nødkonto. Hvert trin skal være gennemført, før det sidste åbner.

Når tjenesten til virksomheds-login holder op med at svare, viser loginsiden IDP_UNREACHABLE (503). Personer, der allerede er logget ind, forbliver logget ind. Administratorer kan bruge nød-login for administratorer, hvilket kræver den forseglede kode, der opbevares i pengeskabet, og administratorens adgangsnøgle. Hver brug skrives i revisionsloggen med angivelse af, hvem der brugte den, og hvorfra, annonceres med det samme til enhver administrator, og den slutter efter 4 timer, eller når virksomheds-login vender tilbage.

Alle i en organisation logger ind i den samme konsol og udfører deres daglige arbejde dér; ejere og administratorer ser også administrationssiderne. Et medlem, der åbner en af disse sider, får siden Ikke en administrator, hvor rækkerne er nedtonede, og navnene på de personer, der kan ændre dem, vises (NOT_AN_ADMINISTRATOR).

Mistænkelige logins og adresseregler

På Enterprise viser Mistænkelige logins adgangskode-logins, der så nye eller usædvanlige ud: et nyt sted eller en ny enhed eller forkerte adgangskoder tidligere samme dag. For hvert af dem står der, hvad Nexus gjorde, uanset om det var at bede om en ekstra kontrol eller at blokere loginnet. Nogen besvarer hver række med Ikke dem, hvilket afslutter den pågældende persons logins, eller Det var dem.

Tilladte og blokerede adresser rummer to lister. De tilladte områder er de eneste steder, ejere og administratorer må logge ind fra; hvis der ingen er, kan de logge ind hvor som helst fra. Medlemmer påvirkes ikke. De blokerede adresser er steder, ingen kan logge ind fra. Hver post registrerer, hvem der har tilføjet den, og hvornår den ophæves. Enhver ændring testes først op imod Deres egen nuværende adresse, og en ændring, der ville låse Dem ude, afvises, uden at noget gemmes. En stramning af et område afslutter med det samme de administrator-logins, som det ikke længere lukker ind.

Tilladte og blokerede adresser
Tilladte og blokerede adresser
Adressereglerne. Feltet øverst viser, hvordan reglerne vurderer administratorens egen adresse, så en ændring, der ville låse hende ude, afvises, før den gemmes.

Nøgler og certifikater

Hver organisations data er låst med dens egen nøgle, som opbevares af en forvalter efter Deres valg: et hardware security module eller software. Siden Nøgler viser organisationsnøglens versioner, og hvornår næste rotation skal finde sted. En version forbliver læsbar, efter at den ikke længere er den aktuelle, indtil intet længere er krypteret under den. Selve nøglerne vises aldrig, kun deres fingeraftryk.

At destruere en nøgle er den måde, Nexus sletter på. Under Nøgler og sletning destruerer Slet nøglen for én person eller for en hel organisation, hvilket gør alt, hvad den har låst, ulæseligt overalt, inklusive sikkerhedskopier. Det kan ikke fortrydes, så det kræver en skriftlig begrundelse og en person mere. Det efterlader en kvittering, der registrerer, hvad der blev slettet og af hvem, aldrig selve indholdet.

Nøgler, der snart udløber viser udbydertokens og certifikater, der snart slutter, hvem der advares og hvornår, og hvad der stopper, hvis en udløber. Igangværende arbejde stopper ikke, og AI-routeren falder tilbage på en anden nøgle.

Fire-øjne-godkendelser

På Enterprise kan politikker tilbageholde følsomme ændringer, så de venter på en person mere. Fire-øjne-godkendelser viser hver ventende anmodning med angivelse af, hvem der har spurgt, hvorfor, hvor mange godkendelser den kræver, og hvornår den udløber. Ingen godkender sin egen anmodning (TRUST_APPROVAL_SELF_APPROVAL), og en anmodning, der allerede er afgjort, svarer APPROVAL_ALREADY_DECIDED. At afvise en anmodning kræver en begrundelse. En anmodning, som ingen tager stilling til i tide, udløber, og intet ændres. Hvilke ændringer der venter her, bestemmes af de politikker, der kræver en person mere: Gendannelse af en sikkerhedskopi og tilføjelse af pladser er to eksempler andre steder i denne vejledning.

Fire-øjne-godkendelser
Fire-øjne-godkendelser
Ændringer, der venter på en person mere. Hver anmodning viser, hvem der har spurgt, og hvornår den udløber, og den person, der har spurgt, har ingen Godkend-knap på sin egen anmodning.

At se hvad en anden ser

Support internt i en organisation betyder nogle gange at se en side, som en kollega ser den. På Enterprise giver Se det, som de gør en administrator en skrivebeskyttet visning af konsollen, som ét medlem ser den, i 30 minutter efter en ekstra kontrol og en skriftlig begrundelse. Medlemmet får besked. Vedkommendes private elementer (mail, notesbøger, direkte beskeder og det, assistenten husker for vedkommende) vises aldrig, et banner ligger øverst i hele perioden, og alt registreres i revisionsloggen.

Store ændringer får deres egen tænkepause. Før en ændring med vidtrækkende konsekvenser gemmes, viser vinduet Før denne ændring sker, hvad der går i stykker, hvad der kræver opmærksomhed, og hvad der er upåvirket. Ændringen blokeres ikke. Den gøres besværlig nok til, at man tænker sig om, og på Enterprise venter en følsom ændring også på en person mere.

Opbevaring og streaming af revisionslogge

Revisionsloggen registrerer, hvem der gjorde hvad, med det nyeste først, og den kan filtreres og eksporteres. Community gemmer 30 dage og eksporterer en regnearksfil. Enterprise gemmer den så længe, som Deres opbevaringspolitik foreskriver på siden Opbevaring og sletning under Indstillinger, og streamer den til Deres sikkerhedsovervågningssystem. Afvisninger registreres også, så en person, der fik et nej, efterlader en række på samme måde som en person, der fik lov. Governance-posterne bag den er kædet sammen pr. organisation, så hver organisation kan kontrollere sit eget udsnit uden at se andres.

Databaseroller

Nexus kører aldrig sine tjenester som database-superbruger. Bootstrap-hooket, som er den eneste del, der ligger inde med klyngens superbruger bortset fra det engangs-provisioneringstrin, der udføres af konsollens backend for frontend (BFF), opretter disse roller:

Rolle Hvad det er
nexus_migrator LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Ejer databasen nexus og hvert objekt, som migreringerne opretter, og opretter de roller, migreringerne navngiver.
nexus_runtime En gruppe, der ikke kan logge ind. Den giver ret til forbindelse og skemabrug, men ingen tabelrettigheder.
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills Hver tjenestes eget login: NOSUPERUSER NOBYPASSRLS, et medlem af nexus_runtime, som får tildelt sine egne tabeller af sine egne migreringer og intet andet.
nexus_ledger_reader Læser én tabel, release-hovedbogen (release ledger), for wait-for-schema-init-containerne. Ingen andre rettigheder.

Fordi ingen tjenesterolle ejer sine tabeller, og ingen kan omgå sikkerhed på rækkeniveau (row-level security, RLS), gælder enhver RLS-politik for enhver tjenesteforbindelse. Sikkerhed på rækkeniveau er gennemtvunget på nexus-auths tabeller, så selv deres ejer er underlagt den. Hvis der allerede findes en rolle med navnet nexus på Deres server med SUPERUSER eller BYPASSRLS, nægter bootstrappen at fortsætte: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Fjern den egenskab, eller brug en anden server.