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.
| Outil | Ce qu'il renvoie comme réponse |
|---|---|
get_security_overview | Par 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_findings | Constatations 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_needs | Les 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_finding | Une 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_settings | Chaque 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_runs | Les 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_surface | Les 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_model | La 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_packages | Les 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.
| Outil | Fonctionnalités | Approbation |
|---|---|---|
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_scan | Analyser 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_secret | Confirmer 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_exception | Clore une exception : le problème détecté redevient ouvert. | Non |
dismiss_security_finding | Classer un problème détecté comme « Pas un problème », en indiquant la raison. | Toujours |
add_security_exception | Accepter le risque lié à un problème détecté jusqu'à une date donnée, en justifiant cette décision. | Toujours |
attest_secret_rotated | Attester 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.
| Outil | Fonctionnalité | Approbation |
|---|---|---|
raise_entry_point_exposure | Rendre les points d'entrée plus exposés, les verrouiller pour l'audit ou les réintégrer dans le périmètre | Non |
lower_entry_point_exposure | Rendre les points d'entrée moins exposés, retirer un verrouillage ou les exclure du périmètre en indiquant une raison | Toujours |
refresh_threat_model | Relire à nouveau le code du projet ; ce qu'il révèle est soumis sous forme de proposition | Non |
add_threat_model_entries | Ajouter des entrées au modèle de menace | Non |
accept_threat_model_proposal | Accepter ce qu'une nouvelle lecture du code a proposé | Non |
update_threat_model_entries | Modifier le titre ou les détails d'une entrée | Toujours |
remove_threat_model_entries | Supprimer des entrées du modèle de menace | Toujours |
dismiss_threat_model_proposal | Rejeter ce qu'une nouvelle lecture du code a proposé | Toujours |
keep_security_proof | Conserver comme test de régression la preuve ayant reproduit une anomalie détectée | Non |
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.
| Outil | Fonctionnalités | Approbation |
|---|---|---|
list_security_contacts | Les contacts de sécurité d'un projet et les critères pour en être un | Non |
get_security_disclosure | Les 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 divulgation | Non |
add_security_contact | Attribuer à un membre du projet le rôle de contact de sécurité | Toujours |
remove_security_contact | Supprimer un contact de sécurité | Toujours |
publish_private_fix | Publier une correction en attente : la vulnérabilité est alors divulguée et une tâche ouvre son pull request | Toujours |
discard_private_fix | Supprimer une correction en attente | Toujours |
draft_github_security_advisory | Rédiger un avis de sécurité GitHub dans le dépôt, visible par ses mainteneurs | Toujours |
record_maintainer_report | Enregistrer 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.