#084Guide4 min
Intégrer les contrôles Hackaiz à une chaîne de livraison
Choisir le bon type de contrôle automatisé, protéger les identifiants et lire les résultats sans élargir leur portée.
Équipe Hackaiz · mis à jour le 21/11/2026

01Définir ce que la chaîne doit contrôler
L’intégration et la livraison continues, souvent désignées par CI/CD, exécutent des tâches répétables lors des changements de code et préparent les publications. Hackaiz propose des chemins distincts. L’action officielle import-gate vérifie des composants soumis. Le modèle connecté demande l’analyse d’une plateforme déjà enregistrée. Leurs résultats ne sont pas interchangeables : examiner une configuration ne revient pas à analyser toute l’application, et analyser la cible enregistrée ne signifie pas nécessairement examiner le commit proposé.
Partez de la page Intégrations pour choisir le mécanisme correspondant à votre question. Pour examiner un composant ou une configuration d’automatisation, l’action documentée est Hacktualiz/import-gate@v1. Pour une cible enregistrée et autorisée, le modèle https://hackaiz.com/hackaiz-connected-action.yml utilise le client préparé dans tools/hackaiz-cli. Ce client n’est pas publié sur npm et nécessite un service de traitement autonome configuré et déployé. Un modèle fourni ne démontre pas une exécution réussie dans votre dépôt.
02Configurer prudemment l’action de composants
La page Intégrations indique de créer le secret HACKAIZ_API_KEY dans les paramètres GitHub, rubrique des secrets et variables, puis section des actions. Ajoutez ensuite .github/workflows/hackaiz.yml avec uses: Hacktualiz/import-gate@v1 et l’entrée api-key reliée à ${{ secrets.HACKAIZ_API_KEY }}. L’écran de choix d’une automatisation GitHub n’est pas un catalogue de toutes les actions : le fichier doit être écrit et examiné dans le dépôt. Consultez les entrées documentées de l’action pour savoir quel contenu sera soumis.
Ce mécanisme examine statiquement le texte fourni. Il n’exécute pas le composant, n’observe pas son comportement réel et ne lit pas tout le code des dépendances installées. Un manifeste de paquets ou un fichier d’automatisation peut ainsi être examiné avant ajout, sans conclure à la sécurité de l’application entière. Par défaut, Danger ou un résultat incomplet fait échouer la tâche. Chaque passage consomme des crédits. Un rapport SARIF, format structuré de constats, peut alimenter l’onglet de sécurité GitHub si les droits du dépôt et ses options d’analyse de code le permettent.
03Comprendre le modèle connecté avant activation
Le modèle connecté s’applique aux demandes de modification provenant du même dépôt et exclut celles des dépôts dérivés. Il récupère la branche par défaut, demande contents: read et utilise pull-requests: write pour publier un commentaire avec le lien du résultat. La clé est fournie comme secret ; l’identifiant de projet vient de la variable HACKAIZ_PROJECT_ID. La clé de demande inclut les identifiants du dépôt, de la demande de modification et du commit. Cette association identifie une demande, pas une preuve d’analyse de ce commit.
La cible reste la plateforme enregistrée. Pour un site ou une API, prouvez d’abord la propriété avec DNS TXT _hackaiz ou le fichier HTTPS /.well-known/hackaiz-verification.txt, que l’IA du projet peut aider à créer. Le consentement doit rester actuel. Le client dépose la demande puis consulte son état ; le traitement autonome continue si le client se ferme. Conservez l’identifiant renvoyé et relisez cette même demande après une coupure au lieu de recréer une analyse. Le modèle évite l’annulation d’une tâche en cours lorsqu’un nouvel événement arrive.
04Protéger les accès et examiner les preuves
Ne fournissez jamais HACKAIZ_API_KEY à du code non fiable provenant d’un dépôt dérivé, ne l’imprimez pas dans les journaux et ne la collez pas dans un commentaire. Examinez les changements de configuration comme du code : les droits et événements choisis déterminent qui peut agir avec vos identifiants. Gardez la référence du projet, l’identifiant de demande, l’issue de la tâche et l’état réel de l’analyse. Une tâche de lancement réussie ne suffit pas, car analyze accepte aussi une analyse partielle.
Le modèle connecté publie un lien ; il ne modifie pas les sources, ne fusionne rien et ne crée pas à lui seul un blocage de déploiement. Si votre procédure exige une décision plus stricte, ajoutez une étape de vérification examinée et les dépendances explicites de votre chaîne de livraison. Le travail d’analyse utilise des crédits ; les contrôles décochés ne sont ni exécutés ni facturés. Les corrections Hackaiz restent des demandes de modification GitHub en brouillon, examinées et approuvées par une personne avant toute fusion manuelle.
Questions fréquentes
Passer à l’action
Cet article vous a-t-il aidé ?