ConnexionPlanifier un briefing

Chapitre 2.16

Sécurité et réseau

Ce qu'une installation autorise en entrée et en sortie, comment ses services se prouvent mutuellement leur identité, et les contrôles qu'un opérateur définit ou hérite pour la connexion et la base de données.

Cette page a été traduite par l'IA à partir de l'original en anglais. En cas de doute, la page en anglais fait foi. Lire cette page en anglais

17 minutes de lecture

L'examen de sécurité de Harrow Port Authority a d'abord posé une question à Tomás Reilly : qu'est-ce qui quitte le cluster ? Sa réponse tenait sur une page. Rien dans l'espace de noms nexus n'atteint quoi que ce soit à l'extérieur, à l'exception des recherches dans le système de noms de domaine (DNS), de l'interface de programmation d'applications (API) Kubernetes pour quelques charges de travail, et des plages d'adresses que Harrow répertorie dans son fichier de valeurs. Il n'y a aucune télémétrie ni aucun appel vers l'extérieur. L'examen est ensuite passé à la connexion et à la base de données, ce qui correspond à peu près à l'ordre suivi dans ce chapitre.

Politiques réseau

Les politiques réseau sont activées par défaut (networkPolicy.enabled: true), et le chart part d'une politique de refus total pour ne réautoriser que ce dont Nexus a besoin :

Politique Ce qu'il permet
nexus-default-deny Rien. Elle sélectionne chaque pod de l'espace de noms, dans les deux sens.
nexus-in-namespace Les pods Nexus communiquant entre eux, et les recherches DNS vers kube-dns dans kube-system sur le port 53.
nexus-token-review Les vérificateurs de jetons (nexus-probitas et nexus-orchestrator) et le Job de garde des clés atteignant le serveur d'API Kubernetes sur le port 6443 ou 443. Aucun autre pod n'a le jeton d'API monté.
nexus-ingress-controller L'espace de noms du contrôleur d'ingress atteignant les trois services publics et rien d'autre.
nexus-operator-egress Les pods atteignant les plages d'adresses dans networkPolicy.externalEgressCIDRs. Généré uniquement lorsque cette liste n'est pas vide.

Les deux serveurs OpenBao sont protégés par leur propre politique. Ils sont étiquetés comme faisant partie du magasin de clés et non de Nexus, de sorte que la règle interne à l'espace de noms ne les atteint pas. Seuls nexus-keys et ses jobs (dont le Job de garde) peuvent communiquer avec eux, et seul le magasin de clés peut communiquer avec le service de déverrouillage (unsealer).

Trois valeurs façonnent les politiques :

# 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 est l'espace de noms du contrôleur d'ingress situé devant les trois hôtes publics. La valeur par défaut, kube-system, convient à k3s, qui y déploie Traefik. Harrow exécute son propre contrôleur dans ingress-nginx.

apiServerCIDRs correspond aux adresses du serveur d'API Kubernetes sous forme de plages /32 Classless Inter-Domain Routing (CIDR). Si ce champ est laissé vide, le chart les lit depuis les Endpoints kubernetes lors de l'installation. helm template n'ayant pas de cluster à lire, il faut les lui fournir, sinon il s'arrête avec le message « networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read ».

externalEgressCIDRs répertorie tout ce qui se trouve en dehors de l'espace de noms et que Nexus doit appeler. Vide signifie rien. Harrow répertorie son relais de messagerie et le sous-réseau de ses serveurs de modèles. Si vous connectez un fournisseur de modèles hébergé, un service de connexion d'entreprise externe au cluster ou une source de données, ses plages ont également leur place ici. En oublier une est la raison habituelle pour laquelle une clé qui fonctionne sur un ordinateur portable échoue sur l'installation : l'appel ne quitte jamais le cluster.

Un grand cadre aux coins arrondis intitulé « namespace nexus (default deny) ». À l'intérieur, un groupe de petits cadres « console », « nexus-auth », « gateway », « other Nexus services » reliés par des flèches bidirectionnelles intitulées « in-namespace ». Dans un coin à l'intérieur, un cadre délimité séparément « key store: openbao, openbao-unsealer » avec des flèches provenant uniquement de « nexus-keys » et « custody Job ». À l'extérieur du grand cadre : à gauche, « ingress controller namespace » avec des flèches entrant uniquement dans les trois services publics ; en haut, « kube-dns (port 53) » ; en haut à droite, « Kubernetes API server (apiServerCIDRs) » atteint uniquement depuis les vérificateurs de jetons ; à droite, « externalEgressCIDRs: mail relay, model servers » atteint depuis les pods Nexus. Toutes les autres flèches sortantes sont barrées et portent la mention « refused ».
Ce que les politiques réseau autorisent à entrer et à sortir de l'espace de noms nexus.

