Versione 1.0.0-alpha.1ultima
Capitolo 2.16
Sicurezza e rete
Cosa lascia entrare e uscire un'installazione, come i suoi servizi dimostrano reciprocamente la propria identità e i controlli che un operatore imposta o eredita per l'accesso e il database.
Questa pagina è stata tradotta dall'IA a partire dall'originale in inglese. In caso di dubbi, fa fede la pagina in inglese. Legga questa pagina in inglese

La revisione di sicurezza di Harrow Port Authority ha posto per prima cosa una domanda a Tomás Reilly: cosa esce dal cluster? La sua risposta stava in una pagina. Nulla nel namespace nexus raggiunge alcunché al di fuori di esso, a eccezione delle ricerche nel Domain Name System (DNS), dell'application programming interface (API) di Kubernetes per alcuni carichi di lavoro e degli intervalli di indirizzi che Harrow elenca nel proprio file dei valori. Non c'è telemetria né alcuna chiamata verso l'esterno (call home). La revisione è poi passata all'accesso e al database, che è all'incirca l'ordine seguito da questo capitolo.
Criteri di rete
I criteri di rete sono attivi per impostazione predefinita (networkPolicy.enabled: true), e il chart parte da un criterio che nega tutto (deny-all) e riaggiunge solo ciò di cui Nexus ha bisogno:
| Criterio | Cosa consente |
|---|---|
nexus-default-deny |
Nulla. Seleziona ogni pod nel namespace, in entrambe le direzioni. |
nexus-in-namespace |
I pod di Nexus che comunicano tra loro e le ricerche DNS verso kube-dns in kube-system sulla porta 53. |
nexus-token-review |
I revisori di token (nexus-probitas e nexus-orchestrator) e il Job di custodia delle chiavi che raggiungono l'API server di Kubernetes sulla 6443 o 443. Nessun altro pod ha il token API montato. |
nexus-ingress-controller |
Il namespace dell'ingress controller che raggiunge i tre servizi pubblici e nient'altro. |
nexus-operator-egress |
I pod che raggiungono gli intervalli di indirizzi in networkPolicy.externalEgressCIDRs. Generato solo quando tale elenco non è vuoto. |
I due server OpenBao si trovano dietro il proprio criterio. Sono etichettati come parte del key store e non come parte di Nexus, pertanto la regola interna al namespace non li raggiunge. Solo nexus-keys e i relativi job (tra cui il Job di custodia) possono comunicare con essi, e solo il key store può comunicare con l'unsealer.
Tre valori definiscono i criteri:
# 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 è il namespace dell'ingress controller davanti ai tre host pubblici. Il valore predefinito, kube-system, è adatto a k3s, che distribuisce lì Traefik. Harrow esegue il proprio controller in ingress-nginx.
apiServerCIDRs sono gli indirizzi dell'API server di Kubernetes come intervalli /32 Classless Inter-Domain Routing (CIDR). Se lasciato vuoto, il chart li legge dagli Endpoints kubernetes durante l'installazione. helm template non ha alcun cluster da leggere, quindi devono essergli forniti, altrimenti si interrompe con "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".
externalEgressCIDRs elenca tutto ciò che si trova all'esterno del namespace e che Nexus deve chiamare. Vuoto significa nulla. Harrow elenca il proprio mail relay e la sottorete dei propri server dei modelli. Se collegate un fornitore di modelli in hosting, un servizio di accesso aziendale esterno al cluster o un'origine dati, anche i relativi intervalli vanno inseriti qui. Dimenticarne uno è il motivo abituale per cui una chiave che funziona su un portatile fallisce sull'installazione: la chiamata non esce mai dal cluster.
All'interno del prodotto, la pagina Destinazioni delle chiamate in uscita elenca ogni posizione esterna che Nexus può raggiungere, perché si trova lì e chi l'ha aggiunta. Tutto il resto viene rifiutato con un codice che indica la regola. Sulla pagina il rifiuto riporta EGRESS_DENIED. La residenza dei dati funziona allo stesso modo un livello più su: su Enterprise, Dove risiedono i dati imposta la regione per ciascun tipo di dati, e un'organizzazione può bloccare il proprio traffico di intelligenza artificiale (IA) verso i fornitori dell'UE in modo che il router rifiuti tutto il resto (si veda il capitolo 2.14, Fornitori e modelli di IA). Un'app che tenta di raggiungere un indirizzo mai dichiarato nel proprio manifesto viene bloccata sul perimetro con EGRESS_NOT_DECLARED.
Identità dei servizi dall'autorità di certificazione locale
Nexus funziona senza un service mesh. Il chart ha un valore istio.enabled, la cui impostazione predefinita è false, e non c'è motivo di attivarlo. I servizi dimostrano invece la propria identità l'uno all'altro tramite mutual TLS (mTLS): Transport Layer Security (TLS) in cui entrambe le estremità mostrano un certificato. I certificati provengono da un'autorità di certificazione (CA) locale che il chart crea tramite cert-manager v1.21.3, e non occorre installare nient'altro.
La catena è breve. Un emittente autofirmato, nexus-selfsigned, firma il certificato CA nexus-local-ca, una chiave ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 valida per dieci anni. cert-manager la rinnova 30 giorni prima della scadenza. Un secondo emittente con lo stesso nome firma tutto il resto a partire da esso.
Ogni servizio che chiama un servizio che richiede il mutual TLS ottiene il proprio certificato client, in un Secret che prende il nome dal suo service account (<service-account>-client-tls). Il certificato riporta l'identità SPIFFE del servizio come nome URI:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
Il servizio chiamato verifica tale certificato rispetto alla CA locale e ne legge l'identità del chiamante. Ogni carico di lavoro considera attendibile la CA tramite il ca.crt nel Secret del proprio certificato. Nessun pod monta la chiave privata della CA e nessuna ConfigMap contiene la CA. nexus-probitas eroga direttamente TLS da nexus-probitas-tls, un certificato di 90 giorni rinnovato 15 giorni prima della scadenza.
Il perimetro pubblico è separato ed è tls.mode a deciderlo:
existing: un Secret TLS creato da voi, indicato intls.existingSecret.cert-manager: certificati provenienti da un ClusterIssuer gestito da voi, indicato intls.clusterIssuer.none: TLS termina prima dell'ingress, sul vostro bilanciatore di carico. Il browser deve comunque raggiungere la console tramite HTTPS (si veda il capitolo 2.17, Risoluzione dei problemi).
La sessione di accesso stessa dipende da HTTPS. La console accetta un accesso solo dalla propria origine, https://<hosts.console>, mantiene la sessione in un cookie __Host- contrassegnato come Secure, e la passkey del primo amministratore richiede una pagina con un certificato valido. Un browser su semplice HTTP, o dietro un avviso di certificato, non può effettuare l'accesso in alcun modo.
Il livello dati interno al cluster comunica con i servizi senza TLS per impostazione predefinita (dataTier.postgres.sslmode: disable), poiché tale traffico rimane all'interno del namespace secondo i criteri descritti sopra. Un Postgres esterno utilizza verify-full o verify-ca, con la CA del server nel Secret dell'archivio, come descritto nel capitolo 2.11, Varianti: archivi esterni, TLS e ingress.
La telemetria è disattivata
Nessuna telemetria esce da un'installazione. telemetry.enabled può essere solo false: lo schema del chart rifiuta qualsiasi altro valore. Anche l'invio di segnalazioni proprio del livello dati è disattivato, pertanto Neo4j non invia rapporti sull'utilizzo e Qdrant non invia telemetria.
Controlli di registrazione
nexus-auth dispone di due controlli per filtrare le persone che si registrano, ed entrambi sono disattivati su ogni installazione.
Il controllo CAPTCHA verifica ogni registrazione tramite un servizio in hosting su Internet. Un'installazione non dipende mai da Internet al momento della registrazione, pertanto il chart lo disattiva. Il filtro di rete richiede due database GeoLite2 per valutare da dove proviene una registrazione. Si tratta di download con licenza che non sono presenti nell'immagine di nexus-auth né montati dal chart, e non esiste alcun valore per attivare il filtro. Ciò a cui si rinuncia è il filtraggio delle registrazioni provenienti dalle reti di data center e hosting.
Ciò che si ottiene in cambio è l'approvazione. La registrazione di uno sconosciuto viene trattenuta in attesa dell'approvazione di un amministratore e, fino a quel momento, alla persona viene risposto 403 SIGNUP_REQUIRES_APPROVAL. Nessuno dei due interruttori modifica questo comportamento.
Limiti di frequenza e durata dei token
# harrow-values.yaml (Helm values): sign-in service
auth:
rateLimitPerMinute: 5000
accessTokenTTL: 15m
refreshTokenTTL: 12h
proxy:
trustedCIDRs: "10.244.0.0/16"auth.rateLimitPerMinute è il numero massimo di richieste che una persona che ha effettuato l'accesso può inviare a nexus-auth in un minuto prima che questo risponda 429. Ogni persona riceve lo stesso limite e il service principal della piattaforma stessa non viene conteggiato ai fini di tale limite. Il valore predefinito di 5000 equivale a circa 83 al secondo da un singolo account, una quantità ampiamente sufficiente per persone e script. Abbassatelo per restringere il limite, oppure aumentatelo in caso di automazione intensiva. È un numero intero pari o superiore a 1. La protezione contro gli attacchi brute-force all'accesso (blocco dell'account e limiti sui tentativi del secondo fattore) è separata e non si imposta qui.
Un chiamante che supera un limite riceve RATE_LIMITED con un'intestazione Retry-After, e il corpo del messaggio riporta il limite e il tempo di attesa. Su Enterprise, gli amministratori impostano limiti più granulari in Impostazioni, Limiti di frequenza: richieste al minuto e job simultanei, per ciascuna chiave di script o app e per ciascuna unità. A un chiamante che supera il proprio limite viene chiesto di attendere e non viene mai disconnesso. Un limite revocato ripiega su quello dell'unità, e poi su quello predefinito.
auth.accessTokenTTL e auth.refreshTokenTTL impostano la durata di un token di accesso e di un token di aggiornamento. Mantenete il token di accesso a un'ora o meno. I plugin realizzati con il Plugin SDK, il kit di sviluppo software per le estensioni di Nexus, rifiutano un token di sessione che dura più di un'ora con JWT_LIFETIME_EXCEEDED.
proxy.trustedCIDRs indica gli hop proxy la cui intestazione X-Forwarded-For è considerata attendibile da nexus-auth. Il valore predefinito, 10.42.0.0/16, è la rete dei pod di k3s in cui viene eseguito il relativo Traefik. Su un'altra distribuzione, impostatelo sulla rete dei pod del vostro ingress controller. Se è errato, nexus-auth vede ogni richiesta come proveniente dall'ingress controller, pertanto le regole sugli indirizzi riportate di seguito vedrebbero solo quell'indirizzo. Un X-Forwarded-For diverso proveniente da un hop non attendibile non apre mai una nuova finestra per il limite di frequenza.
Accesso aziendale
Le persone accedono con una passkey oppure tramite Google o GitHub, e l'accesso aziendale è la quarta modalità. Un amministratore non accede mai solo con una password: la seconda verifica è una passkey.
Community include un accesso aziendale tramite OpenID Connect (OIDC), con la propria schermata di configurazione e un risultato del test. Enterprise aggiunge il Security Assertion Markup Language (SAML), l'applicazione obbligatoria per tutti e la sincronizzazione della directory tramite il System for Cross-domain Identity Management (SCIM).
L'accesso aziendale può essere reso obbligatorio solo dopo che un amministratore ha eseguito quattro operazioni, nell'ordine: collegare il servizio di accesso, dimostrare la titolarità del dominio, accedervi con il proprio account e indicare un account di emergenza. Fino ad allora il pulsante Rendilo obbligatorio rimane disattivato e la pagina indica quali passaggi mancano con il codice COMPANY_SIGNIN_STEPS_MISSING. La modifica del servizio di accesso azzera il test, pertanto un nuovo servizio deve essere testato nuovamente.
Quando il servizio di accesso aziendale smette di rispondere, la pagina di accesso mostra IDP_UNREACHABLE (503). Le persone che hanno già effettuato l'accesso rimangono collegate. Gli amministratori possono utilizzare l'accesso amministratore di emergenza, che richiede il codice sigillato custodito in cassaforte e la passkey dell'amministratore. Ogni utilizzo viene scritto nel registro di controllo (audit log) indicando chi lo ha usato e da dove, annunciato immediatamente a ogni amministratore, e termina dopo 4 ore o quando l'accesso aziendale torna disponibile.
Tutti i membri di un'organizzazione accedono alla stessa console e vi svolgono il proprio lavoro quotidiano; i proprietari e gli amministratori vedono anche le pagine di amministrazione. Un membro che apre una di queste pagine visualizza la pagina Non sei un amministratore, con le righe disattivate in grigio e i nomi delle persone che possono modificarle (NOT_AN_ADMINISTRATOR).
Accessi sospetti e regole sugli indirizzi
Su Enterprise, Accessi sospetti elenca gli accessi tramite password che sono apparsi nuovi o insoliti: un luogo o un dispositivo nuovo, oppure password errate inserite in precedenza nello stesso giorno. Per ciascuno indica cosa ha fatto Nexus, sia che abbia richiesto una seconda verifica sia che abbia bloccato l'accesso. Qualcuno risponde a ciascuna riga con Non era questa persona, il che termina le sessioni di accesso di tale persona, oppure Era questa persona.
Indirizzi consentiti e bloccati contiene due elenchi. Gli intervalli consentiti sono gli unici luoghi da cui proprietari e amministratori possono accedere; se non ve ne sono, possono accedere da ovunque. I membri non sono interessati. Gli indirizzi bloccati sono luoghi da cui nessuno può accedere. Ogni voce registra chi l'ha aggiunta e quando scade il blocco. Ogni modifica viene prima testata rispetto al vostro indirizzo attuale, e una modifica che vi taglierebbe fuori viene rifiutata senza salvare nulla. La restrizione di un intervallo termina immediatamente le sessioni di accesso degli amministratori che non sono più ammessi.
Chiavi e certificati
I dati di ciascuna organizzazione sono bloccati con la propria chiave, detenuta da un custode a vostra scelta: un modulo di sicurezza hardware (HSM) o un software. La pagina Chiavi mostra le versioni della chiave dell'organizzazione e la scadenza della prossima rotazione. Una versione rimane leggibile anche dopo aver cessato di essere quella corrente, finché non vi è più nulla protetto (wrapped) con essa. Le chiavi in sé non vengono mai mostrate, ma solo le rispettive impronte digitali (fingerprint).
Distruggere una chiave è il modo in cui Nexus cancella i dati. Nella pagina Chiavi e cancellazione, Cancella distrugge la chiave di una persona o di un'intera organizzazione, rendendo illeggibile ovunque tutto ciò che essa bloccava, inclusi i backup. L'operazione non può essere annullata, pertanto richiede una motivazione scritta e una seconda persona. Lascia una ricevuta che registra cosa è stato cancellato e da chi, mai il contenuto.
Chiavi in scadenza elenca i token dei fornitori e i certificati prossimi alla scadenza, chi viene avvisato e quando, e cosa si interrompe se uno scade. Il lavoro in esecuzione non si interrompe e il router IA ripiega su un'altra chiave.
Approvazioni a quattro occhi
Su Enterprise, i criteri possono trattenere le modifiche sensibili in attesa di una seconda persona. Approvazioni a quattro occhi elenca ogni richiesta in attesa indicando chi l'ha presentata, perché, di quante approvazioni ha bisogno e quando scade. Nessuno può approvare la propria richiesta (TRUST_APPROVAL_SELF_APPROVAL), e una richiesta già decisa risponde APPROVAL_ALREADY_DECIDED. Rifiutare una richiesta richiede una motivazione. Una richiesta che nessuno decide in tempo scade e nulla cambia. Quali modifiche rimangono in attesa qui è stabilito dai criteri che richiedono una seconda persona: il ripristino di un backup e l'aggiunta di postazioni sono due esempi trattati altrove in questa guida.
Vedere ciò che vede qualcun altro
Fornire assistenza all'interno di un'organizzazione a volte significa vedere una pagina come la vede un collega. Su Enterprise, Visualizza come l'utente offre a un amministratore una vista di sola lettura della console così come la vede un membro, per 30 minuti, dopo una seconda verifica e una motivazione scritta. Il membro viene informato. I suoi elementi privati (posta, blocchi note, messaggi diretti e ciò che l'assistente ricorda per lui) non vengono mai mostrati, un banner rimane visibile in alto per tutto il tempo e tutto viene registrato nel registro di controllo.
Le grandi modifiche prevedono una pausa dedicata. Prima che una modifica con effetti estesi venga salvata, la sovrimpressione Prima che questa modifica avvenga elenca cosa si interrompe, cosa richiede attenzione e cosa rimane invariato. La modifica non viene bloccata. Viene resa abbastanza impegnativa da indurre a riflettere e, su Enterprise, una modifica sensibile attende anche una seconda persona.
Conservazione e streaming dei log di audit
Il registro di controllo registra chi ha fatto cosa, a partire dagli eventi più recenti, e può essere filtrato ed esportato. Community conserva 30 giorni ed esporta un file di foglio di calcolo. Enterprise lo conserva per tutto il tempo previsto dal vostro criterio di conservazione, nella pagina Conservazione ed eliminazione sotto Impostazioni, e lo trasmette in streaming al vostro sistema di monitoraggio della sicurezza. Vengono registrati anche i rifiuti, in modo che una persona a cui è stato detto di no lasci una riga proprio come una persona la cui operazione è andata a buon fine. I record di governance sottostanti sono concatenati per organizzazione, cosicché ciascuna organizzazione possa verificare la propria porzione senza vedere quella di nessun altro.
Ruoli del database
Nexus non esegue mai i propri servizi come superuser del database. L'hook di bootstrap, che è l'unica parte a detenere il superuser del cluster oltre al passaggio di provisioning una tantum del backend for frontend (BFF) della console, crea questi ruoli:
| Ruolo | Cos'è |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Possiede il database nexus e ogni oggetto creato dalle migrazioni, e crea i ruoli indicati dalle migrazioni. |
nexus_runtime |
Un gruppo che non può effettuare l'accesso. Concede la connessione e l'uso dello schema, ma nessun diritto sulle tabelle. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
L'account di accesso proprio di ciascun servizio: NOSUPERUSER NOBYPASSRLS, membro di nexus_runtime, a cui vengono concesse le proprie tabelle dalle rispettive migrazioni e nient'altro. |
nexus_ledger_reader |
Legge una sola tabella, il registro delle release (release ledger), per gli init container wait-for-schema. Nessun'altra concessione. |
Poiché nessun ruolo di servizio possiede le proprie tabelle e nessuno può aggirare la sicurezza a livello di riga (Row-Level Security, RLS), ogni criterio RLS si applica a ogni connessione di servizio. La sicurezza a livello di riga è forzata sulle tabelle di nexus-auth, pertanto anche il loro proprietario è tenuto a rispettarla. Se sul vostro server esiste già un ruolo denominato nexus con SUPERUSER o BYPASSRLS, il bootstrap rifiuta di proseguire: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Rimuovete tale attributo o utilizzate un altro server.




