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 :
| Variable | Valeur | Secrète |
|---|---|---|
WISEC_PROJECT_ID | Votre ID de projet numérique | Non |
AGENT_PRIVATE_KEY_HEX | Votre clé privée Ed25519 | Oui |
WISEC_API_ENDPOINT | https://api.wisec.io/api/v1/events | Non |
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.
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
| Variable | Défaut | Description |
|---|---|---|
WISEC_GATE_TIMEOUT | 120 | Secondes max d'attente pour la fin de l'analyse |
WISEC_STRICT | false | Si true, fait échouer le gate en cas de timeout |
4. Gitleaks (détection de secrets)
- 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
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.
- 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.