#081Tutoriel4 min
Utiliser le client Hackaiz en ligne de commande
Comprendre le client préparé, les demandes stables et les codes de vérification avant son automatisation.
Équipe Hackaiz · mis à jour le 21/11/2026

01Vérifier la distribution avant toute installation
Le dépôt contient un client en ligne de commande dans tools/hackaiz-cli, avec l’exécutable bin/hackaiz.mjs. Le paquet exige Node.js 22 ou une version ultérieure. Son fichier de présentation montre une installation globale par npm, mais la page Intégrations précise que le client est préparé dans le dépôt et n’est pas publié sur npm. Utilisez donc les sources dans un environnement approuvé, sans présenter cet exemple comme la preuve d’un paquet public disponible.
Le parcours connecté exige aussi un traitement autonome déployé et synchronisé. La page Intégrations ne confirme pas d’essai sur un véritable compte client. Ce sont des prérequis d’exploitation, pas des détails réglés par la seule présence des fichiers. Dans un environnement source correctement préparé, « node tools/hackaiz-cli/bin/hackaiz.mjs help » affiche les commandes implémentées. Cette aide ne soumet pas d’analyse et ne démontre pas que le service distant est prêt.
02Préparer la clé et l’identifiant de plateforme
Le client lit HACKAIZ_API_KEY dans l’environnement et la transmet dans un en-tête d’authentification Bearer. Choisissez une clé personnelle disposant de la lecture et du lancement pour la plateforme voulue. Gardez-la hors du dépôt et des journaux, dans l’environnement du terminal ou le coffre à secrets de l’automatisation. Le premier identifiant des commandes connectées est l’UUID de la plateforme enregistrée, pas une adresse de dépôt, un domaine ou un dossier de sources local.
Avant d’analyser un site ou une API, prouvez le contrôle du domaine par TXT DNS _hackaiz, fichier HTTPS /.well-known/hackaiz-verification.txt ou instruction à l’IA du projet pour créer ce fichier. La cible doit être autorisée et le consentement actuel. La clé ne remplace aucune de ces exigences. Les analyses utilisent les crédits du compte et les achats restent sur Hackaiz. N’insérez jamais un secret dans une commande destinée à être copiée dans une demande d’aide publique.
03Lancer une fois et reprendre la même demande
La syntaxe connectée est « hackaiz analyze PLATFORM_UUID STABLE_REQUEST_KEY ». Pour utiliser directement les sources, remplacez hackaiz par l’appel Node de bin/hackaiz.mjs. Fournissez une clé de demande stable identifiant le traitement voulu et conservez requestId dans la réponse. Le client consulte ensuite la demande existante par lectures GET. Fermer le terminal ne demande pas l’arrêt du traitement autonome et ne justifie pas de rejouer une analyse déjà commencée.
Après une interruption, utilisez « hackaiz status PLATFORM_UUID REQUEST_UUID ». La commande « hackaiz report PLATFORM_UUID » lit le dernier rapport de plateforme, tandis que « hackaiz findings PLATFORM_UUID » lit les constats. Ces consultations pratiques ne remplacent pas le lien à une exécution précise pour décider d’une publication. La commande analyze peut se terminer favorablement avec une analyse partielle : son code de sortie ne suffit donc pas. Examinez la demande enregistrée et ses constats.
04Distinguer vérification et examen de composant
« hackaiz verify PLATFORM_UUID REQUEST_UUID » lit uniquement l’analyse liée à cette demande et parcourt ses constats. Le code 0 signifie qu’aucun constat critique ou élevé non résolu n’a été trouvé dans une analyse complète liée ; le code 1 indique qu’il en existe ; le code 2 reste non concluant si les données sont incomplètes ou indisponibles. Ces gravités relèvent du groupe Danger. Cette vérification concerne la plateforme enregistrée, pas un commit GitHub ou un déploiement déterminé.
La commande distincte « hackaiz check <path> --sarif » examine le texte de composants tels qu’une compétence d’assistant, une configuration MCP, un paquet ou une procédure automatisée et produit du SARIF structuré. Ses codes diffèrent : Danger renvoie 2 et un verdict incomplet renvoie 3. Ne reprenez pas le tableau de verify pour check. Le client ne publie aucun correctif et ne fusionne rien ; les corrections restent des propositions GitHub en brouillon pour revue humaine. Une sortie favorable n’est pas une certification.
Questions fréquentes
Passer à l’action
Cet article vous a-t-il aidé ?