CodeMender peut produire, valider et appliquer automatiquement des correctifs de code source pour les failles vérifiées, en les testant dans votre bac à sable local pour réduire les régressions.
Générer des correctifs de failles
Utilisez cm fix pour générer un correctif de sécurité validé pour un résultat vérifié :
cm fix FINDING_ID
Lorsque vous exécutez cm fix, CodeMender effectue les étapes de validation suivantes :
- Génère un correctif candidat à l'aide du moteur de raisonnement hébergé dans le cloud.
- Applique le correctif à une copie du code source dans votre bac à sable local.
- Compile et teste la codebase en exécutant le
build.commandconfiguré pour s'assurer que le projet se compile et que les tests unitaires réussissent. - Réexécute l'exploit de preuve de concept validé pour confirmer que la faille n'est plus exploitable.
Par défaut, CodeMender vous invite à confirmer chaque modification de fichier avant de l'écrire sur le disque de votre espace de travail. Une fois toutes les vérifications réussies, CodeMender applique le correctif validé à votre espace de travail. Vous pouvez ensuite préparer les modifications.
Corriger les flags
- Fournir un contexte de correction (
-c/--context) : fournissez des contraintes architecturales ou des consignes de codage :cm fix FINDING_ID -c "Use the safe parameterized database helper in src/db/query.go"
- Approuver automatiquement les invites (
-y/--yes) : approuvez automatiquement toutes les écritures de fichiers et les invites de confirmation de commande pendant le processus de correction : Remarque : Vous pouvez également désactiver les invites de confirmation interactives dans votrecm fix FINDING_ID -y
config.yamlen définissanttools.confirm_writes: falseettools.confirm_commands: false. Lorsque les invites de confirmation sont désactivées, examinez les résultats des tests avant de préproduire ou de valider les modifications. - Contrôler l'exécution en bac à sable (
--sandbox) : activez ou désactivez explicitement le bac à sable au niveau de l'OS pour cette exécution (par exemple,--sandbox=falsepour le désactiver) :cm fix FINDING_ID --sandbox=false
- Contourner les limites de chemin d'accès (
--allow-all-paths) : désactivez la vérification des limites de chemin d'accès de l'espace de travail pour cette exécution afin que les outils de l'agent puissent accéder aux chemins d'accès en dehors de la racine du projet et de l'project_pathsconfiguré (à combiner avec--sandbox=falsepour accéder aux chemins d'accès de l'hôte qui ne sont pas installés dans le bac à sable) :cm fix FINDING_ID --allow-all-paths
- Règle de contournement de commande (
--allow-all-commands) : désactivez l'application de la liste de blocagecommand_policy.yamlpour cette exécution :cm fix FINDING_ID --allow-all-commands
- Ignorer le cache (
--no-cache) : force CodeMender à générer un nouveau correctif.cm fix FINDING_ID --no-cache
- Définissez un budget de durée d'exécution (
--duration/--timeout) : limitez la durée d'horloge pour la génération et la validation des correctifs (par exemple,15mou30m), ou définissezCM_DURATIONouexecution.durationdansconfig.yaml: Lorsque la limite de durée est atteinte, CodeMender accorde à l'agent un court délai de grâce pour terminer son correctif. Si l'agent termine pendant le tour de grâce,cm fix FINDING_ID --duration 20m
cm fixexécute la validation de votre compilation (en appliquant le correctif et en marquant le résultatFIXEDsi la compilation réussit, ou en enregistrant un correctifpendinget en laissant les modifications en place si la compilation échoue) et se ferme toujours avec l'état50. Si la session atteint la limite stricte avant de se terminer, CodeMender annule les modifications non validées de l'arbre de travail, enregistre toute différence en cours sous la forme d'un correctifpartialque vous pouvez inspecter aveccm report --patches, puis se ferme avec l'état50.
Inspecter et gérer les différences VCS locales
CodeMender inclut des commandes VCS intégrées pour vous aider à inspecter, préparer et gérer les modifications de code introduites par les correctifs avant de les valider :
Afficher l'état du dépôt : vérifiez les fichiers que CodeMender a modifiés ou créés dans votre espace de travail local.
cm vcs status
Inspecter les différences : examinez les différences unifiées ligne par ligne de toutes les modifications de code non validées générées par l'agent.
cm vcs diff
Préparer les modifications : ajoutez les modifications de correctif validées à votre environnement de préproduction local afin de pouvoir les tester et les valider.
cm vcs stage
Annuler les modifications de la session : supprimez toutes les modifications de fichiers locaux générées par CodeMender au cours de la session actuelle et restaurez l'état de référence de votre dépôt.
cm vcs reset