🇬🇧 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-commandesgitmutantes nécessitent un opt-in explicite.shell_commandest 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 avecOrkeon:Tools:Shell:Confinement:Mode = None(ADR-014).code_interpreters'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 queOrkeon:CodeSandbox:AllowHostExecutionn'est pas posé. - Outils réseau (
WebScrapeTool,HttpApiTool, recherche web,rag_ingestet 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'aucunIUrlValidatorn'est enregistré (AddOrkeonInfrastructureen enregistre un). Les redirections ne sont pas suivies :AddOrkeonWebToolsdonne aux outils web leur propreHttpClientnommé et au loader de pages RAG son propre client typé, tous deux avecAllowAutoRedirect = 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 etRightsobligatoires 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 listeSend:AllowedRecipientsvide 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.tsqui rĂ©sout le mĂŞme fichier de rĂ©glages (les crews hĂ©bergĂ©s parorkeon-hostpartagent 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 unappsettings.jsondu rĂ©pertoire d'oĂą partent les runs, que l'hĂ´te .NET lit pour chaque run —, accordez le moins de droits possible, prĂ©fĂ©rezemail_draftĂemail_send, et ne donnez jamais Ă un crew non fiable Ă la fois leReade-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, lesRightsobligatoires de chaque compte et son dossierRootrelè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 listeShare:AllowedRecipientsvide n'autorise personne, et les liens publics restent désactivés tant queShare:AllowPublicLinksn'est pas posé.drive_readmarque 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 leReaddrive 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_interpretern'est jamais exposĂ© commeIBaseTool:SecureCodeInterpreterTooln'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 commeIBaseTool, 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-commandesgitnon mutantes) ; les interprĂ©teurs et legitmutant restent fermĂ©s tant que vous ne posez pasOrkeon: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:AllowedCommandsremplace purement et simplement l'allowlist. Pour tenirshell_commandhors de portĂ©e d'un agent, composez votre hĂ´te sansAddOrkeonCodeTools().- Utilisez
DockerSandboxpour tout scénario d'exécution de code avec des entrées non fiables, et laissezOrkeon:CodeSandbox:AllowHostExecutiondé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 updatepartout (EXPKEYSIG). - Une nouvelle sous-clé arrive aux utilisateurs par le paquet
orkeon-archive-keyring, viaapt 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.