Dans le produit, la page Où les appels peuvent sortir répertorie chaque emplacement externe que Nexus peut atteindre, la raison de sa présence et la personne qui l'a ajouté. Tout le reste est refusé avec un code qui nomme la règle. Sur la page, le refus s'affiche sous la forme EGRESS_DENIED. La résidence des données fonctionne de la même manière un niveau plus haut : dans l'édition Enterprise, la page Où résident les données définit la région pour chaque type de données, et une organisation peut verrouiller son trafic d'intelligence artificielle (IA) sur des fournisseurs de l'UE afin que le routeur refuse tout le reste (voir le chapitre 2.14, Fournisseurs et modèles d'IA). Une application qui tente d'atteindre une adresse que son manifeste n'a jamais déclarée est bloquée à la périphérie avec EGRESS_NOT_DECLARED.

Où les appels peuvent sortir
Où les appels peuvent sortir
Où les appels peuvent sortir. Chaque destination autorisée indique qui l'a ajoutée et pourquoi ; tout le reste est refusé, et les refus du jour sont répertoriés avec la règle qui les a bloqués.

Identité des services via l'autorité de certification locale

Nexus fonctionne sans maillage de services (service mesh). Le chart possède une valeur istio.enabled, définie par défaut sur false, et il n'y a aucune raison de l'activer. Les services se prouvent mutuellement leur identité par TLS mutuel (mTLS) : le protocole Transport Layer Security (TLS) où les deux extrémités présentent un certificat. Les certificats proviennent d'une autorité de certification (CA) locale que le chart crée via cert-manager v1.21.3, et rien d'autre n'a besoin d'être installé.

La chaîne est courte. Un émetteur auto-signé, nexus-selfsigned, signe le certificat de CA nexus-local-ca, une clé ECDSA (Elliptic Curve Digital Signature Algorithm) P-256 valide pendant dix ans. cert-manager le renouvelle 30 jours avant son expiration. Un second émetteur du même nom signe tout le reste à partir de celui-ci.

Chaque service qui appelle un service exigeant le TLS mutuel obtient son propre certificat client, dans un Secret nommé d'après son compte de service (<service-account>-client-tls). Le certificat porte l'identité SPIFFE du service comme nom d'URI :

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

Le service appelé vérifie ce certificat auprès de la CA locale et y lit l'identité de l'appelant. Chaque charge de travail fait confiance à la CA via le ca.crt présent dans le Secret de son propre certificat. Aucun pod ne monte la clé privée de la CA, et aucun ConfigMap ne contient la CA. nexus-probitas sert lui-même le TLS à partir de nexus-probitas-tls, un certificat de 90 jours renouvelé 15 jours avant son expiration.

La périphérie publique est distincte, et tls.mode en décide :

  • existing : un Secret TLS que vous avez créé, nommé dans tls.existingSecret.
  • cert-manager : des certificats provenant d'un ClusterIssuer que vous gérez, nommé dans tls.clusterIssuer.
  • none : le TLS se termine avant l'ingress, sur votre propre équilibreur de charge. Le navigateur doit tout de même atteindre la console via HTTPS (voir le chapitre 2.17, Dépannage).

La session de connexion elle-même dépend de HTTPS. La console n'accepte une connexion que depuis sa propre origine, https://<hosts.console>, conserve la session dans un cookie __Host- marqué Secure, et la clé d'accès (passkey) du premier administrateur nécessite une page avec un certificat valide. Un navigateur en simple HTTP, ou derrière un avertissement de certificat, ne peut pas du tout se connecter.

La couche de données interne au cluster communique avec les services sans TLS par défaut (dataTier.postgres.sslmode: disable), car ce trafic reste à l'intérieur de l'espace de noms conformément aux politiques ci-dessus. Un Postgres externe utilise verify-full ou verify-ca, avec la CA du serveur dans le Secret du magasin de données, comme le décrit le chapitre 2.11, Variations : magasins de données externes, TLS et ingress.

La télémétrie est désactivée

Aucune télémétrie ne quitte une installation. telemetry.enabled ne peut être que false : le schéma du chart refuse toute autre valeur. Les rapports propres à la couche de données sont également désactivés, de sorte que Neo4j n'envoie aucun rapport d'utilisation et Qdrant n'envoie aucune télémétrie.

Contrôles d'inscription

