Import de Rapport SARIF

SARIF (Static Analysis Results Interchange Format) est le format standard de l'industrie pour l'échange de résultats d'analyse statique. Wisec supporte l'import SARIF v2.1.0, vous permettant d'intégrer les résultats de n'importe quel scanner compatible dans votre enregistrement de build notarié.

Pourquoi importer des rapports SARIF ?

Le moteur intégré de Wisec scanne déjà vos dépendances pour les CVE et détecte les anomalies comportementales. L'import SARIF vous permet d'aller plus loin en intégrant les résultats de vos outils existants - qualité du code, scan de conteneurs, SAST - sans les remplacer.

Une fois importés, les résultats SARIF sont :

  • Inclus dans le manifeste signé (le hash SHA-256 du rapport est ancré cryptographiquement)
  • Visibles comme anomalies dans votre tableau de bord Wisec
  • Classés par sévérité (CRITICAL, HIGH, MEDIUM, LOW)
  • Dédupliqués par règle et localisation de fichier

Scanners compatibles

Tout outil qui génère du SARIF v2.1.0 est compatible :

OutilCatégorie
CodeQLSAST (GitHub Advanced Security)
SemgrepSAST / Règles personnalisées
SnykVulnérabilités dépendances & code
TrivyScan conteneurs & filesystem
CheckovInfrastructure as Code
ESLint (avec reporter SARIF)Qualité du code
Tout outil SARIF v2.1.0-

Configuration

Définissez la variable d'environnement WISEC_SCAN_REPORT_PATH pointant vers votre fichier SARIF avant d'exécuter l'agent Wisec. L'agent le détecte et le traite automatiquement.

bash
export WISEC_SCAN_REPORT_PATH="/chemin/vers/results.sarif"
./wisec-agent

Correspondance des sévérités

Wisec mappe la sévérité SARIF vers sa propre classification dans cet ordre :

  1. Propriété CVSS security-severity (prioritaire si présente) :

    • ≥ 9.0 → CRITICAL
    • ≥ 7.0 → HIGH
    • ≥ 4.0 → MEDIUM
    • < 4.0 → LOW
  2. Champ level SARIF (fallback) :

    • error → HIGH
    • warning → MEDIUM
    • note / info / none → LOW

Exemple GitLab CI

yaml
stages:
  - scan
  - wisec

semgrep:
  stage: scan
  image: returntocorp/semgrep
  script:
    - semgrep --sarif --output $CI_PROJECT_DIR/results.sarif .
  artifacts:
    paths:
      - results.sarif

run_wisec:
  stage: wisec
  image: alpine
  before_script:
    - apk add --no-cache git curl tar wget
    - wget -q https://github.com/gitleaks/gitleaks/releases/download/v8.30.1/gitleaks_8.30.1_linux_x64.tar.gz -O gitleaks.tar.gz
    - tar -xzf gitleaks.tar.gz gitleaks && chmod +x gitleaks && 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
  script:
    - ./wisec-agent
  variables:
    WISEC_SCAN_REPORT_PATH: "$CI_PROJECT_DIR/results.sarif"

Exemple GitHub Actions

yaml
jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Lancer Semgrep
        run: semgrep --sarif --output results.sarif .

      - name: Préparer l'agent Wisec
        run: |
          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
          wget -q https://github.com/gitleaks/gitleaks/releases/download/v8.30.1/gitleaks_8.30.1_linux_x64.tar.gz -O gitleaks.tar.gz
          tar -xzf gitleaks.tar.gz gitleaks && chmod +x gitleaks && sudo mv gitleaks /usr/local/bin/

      - name: Lancer l'agent Wisec
        env:
          WISEC_PROJECT_ID: ${{ secrets.WISEC_PROJECT_ID }}
          AGENT_PRIVATE_KEY_HEX: ${{ secrets.AGENT_PRIVATE_KEY_HEX }}
          WISEC_API_ENDPOINT: ${{ secrets.WISEC_API_ENDPOINT }}
          WISEC_SCAN_REPORT_PATH: "${{ github.workspace }}/results.sarif"
        run: ./wisec-agent

Ce qui apparaît dans le tableau de bord

Chaque résultat SARIF devient une entrée d'anomalie dans votre build, affichant :

  • L'identifiant de règle (ex. javascript/sql-injection)
  • Le message du scanner
  • Le fichier et la ligne concernés
  • La sévérité (mappée comme décrit ci-dessus)
  • La source identifiée comme l'outil scanner d'origine

Les résultats sont dédupliqués par (ruleId, URI du fichier) - exécuter le même scanner deux fois sur le même code ne créera pas de doublons.

Garantie d'intégrité

Le fichier SARIF lui-même n'est pas stocké par Wisec - seul son hash SHA-256 est inclus dans le manifeste signé ancré sur IPFS. Cela signifie :

  • Le contenu du rapport reste dans votre infrastructure
  • Son intégrité est cryptographiquement prouvable via le registre public Wisec
  • Toute modification du rapport après le build est détectable