Documentation

Sécurité via MCP et Chat

Lisez les constatations et agissez en conséquence depuis le Chat ou votre propre assistant, selon les règles du portail, et découvrez pourquoi certaines actions nécessitent toujours l'intervention d'une personne.

Vous pouvez consulter les constatations de Sécurité et y réagir depuis l'assistant Chat, ou depuis votre propre assistant via CoRoid en tant que serveur MCP: Claude Code, Codex, Cursor ou un autre client MCP. Ces outils suivent les mêmes règles que le portail, afin de fournir les mêmes réponses et de refuser les mêmes demandes.

Lecture

Sécurité possède ses propres périmètres, donc une connexion établie pour d'autres tâches ne percevra pas les constatations. Ces outils requièrent le rôle de Réviseur et mcp.security.read. Aucun ne nécessite d'approbation. Ils respectent les règles propres à la Sécurité de CoRoid : vous voyez les projets auxquels vous avez accès dans le portail. Une connexion limitée à certains projets doit spécifier l'un d'entre eux, ou une constatation le concernant.

OutilCe qu'il renvoie comme réponse
get_security_overviewPar projet : les constatations ouvertes classées par gravité, celles dont la date de correction est dépassée, celles non confirmées par quiconque, le code de test, et le nombre d'actions en attente de votre intervention
list_security_findingsConstatations par projet, type, gravité et état, classées en priorité d'exploitation puis par gravité ; needsYou n'affiche que celles qui attendent l'intervention d'une personne
list_security_needsLes décisions qui attendent une validation humaine, classées par ordre d'urgence, chacune accompagnée de la réponse de CoRoid et d'un lien pour y accéder : il s'agit du même listing que celui disponible sous l'onglet Sécurité → Décisions.
get_security_findingUne constatation : son emplacement, si elle a été confirmée, sa date d'échéance et les travaux de correction associés. Jamais la valeur d'un secret
get_security_settingsChaque protection appliquée à un projet dépend de ses paramètres : désactivée, en mode observation, en mode application ou incapable de fonctionner, ainsi que les raisons de ce choix selon la configuration du projet.
list_security_runsLes exécutions de Sécurité, classées par ordre chronologique décroissant dans le journal d'exécution : en cours, en attente, terminées, échouées ou remplacées, avec les motifs de tout échec d'exécution.
get_attack_surfaceLes points d'entrée de chaque projet et le nombre d'entre eux en attente d'exposition ; pour un projet donné, chaque point d'entrée avec le contenu du code et les décisions prises, les suggestions de déploiement, ainsi que les résultats de la protection pull request.
get_threat_modelLa version du modèle de menace de chaque projet et le nombre d'éléments en attente de révision ; pour un projet donné, le modèle, la proposition en attente et les dernières versions disponibles.
list_security_packagesLes derniers inventaires de dépendances de chaque projet avec le nombre de paquets installés et ceux qui sont vulnérables ; pour un projet donné, les paquets affichés page par page, classés par vulnérabilité.

Chaque résultat renvoie vers sa page dans CoRoid.

Agir sur les résultats

Ces outils agissent sur les résultats. Ils nécessitent mcp.security.write et un propriétaire ou administrateur, comme indiqué dans le portail.

OutilFonctionnalitésApprobation
start_security_fix« Fix » dans le portail : corriger une dépendance vulnérable, traiter une tâche incluant un test de régression pour un problème de code détecté, ou appliquer la liste de contrôle de rotation pour un identifiant compromis. Une deuxième action « Fix » répond à une tâche déjà enregistrée.Non
run_security_scanAnalyser un projet immédiatement : l'ensemble des éléments actifs, les dépendances, l'historique des secrets, la surface d'attaque, l'audit (son état) ou les preuves conservées.Non
confirm_real_secretConfirmer qu'un identifiant compromis est bien réel. Il reste actif jusqu'à ce que quelqu'un atteste qu'il a été roté.Non
revoke_security_exceptionClore une exception : le problème détecté redevient ouvert.Non
dismiss_security_findingClasser un problème détecté comme « Pas un problème », en indiquant la raison.Toujours
add_security_exceptionAccepter le risque lié à un problème détecté jusqu'à une date donnée, en justifiant cette décision.Toujours
attest_secret_rotatedAttester qu'un identifiant compromis a été roté ou révoqué, ce qui permet de le clore. Le CoRoid ne teste jamais un identifiant qu'il détecte.Toujours

Agir sur la surface d'attaque et le modèle de menace

Ces éléments nécessitent mcp.security.write ainsi qu'un propriétaire ou un administrateur. Lorsqu'un contrôle dans le portail à la fois renforce et affaiblit une règle, deux outils interviennent : celui qui renforce refuse tout changement susceptible d'affaiblir la règle, de sorte que ce changement passe toujours par l'outil qui attend l'intervention humaine.