nexus-auth dispose de deux contrôles pour filtrer les personnes qui s'inscrivent, et tous deux sont désactivés sur chaque installation.

Le contrôle CAPTCHA vérifie chaque inscription auprès d'un service hébergé sur Internet. Une installation ne dépend jamais d'Internet lors de l'inscription, c'est pourquoi le chart le désactive. Le filtrage réseau nécessite deux bases de données GeoLite2 pour évaluer la provenance d'une inscription. Il s'agit de téléchargements sous licence qui ne sont ni dans l'image nexus-auth ni montés par le chart, et il n'existe aucune valeur pour activer ce filtrage. Ce à quoi vous renoncez, c'est au filtrage des inscriptions provenant de centres de données et de réseaux d'hébergement.

Ce que vous obtenez à la place, c'est l'approbation. L'inscription d'un inconnu est mise en attente pour qu'un administrateur l'approuve, et jusque-là, la personne reçoit la réponse 403 SIGNUP_REQUIRES_APPROVAL. Aucun des deux paramètres ne change cela.

Limites de débit et durée de vie des jetons

# harrow-values.yaml (Helm values): sign-in service
auth:
  rateLimitPerMinute: 5000
  accessTokenTTL: 15m
  refreshTokenTTL: 12h
proxy:
  trustedCIDRs: "10.244.0.0/16"

auth.rateLimitPerMinute est le nombre maximal de requêtes qu'une personne connectée peut adresser à nexus-auth en une minute avant qu'il ne réponde 429. Chaque personne bénéficie de la même limite, et le principal de service propre à la plateforme n'est pas comptabilisé dans cette limite. La valeur par défaut de 5000 correspond à environ 83 par seconde à partir d'un seul compte, ce qui est largement suffisant pour les utilisateurs et les scripts. Abaissez-la pour durcir les règles, ou augmentez-la pour une automatisation intensive. Il s'agit d'un nombre entier supérieur ou égal à 1. La protection contre la force brute lors de la connexion (verrouillage de compte et limites sur les tentatives de second facteur) est distincte et ne se définit pas ici.

Un appelant qui dépasse une limite reçoit RATE_LIMITED avec un en-tête Retry-After, et le corps du message indique la limite ainsi que le temps d'attente. Dans l'édition Enterprise, les administrateurs définissent des limites plus fines dans Paramètres, Limites de débit : requêtes par minute et tâches simultanées, pour chaque clé de script ou application et pour chaque unité. Un appelant qui dépasse sa limite est invité à patienter et n'est jamais coupé. Une limite retirée revient à celle de l'unité, puis à la valeur par défaut.

Limites de débit
Limites de débit
Limites de débit par clé et par unité. Un script réessaie trop vite et est ralenti ; la page affiche la réponse 429 que voit le script et permet à un administrateur d'augmenter sa limite en indiquant un motif.

auth.accessTokenTTL et auth.refreshTokenTTL définissent la durée de vie d'un jeton d'accès et d'un jeton d'actualisation. Maintenez le jeton d'accès à une heure ou moins. Les plugins construits avec le Plugin SDK, le kit de développement logiciel pour les extensions Nexus, refusent un jeton de session dont la durée de vie dépasse une heure, avec JWT_LIFETIME_EXCEEDED.

proxy.trustedCIDRs nomme les sauts de proxy dont nexus-auth considère l'en-tête X-Forwarded-For comme fiable. La valeur par défaut, 10.42.0.0/16, correspond au réseau de pods k3s où s'exécute son Traefik. Sur une autre distribution, définissez-la sur le réseau de pods de votre contrôleur d'ingress. Si elle est incorrecte, nexus-auth voit chaque requête comme provenant du contrôleur d'ingress, de sorte que les règles d'adresse ci-dessous ne verraient que cette adresse. Un X-Forwarded-For différent provenant d'un saut non fiable n'ouvre jamais une nouvelle fenêtre de limite de débit.

Authentification d'entreprise

Les utilisateurs se connectent avec une clé d'accès (passkey) ou via Google ou GitHub, et la connexion d'entreprise constitue le quatrième moyen. Un administrateur ne se connecte jamais avec un mot de passe seul : la seconde vérification est une clé d'accès.

L'édition Community inclut une connexion d'entreprise via OpenID Connect (OIDC), avec son propre écran de configuration et un résultat de test. L'édition Enterprise ajoute le Security Assertion Markup Language (SAML), l'application obligatoire pour tous, et la synchronisation d'annuaire via le System for Cross-domain Identity Management (SCIM).

