Versão 1.0.0-alpha.1mais recente
Capítulo 2.16
Segurança e rede
O que uma instalação deixa entrar e sair, como os seus serviços provam a sua identidade uns aos outros e os controlos que um operador define ou herda para o início de sessão e para a base de dados.
Esta página foi traduzida por IA a partir do original em inglês. Em caso de dúvida, a página em inglês serve de referência. Ler esta página em inglês

A revisão de segurança da Harrow Port Authority colocou primeiro uma questão a Tomás Reilly: o que sai do cluster? A resposta dele coube numa página. Nada no namespace nexus alcança o que quer que seja fora dele, exceto pesquisas de Domain Name System (DNS), a interface de programação de aplicações (API) do Kubernetes para algumas cargas de trabalho e os intervalos de endereços que a Harrow lista no seu ficheiro de valores. Não há telemetria nem comunicação com a origem. A revisão avançou depois para o início de sessão e para a base de dados, que é aproximadamente a ordem que este capítulo segue.
Políticas de rede
As políticas de rede estão ativas por predefinição (networkPolicy.enabled: true), e o chart parte de uma política de recusa total e readiciona apenas o que o Nexus precisa:
| Política | O que permite |
|---|---|
nexus-default-deny |
Nada. Seleciona todos os pods no namespace, em ambas as direções. |
nexus-in-namespace |
Pods do Nexus a comunicar entre si e pesquisas de DNS para kube-dns em kube-system na porta 53. |
nexus-token-review |
Os revisores de tokens (nexus-probitas e nexus-orchestrator) e o Job de custódia de chaves a alcançar o servidor da API do Kubernetes na porta 6443 ou 443. Nenhum outro pod tem o token da API montado. |
nexus-ingress-controller |
O namespace do controlador de ingress a alcançar os três serviços públicos e mais nada. |
nexus-operator-egress |
Pods a alcançar os intervalos de endereços em networkPolicy.externalEgressCIDRs. Renderizado apenas quando essa lista não está vazia. |
Os dois servidores OpenBao ficam protegidos pela sua própria política. Estão identificados como parte do armazenamento de chaves e não como parte do Nexus, pelo que a regra interna do namespace não os alcança. Apenas o nexus-keys e os seus jobs (entre eles, o Job de custódia) podem comunicar com eles, e apenas o armazenamento de chaves pode comunicar com o unsealer.
Três valores moldam as 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 é o namespace do controlador de ingress à frente dos três anfitriões públicos. O valor predefinido, kube-system, adequa-se ao k3s, que inclui aí o Traefik. A Harrow executa o seu próprio controlador em ingress-nginx.
apiServerCIDRs são os endereços do servidor da API do Kubernetes como intervalos Classless Inter-Domain Routing (CIDR) /32. Se deixado vazio, o chart lê-os a partir dos Endpoints kubernetes quando é instalado. O helm template não tem cluster para ler, pelo que têm de lhe ser fornecidos; caso contrário, para com a mensagem "networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read".
externalEgressCIDRs lista tudo fora do namespace que o Nexus tem de chamar. Vazio significa nada. A Harrow lista o seu retransmissor de correio e a sub-rede dos seus servidores de modelos. Se ligar um fornecedor de modelos alojado, um serviço de início de sessão empresarial fora do cluster ou uma fonte de dados, os respetivos intervalos também pertencem aqui. Esquecer um é a razão habitual pela qual uma chave que funciona num portátil falha na instalação: a chamada nunca sai do cluster.
Dentro do produto, a página Para onde as chamadas podem sair lista cada local externo que o Nexus pode alcançar, porque está lá e quem o adicionou. Tudo o resto é recusado com um código que indica a regra. Na página, a recusa apresenta EGRESS_DENIED. A residência funciona da mesma forma um nível acima: no Enterprise, Onde residem os dados define a região para cada tipo de dados, e uma organização pode restringir o seu tráfego de inteligência artificial (IA) a fornecedores da UE para que o encaminhador recuse tudo o resto (consulte o capítulo 2.14, Fornecedores e modelos de IA). Uma aplicação que tente alcançar um endereço que o seu manifesto nunca declarou é travada na periferia com EGRESS_NOT_DECLARED.
Identidade de serviço a partir da autoridade de certificação local
O Nexus funciona sem uma service mesh. O chart tem um valor istio.enabled, que por predefinição é false, e não há razão para o ativar. Em vez disso, os serviços provam a sua identidade uns aos outros com TLS mútuo (mTLS): Transport Layer Security (TLS) onde ambas as extremidades apresentam um certificado. Os certificados provêm de uma autoridade de certificação (CA) local que o chart cria através do cert-manager v1.21.3, e não é necessário instalar mais nada.
A cadeia é curta. Um emissor autoassinado, nexus-selfsigned, assina o certificado da CA nexus-local-ca, uma chave ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 válida por dez anos. O cert-manager renova-o 30 dias antes de expirar. Um segundo emissor com o mesmo nome assina tudo o resto a partir dele.
Cada serviço que chama um serviço que exige TLS mútuo recebe o seu próprio certificado de cliente, num Secret com o nome da sua conta de serviço (<service-account>-client-tls). O certificado transporta a identidade SPIFFE do serviço como o seu nome de URI:
spiffe://cluster.local/ns/<namespace>/sa/<service-account>
O serviço chamado verifica esse certificado junto da CA local e lê a partir dele quem fez a chamada. Cada carga de trabalho confia na CA através do ca.crt no Secret do seu próprio certificado. Nenhum pod monta a chave privada da CA e nenhum ConfigMap transporta a CA. O nexus-probitas serve o próprio TLS a partir de nexus-probitas-tls, um certificado de 90 dias renovado 15 dias antes de expirar.
A periferia pública é separada, e tls.mode decide-a:
existing: um Secret TLS que criou, indicado emtls.existingSecret.cert-manager: certificados de um ClusterIssuer que executa, indicado emtls.clusterIssuer.none: o TLS termina antes do ingress, no seu próprio balanceador de carga. O navegador ainda tem de alcançar a consola por HTTPS (consulte o capítulo 2.17, Resolução de problemas).
A própria sessão de início de sessão depende de HTTPS. A consola aceita um início de sessão apenas a partir da sua própria origem, https://<hosts.console>, mantém a sessão num cookie __Host- marcado como Secure, e a chave de acesso do primeiro administrador precisa de uma página com um certificado válido. Um navegador em HTTP simples, ou atrás de um aviso de certificado, não consegue iniciar sessão de todo.
A camada de dados dentro do cluster comunica com os serviços sem TLS por predefinição (dataTier.postgres.sslmode: disable), porque esse tráfego permanece dentro do namespace sob as políticas acima. Um Postgres externo utiliza verify-full ou verify-ca, com a CA do servidor no Secret do armazenamento, conforme descreve o capítulo 2.11, Variações: armazenamentos externos, TLS e ingress.
A telemetria está desativada
Nenhuma telemetria sai de uma instalação. telemetry.enabled só pode ser false: o esquema do chart recusa qualquer outro valor. Os relatórios próprios da camada de dados também estão desativados, pelo que o Neo4j não envia relatórios de utilização e o Qdrant não envia telemetria.
Controlos de registo
O nexus-auth tem dois controlos para filtrar as pessoas que se registam, e ambos estão desativados em todas as instalações.
O controlo CAPTCHA verifica cada registo com um serviço alojado na Internet. Uma instalação nunca depende da Internet no momento do registo, pelo que o chart o desativa. O filtro de rede precisa de duas bases de dados GeoLite2 para avaliar de onde provém um registo. São transferências licenciadas que não estão na imagem do nexus-auth nem são montadas pelo chart, e não existe nenhum valor para ativar o filtro. O que perde é a filtragem de registos provenientes de redes de centros de dados e de alojamento.
O que obtém em vez disso é aprovação. O registo de um desconhecido fica retido para aprovação de um administrador e, até lá, a pessoa recebe a resposta 403 SIGNUP_REQUIRES_APPROVAL. Nenhum dos interruptores altera isso.
Limites de taxa e tempos de vida dos 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 é o máximo de pedidos que uma pessoa com sessão iniciada pode fazer ao nexus-auth num minuto antes de este responder 429. Todas as pessoas têm o mesmo limite, e o próprio principal de serviço da plataforma não é contabilizado para esse limite. O valor predefinido de 5000 equivale a cerca de 83 por segundo a partir de uma conta, o que é mais do que suficiente para pessoas e scripts. Diminua-o para restringir ou aumente-o para automatização intensiva. É um número inteiro igual ou superior a 1. A proteção contra força bruta no início de sessão (bloqueio de conta e limites nas tentativas de segundo fator) é separada e não é definida aqui.
Um autor de chamada acima de um limite recebe RATE_LIMITED com um cabeçalho Retry-After, e o corpo transporta o limite e quanto tempo deve aguardar. No Enterprise, os administradores definem limites mais finos em Definições, Limites de taxa: pedidos por minuto e trabalhos em simultâneo, para cada chave de script ou aplicação e para cada unidade. A um autor de chamada acima do seu limite é pedido que aguarde e nunca é desligado. Um limite retirado reverte para o da unidade e, depois, para o predefinido.
auth.accessTokenTTL e auth.refreshTokenTTL definem quanto tempo duram um token de acesso e um token de atualização. Mantenha o token de acesso em uma hora ou menos. Os plugins criados com o Plugin SDK, o kit de desenvolvimento de software para extensões do Nexus, recusam um token de sessão que dure mais de uma hora, com JWT_LIFETIME_EXCEEDED.
proxy.trustedCIDRs indica os saltos de proxy em cujo cabeçalho X-Forwarded-For o nexus-auth confia. O valor predefinido, 10.42.0.0/16, é a rede de pods do k3s onde o seu Traefik é executado. Noutra distribuição, defina-o para a rede de pods do seu controlador de ingress. Se estiver incorreto, o nexus-auth vê todos os pedidos como provenientes do controlador de ingress, pelo que as regras de endereços abaixo veriam apenas esse endereço. Um X-Forwarded-For diferente de um salto não fidedigno nunca abre uma nova janela de limite de taxa.
Início de sessão da empresa
As pessoas iniciam sessão com uma chave de acesso ou através do Google ou GitHub, e o início de sessão empresarial é a quarta forma. Um administrador nunca inicia sessão apenas com uma palavra-passe: a segunda verificação é uma chave de acesso.
A edição Community inclui um início de sessão empresarial através de OpenID Connect (OIDC), com o seu próprio ecrã de configuração e um resultado de teste. A edição Enterprise adiciona Security Assertion Markup Language (SAML), imposição para todos e sincronização de diretórios através do System for Cross-domain Identity Management (SCIM).
O início de sessão empresarial só pode ser exigido depois de um administrador ter feito quatro coisas, por ordem: ligar o serviço de início de sessão, provar o domínio, iniciar sessão através dele com a sua própria conta e indicar uma conta de emergência. Até lá, o botão Exigir permanece fechado, e a página indica que passos faltam com o código COMPANY_SIGNIN_STEPS_MISSING. Alterar o serviço de início de sessão limpa o teste, pelo que um novo serviço tem de ser testado novamente.
Quando o serviço de início de sessão empresarial deixa de responder, a página de início de sessão apresenta IDP_UNREACHABLE (503). As pessoas que já têm sessão iniciada mantêm a sessão iniciada. Os administradores podem utilizar o início de sessão de administrador de emergência, que necessita do código selado guardado no cofre e da chave de acesso do administrador. Cada utilização é registada no registo de auditoria com quem o utilizou e a partir de onde, anunciada de imediato a todos os administradores, e termina após 4 horas ou quando o início de sessão empresarial regressa.
Todas as pessoas numa organização iniciam sessão na mesma consola e fazem aí o seu trabalho diário; os proprietários e administradores também veem as páginas de administração. Um membro que abra uma dessas páginas vê a página Não é um administrador, com as linhas a cinzento e os nomes das pessoas que as podem alterar (NOT_AN_ADMINISTRATOR).
Inícios de sessão suspeitos e regras de endereços
No Enterprise, Inícios de sessão suspeitos lista os inícios de sessão por palavra-passe que pareceram novos ou invulgares: um novo local ou dispositivo, ou palavras-passe incorretas mais cedo nesse dia. Para cada um, indica o que o Nexus fez, quer tenha sido pedir uma segunda verificação ou bloquear o início de sessão. Alguém responde a cada linha com Não foi a pessoa, o que termina os inícios de sessão dessa pessoa, ou Foi a pessoa.
Endereços permitidos e bloqueados contém duas listas. Os intervalos permitidos são os únicos locais a partir dos quais os proprietários e administradores podem iniciar sessão; sem nenhum, iniciam sessão a partir de qualquer lugar. Os membros não são afetados. Os endereços bloqueados são locais a partir dos quais ninguém inicia sessão. Cada entrada regista quem a adicionou e quando expira. Cada alteração é testada primeiro contra o seu próprio endereço atual, e uma alteração que o bloqueasse a si próprio é recusada sem que nada seja guardado. Restringir um intervalo termina, de imediato, os inícios de sessão dos administradores que deixa de permitir.
Chaves e certificados
Os dados de cada organização são trancados com a sua própria chave, detida por um custodiante à sua escolha: um módulo de segurança de hardware ou software. A página Chaves mostra as versões da chave da organização e quando está prevista a próxima rotação. Uma versão permanece legível depois de deixar de ser a atual, até que mais nada esteja encapsulado sob ela. As próprias chaves nunca são mostradas, apenas as suas impressões digitais.
Destruir uma chave é a forma como o Nexus apaga dados. Em Chaves e apagamento, Apagar destrói a chave de uma pessoa ou de toda uma organização, o que torna tudo o que ela trancou ilegível em todo o lado, incluindo nas cópias de segurança. Não pode ser anulado, pelo que pede um motivo por escrito e uma segunda pessoa. Deixa um recibo que regista o que foi apagado e por quem, nunca o conteúdo.
Chaves prestes a expirar lista os tokens de fornecedores e certificados que terminam em breve, quem é avisado e quando, e o que para se um expirar. O trabalho em execução não para, e o encaminhador de IA recorre a outra chave.
Aprovações a quatro olhos
No Enterprise, as políticas podem reter alterações sensíveis a aguardar uma segunda pessoa. Aprovações a quatro olhos lista cada pedido em espera indicando quem pediu, porquê, de quantas aprovações precisa e quando caduca. Ninguém aprova o seu próprio pedido (TRUST_APPROVAL_SELF_APPROVAL), e um pedido já decidido responde APPROVAL_ALREADY_DECIDED. Recusar um pedido exige um motivo. Um pedido que ninguém decida a tempo caduca e nada muda. As alterações que aguardam aqui são definidas pelas políticas que pedem uma segunda pessoa: restaurar uma cópia de segurança e adicionar lugares são dois exemplos noutros pontos deste guia.
Ver o que outra pessoa vê
Dar suporte dentro de uma organização significa, por vezes, ver uma página como um colega a vê. No Enterprise, Ver como eles veem dá a um administrador uma vista só de leitura da consola tal como um membro a vê, durante 30 minutos, após uma segunda verificação e um motivo por escrito. O membro é informado. Os seus itens privados (correio, blocos de notas, mensagens diretas e o que o assistente memoriza para ele) nunca são mostrados, uma faixa permanece no topo durante todo o tempo e tudo é registado no registo de auditoria.
As grandes alterações têm uma pausa própria. Antes de uma alteração com efeitos amplos ser guardada, a sobreposição Antes que esta alteração aconteça lista o que deixa de funcionar, o que requer atenção e o que não é afetado. A alteração não é bloqueada. É tornada suficientemente exigente para obrigar a refletir e, no Enterprise, uma alteração sensível também aguarda por uma segunda pessoa.
Retenção e transmissão contínua de auditoria
O registo de auditoria regista quem fez o quê, do mais recente para o mais antigo, e pode ser filtrado e exportado. A edição Community guarda 30 dias e exporta um ficheiro de folha de cálculo. A edição Enterprise guarda-o durante o tempo que a sua política de retenção indicar, na página Manter e eliminar em Definições, e transmite-o continuamente para o seu sistema de monitorização de segurança. As recusas também são registadas, pelo que uma pessoa a quem foi dito não deixa uma linha, tal como uma pessoa que teve êxito. Os registos de governação subjacentes estão encadeados por organização, para que cada organização possa verificar a sua própria parte sem ver a de mais ninguém.
Funções da base de dados
O Nexus nunca executa os seus serviços como superutilizador da base de dados. O hook de arranque, que é a única parte que detém o superutilizador do cluster além do passo único de aprovisionamento do backend for frontend (BFF) da consola, cria estas funções (roles):
| Função | O que é |
|---|---|
nexus_migrator |
LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. É proprietária da base de dados nexus e de cada objeto que as migrações criam, e cria as funções que as migrações indicam. |
nexus_runtime |
Um grupo que não pode iniciar sessão. Concede ligação e utilização do esquema, e nenhuns direitos sobre tabelas. |
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills |
O início de sessão próprio de cada serviço: NOSUPERUSER NOBYPASSRLS, membro de nexus_runtime, a quem são concedidas as suas próprias tabelas pelas suas próprias migrações e mais nada. |
nexus_ledger_reader |
Lê uma tabela, o livro-razão de lançamentos (release ledger), para os contentores de inicialização wait-for-schema. Nenhuma outra concessão. |
Como nenhuma função de serviço é proprietária das suas tabelas e nenhuma pode contornar a segurança ao nível da linha (RLS), todas as políticas de RLS se aplicam a todas as ligações de serviço. A segurança ao nível da linha é forçada nas tabelas do nexus-auth, pelo que até o seu proprietário está sujeito a ela. Se já existir uma função chamada nexus no seu servidor com SUPERUSER ou BYPASSRLS, o arranque recusa-se 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." Remova esse atributo ou utilize outro servidor.




