Vérification des Attestations SLSA

À partir de Wisec Level 3, chaque build sur les plans Starter et Pro produit une attestation de provenance SLSA - un document signé qui prouve que Wisec, en tant que service indépendant, a traité votre build et enregistré sa provenance complète.

Cette page explique ce que c'est, pourquoi ça existe et comment le vérifier de manière indépendante.


Qu'est-ce qu'une attestation SLSA ?

SLSA (Supply-chain Levels for Software Artifacts) est un framework développé par Google et l'OpenSSF qui définit des niveaux d'intégrité pour la provenance des builds.

Une attestation de provenance SLSA est un document JSON (au format in-toto), ici signé par Wisec, qui répond à la question :

"Qu'est-ce qui a été construit, depuis quelle source, avec quelles dépendances ?"

Ce n'est pas la même chose que la signature de l'agent faite par votre clé CI/CD. Il y a deux signatures distinctes :

SignatureSignée parCertifie
Signature agent (Ed25519)Votre clé de pipeline CI/CD"Ce développeur a initié ce build"
Attestation SLSA (DSSE/Ed25519)Clé de service Wisec"Wisec atteste indépendamment cette provenance"

La valeur d'avoir Wisec qui signe la provenance, c'est qu'elle vient d'un tiers indépendant - votre clé CI/CD ne peut pas la forger.

Quel niveau SLSA ?

Énoncé précisément, parce qu'un niveau revendiqué plus fermement qu'il n'est atteint vaut moins qu'aucune revendication :

  • SLSA Build niveau 1 : atteint. Chaque build dispose d'une provenance qui décrit comment il a été produit.
  • SLSA Build niveau 2 : non revendiqué. Le niveau 2 exige que la provenance soit générée et signée par la plateforme de build hébergée elle-même. Wisec la signe en tant que tiers indépendant, à partir de ce que l'agent rapporte depuis votre pipeline : c'est ce qui la rend infalsifiable par votre clé CI, mais ce n'est pas ce que décrit le niveau 2.
  • SLSA Build niveau 3 : non revendiqué.

Ce que Wisec ajoute à la provenance ne relève pas des niveaux SLSA : un horodatage public dans le journal de transparence Rekor, et un stockage qui ne peut plus être modifié après coup.


Clé Publique Wisec (Production)

La clé Ed25519 suivante est utilisée pour signer toutes les attestations SLSA produites par app.wisec.io (environnement de production).

d553e9dbf0b0ad698ddbcd3d9d9225f0a804a85f999a511ce8823fc21a9e3a10

Cette clé est stable. Toute rotation sera annoncée avec un préavis minimum de 90 jours, et l'ancienne clé restera valide pour les attestations déjà émises.


Où trouver l'attestation

Pour tout build certifié (plan Starter/Pro), le CID IPFS de l'attestation SLSA est disponible :

  • Dashboard → Page Certificats → champ slsa_attestation_cid
  • Page de vérification publique : https://app.wisec.io/verify/<event_hash> → champ slsa_attestation_cid
  • Bundle ZIP de sécurité → fichier slsa-provenance.json

Vérifier une attestation

1. Récupérer l'attestation depuis IPFS

bash
# Gateway de vérification publique de Wisec (lecture seule, sans compte)
curl https://api.wisec.io/ipfs/<slsa_attestation_cid> > attestation.json

2. Inspecter l'enveloppe DSSE

bash
cat attestation.json | jq .

Vous verrez :

json
{
  "payloadType": "application/vnd.in-toto+json",
  "payload": "<statement SLSA encodé en base64>",
  "signatures": [
    {
      "keyid": "d553e9dbf0b0ad698ddbcd3d9d9225f0a804a85f999a511ce8823fc21a9e3a10",
      "sig": "<signature Ed25519 encodée en base64>"
    }
  ]
}

3. Décoder le statement SLSA

