🇬🇧 English version

Politique de sécurité

Versions prises en charge

Version Prise en charge
Dernière release stable ✅
Releases plus anciennes ❌

Seule la dernière release stable reçoit des correctifs de sécurité.

Signaler une vulnérabilité

Merci de ne pas ouvrir d'issue publique pour les vulnérabilités de sécurité.

Signalez les vulnérabilités via le GitHub Private Vulnerability Reporting de ce dépôt (onglet « Security » → « Report a vulnerability »).

Ă€ inclure dans le signalement :

  • Une description de la vulnĂ©rabilitĂ© et de son impact.
  • Les Ă©tapes de reproduction (code ou configuration de preuve de concept si possible).
  • Le composant affectĂ© (outil, fournisseur LLM, fournisseur de mĂ©moire, orchestrateur…).

Nous visons un accusé de réception sous 72 heures et un plan de remédiation ou un correctif sous 30 jours pour les problèmes confirmés.

Modèle de menace — Exécution d'outils pilotée par LLM

Orkeon est un framework d'orchestration d'agents IA : la sortie d'un LLM peut déclencher l'exécution d'outils. Cela rend certains composants sensibles en matière de sécurité par conception, et vous devez considérer toute configuration de crew comme faisant partie de votre surface d'attaque :

  • Outils d'exĂ©cution de code/shell (ShellCommandTool, SecureCodeInterpreterTool) : les commandes shell sont restreintes par allowlist par dĂ©faut (ensemble en lecture seule) et les interprĂ©teurs (node, dotnet, npm, find) ainsi que les sous-commandes git mutantes nĂ©cessitent un opt-in explicite. shell_command est confinĂ© par le système d'exploitation par dĂ©faut — bubblewrap sous Linux, Seatbelt sous macOS, un AppContainer dans un Job Object sous Windows : les montages de l'agent, les rĂ©pertoires système en lecture seule, pas de rĂ©seau — et Ă©choue franchement quand le backend ne peut pas tourner ; il n'est non confinĂ© que quand l'hĂ´te tourne dans un conteneur (le conteneur est la frontière) ou avec Orkeon:Tools:Shell:Confinement:Mode = None (ADR-014). code_interpreter s'exĂ©cute dans le sandbox Docker (DockerSandbox) et Ă©choue fermĂ© : quand Docker est indisponible, il refuse de se rabattre sur une exĂ©cution directe sur l'hĂ´te tant que Orkeon:CodeSandbox:AllowHostExecution n'est pas posĂ©.
  • Outils rĂ©seau (WebScrapeTool, HttpApiTool, recherche web, rag_ingest et le repli web RAG opt-in) : la validation d'URL est fail-closed — les adresses privĂ©es, de loopback, link-local, IPv6 non spĂ©cifiĂ©e, multicast, NAT64 et de mĂ©tadonnĂ©es cloud sont refusĂ©es par dĂ©faut (protection SSRF), et l'ingestion d'URL refuse de fetcher tant qu'aucun IUrlValidator n'est enregistrĂ© (AddOrkeonInfrastructure en enregistre un). Les redirections ne sont pas suivies : AddOrkeonWebTools donne aux outils web leur propre HttpClient nommĂ© et au loader de pages RAG son propre client typĂ©, tous deux avec AllowAutoRedirect = false, de sorte qu'une redirection ne peut pas emmener une requĂŞte au-delĂ  du validateur qui a autorisĂ© le premier saut.
  • Outils de système de fichiers : tout accès aux fichiers passe par le Virtual File System (IFileSystemService), validĂ© contre les montages configurĂ©s et les droits d'accès.
  • Outils de base de donnĂ©es : les requĂŞtes passent par IDatabaseSecurityPolicy (allowlist par type d'instruction).
  • Outils e-mail (email_*) : ils agissent sur une vraie boĂ®te aux lettres et lisent du courrier Ă©crit par des inconnus. Un agent ne fait que nommer un compte ; serveurs, identifiants et Rights obligatoires de chaque compte relèvent de la configuration de l'opĂ©rateur, et un secret n'y est jamais que le nom d'une variable d'environnement. L'envoi est fermĂ© par dĂ©faut — une liste Send:AllowedRecipients vide n'autorise personne, et l'enveloppe SMTP est la liste de destinataires contrĂ´lĂ©e, jamais lue dans les en-tĂŞtes. Chaque message lu est marquĂ© non fiable et passĂ© au filtre anti-injection de prompt, qui signale mais peut ĂŞtre contournĂ©. Chaque compte est visible de chaque crew et de chaque script .ork.ts qui rĂ©sout le mĂŞme fichier de rĂ©glages (les crews hĂ©bergĂ©s par orkeon-host partagent celui de l'hĂ´te) : dĂ©clarez les comptes dans le propre fichier de rĂ©glages du crew — pas dans des variables d'environnement ni dans un appsettings.json du rĂ©pertoire d'oĂą partent les runs, que l'hĂ´te .NET lit pour chaque run —, accordez le moins de droits possible, prĂ©fĂ©rez email_draft Ă  email_send, et ne donnez jamais Ă  un crew non fiable Ă  la fois le Read e-mail et un canal sortant (http_api, les outils web). Les jetons OAuth sont dans un fichier sous le rĂ©pertoire des rĂ©glages de l'utilisateur, hors de portĂ©e des outils du VFS mais pas d'un outil shell ou de code qui tourne sous le mĂŞme utilisateur du système. DĂ©tails : Outils e-mail et SĂ©curitĂ©.
  • Outils drive (drive_*) : ils agissent sur un vrai Google Drive ou un vrai OneDrive et lisent des fichiers que n'importe qui a pu partager. Un agent ne fait que nommer un compte ; le client OAuth, les Rights obligatoires de chaque compte et son dossier Root relèvent de la configuration de l'opĂ©rateur, et un Ă©lĂ©ment hors de la racine est signalĂ© comme introuvable. Le partage est fermĂ© par dĂ©faut — une liste Share:AllowedRecipients vide n'autorise personne, et les liens publics restent dĂ©sactivĂ©s tant que Share:AllowPublicLinks n'est pas posĂ©. drive_read marque ce qu'il lit comme non fiable et le passe au filtre anti-injection de prompt. Le jeton porteur n'est envoyĂ© qu'Ă  l'hĂ´te de l'API du fournisseur — jamais Ă  un lien de tĂ©lĂ©chargement, Ă  une session de chargement ni Ă  un lien de pagination ailleurs. Comme pour l'e-mail, dĂ©clarez les comptes dans le propre fichier de rĂ©glages du crew, accordez le moins de droits possible, et ne donnez jamais Ă  un crew non fiable Ă  la fois le Read drive et un canal sortant. DĂ©tails : Outils drive et SĂ©curitĂ©.
  • Injection de prompt : tout contenu rĂ©cupĂ©rĂ© par les outils (pages web, fichiers, lignes de base de donnĂ©es) peut contenir des instructions adverses. ExĂ©cutez les agents avec l'ensemble d'outils au moindre privilège que votre cas d'usage permet.

