#082Tutoriel4 min
Intégrer Hackaiz dans GitHub Actions
Choisir une vérification de composants ou une analyse de plateforme enregistrée, protéger les secrets et interpréter le résultat.
Équipe Hackaiz · mis à jour le 21/11/2026

01Définir ce que la procédure doit vérifier
La page Intégrations décrit l’action Hackaiz Import Gate sous le nom Hacktualiz/import-gate@v1, avec une clé personnelle pour examiner des composants transmis. Elle fournit aussi le modèle distinct https://hackaiz.com/hackaiz-connected-action.yml. Celui-ci demande l’analyse d’une plateforme déjà enregistrée dans Hackaiz. Ces contrôles ne sont pas interchangeables : le premier examine du texte soumis ; le second traite une cible autorisée sauvegardée dans le compte.
Le projet contient également une procédure téléchargeable appliquant des règles ouvertes de recherche de secrets et de code. Ne transposez pas son fonctionnement à une analyse de compte utilisant des crédits. Choisissez le mécanisme voulu et nommez-le clairement dans votre dépôt. En particulier, ne présentez pas la réussite d’une analyse de plateforme comme la validation du commit proposé. Le modèle connecté indique expressément qu’il ne vérifie pas le commit à la tête de la proposition GitHub.
02Préparer volontairement l’action de composants
Le parcours documenté consiste à ajouter HACKAIZ_API_KEY dans les réglages GitHub, rubrique des secrets et variables pour Actions, puis à créer .github/workflows/hackaiz.yml. L’étape utilise « uses: Hacktualiz/import-gate@v1 » avec l’entrée « api-key: ${{ secrets.HACKAIZ_API_KEY }} ». La page de choix d’une procédure GitHub ne répertorie pas toutes les actions comme des modèles prêts à l’emploi. Créez le fichier au lieu de conclure qu’un modèle absent signifie une intégration inexistante.
La page Intégrations précise que Danger ou un résultat incomplet fait échouer l’action par défaut. Chaque examen payant de composants utilise des crédits. Le rapport SARIF peut être envoyé à l’interface Sécurité de GitHub si les permissions et options du dépôt permettent l’examen de code. Le résultat de l’action ne garantit pas l’accès à cette interface. L’examen est statique : il n’exécute pas le code reçu et ne démontre pas le comportement de toutes les dépendances installées.
03Lire le modèle de plateforme avant de le copier
Le modèle connecté attend les sources du client préparé dans tools/hackaiz-cli. La page Intégrations indique que ce client n’est pas publié sur npm et que le traitement autonome doit être déployé et synchronisé ; elle ne confirme pas d’exécution GitHub réelle. Le modèle utilise le secret HACKAIZ_API_KEY et la variable de dépôt HACKAIZ_PROJECT_ID. Sa clé de demande stable inclut des informations de dépôt, de proposition et de commit, sans transformer la cible en analyse de ce commit.
La procédure récupère la branche par défaut pour le client préparé, exclut les propositions provenant de dépôts dérivés, lance la plateforme enregistrée et peut commenter un lien de rapport. Elle ne modifie pas les sources et ne fusionne rien. Son étape de lancement n’appelle pas verify. Comme analyze peut terminer avec un rapport partiel, une tâche verte ne prouve pas qu’une vérification de sécurité complète a réussi. Si votre politique exige davantage, concevez et relisez séparément cette vérification.
04Protéger les accès et garder une décision humaine
N’exposez jamais la clé personnelle au code non fiable d’un dépôt dérivé. Conservez l’exclusion prévue et la séparation entre automatisation approuvée et sources proposées. Limitez les permissions à la procédure choisie : le modèle connecté demande l’écriture sur les propositions pour commenter, pas pour réécrire l’application. Gardez les clés hors des journaux et des fichiers produits. Relisez les modifications de procédure avant de les laisser utiliser un accès au compte.
Un site ou une API exige toujours une preuve de domaine avant analyse : TXT DNS _hackaiz, fichier HTTPS de vérification ou création de ce fichier par l’IA du projet. L’autorisation du dépôt GitHub ne la remplace pas. Examinez la fin du traitement, la couverture et les constats avant de publier. Une correction Hackaiz reste une proposition GitHub en brouillon, soumise à revue et approbation humaines, sans fusion automatique. La procédure apporte un élément de décision, pas une certification ni une garantie de sécurité.
Questions fréquentes
Passer à l’action
Cet article vous a-t-il aidé ?