La connexion d'entreprise ne peut être rendue obligatoire qu'une fois qu'un administrateur a effectué quatre opérations, dans l'ordre : connecter le service de connexion, prouver la propriété du domaine, s'y connecter avec son propre compte, et désigner un compte d'urgence. Jusque-là, le bouton Rendre obligatoire reste verrouillé, et la page indique quelles étapes manquent avec le code COMPANY_SIGNIN_STEPS_MISSING. Le changement du service de connexion efface le test, de sorte qu'un nouveau service doit être testé à nouveau.

Connexion d'entreprise
Authentification d'entreprise
La connexion d'entreprise ne peut être rendue obligatoire qu'après qu'un administrateur l'a testée avec son propre compte et a désigné un compte d'urgence. Chaque étape doit être effectuée avant que la dernière ne s'ouvre.

Lorsque le service de connexion d'entreprise cesse de répondre, la page de connexion affiche IDP_UNREACHABLE (503). Les personnes déjà connectées restent connectées. Les administrateurs peuvent utiliser la connexion administrateur d'urgence, qui nécessite le code scellé conservé dans le coffre-fort ainsi que la clé d'accès de l'administrateur. Chaque utilisation est inscrite dans le journal d'audit avec l'identité de l'utilisateur et sa provenance, annoncée immédiatement à tous les administrateurs, et prend fin au bout de 4 heures ou lorsque la connexion d'entreprise est rétablie.

Tous les membres d'une organisation se connectent à la même console et y effectuent leur travail quotidien ; les propriétaires et les administrateurs voient également les pages d'administration. Un membre qui ouvre l'une de ces pages obtient la page Non administrateur, avec ses lignes grisées et le nom des personnes habilitées à les modifier (NOT_AN_ADMINISTRATOR).

Connexions suspectes et règles d'adresses

Dans l'édition Enterprise, la page Connexions suspectes répertorie les connexions par mot de passe qui semblaient nouvelles ou inhabituelles : un nouvel emplacement ou un nouvel appareil, ou des mots de passe erronés plus tôt dans la journée. Pour chacune, elle indique ce qu'a fait Nexus, qu'il s'agisse de demander une seconde vérification ou de bloquer la connexion. Une personne répond à chaque ligne par Ce n'était pas cette personne, ce qui met fin aux sessions de l'intéressé, ou C'était bien cette personne.

La page Adresses autorisées et bloquées contient deux listes. Les plages autorisées sont les seuls emplacements depuis lesquels les propriétaires et les administrateurs peuvent se connecter ; s'il n'y en a aucune, ils se connectent depuis n'importe où. Les membres ne sont pas concernés. Les adresses bloquées sont des emplacements depuis lesquels personne ne peut se connecter. Chaque entrée enregistre qui l'a ajoutée et quand elle expire. Chaque modification est d'abord testée par rapport à votre propre adresse actuelle, et une modification qui vous exclurait est refusée sans que rien ne soit enregistré. Le durcissement d'une plage met fin, immédiatement, aux sessions des administrateurs qu'elle n'autorise plus.

Adresses autorisées et bloquées
Adresses autorisées et bloquées
Les règles d'adresse. L'encadré supérieur indique l'effet des règles sur la propre adresse de l'administratrice, de sorte qu'une modification qui l'exclurait est refusée avant d'être enregistrée.

Clés et certificats

Les données de chaque organisation sont verrouillées avec sa propre clé, détenue par un dépositaire de votre choix : un module matériel de sécurité (HSM) ou un logiciel. La page Clés affiche les versions de la clé de l'organisation et la date de la prochaine rotation. Une version reste lisible après avoir cessé d'être la version actuelle, jusqu'à ce que plus rien ne soit chiffré sous celle-ci. Les clés elles-mêmes ne sont jamais affichées, seules leurs empreintes le sont.

Détruire une clé est la manière dont Nexus efface les données. Sur la page Clés et effacement, le bouton Effacer détruit la clé d'une personne ou d'une organisation entière, ce qui rend tout ce qu'elle verrouillait illisible partout, sauvegardes comprises. Cette opération étant irréversible, elle exige un motif écrit et l'intervention d'une seconde personne. Elle laisse un reçu qui enregistre ce qui a été effacé et par qui, mais jamais le contenu.

La page Clés arrivant à expiration répertorie les jetons de fournisseurs et les certificats qui expirent bientôt, qui est averti et quand, et ce qui s'arrête si l'un d'eux expire. Les tâches en cours ne s'arrêtent pas, et le routeur d'IA bascule sur une autre clé.

Approbations à quatre yeux

