ASoC et GitLab

Utilisez AppScan on Cloud avec GitLab pour exécuter des tests de sécurité d'analyse statique (SAST) sur les fichiers de votre référentiel à chaque requête de fusion, empêchant ainsi les vulnérabilités d'atteindre la branche principale. Les résultats sont stockés dans AppScan on Cloud.

S'inscrire

Si vous n'avez pas encore de compte, inscrivez-vous sur HCL AppScan on Cloud (ASoC) pour générer votre clé d'API et votre secret d'API.

Configuration

  1. Générez votre clé d'API ASoC et votre secret d'API sur la page API.

    La clé d'API et le secret d'API correspondent aux paramètres ASOC_KEY et ASOC_SECRET de cette action. Notez la clé et le secret.

  2. Créez l'application dans ASoC.

    Les applications servent de conteneur pour stocker tous les examens liés au même projet.

  3. Copiez le nom de l'application.

    Le nom de l'application dans ASoC correspond à APP_NAME pour cette intégration.

  4. Créez des variables dans GitLab. Sélectionnez Paramètres > CI/CD > Variables, et définissez les variables comme suit :
    Tableau 1. Entrées requises (SAST ou DAST)
    Variable Valeur
    APPSCAN_KEY Clé d'API que vous avez générée sur la page API.
    APPSCAN_SECRET Secret d'API que vous avez généré sur la page API
    APP_NAME Nom de l'application dans AppScan.
    APPSCAN_ASSET ID du groupe d'actifs dans AppScan.

  5. Copiez .gitlab-ci.yaml et Dockerfile à la racine de votre référentiel GitLab.
  6. Définissez le fichier de configuration CI/CD. Sélectionnez Paramètres > CI/CD > Pipelines généraux > Fichier de configuration CI/CD.

  7. Générez votre propre outil d'exécution. Sélectionnez Paramètres > CI/CD > Outils d'exécution et suivez les étapes de la section Outils d'exécution spécifiques.
  8. Sur le système sur lequel vous configurez l'outil d'exécution GitLab, connectez-vous et clonez votre référentiel GitLab si celui-ci n'existe pas déjà. Assurez-vous qu'un moteur Docker est installé sur cette machine.
  9. Générez une nouvelle image Docker nommée saclient à partir du Dockerfile. Remplacez le répertoire par la racine du référentiel et exécutez la commande suivante pour créer l'image Docker :
     docker build -t saclient . 
    Important :
    Le point à la fin indique le répertoire actuel.
  10. Dans GitLab, pour empêcher les fusions en cas d'échec de l'examen, activez Pipelines must succeed dans Settings > Merge requests > Merge checks.
  11. Vérifiez qu'une nouvelle tâche d'examen est lancée lorsque de nouvelles requêtes de fusion sont créées dans Settings > CI/CD > Pipelines.

Exemples

Tâche d'examen

Artefacts d'examen prêts à être téléchargés

Tâche d'examen réussie basée sur maxIssuesAllowed

Informations complémentaires

Le script yaml actuel contient un exemple de vérification de stratégie de sécurité qui échoue à l'analyse si le nombre de problèmes de sécurité autorisés dépasse un certain seuil. Dans l'exemple, maxIssuesAllowed est défini sur 100.