Versiune 1.0.0-alpha.1cea mai recentă
Capitolul 2.16
Securitate și rețelistică
Ce permite o instalare la intrare și la ieșire, cum își dovedesc serviciile sale identitatea unele față de altele și controalele pe care un operator le setează sau le moștenește pentru autentificare și baza de date.
Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

Evaluarea de securitate a Harrow Port Authority i-a adresat mai întâi o singură întrebare lui Tomás Reilly: ce părăsește clusterul? Răspunsul său a încăput pe o pagină. Nimic din spațiul de nume nexus nu accesează ceva din afara acestuia, cu excepția interogărilor Domain Name System (DNS), a interfeței de programare a aplicațiilor (API) Kubernetes pentru câteva sarcini de lucru și a intervalelor de adrese pe care Harrow le listează în fișierul său de valori. Nu există telemetrie și nici apeluri către serverele producătorului. Evaluarea a trecut apoi la autentificare și la baza de date, aceasta fiind, în linii mari, ordinea pe care o urmează acest capitol.
Politici de rețea
Politicile de rețea sunt activate în mod implicit (networkPolicy.enabled: true), iar chart-ul pornește de la o politică de interzicere totală (deny-all) și readaugă doar ceea ce are nevoie Nexus:
| Politică | Ce permite |
|---|---|
nexus-default-deny |
Nimic. Selectează fiecare pod din spațiul de nume, în ambele direcții. |
nexus-in-namespace |
Pod-urile Nexus care comunică între ele și interogările DNS către kube-dns în kube-system pe portul 53. |
nexus-token-review |
Verificatorii de tokenuri (nexus-probitas și nexus-orchestrator) și Job-ul de custodie a cheilor care accesează serverul API Kubernetes pe 6443 sau 443. Niciun alt pod nu are tokenul API montat. |
nexus-ingress-controller |
Spațiul de nume al controlerului ingress care accesează cele trei servicii publice și nimic altceva. |
nexus-operator-egress |
Pod-urile care accesează intervalele de adrese din networkPolicy.externalEgressCIDRs. Se generează doar atunci când acea listă nu este goală. |
Cele două servere OpenBao se află în spatele propriei lor politici. Acestea sunt etichetate ca parte a depozitului de chei, și nu ca parte a Nexus, astfel încât regula din interiorul spațiului de nume nu li se aplică. Doar nexus-keys și job-urile sale (printre care Job-ul de custodie) pot comunica cu ele, și doar depozitul de chei poate comunica cu serviciul de desigilare (unsealer).
Trei valori definesc politicile:
# 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 este spațiul de nume al controlerului ingress din fața celor trei gazde publice. Valoarea implicită, kube-system, se potrivește cu k3s, care livrează Traefik acolo. Harrow își rulează propriul controler în ingress-nginx.
apiServerCIDRs reprezintă adresele serverului API Kubernetes sub formă de intervale /32 Classless Inter-Domain Routing (CIDR). Dacă sunt lăsate goale, chart-ul le citește din obiectul Endpoints kubernetes la instalare. helm template nu are niciun cluster din care să citească, așadar trebuie să îi fie furnizate; în caz contrar, se oprește cu eroarea „networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read”.
externalEgressCIDRs listează tot ceea ce se află în afara spațiului de nume și pe care Nexus trebuie să îl apeleze. Dacă este gol, înseamnă nimic. Harrow își listează propriul releu de e-mail și subrețeaua serverelor sale de modele. Dacă vă conectați la un furnizor de modele găzduit, la un serviciu de autentificare al companiei din afara clusterului sau la o sursă de date, intervalele acestora își au locul tot aici. Omiterea unuia este motivul obișnuit pentru care o cheie care funcționează pe un laptop eșuează pe instanța instalată: apelul nu părăsește niciodată clusterul.
În interiorul produsului, pagina Unde pot pleca apelurile listează fiecare destinație externă pe care Nexus o poate accesa, motivul pentru care se află acolo și cine a adăugat-o. Orice altceva este refuzat cu un cod care indică regula. Pe pagină, refuzul apare ca EGRESS_DENIED. Rezidența datelor funcționează în același mod, cu un nivel mai sus: în ediția Enterprise, Unde sunt stocate datele stabilește regiunea pentru fiecare tip de date, iar o organizație își poate restricționa traficul de inteligență artificială (IA) către furnizori din UE, astfel încât ruterul să refuze orice altceva (consultați capitolul 2.14, Furnizori și modele de IA). O aplicație care încearcă să acceseze o adresă pe care manifestul său nu a declarat-o niciodată este oprită la marginea rețelei cu EGRESS_NOT_DECLARED.
Identitatea serviciilor de la autoritatea locală de certificare
Nexus rulează fără un service mesh. Chart-ul are o valoare istio.enabled, care este setată implicit la false, și nu există niciun motiv pentru a o activa. În schimb, serviciile își dovedesc identitatea unele altora prin TLS mutual (mTLS): Transport Layer Security (TLS) în care ambele capete prezintă un certificat. Certificatele provin de la o autoritate de certificare (CA) locală pe care chart-ul o creează prin cert-manager v1.21.3, fără a fi necesară instalarea altui element.
Lanțul este scurt. Un emițător autosemnat, nexus-selfsigned, semnează certificatul CA nexus-local-ca, o cheie ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 valabilă timp de zece ani. cert-manager îl reînnoiește cu 30 de zile înainte de expirare. Un al doilea emițător cu același nume semnează tot restul pe baza acestuia.
Fiecare serviciu care apelează un serviciu ce necesită TLS mutual primește propriul său certificat de client, într-un Secret denumit după contul său de serviciu (<service-account>-client-tls). Certificatul poartă identitatea SPIFFE a serviciului ca nume URI:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Serviciul apelat verifică acel certificat în raport cu autoritatea de certificare (CA) locală și citește din acesta identitatea apelantului. Fiecare sarcină de lucru are încredere în CA prin intermediul ca.crt din Secret-ul propriului său certificat. Niciun pod nu montează cheia privată a CA și niciun ConfigMap nu conține CA. nexus-probitas deservește singur TLS din nexus-probitas-tls, un certificat de 90 de zile reînnoit cu 15 zile înainte de expirare.
Marginea publică este separată, iar tls.mode o determină:
existing: un Secret TLS creat de dumneavoastră, numit întls.existingSecret.cert-manager: certificate de la un ClusterIssuer pe care îl rulați, numit întls.clusterIssuer.none: conexiunea TLS se termină înainte de ingress, pe propriul dumneavoastră echilibrator de sarcină (load balancer). Browserul trebuie totuși să acceseze consola prin HTTPS (consultați capitolul 2.17, Depanare).
Sesiunea de autentificare în sine depinde de HTTPS. Consola acceptă o autentificare doar de la propria sa origine, https://<hosts.console>, păstrează sesiunea într-un cookie __Host- marcat ca Secure, iar cheia de acces (passkey) a primului administrator necesită o pagină cu un certificat valid. Un browser pe HTTP simplu sau aflat în spatele unui avertisment de certificat nu se poate autentifica deloc.
Nivelul de date din interiorul clusterului comunică cu serviciile fără TLS în mod implicit (dataTier.postgres.sslmode: disable), deoarece acel trafic rămâne în interiorul spațiului de nume, sub incidența politicilor de mai sus. Un Postgres extern utilizează verify-full sau verify-ca, cu CA-ul serverului în Secret-ul depozitului, așa cum este descris în capitolul 2.11, Variații: depozite externe, TLS și ingress.
Telemetria este dezactivată
Nicio telemetrie nu părăsește o instanță instalată. telemetry.enabled poate fi doar false: schema chart-ului refuză orice altă valoare. Raportarea proprie a nivelului de date este, de asemenea, dezactivată, astfel încât Neo4j nu trimite niciun raport de utilizare, iar Qdrant nu trimite nicio telemetrie.
Controale pentru înregistrare
nexus-auth are două controale pentru filtrarea persoanelor care se înregistrează, iar ambele sunt dezactivate pe fiecare instanță instalată.
Controlul CAPTCHA verifică fiecare înregistrare cu ajutorul unui serviciu găzduit pe internet. O instanță instalată nu depinde niciodată de internet la înregistrare, astfel încât chart-ul îl dezactivează. Filtrul de rețea are nevoie de două baze de date GeoLite2 pentru a evalua de unde provine o înregistrare. Acestea sunt descărcări licențiate care nu se află nici în imaginea nexus-auth și nici nu sunt montate de chart, și nu există nicio valoare de configurare pentru a activa acest filtru. Ceea ce pierdeți este filtrarea înregistrărilor provenite din rețele de centre de date și de găzduire.
Ceea ce primiți în schimb este aprobarea. Înregistrarea unei persoane necunoscute este reținută pentru a fi aprobată de un administrator, iar până atunci persoanei i se răspunde cu 403 SIGNUP_REQUIRES_APPROVAL. Niciuna dintre opțiuni nu schimbă acest lucru.
Limite de rată și durate de viață ale tokenurilor
# harrow-values.yaml (Helm values): sign-in service
auth:
rateLimitPerMinute: 5000
accessTokenTTL: 15m
refreshTokenTTL: 12h
proxy:
trustedCIDRs: "10.244.0.0/16"auth.rateLimitPerMinute reprezintă numărul maxim de cereri pe care o persoană autentificată le poate face către nexus-auth într-un minut înainte ca acesta să răspundă cu 429. Fiecare persoană primește aceeași limită, iar entitatea de serviciu (service principal) proprie a platformei nu este contorizată în cadrul acesteia. Valoarea implicită de 5000 înseamnă aproximativ 83 pe secundă de la un singur cont, ceea ce este mai mult decât suficient pentru persoane și scripturi. Reduceți valoarea pentru a înăspri restricția sau creșteți-o pentru automatizări complexe. Este un număr întreg mai mare sau egal cu 1. Protecția împotriva atacurilor de tip forță brută la autentificare (blocarea contului și limitele privind încercările pentru al doilea factor) este separată și nu se setează aici.
Un apelant care depășește o limită primește RATE_LIMITED cu un antet Retry-After, iar corpul răspunsului conține limita și timpul de așteptare. În ediția Enterprise, administratorii stabilesc limite mai detaliate în Setări, Limite de rată: cereri pe minut și job-uri simultane, pentru fiecare cheie de script sau aplicație și pentru fiecare unitate. Un apelant care își depășește limita este rugat să aștepte și nu este niciodată deconectat. O limită retrasă revine la cea a unității, apoi la valoarea implicită.
auth.accessTokenTTL și auth.refreshTokenTTL stabilesc durata de viață a unui token de acces și a unui token de reîmprospătare. Păstrați tokenul de acces la o oră sau mai puțin. Pluginurile construite cu Plugin SDK, kitul de dezvoltare software pentru extensiile Nexus, refuză un token de sesiune care are o durată de viață mai mare de o oră, returnând JWT_LIFETIME_EXCEEDED.
proxy.trustedCIDRs indică nodurile proxy intermediare (hops) în al căror antet X-Forwarded-For are încredere nexus-auth. Valoarea implicită, 10.42.0.0/16, este rețeaua de pod-uri k3s în care rulează Traefik. Pe o altă distribuție, setați-o la rețeaua de pod-uri a controlerului dumneavoastră ingress. Dacă este greșită, nexus-auth vede fiecare cerere ca provenind de la controlerul ingress, astfel încât regulile de adrese de mai jos ar vedea doar acea adresă. Un X-Forwarded-For diferit de la un nod intermediar care nu este de încredere nu deschide niciodată o nouă fereastră de limitare a ratei.
Autentificarea companiei
Utilizatorii se autentifică cu o cheie de acces (passkey) sau prin Google ori GitHub, iar autentificarea companiei este a patra modalitate. Un administrator nu se autentifică niciodată doar cu o parolă: a doua verificare este o cheie de acces.
Ediția Community include o autentificare a companiei prin OpenID Connect (OIDC), cu propriul ecran de configurare și un rezultat de test. Ediția Enterprise adaugă Security Assertion Markup Language (SAML), impunerea autentificării pentru toți utilizatorii și sincronizarea directoarelor prin System for Cross-domain Identity Management (SCIM).
Autentificarea companiei poate deveni obligatorie doar după ce un administrator a efectuat patru pași, în această ordine: a conectat serviciul de autentificare, a dovedit deținerea domeniului, s-a autentificat prin intermediul acestuia cu propriul cont și a desemnat un cont de urgență. Până atunci, butonul Impune rămâne inactiv, iar pagina indică pașii care lipsesc cu codul COMPANY_SIGNIN_STEPS_MISSING. Schimbarea serviciului de autentificare șterge testul, astfel încât un serviciu nou trebuie testat din nou.
Când serviciul de autentificare al companiei nu mai răspunde, pagina de autentificare afișează IDP_UNREACHABLE (503). Utilizatorii deja autentificați rămân autentificați. Administratorii pot folosi autentificarea de urgență pentru administratori, care necesită codul sigilat păstrat în seif și cheia de acces a administratorului. Fiecare utilizare este înregistrată în jurnalul de audit cu detalii despre cine a folosit-o și de unde, este anunțată imediat tuturor administratorilor și expiră după 4 ore sau când autentificarea companiei își revine.
Toți membrii unei organizații se autentifică în aceeași consolă și își desfășoară activitatea zilnică acolo; proprietarii și administratorii văd, de asemenea, paginile de administrare. Un membru care deschide una dintre acele pagini primește pagina Nu sunteți administrator, cu rândurile dezactivate (gri) și numele persoanelor care le pot modifica (NOT_AN_ADMINISTRATOR).
Autentificări suspecte și reguli privind adresele
În ediția Enterprise, Autentificări suspecte listează autentificările cu parolă care au părut noi sau neobișnuite: o locație sau un dispozitiv nou, ori parole greșite introduse mai devreme în acea zi. Pentru fiecare caz, se specifică ce a făcut Nexus, fie că a solicitat o a doua verificare, fie că a blocat autentificarea. Cineva răspunde la fiecare rând cu Nu a fost această persoană, ceea ce încheie sesiunile de autentificare ale persoanei respective, sau A fost această persoană.
Adrese permise și blocate conține două liste. Intervalele permise sunt singurele locuri din care proprietarii și administratorii se pot autentifica; dacă nu este specificat niciunul, aceștia se pot autentifica de oriunde. Membrii nu sunt afectați. Adresele blocate sunt locuri din care nimeni nu se poate autentifica. Fiecare înregistrare reține cine a adăugat-o și când expiră restricția. Fiecare modificare este testată mai întâi în raport cu propria dumneavoastră adresă curentă, iar o modificare care v-ar bloca accesul este refuzată fără a salva nimic. Restrângerea unui interval încheie imediat sesiunile de autentificare ale administratorilor cărora nu le mai permite accesul.
Chei și certificate
Datele fiecărei organizații sunt blocate cu propria sa cheie, deținută de un custode ales de dumneavoastră: un modul de securitate hardware (HSM) sau software. Pagina Chei afișează versiunile cheii organizației și data la care este scadentă următoarea rotație. O versiune rămâne lizibilă după ce încetează să mai fie cea curentă, până când nimic nu mai este încapsulat sub ea. Cheile în sine nu sunt afișate niciodată, ci doar amprentele lor.
Distrugerea unei chei este modul în care Nexus șterge datele. În Chei și ștergere, opțiunea Șterge distruge cheia unei persoane sau a unei întregi organizații, ceea ce face ca tot ceea ce a blocat acea cheie să devină ilizibil peste tot, inclusiv în copiile de rezervă. Acțiunea nu poate fi anulată, motiv pentru care solicită un motiv scris și aprobarea unei a doua persoane. Aceasta lasă în urmă o confirmare care înregistrează ce s-a șters și de către cine, dar niciodată conținutul.
Chei pe cale să expire listează tokenurile de furnizor și certificatele care expiră în curând, cine este avertizat și când, precum și ce se oprește dacă unul dintre ele expiră. Activitatea în curs de desfășurare nu se oprește, iar ruterul IA trece pe o altă cheie de rezervă.
Aprobări de tip „patru ochi”
În ediția Enterprise, politicile pot reține modificările sensibile în așteptarea unei a doua persoane. Aprobări de tip „patru ochi” listează fiecare cerere în așteptare, indicând cine a solicitat-o, de ce, de câte aprobări are nevoie și când expiră. Nimeni nu își poate aproba propria cerere (TRUST_APPROVAL_SELF_APPROVAL), iar o cerere deja soluționată răspunde cu APPROVAL_ALREADY_DECIDED. Respingerea unei cereri necesită un motiv. O cerere asupra căreia nimeni nu ia o decizie în timp util expiră și nimic nu se schimbă. Modificările care așteaptă aici sunt stabilite de politicile care solicită o a doua persoană: restaurarea unei copii de rezervă și adăugarea de locuri (seats) sunt două exemple prezentate în altă parte a acestui ghid.
Vizualizarea a ceea ce vede altcineva
Asistența în cadrul unei organizații înseamnă uneori să vezi o pagină așa cum o vede un coleg. În ediția Enterprise, Vezi cum văd ei îi oferă unui administrator o vizualizare doar în citire a consolei așa cum o vede un membru, timp de 30 de minute, după o a doua verificare și furnizarea unui motiv scris. Membrul este informat. Elementele sale private (e-mailul, agendele, mesajele directe și ceea ce reține asistentul pentru el) nu sunt afișate niciodată, un banner rămâne în partea de sus pe toată durata sesiunii și totul este înregistrat în jurnalul de audit.
Modificările majore primesc propria lor pauză. Înainte ca o modificare cu efecte ample să fie salvată, fereastra suprapusă Înainte ca această modificare să aibă loc listează ce nu va mai funcționa, ce necesită atenție și ce rămâne neafectat. Modificarea nu este blocată. Este făcută suficient de solicitantă încât să vă determine să vă gândiți bine, iar în ediția Enterprise o modificare sensibilă așteaptă, de asemenea, aprobarea unei a doua persoane.
Păstrarea și transmiterea în flux a datelor de audit
Jurnalul de audit înregistrează cine ce a făcut, începând cu cele mai recente acțiuni, și poate fi filtrat și exportat. Ediția Community păstrează datele timp de 30 de zile și exportă un fișier de calcul tabelar. Ediția Enterprise le păstrează atât timp cât prevede politica dumneavoastră de retenție, din pagina Păstrare și eliminare din Setări, și le transmite în flux continuu către sistemul dumneavoastră de monitorizare a securității. Refuzurile sunt înregistrate și ele, astfel încât o persoană căreia i s-a respins o acțiune lasă o înregistrare, la fel ca o persoană care a reușit. Înregistrările de guvernanță din spate sunt înlănțuite la nivel de organizație, astfel încât fiecare organizație își poate verifica propria secțiune fără a o vedea pe a altcuiva.
Roluri în baza de date
Nexus nu își rulează niciodată serviciile ca superutilizator (superuser) al bazei de date. Hook-ul de bootstrap, care este singura componentă ce deține drepturi de superutilizator al clusterului în afară de pasul unic de provizionare al backend-ului pentru frontend (BFF) al consolei, creează următoarele roluri:
| Rol | Ce reprezintă |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Deține baza de date nexus și fiecare obiect pe care îl creează migrările, și creează rolurile pe care le nominalizează migrările. |
nexus_runtime |
Un grup care nu se poate autentifica. Acesta acordă dreptul de conectare și de utilizare a schemei, dar niciun drept asupra tabelelor. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
Contul de autentificare propriu al fiecărui serviciu: NOSUPERUSER NOBYPASSRLS, membru al nexus_runtime, căruia i se acordă drepturi asupra propriilor tabele prin propriile sale migrări și nimic altceva. |
nexus_ledger_reader |
Citește un singur tabel, registrul de lansări (release ledger), pentru containerele de inițializare wait-for-schema. Niciun alt drept acordat. |
Deoarece niciun rol de serviciu nu își deține tabelele și niciunul nu poate ocoli securitatea la nivel de rând (RLS), fiecare politică RLS se aplică fiecărei conexiuni de serviciu. Securitatea la nivel de rând este impusă pe tabelele nexus-auth, astfel încât chiar și proprietarul acestora trebuie să o respecte. Dacă pe serverul dumneavoastră există deja un rol numit nexus cu SUPERUSER sau BYPASSRLS, procesul de bootstrap refuză să continue: „role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done.” Eliminați acel atribut sau utilizați un alt server.




