Intégration Azure DevOps

Ce guide explique comment intégrer Wisec dans vos pipelines Azure DevOps avec la configuration deux étapes : notarisation + application des policies.

1. Prérequis

  • Un compte Wisec et un projet créé.
  • Votre Project ID depuis le dashboard.
  • Votre clé de signature agent (clé privée) générée depuis Paramètres → Clés de signature.

2. Configurer les variables de pipeline

Pipelines > Library > Variable Groups - ajoutez les variables suivantes en marquant les valeurs sensibles comme secrètes :

VariableValeurSecrète
WISEC_PROJECT_IDVotre ID de projet numériqueNon
AGENT_PRIVATE_KEY_HEXVotre clé privée Ed25519Oui
WISEC_API_ENDPOINThttps://api.wisec.io/api/v1/eventsNon

3. Configuration deux étapes

WisecNotify notarise le build tôt (et ne bloque jamais) ; WisecGate applique vos policies en fin de pipeline après l'analyse CVE.

L'étape WisecGate est indispensable pour l'application des policies. Les policies sont évaluées et enregistrées par WisecNotify, mais elles ne bloquent votre pipeline qu'à travers le gate. Sans l'étape gate, un build qui viole une policy block passera quand même. WisecNotify seul ne fournit que la notarisation.

yaml
trigger:
  - main
  - master

pool:
  vmImage: 'ubuntu-latest'

stages:
  - stage: Build
    displayName: 'Build et notification'
    jobs:
      - job: Build
        steps:
          - script: echo "Votre commande de build"

      # Étape 1 - Soumission du build (non bloquant, tôt dans le pipeline)
      - job: WisecNotify
        displayName: 'Wisec Notify'
        steps:
          - script: |
              curl -fsSLO https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64
              curl -fsSL https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64.sha256 | sha256sum -c -
              mv wisec-agent-v1.5.0-linux-amd64 wisec-agent
              chmod +x wisec-agent && ./wisec-agent && rm -f wisec-agent
            displayName: 'Exécuter l'agent Wisec'
            env:
              WISEC_PROJECT_ID: $(WISEC_PROJECT_ID)
              AGENT_PRIVATE_KEY_HEX: $(AGENT_PRIVATE_KEY_HEX)
              WISEC_API_ENDPOINT: $(WISEC_API_ENDPOINT)

  - stage: Test
    displayName: 'Tests'
    dependsOn: Build
    jobs:
      - job: Test
        steps:
          - script: echo "Votre commande de test"

  # Étape 2 - Contrôle de policy (bloquant, en fin de pipeline)
  - stage: WisecGate
    displayName: 'Wisec Policy Gate'
    dependsOn: [Build, Test]
    jobs:
      - job: Gate
        steps:
          - script: |
              curl -fsSLO https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64
              curl -fsSL https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64.sha256 | sha256sum -c -
              mv wisec-agent-v1.5.0-linux-amd64 wisec-agent
              chmod +x wisec-agent && ./wisec-agent --gate && rm -f wisec-agent
            displayName: 'Wisec Gate'
            env:
              WISEC_PROJECT_ID: $(WISEC_PROJECT_ID)
              AGENT_PRIVATE_KEY_HEX: $(AGENT_PRIVATE_KEY_HEX)
              WISEC_API_ENDPOINT: $(WISEC_API_ENDPOINT)
              WISEC_GATE_TIMEOUT: "120"
              WISEC_STRICT: "false"

Variables d'environnement du gate

VariableDéfautDescription
WISEC_GATE_TIMEOUT120Secondes max d'attente pour la fin de l'analyse
WISEC_STRICTfalseSi true, fait échouer le gate en cas de timeout

4. Gitleaks (détection de secrets)

yaml
          - script: |
              curl -fsSL https://github.com/gitleaks/gitleaks/releases/download/v8.30.1/gitleaks_8.30.1_linux_x64.tar.gz | tar xz
              chmod +x gitleaks && sudo mv gitleaks /usr/local/bin/
              curl -fsSLO https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64
              curl -fsSL https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64.sha256 | sha256sum -c -
              mv wisec-agent-v1.5.0-linux-amd64 wisec-agent
              chmod +x wisec-agent && ./wisec-agent && rm -f wisec-agent
            env:
              WISEC_PROJECT_ID: $(WISEC_PROJECT_ID)
              AGENT_PRIVATE_KEY_HEX: $(AGENT_PRIVATE_KEY_HEX)
              WISEC_API_ENDPOINT: $(WISEC_API_ENDPOINT)

5. Import de rapport SARIF

yaml
              WISEC_SCAN_REPORT_PATH: "$(Build.SourcesDirectory)/results.sarif"

Note : Dans Azure DevOps, les variables secrètes ne sont pas automatiquement injectées comme variables d'environnement. Mappez-les toujours explicitement via le bloc env: dans chaque étape.

6. Rattacher la preuve à l'artefact livré (optionnel)

Par défaut, la provenance identifie le build par son commit source. Pour qu'elle désigne le fichier que vous livrez, lancez l'agent après le build et renseignez WISEC_BINARY_PATH avec ce fichier. Le guide d'installation explique ce que cela change, et ses limites. Les images de conteneurs que votre build pousse peuvent aussi être désignées, avec WISEC_IMAGE_DIGESTS (agent v1.3.0 ou plus) : voir Images de conteneurs.

yaml
  - stage: Build
    jobs:
      - job: Build
        steps:
          - script: make build   # produit dist/myapp
            displayName: 'Build'

          - script: |
              curl -fsSLO https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64
              curl -fsSL https://wisec-downloads.s3.fr-par.scw.cloud/wisec-agent-v1.5.0-linux-amd64.sha256 | sha256sum -c -
              mv wisec-agent-v1.5.0-linux-amd64 wisec-agent
              chmod +x wisec-agent && ./wisec-agent && rm -f wisec-agent
            displayName: 'Wisec Notify'
            env:
              WISEC_PROJECT_ID: $(WISEC_PROJECT_ID)
              AGENT_PRIVATE_KEY_HEX: $(AGENT_PRIVATE_KEY_HEX)
              WISEC_API_ENDPOINT: $(WISEC_API_ENDPOINT)
              WISEC_BINARY_PATH: 'dist/myapp'

L'agent devient une étape du job Build, après la compilation, pour accéder au fichier produit dans le même espace de travail. Le job séparé WisecNotify n'est plus nécessaire ; le stage WisecGate reste inchangé.

Pour vérifier que cela a fonctionné, ouvrez l'attestation depuis le dashboard : son sujet indique artifact sha256:…. S'il indique source commit …, l'agent n'a pas trouvé le fichier.