Documentation ChatGPT
Français
Contact goolvyouyou@gmail.com

Exécuter une analyse de sécurité approfondie

Effectuez des examens de sécurité répétés d’un dépôt ou d’un dossier et fixez des limites de parallélisme et de durée.

Une analyse approfondie exécute plusieurs analyses standard indépendantes sur le même dépôt ou dossier et regroupe les problèmes détectés. Utilisez-la lorsque vous souhaitez des examens répétés et pouvez accepter le temps d’exécution et la consommation de tokens supplémentaires.

Commencez par une analyse standard pour vérifier que le périmètre et le contexte de sécurité correspondent à votre objectif. Des examens répétés peuvent détecter des problèmes manqués lors d’un passage précédent, mais ne garantissent ni une détection exhaustive ni des résultats identiques d’une exécution à l’autre.

Choisir entre une analyse standard et une analyse approfondie

Analyse standard Analyse approfondie
Examen Une analyse standard Plusieurs analyses standard avec regroupement des problèmes détectés
Utilisation Une première analyse ou l’examen d’un périmètre défini Des examens indépendants supplémentaires de ce périmètre
Périmètre Dépôt ou dossier Dépôt ou dossier
Modifications Utilisez la procédure d’examen des modifications Non pris en charge

Lancer l’analyse approfondie

Pour obtenir la meilleure qualité d’analyse, utilisez gpt-5.6-sol avec un effort de raisonnement xhigh.

  1. Ouvrez Security > Analyses et sélectionnez + Analyse.
  2. Choisissez un dépôt ou un dossier, sélectionnez Base de code et activez Analyse approfondie. L’analyse examine l’intégralité du dépôt ou du dossier sélectionné.
  3. Choisissez le modèle et l’effort de raisonnement. Ajoutez le contexte du modèle de menace ou du déploiement dans Contexte supplémentaire.
  4. Sélectionnez Lancer l’analyse.

Vous pouvez aussi la lancer depuis une conversation Codex :

Use $codex-security:deep-security-scan to run a deep security scan of this repository.

Pour un seul composant, remplacez « this repository » par le chemin de son dossier.

Les agents d’analyse approfondie héritent du modèle et des paramètres de raisonnement que vous avez sélectionnés. Chaque agent exécute une analyse standard complète, et Codex Security regroupe les résultats obtenus. Suivez l’analyse enregistrée depuis Analyses, ou sélectionnez Voir l’activité pour examiner sa tâche Codex. Définissez des limites d’exécution avant de commencer si vous devez limiter le parallélisme ou la durée.

Suivez la phase en cours de l’analyse approfondie et examinez son activité Codex avant de consulter le résultat final.

Examiner le résultat

Les analyses approfondies utilisent les mêmes détails d’analyse enregistrés et le même répertoire d’analyse complet que les analyses standard. Ouvrez l’analyse terminée dans Analyses ou examinez ses constats dans Constats. Le fichier report.md généré contient des liens vers des rapports de vulnérabilité détaillés ou des recommandations de renforcement structurel lorsque vous demandez ces livrables. Conservez les répertoires findings/ et hardening/ liés avec le rapport lorsque vous partagez ou archivez le résultat.

Examinez le résumé de couverture avant les constats. Même une analyse approfondie a ses limites, vérifiez donc les surfaces dont l’examen a été reporté et les lacunes de preuve restantes avant de tirer une conclusion. Pour un constat que vous acceptez, poursuivez avec Corriger et vérifier un constat.

Pour examiner une pull request, un commit, une plage de révisions de branche ou un correctif local, utilisez Examiner les modifications de code. Les analyses approfondies n’acceptent pas de cibles de diff.

Configurer la durée d’exécution d’une analyse approfondie

Pour contrôler la concurrence et la durée d’une analyse approfondie, créez ou modifiez ~/.codex/codex-security/config.toml. Si vous définissez CODEX_HOME, utilisez plutôt $CODEX_HOME/codex-security/config.toml.

Par exemple, ce profil exécute une analyse plus courte avec une concurrence limitée :

[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5
Paramètre Valeur par défaut Description
workers 4 Nombre de workers d’analyse standard indépendants autorisés à s’exécuter simultanément. L’ancienne valeur "auto" correspond également à 4.
subagents 3 Nombre de sous-agents que chaque worker peut lancer. Définissez 0 pour les désactiver.
stop_after_no_new 4 Arrête l’analyse après ce nombre d’analyses de worker consécutives terminées sans produire de nouveau résultat.
stop_after_consecutive_errors 3 Arrête l’analyse après ce nombre d’erreurs de worker consécutives.
max_discovery_runs 40 Limite le nombre d’exécutions indépendantes de l’analyse standard avant l’agrégation.
max_time_hours 96 Limite l’exécution des workers à un nombre d’heures positif, jusqu’à 96 ; utilisez des valeurs fractionnaires si nécessaire.

Des valeurs plus faibles peuvent réduire la durée de l’analyse et l’utilisation de tokens, mais risquent de laisser passer certains constats. Les modifications de configuration s’appliquent aux nouvelles analyses approfondies, pas à celles déjà en cours.

Lorsque la limite de temps expire, Codex Security arrête les workers qui n’ont pas terminé, conserve les résultats des analyses terminées et les agrège dans le rapport final. Si aucun worker ne termine l’examen du code source avant l’échéance, le rapport indique une couverture partielle.

Le paramètre max_time_hours nécessite la version 0.1.19 ou ultérieure du plugin. Consultez le journal des modifications du plugin pour connaître les détails de la version.