Les vulnérabilités dans ces couches (contournement d'allowlist, contournement du filtre SSRF, évasion du VFS, évasion du sandbox, fuite de secrets dans les logs, un envoi hors de la liste de destinataires autorisés d'un compte) sont considérées comme de sévérité haute — merci de les signaler en privé.

Recommandations de durcissement

  • code_interpreter n'est jamais exposĂ© comme IBaseTool : SecureCodeInterpreterTool n'est enregistrĂ© que comme type concret, donc aucun agent ne peut l'appeler tant que vous ne l'exposez pas vous-mĂŞme.
  • shell_command, lui, est livrĂ© enregistrĂ©. AddOrkeonCodeTools() l'enregistre comme IBaseTool, et les runners livrĂ©s (orkeon run, orkeon-repl, orkeon-host) appellent cette mĂ©thode sans condition : l'outil est donc au catalogue par dĂ©faut. Son allowlist par dĂ©faut est en lecture seule (ls, cat, pwd, grep… plus les sous-commandes git non mutantes) ; les interprĂ©teurs et le git mutant restent fermĂ©s tant que vous ne posez pas Orkeon:Tools:Shell:AllowInterpreters, qui est Ă©quivalent Ă  une RCE et fait Ă©mettre Ă  l'outil un avertissement de sĂ©curitĂ©. PrĂ©fĂ©rez ajouter la seule commande dont vous avez besoin Ă  Orkeon:Tools:Shell:ExtraAllowedCommands ; Orkeon:Tools:Shell:AllowedCommands remplace purement et simplement l'allowlist. Pour tenir shell_command hors de portĂ©e d'un agent, composez votre hĂ´te sans AddOrkeonCodeTools().
  • Utilisez DockerSandbox pour tout scĂ©nario d'exĂ©cution de code avec des entrĂ©es non fiables, et laissez Orkeon:CodeSandbox:AllowHostExecution dĂ©sactivĂ©.
  • Configurez les clĂ©s d'API via des variables d'environnement ou un gestionnaire de secrets — jamais dans les dĂ©finitions YAML de crew.
  • Activez le chiffrement de la mĂ©moire au repos (EncryptedMemoryProviderDecorator) pour les charges de travail sensibles.