Dans l'édition Enterprise, des politiques peuvent mettre en attente les modifications sensibles pour validation par une seconde personne. La page Approbations à quatre yeux répertorie chaque demande en attente en indiquant qui l'a formulée, pourquoi, combien d'approbations elle nécessite et quand elle expire. Personne n'approuve sa propre demande (TRUST_APPROVAL_SELF_APPROVAL), et une demande ayant déjà fait l'objet d'une décision renvoie APPROVAL_ALREADY_DECIDED. Le refus d'une demande nécessite un motif. Une demande sur laquelle personne ne statue à temps expire, et rien ne change. Les modifications mises en attente ici sont définies par les politiques qui exigent une seconde personne : la restauration d'une sauvegarde et l'ajout de sièges en sont deux exemples présentés ailleurs dans ce guide.

Approbations à quatre yeux
Approbations à quatre yeux
Modifications en attente d'une seconde personne. Chaque demande indique qui l'a formulée et quand elle expire, et le demandeur ne dispose d'aucun bouton Approuver sur sa propre demande.

Voir ce que voit un autre utilisateur

L'assistance au sein d'une organisation implique parfois de voir une page telle qu'un collègue la voit. Dans l'édition Enterprise, la fonction Voir comme cet utilisateur offre à un administrateur une vue en lecture seule de la console telle qu'un membre la voit, pendant 30 minutes, après une seconde vérification et l'indication d'un motif écrit. Le membre en est informé. Ses éléments privés (courriers, carnets de notes, messages directs et ce que l'assistant retient pour lui) ne sont jamais affichés, une bannière reste visible en haut de l'écran pendant toute la durée, et tout est enregistré dans le journal d'audit.

Les changements importants font l'objet d'une pause qui leur est propre. Avant qu'une modification ayant de larges répercussions ne soit enregistrée, la fenêtre superposée Avant que ce changement n'ait lieu répertorie ce qui sera interrompu, ce qui nécessite de l'attention et ce qui n'est pas affecté. La modification n'est pas bloquée. Elle demande suffisamment d'efforts pour inciter à la réflexion, et dans l'édition Enterprise, une modification sensible attend également l'intervention d'une seconde personne.

Conservation et diffusion en continu des journaux d'audit

Le journal d'audit enregistre qui a fait quoi, du plus récent au plus ancien, et peut être filtré et exporté. L'édition Community conserve 30 jours d'historique et exporte un fichier de feuille de calcul. L'édition Enterprise le conserve aussi longtemps que le prévoit votre politique de rétention, sur la page Conservation et suppression sous Paramètres, et le diffuse en continu vers votre système de surveillance de la sécurité. Les refus sont également enregistrés, de sorte qu'une personne à qui l'on a opposé un refus laisse une ligne tout comme une personne dont l'action a abouti. Les enregistrements de gouvernance sous-jacents sont chaînés par organisation, afin que chaque organisation puisse vérifier sa propre tranche sans voir celle des autres.

Rôles de base de données

Nexus n'exécute jamais ses services en tant que superutilisateur de base de données. Le hook d'amorçage (bootstrap), qui est la seule partie détenant le superutilisateur du cluster en dehors de l'étape unique de provisionnement du backend for frontend (BFF) de la console, crée ces rôles :

Rôle En quoi cela consiste
nexus_migrator LOGIN NOSUPERUSER NOBYPASSRLS CREATEROLE. Possède la base de données nexus et chaque objet créé par les migrations, et crée les rôles nommés par les migrations.
nexus_runtime Un groupe qui ne peut pas se connecter. Il accorde les droits de connexion et d'utilisation du schéma, mais aucun droit sur les tables.
nexus_auth, nexus_gateway, nexus_graphrag, nexus_skills L'identifiant de connexion propre à chaque service : NOSUPERUSER NOBYPASSRLS, membre de nexus_runtime, qui se voit accorder ses propres tables par ses propres migrations et rien d'autre.
nexus_ledger_reader Lit une seule table, le registre des versions (release ledger), pour les conteneurs d'initialisation wait-for-schema. Aucune autre autorisation.

Comme aucun rôle de service ne possède ses tables et qu'aucun ne peut contourner la sécurité au niveau des lignes (RLS), chaque politique RLS s'applique à chaque connexion de service. La sécurité au niveau des lignes est forcée sur les tables de nexus-auth, de sorte que même leur propriétaire y est soumis. Si un rôle nommé nexus existe déjà sur votre serveur avec SUPERUSER ou BYPASSRLS, l'amorçage refuse de continuer : « role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done. » Supprimez cet attribut ou utilisez un autre serveur.