Versión 1.0.0-alpha.1 más reciente
Capítulo 2.16
Seguridad y redes
Qué deja entrar y salir una instalación, cómo sus servicios demuestran su identidad entre sí, y los controles que un operador establece o hereda para el inicio de sesión y la base de datos.
Esta página fue traducida por IA a partir del original en inglés. Si algo no está claro, la página en inglés es la referencia. Leer esta página en inglés

La revisión de seguridad de Harrow Port Authority le hizo a Tomás Reilly una pregunta primero: ¿qué sale del clúster? Su respuesta cabía en una página. Nada en el espacio de nombres nexus llega a nada fuera de él, excepto las consultas del sistema de nombres de dominio (DNS), la interfaz de programación de aplicaciones (API) de Kubernetes para unas pocas cargas de trabajo y los rangos de direcciones que Harrow enumera en su archivo de valores. No hay telemetría ni llamadas a casa. La revisión pasó luego al inicio de sesión y a la base de datos, que es aproximadamente el orden que sigue este capítulo.
Políticas de red
Las políticas de red están activadas de forma predeterminada (networkPolicy.enabled: true), y el chart parte de una política de denegación total y vuelve a añadir solo lo que Nexus necesita:
| Política | Qué permite |
|---|---|
nexus-default-deny |
Nada. Selecciona cada pod del espacio de nombres, en ambas direcciones. |
nexus-in-namespace |
Los pods de Nexus comunicándose entre sí y las consultas DNS a kube-dns en kube-system en el puerto 53. |
nexus-token-review |
Los revisores de tokens (nexus-probitas y nexus-orchestrator) y el Job de custodia de claves llegando al servidor de la API de Kubernetes en el 6443 o el 443. Ningún otro pod tiene montado el token de la API. |
nexus-ingress-controller |
El espacio de nombres del controlador de ingress llegando a los tres servicios públicos y a nada más. |
nexus-operator-egress |
Los pods llegando a los rangos de direcciones en networkPolicy.externalEgressCIDRs. Se genera solo cuando esa lista no está vacía. |
Los dos servidores de OpenBao se encuentran detrás de su propia política. Están etiquetados como parte del almacén de claves y no como parte de Nexus, por lo que la regla dentro del espacio de nombres no los alcanza. Solo nexus-keys y sus trabajos (el Job de custodia entre ellos) pueden comunicarse con ellos, y solo el almacén de claves puede comunicarse con el desellador.
Tres valores dan forma a las políticas:
# 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 es el espacio de nombres del controlador de ingress frente a los tres hosts públicos. El valor predeterminado, kube-system, se ajusta a k3s, que incluye Traefik allí. Harrow ejecuta su propio controlador en ingress-nginx.
apiServerCIDRs son las direcciones del servidor de la API de Kubernetes como /32 rangos de enrutamiento entre dominios sin clases (CIDR). Si se deja vacío, el chart los lee de los Endpoints de kubernetes cuando se instala. helm template no tiene ningún clúster que leer, por lo que se le deben proporcionar; de lo contrario, se detiene con "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".
externalEgressCIDRs enumera todo lo que está fuera del espacio de nombres a lo que Nexus debe llamar. Vacío significa nada. Harrow enumera su relé de correo y la subred de sus servidores de modelos. Si conecta un proveedor de modelos alojado, un servicio de inicio de sesión de empresa fuera del clúster o una fuente de datos, sus rangos también pertenecen aquí. Olvidar uno es la razón habitual por la que una clave que funciona en un portátil falla en la instalación: la llamada nunca sale del clúster.
Dentro del producto, la página A dónde pueden salir las llamadas enumera cada lugar externo al que Nexus puede llegar, por qué está ahí y quién lo añadió. Cualquier otra cosa se rechaza con un código que nombra la regla. En la página, el rechazo muestra EGRESS_DENIED. La residencia funciona de la misma manera un nivel más arriba: en Enterprise, Dónde residen los datos establece la región para cada tipo de datos, y una organización puede bloquear su tráfico de inteligencia artificial (IA) hacia proveedores de la UE para que el enrutador rechace cualquier otra cosa (consulte el capítulo 2.14, Proveedores y modelos de IA). Una aplicación que intenta llegar a una dirección que su manifiesto nunca declaró es detenida en el borde con EGRESS_NOT_DECLARED.
Identidad de servicio desde la autoridad de certificación local
Nexus se ejecuta sin una malla de servicios. El chart tiene un valor istio.enabled, su valor predeterminado es false y no hay razón para activarlo. En su lugar, los servicios demuestran quiénes son entre sí con TLS mutuo (mTLS): seguridad de la capa de transporte (TLS) donde ambos extremos muestran un certificado. Los certificados provienen de una autoridad de certificación (CA) local que el chart crea a través de cert-manager v1.21.3, y no es necesario instalar nada más.
La cadena es corta. Un emisor autofirmado, nexus-selfsigned, firma el certificado de la CA nexus-local-ca, una clave ECDSA (algoritmo de firma digital de curva elíptica) P-256 válida durante diez años. cert-manager la renueva 30 días antes de que venza. Un segundo emisor del mismo nombre firma todo lo demás a partir de ella.
Cada servicio que llama a un servicio que requiere TLS mutuo obtiene su propio certificado de cliente, en un Secret que lleva el nombre de su cuenta de servicio (<service-account>-client-tls). El certificado lleva la identidad SPIFFE del servicio como su nombre de URI:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
El servicio al que llama comprueba ese certificado frente a la CA local y lee en él quién realiza la llamada. Cada carga de trabajo confía en la CA a través de ca.crt en el Secret de su propio certificado. Ningún pod monta la clave privada de la CA, y ningún ConfigMap contiene la CA. nexus-probitas sirve TLS por sí mismo desde nexus-probitas-tls, un certificado de 90 días que se renueva 15 días antes de que venza.
El borde público está separado, y tls.mode lo decide:
existing: un Secret TLS que usted creó, nombrado entls.existingSecret.cert-manager: certificados de un ClusterIssuer que usted ejecuta, nombrado entls.clusterIssuer.none: TLS termina antes del ingress, en su propio balanceador de carga. El navegador aún debe llegar a la consola a través de HTTPS (consulte el capítulo 2.17, Resolución de problemas).
La propia sesión de inicio de sesión depende de HTTPS. La consola acepta un inicio de sesión solo desde su propio origen, https://<hosts.console>, mantiene la sesión en una cookie __Host- marcada como Secure, y la clave de acceso del primer administrador necesita una página con un certificado válido. Un navegador en HTTP plano, o detrás de una advertencia de certificado, no puede iniciar sesión en absoluto.
La capa de datos dentro del clúster se comunica con los servicios sin TLS de forma predeterminada (dataTier.postgres.sslmode: disable), porque ese tráfico permanece dentro del espacio de nombres bajo las políticas anteriores. Un Postgres externo utiliza verify-full o verify-ca, con la CA del servidor en el Secret del almacén, como se describe en el capítulo 2.11, Variaciones: almacenes externos, TLS e ingress.
La telemetría está desactivada
Ninguna telemetría sale de una instalación. telemetry.enabled solo puede ser false: el esquema del chart rechaza cualquier otro valor. Los informes propios de la capa de datos también están desactivados, por lo que Neo4j no envía informes de uso y Qdrant no envía telemetría.
Controles de registro
nexus-auth tiene dos controles para filtrar a las personas que se registran, y ambos están desactivados en cada instalación.
El control CAPTCHA comprueba cada registro con un servicio alojado en internet. Una instalación nunca depende de internet en el momento del registro, por lo que el chart lo desactiva. El filtro de red necesita dos bases de datos GeoLite2 para evaluar de dónde proviene un registro. Son descargas con licencia que no están ni en la imagen de nexus-auth ni montadas por el chart, y no hay ningún valor para activar el filtro. A lo que se renuncia es al filtrado de registros procedentes de redes de centros de datos y de alojamiento.
Lo que obtiene en su lugar es la aprobación. El registro de un desconocido se retiene para que un administrador lo apruebe, y hasta entonces a la persona se le responde 403 SIGNUP_REQUIRES_APPROVAL. Ninguno de los dos interruptores cambia eso.
Límites de tasa y tiempos de vida de los 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 es el máximo de solicitudes que una persona que ha iniciado sesión puede hacer a nexus-auth en un minuto antes de que responda 429. Cada persona obtiene el mismo límite, y la propia entidad de servicio de la plataforma no se contabiliza en él. El valor predeterminado de 5000 es de unas 83 por segundo desde una cuenta, lo cual es suficiente para personas y scripts. Redúzcalo para restringirlo o auméntelo para una automatización intensiva. Es un número entero de 1 o más. La protección contra fuerza bruta en el inicio de sesión (bloqueo de cuenta y límites en los intentos del segundo factor) está separada y no se configura aquí.
Un solicitante que supera un límite recibe RATE_LIMITED con un encabezado Retry-After, y el cuerpo indica el límite y cuánto tiempo debe esperar. En Enterprise, los administradores establecen límites más precisos en Configuración, Límites de tasa: solicitudes por minuto y trabajos simultáneos, para cada clave de script o aplicación y para cada unidad. A un solicitante que supera su límite se le pide que espere y nunca se le corta la conexión. Un límite retirado vuelve al de la unidad y luego al predeterminado.
auth.accessTokenTTL y auth.refreshTokenTTL establecen cuánto tiempo duran un token de acceso y un token de actualización. Mantenga el token de acceso en una hora o menos. Los complementos creados con el Plugin SDK, el kit de desarrollo de software para extensiones de Nexus, rechazan un token de sesión que dure más de una hora, con JWT_LIFETIME_EXCEEDED.
proxy.trustedCIDRs nombra los saltos de proxy en cuyo encabezado X-Forwarded-For confía nexus-auth. El valor predeterminado, 10.42.0.0/16, es la red de pods de k3s donde se ejecuta su Traefik. En otra distribución, establézcalo en la red de pods de su controlador de ingress. Si es incorrecto, nexus-auth ve cada solicitud como proveniente del controlador de ingress, por lo que las reglas de direcciones a continuación verían solo esa dirección. Un X-Forwarded-For diferente desde un salto no confiable nunca abre una nueva ventana de límite de tasa.
Inicio de sesión de la empresa
Las personas inician sesión con una clave de acceso o a través de Google o GitHub, y el inicio de sesión de empresa es la cuarta vía. Un administrador nunca inicia sesión solo con una contraseña: la segunda comprobación es una clave de acceso.
Community incluye un inicio de sesión de empresa a través de OpenID Connect (OIDC), con su propia pantalla de configuración y un resultado de prueba. Enterprise añade el lenguaje de marcado de aserción de seguridad (SAML), la aplicación obligatoria para todos y la sincronización de directorios a través del sistema para la gestión de identidades entre dominios (SCIM).
El inicio de sesión de empresa solo se puede exigir una vez que un administrador haya hecho cuatro cosas, en orden: conectar el servicio de inicio de sesión, demostrar la titularidad del dominio, iniciar sesión a través de él con su propia cuenta y nombrar una cuenta de emergencia. Hasta entonces, el botón Exigirlo permanece cerrado y la página indica qué pasos faltan con el código COMPANY_SIGNIN_STEPS_MISSING. Cambiar el servicio de inicio de sesión borra la prueba, por lo que un nuevo servicio debe probarse de nuevo.
Cuando el servicio de inicio de sesión de empresa deja de responder, la página de inicio de sesión muestra IDP_UNREACHABLE (503). Las personas que ya han iniciado sesión permanecen con la sesión iniciada. Los administradores pueden utilizar el inicio de sesión de administrador de emergencia, que necesita el código sellado guardado en la caja fuerte y la clave de acceso del administrador. Cada uso se escribe en el registro de auditoría indicando quién lo usó y desde dónde, se anuncia de inmediato a todos los administradores y finaliza después de 4 horas o cuando vuelve el inicio de sesión de empresa.
Todos en una organización inician sesión en la misma consola y realizan allí su trabajo diario; los propietarios y administradores también ven las páginas de administración. Un miembro que abre una de esas páginas obtiene la página No es administrador, con sus filas atenuadas y los nombres de las personas que pueden cambiarlas (NOT_AN_ADMINISTRATOR).
Inicios de sesión sospechosos y reglas de direcciones
En Enterprise, Inicios de sesión sospechosos enumera los inicios de sesión con contraseña que parecían nuevos o inusuales: un lugar o dispositivo nuevo, o contraseñas incorrectas antes ese mismo día. Para cada uno indica qué hizo Nexus, ya fuera pedir una segunda comprobación o bloquear el inicio de sesión. Alguien responde a cada fila con No fue esa persona, lo que finaliza los inicios de sesión de esa persona, o Fue esa persona.
Direcciones permitidas y bloqueadas contiene dos listas. Los rangos permitidos son los únicos lugares desde los que los propietarios y administradores pueden iniciar sesión; si no hay ninguno, inician sesión desde cualquier lugar. Los miembros no se ven afectados. Las direcciones bloqueadas son lugares desde los que nadie inicia sesión. Cada entrada registra quién la añadió y cuándo se levanta. Cada cambio se prueba primero frente a su propia dirección actual, y un cambio que lo dejaría fuera se rechaza sin guardar nada. Restringir un rango finaliza, de inmediato, los inicios de sesión de los administradores a los que ya no permite entrar.
Claves y certificados
Los datos de cada organización se bloquean con su propia clave, en poder de un custodio que usted elija: un módulo de seguridad de hardware o software. La página Claves muestra las versiones de la clave de la organización y cuándo vence la próxima rotación. Una versión sigue siendo legible después de dejar de ser la actual, hasta que ya no quede nada envuelto bajo ella. Las claves en sí nunca se muestran, solo sus huellas digitales.
Destruir una clave es la forma en que Nexus borra. En Claves y borrado, Borrar destruye la clave de una persona o de toda una organización, lo que hace que todo lo que bloqueó sea ilegible en todas partes, incluidas las copias de seguridad. No se puede deshacer, por lo que pide un motivo por escrito y una segunda persona. Deja un recibo que registra qué se borró y quién lo hizo, nunca el contenido.
Claves a punto de caducar enumera los tokens de proveedores y certificados que vencen pronto, a quién se advierte y cuándo, y qué se detiene si uno caduca. El trabajo en ejecución no se detiene y el enrutador de IA recurre a otra clave.
Aprobaciones de cuatro ojos
En Enterprise, las políticas pueden retener cambios sensibles a la espera de una segunda persona. Aprobaciones de cuatro ojos enumera cada solicitud en espera indicando quién la pidió, por qué, cuántas aprobaciones necesita y cuándo caduca. Nadie aprueba su propia solicitud (TRUST_APPROVAL_SELF_APPROVAL), y una solicitud ya decidida responde APPROVAL_ALREADY_DECIDED. Rechazar una solicitud requiere un motivo. Una solicitud que nadie decide a tiempo caduca y nada cambia. Qué cambios esperan aquí lo establecen las políticas que piden una segunda persona: restaurar una copia de seguridad y añadir plazas son dos ejemplos en otras partes de esta guía.
Ver lo que ve otra persona
El soporte dentro de una organización a veces implica ver una página como la ve un colega. En Enterprise, Verlo como ellos lo ven ofrece a un administrador una vista de solo lectura de la consola tal como la ve un miembro, durante 30 minutos, después de una segunda comprobación y un motivo por escrito. Se informa al miembro. Sus elementos privados (correo, cuadernos, mensajes directos y lo que el asistente recuerda para él) nunca se muestran, aparece un aviso en la parte superior durante todo el tiempo y todo queda registrado en el registro de auditoría.
Los grandes cambios tienen su propia pausa. Antes de que se guarde un cambio con efectos amplios, la ventana superpuesta Antes de que ocurra este cambio enumera qué deja de funcionar, qué necesita atención y qué no se ve afectado. El cambio no se bloquea. Se hace lo suficientemente costoso como para pensarlo, y en Enterprise uno sensible también espera a una segunda persona.
Retención y transmisión de registros de auditoría
El registro de auditoría registra quién hizo qué, lo más reciente primero, y se puede filtrar y exportar. Community conserva 30 días y exporta un archivo de hoja de cálculo. Enterprise lo conserva durante el tiempo que indique su política de retención, en la página Conservar y dejar ir dentro de Configuración, y lo transmite a su sistema de monitoreo de seguridad. Los rechazos también se registran, por lo que una persona a la que se le dijo que no deja una fila al igual que una persona que tuvo éxito. Los registros de gobernanza detrás de él están encadenados por organización, de modo que cada organización puede comprobar su propia parte sin ver la de nadie más.
Roles de base de datos
Nexus nunca ejecuta sus servicios como superusuario de base de datos. El hook de arranque, que es la única parte que posee el superusuario del clúster aparte del paso único de aprovisionamiento del backend para frontend (BFF) de la consola, crea estos roles:
| Rol | Qué es |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Es propietario de la base de datos nexus y de cada objeto que crean las migraciones, y crea los roles que nombran las migraciones. |
nexus_runtime |
Un grupo que no puede iniciar sesión. Concede conexión y uso del esquema, y ningún derecho sobre tablas. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
El inicio de sesión propio de cada servicio: NOSUPERUSER NOBYPASSRLS, miembro de nexus_runtime, al que sus propias migraciones conceden sus propias tablas y nada más. |
nexus_ledger_reader |
Lee una tabla, el libro mayor de versiones, para los contenedores de inicialización wait-for-schema. Ninguna otra concesión. |
Debido a que ningún rol de servicio es propietario de sus tablas y ninguno puede eludir la seguridad a nivel de fila (RLS), cada política de RLS se aplica a cada conexión de servicio. La seguridad a nivel de fila se fuerza en las tablas de nexus-auth, por lo que incluso su propietario está sujeto a ella. Si ya existe un rol llamado nexus en su servidor con SUPERUSER o BYPASSRLS, el arranque se niega a continuar: "role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done." Elimine ese atributo o utilice otro servidor.