Vérifier ce que vous installez

Chaque artefact — paquets NuGet, installeurs, archives CLI, .deb, MSI — est construit par un workflow GitHub Actions public et porte une attestation de provenance de build signée par GitHub (SLSA v1) qui nomme le workflow, le tag et le commit ayant produit ces octets exacts. La publication sur NuGet.org passe par Trusted Publishing (OIDC) : aucune clé API longue durée n'existe. Chaque release livre aussi SHA256SUMS (et SHA256SUMS.msi pour les MSI) et — pour les releases coupées depuis l'arrivée de l'étape SBOM en septembre 2026 — un SBOM CycloneDX couvert par la même attestation. Deux choses ne portent aucune attestation : les builds dev de main (<version>.dev.<numéro de run>, sur GitHub Packages uniquement) et l'image conteneur ghcr.io/orkeon/orkeon sur GHCR.

gh attestation verify orkeon-cli-<version>-osx-arm64.tar.gz --repo Orkeon/orkeon

Un paquet téléchargé depuis nuget.org est re-signé par nuget.org, ce qui change ses octets : retirez d'abord cette signature (scripts/nupkg-unsign.py), puis vérifiez. Les commandes exactes, ce que chaque mécanisme prouve ou non, et la conduite à tenir quand une vérification échoue sont dans Vérifier ce que vous installez. Un artefact qui échoue à la vérification est un signalement de sécurité, pas une question de support.

Clé de signature du dépôt apt

Le dépôt Debian / Ubuntu (Installer avec apt) est signé avec une clé OpenPGP dédiée, Orkeon Archive Signing Key <arion@orkeon.org>. Le premier téléchargement de cette clé repose sur la confiance au premier usage : son empreinte et le SHA-256 du fichier de trousseau binaire que sert la branche apt (orkeon-archive-keyring.gpg) sont donc publiés ici, sur main :

orkeon-archive-keyring fingerprint: 4765 9C57 4882 5078 5C78  2C37 1CF8 CD8A 4C20 1A2E
orkeon-archive-keyring.gpg sha256: 0cc5e804e1ee49c50ec5b23145ee7ee65d4834a08b8dc38914674249dfcc6a21

La garde de la CI compare ces deux lignes au certificat versionné dans installers/apt/.

Le certificat public est versionné, armuré (ASCII), sous installers/apt/orkeon-archive-keyring.asc ; le trousseau binaire est ce fichier passé par gpg --dearmor. Une garde de la CI échoue quand les valeurs ci-dessus ne lui correspondent pas, ou ne correspondent pas à la page d'installation.

Ce qu'apt vérifie de lui-même, une fois la source déclarée avec Signed-By: : la signature de l'index de chaque canal (InRelease) avec cette clé seule, puis le SHA-256 de chaque paquet contre cet index. Vous vérifiez le SHA-256 du trousseau une fois, en ajoutant la source — le bloc d'installation le fait.

Politique de la clé.

  • Une clĂ© OpenPGP v4 : une clĂ© primaire ed25519 rĂ©servĂ©e Ă  la certification et gardĂ©e hors ligne, et une sous-clĂ© de signature ed25519 valable deux ans — le seul secret que dĂ©tient le workflow de publication. Les signatures de l'index utilisent SHA-256.
  • La sous-clĂ© de signature est prolongĂ©e au moins six mois avant son Ă©chĂ©ance ; la CI Ă©choue quand cette Ă©chĂ©ance est Ă  moins de 180 jours. Une clĂ© expirĂ©e fait Ă©chouer apt update partout (EXPKEYSIG).
  • Une nouvelle sous-clĂ© arrive aux utilisateurs par le paquet orkeon-archive-keyring, via apt upgrade, une release avant que le dĂ©pĂ´t soit signĂ© avec elle : personne n'a rien Ă  faire.
  • Une rĂ©vocation — une clĂ© compromise — est annoncĂ©e ici et sur la page d'installation, avec la nouvelle empreinte et le nouveau SHA-256 du trousseau. C'est le seul cas oĂą les utilisateurs doivent tĂ©lĂ©charger eux-mĂŞmes une nouvelle clĂ©. La publication du dĂ©pĂ´t s'arrĂŞte jusqu'Ă  ce que la nouvelle clĂ© soit en place.