bash
cat attestation.json | jq -r '.payload' | base64 -d | jq .
json
{
  "_type": "https://in-toto.io/Statement/v1",
  "subject": [
    {
      "name": "https://github.com/your-org/your-repo@abc123...",
      "digest": { "sha256": "9f86d081884c7d65..." }
    }
  ],
  "predicateType": "https://slsa.dev/provenance/v1",
  "predicate": {
    "buildDefinition": {
      "buildType": "https://wisec.io/slsa/pipeline-agent/v1",
      "externalParameters": {
        "repository": "https://github.com/your-org/your-repo",
        "ref": "main"
      },
      "resolvedDependencies": [
        {
          "uri": "git+https://github.com/your-org/your-repo",
          "digest": { "gitCommit": "abc123..." }
        },
        { "uri": "pkg:npm/lodash@4.17.21" },
        { "uri": "pkg:pypi/flask@2.0.0" }
      ]
    },
    "runDetails": {
      "builder": {
        "id": "https://wisec.io/builders/pipeline-agent",
        "version": { "wisec-agent": "wisec-agent-go/v1.3.0" }
      },
      "metadata": { "invocationId": "<wisec-event-hash>" },
      "byproducts": [
        {
          "name": "sbom.json",
          "digest": { "sha256": "2c26b46b68ffc68f..." },
          "mediaType": "application/vnd.cyclonedx+json"
        }
      ]
    }
  }
}

Deux choses à savoir pour le lire :

  • Le sujet est le fichier que vous avez livré quand votre pipeline a donné son chemin à l'agent (WISEC_BINARY_PATH, voir Installation). Sinon, c'est la révision source : "name": "git+https://github.com/your-org/your-repo", "digest": { "gitCommit": "abc123..." }.
  • Les dépendances n'ont pas d'empreinte. Elles sont identifiées par leur Package URL (nom et version), car les manifestes dont elles sont lues n'en contiennent pas. SLSA v1 le permet.

Les builds attestés avant le passage à SLSA v1 conservent leur document d'origine, au format v0.2 (predicate.builder, predicate.materials, subject.digest.sha1 pour le commit) : une attestation ancrée n'est jamais réécrite. La signature se vérifie de la même façon.

4. Vérifier la signature

La signature suit la spec DSSE. Le message signé est le PAE (Pre-Authentication Encoding) :

DSSEv1 <len(payloadType)> <payloadType> <len(payload)> <payload>

Vérification en Python :

python
import base64, json
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey

WISEC_PUBLIC_KEY_HEX = "d553e9dbf0b0ad698ddbcd3d9d9225f0a804a85f999a511ce8823fc21a9e3a10"

with open("attestation.json") as f:
    env = json.load(f)

payload_type = env["payloadType"].encode()
payload = base64.b64decode(env["payload"])
sig = base64.b64decode(env["signatures"][0]["sig"])

pae = (b"DSSEv1 " + str(len(payload_type)).encode() + b" " + payload_type
       + b" " + str(len(payload)).encode() + b" " + payload)

pub_key = Ed25519PublicKey.from_public_bytes(bytes.fromhex(WISEC_PUBLIC_KEY_HEX))

try:
    pub_key.verify(sig, pae)
    print("✅ Signature valide - l'attestation est authentique")
except Exception as e:
    print(f"❌ Signature invalide : {e}")

Recoupement avec votre build

  • Le build : runDetails.metadata.invocationId est le event_hash Wisec (metadata.buildInvocationID dans les documents v0.2). Retrouvez-le sur la page de vérification publique pour confirmer que l'attestation correspond à un build certifié précis.
  • Le fichier livré, quand le sujet porte une empreinte sha256 : sha256sum <votre-fichier> doit afficher exactement cette valeur. Une valeur différente signifie que le fichier que vous détenez n'est pas celui qui a été attesté.
  • Une image de conteneur, quand le sujet porte le nom d'une image (registre/dépôt) : docker pull <image> ou crane digest <image> doit afficher la même empreinte sha256. Un build peut avoir plusieurs sujets, un par artefact.
  • La source, quand le sujet porte une empreinte gitCommit (sha1 dans les documents v0.2) : c'est votre hash de commit, à croiser avec votre VCS.
  • Le SBOM : le byproduct sbom.json est le SBOM produit par votre pipeline, à l'octet près. Comparez-le avec le fichier conservé par votre CI, pas avec le sbom.json du bundle de sécurité, que Wisec enrichit avec les vulnérabilités trouvées et dont l'empreinte est donc différente.