#083Guide4 min
Mettre en place un contrôle bloquant avant déploiement
Vérifier une analyse précise avant une livraison, sans la confondre avec une validation du commit à publier.
Équipe Hackaiz · mis à jour le 21/11/2026

01Définir ce que le contrôle valide réellement
Un contrôle bloquant est une étape qui arrête la livraison tant que les conditions prévues ne sont pas remplies. Le client connecté de Hackaiz propose une commande verify portant sur une analyse précise de la plateforme enregistrée. Cette commande ne garantit pas que le code prêt à partir en production a été examiné. Son résultat indique saved_platform_not_pr_commit : la cible enregistrée n’est pas nécessairement le commit proposé. Votre équipe doit établir ce lien avant d’en faire une condition de livraison.
Le client préparé se trouve dans tools/hackaiz-cli ; il n’est pas publié comme paquet npm. Le traitement autonome doit être configuré et déployé pour exécuter les demandes connectées. La présence d’un modèle dans le projet ne prouve pas une exécution réussie dans votre environnement GitHub. Si le service n’est pas disponible, conservez la référence de la demande et faites vérifier la configuration, plutôt que de présenter la tâche comme un contrôle de sécurité réussi.
02Lancer une demande et garder sa référence
Préparez une clé personnelle HACKAIZ_API_KEY autorisant la lecture et le lancement, l’identifiant du projet enregistré et le client dans un environnement de confiance. Pour un site ou une API, la preuve actuelle de propriété du domaine et le consentement restent indispensables. Vous pouvez utiliser un enregistrement DNS TXT _hackaiz ou le fichier HTTPS /.well-known/hackaiz-verification.txt, éventuellement créé par l’IA du projet. L’automatisation ne dispense jamais de cette preuve.
Exécutez node tools/hackaiz-cli/bin/hackaiz.mjs analyze <project-id> <request-key> en remplaçant les paramètres par vos identifiants. Conservez le requestId renvoyé. Le client dépose la demande puis consulte son état ; sa fermeture n’annule pas le traitement autonome. Après une coupure, utilisez node tools/hackaiz-cli/bin/hackaiz.mjs status <project-id> <request-id> pour reprendre la lecture de la même demande. Ne créez pas une nouvelle analyse simplement parce que la connexion a été interrompue : le travail d’analyse consomme des crédits.
03Utiliser la vérification, pas seulement le lancement
Lorsque le traitement est terminé, exécutez node tools/hackaiz-cli/bin/hackaiz.mjs verify <project-id> <request-id>. La commande de lancement peut se terminer normalement pour une analyse réussie ou partielle. Son seul code de sortie ne suffit donc pas pour autoriser une livraison. La vérification exige une analyse réussie, correctement rattachée à la demande, puis lit toutes les pages de constats ouverts pour cette analyse précise.
Le verdict pass correspond au code de sortie 0 lorsque aucun constat ouvert de niveau technique high ou critical ne subsiste. Le verdict fail correspond au code 1 si ces constats existent. Le verdict inconclusive donne le code 2 si le résultat complet requis ne peut pas être établi, notamment lorsque les pages de constats sont incohérentes. Ces seuils techniques ne se confondent pas avec les libellés du rapport : Danger, À corriger et À surveiller. Un constat high est présenté comme À corriger et bloque néanmoins ce contrôle.
04Relier explicitement la livraison au résultat
Configurez votre chaîne de livraison pour exiger la réussite de la tâche de vérification avant le déploiement. Lancer une analyse ou publier un commentaire GitHub ne crée pas cette dépendance. Le modèle GitHub connecté fourni lance le traitement et commente un lien vers le projet, mais n’exécute pas verify. Ajoutez cette étape et la dépendance de déploiement dans votre dépôt après examen, puis testez que les résultats fail et inconclusive interrompent bien la livraison.
Associez la référence de livraison, l’identifiant de demande et la sortie de vérification pour la revue humaine. Un résultat favorable décrit les constats enregistrés et la couverture choisie, pas une sécurité garantie. Les contrôles décochés ne sont ni exécutés ni facturés. Si une correction est nécessaire, Hackaiz prépare une demande de modification GitHub en brouillon, examinée et approuvée par une personne, jamais fusionnée automatiquement. Testez la modification approuvée puis obtenez une nouvelle preuve pour la livraison.
Questions fréquentes
Passer à l’action
Cet article vous a-t-il aidé ?