OutilFonctionnalitéApprobation
raise_entry_point_exposureRendre les points d'entrée plus exposés, les verrouiller pour l'audit ou les réintégrer dans le périmètreNon
lower_entry_point_exposureRendre les points d'entrée moins exposés, retirer un verrouillage ou les exclure du périmètre en indiquant une raisonToujours
refresh_threat_modelRelire à nouveau le code du projet ; ce qu'il révèle est soumis sous forme de propositionNon
add_threat_model_entriesAjouter des entrées au modèle de menaceNon
accept_threat_model_proposalAccepter ce qu'une nouvelle lecture du code a proposéNon
update_threat_model_entriesModifier le titre ou les détails d'une entréeToujours
remove_threat_model_entriesSupprimer des entrées du modèle de menaceToujours
dismiss_threat_model_proposalRejeter ce qu'une nouvelle lecture du code a proposéToujours
keep_security_proofConserver comme test de régression la preuve ayant reproduit une anomalie détectéeNon

Modifier les protections

Les paramètres d'une protection, pour un projet ou selon la configuration par défaut de l'organisation, se trouvent dans les deux mêmes outils : tighten_security_protection renforce une protection et rejette toute modification qui l'affaiblit, et relax_security_protection l'affaiblit, or fait en sorte qu'un projet suive à nouveau la configuration par défaut de l'organisation ; dans tous les cas, toute modification attend l'intervention d'une personne. Une modification affaiblit une protection lorsque la détection ou l'application des règles est désactivée, que le seuil de gravité est augmenté, que moins de demandes de correction peuvent être ouvertes, que l'audit est désactivé ou exécuté moins fréquemment, que la analyse des secrets porte sur moins de données, que le réseau du bac à sable est élargi ou autorise plus d'hôtes, ou lorsqu'un point d'entrée « non défini » n'est plus considéré comme accessible depuis Internet. L'option « Votre propre commande d'analyse » est configurée dans le module Contrôle qualité.

Contacts et divulgation

Les contacts de sécurité d'un projet détiennent l'autorité de divulgation, aux côtés des propriétaires et des administrateurs : ils consultent les corrections privées que CoRoid conserve pour les vulnérabilités non divulguées, les publient ou les suppriment, rédigent les avis de sécurité GitHub et enregistrent les rapports destinés aux mainteneurs des dépendances. Via MCP et Chat, ces actions sont réservées aux propriétaires et aux administrateurs, et chaque action attend l'intervention d'une personne : un contact peut divulguer une vulnérabilité, et une fois divulguée, celle-ci ne peut plus être retirée.

OutilFonctionnalitésApprobation
list_security_contactsLes contacts de sécurité d'un projet et les critères pour en être unNon
get_security_disclosureLes corrections privées d'une vulnérabilité (taille et état, jamais leur contenu), son avis GitHub et les rapports envoyés aux mainteneurs, pour l'autorité de divulgationNon
add_security_contactAttribuer à un membre du projet le rôle de contact de sécuritéToujours
remove_security_contactSupprimer un contact de sécuritéToujours
publish_private_fixPublier une correction en attente : la vulnérabilité est alors divulguée et une tâche ouvre son pull requestToujours
discard_private_fixSupprimer une correction en attenteToujours
draft_github_security_advisoryRédiger un avis de sécurité GitHub dans le dépôt, visible par ses mainteneursToujours
record_maintainer_reportEnregistrer l'endroit où vous avez signalé la vulnérabilité aux mainteneurs de la dépendance. CoRoid n'envoie rien.Toujours

Pourquoi certaines actions attendent l'intervention d'une personne

Un problème mineur, un risque accepté ou des identifiants rotatifs retirent une vulnérabilité de la liste des éléments ouverts sans nécessiter de correction ; un point d'entrée moins exposé ou un modèle de menace plus restreint réduisent ce que l'audit prend en compte. Un assistant ne doit pas pouvoir effectuer ces actions seul, c'est pourquoi ces outils attendent toujours l'intervention d'une personne, quel que soit le paramétrage de la connexion :

  • Depuis un client MCP, l'appel attend l'intervention d'un propriétaire ou d'un administrateur Paramètres → Connexions → Serveur MCP CoRoid → Approbations, et ils reçoivent une notification. La demande expire après 10 minutes.
  • Dans Chat, l'assistant vous demande de confirmer dans le chat avant d'agir.

L'approbation indique en termes simples ce qui va se produire, en se basant sur l'enregistrement de la vulnérabilité par CoRoid : « Marquer la faille de contrôle d'accès dans src/routes/admin.ts:76 (Shop) Pas de problème », suivi de la raison entre guillemets. Les mots entourant cette raison proviennent de CoRoid, jamais de l'assistant, et la valeur d'un identifiant n'apparaît jamais : CoRoid ne la conserve pas.