@ferrflow/doc 7.26.11 → 7.26.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/data/benchmarks.json +689 -689
- package/docs-en/verifying-releases.md +8 -7
- package/docs-fr/verifying-releases.md +8 -7
- package/package.json +1 -1
|
@@ -20,7 +20,7 @@ Available since v5.2.
|
|
|
20
20
|
| `ferrflow-windows-arm64.zip` | `.sigstore.json` |
|
|
21
21
|
| `ferrflow-completions.tar.gz` | `.sigstore.json` |
|
|
22
22
|
| `sbom.cdx.json` | `.sigstore.json` |
|
|
23
|
-
| `ghcr.io/ferrlabs/ferrflow:
|
|
23
|
+
| `ghcr.io/ferrlabs/ferrflow:X.Y.Z` | Cosign signature in GHCR + Rekor |
|
|
24
24
|
|
|
25
25
|
All sidecars are downloadable from the GitHub Release page next to the binary.
|
|
26
26
|
|
|
@@ -41,7 +41,7 @@ gh release download "$TAG" --repo FerrLabs/FerrFlow \
|
|
|
41
41
|
# verify
|
|
42
42
|
cosign verify-blob \
|
|
43
43
|
--bundle ferrflow-linux-x64.tar.gz.sigstore.json \
|
|
44
|
-
--certificate-identity-regexp "https://github.com/FerrLabs/FerrFlow
|
|
44
|
+
--certificate-identity-regexp "^https://github.com/FerrLabs/FerrFlow/.github/workflows/publish.yml@refs/tags/" \
|
|
45
45
|
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
|
|
46
46
|
ferrflow-linux-x64.tar.gz
|
|
47
47
|
# → Verified OK
|
|
@@ -50,14 +50,14 @@ cosign verify-blob \
|
|
|
50
50
|
A passing verification means:
|
|
51
51
|
|
|
52
52
|
- The tarball bytes haven't been tampered with since the release workflow signed them.
|
|
53
|
-
- The signing identity was
|
|
53
|
+
- The signing identity was FerrFlow's release workflow, `.github/workflows/publish.yml` in `FerrLabs/FerrFlow` running on a release tag, authenticated by GitHub Actions' OIDC issuer. Another workflow in the repository cannot produce a signature that passes this check.
|
|
54
54
|
- The signature is recorded in the public Rekor log: search [search.sigstore.dev](https://search.sigstore.dev/) for the `.sig` value.
|
|
55
55
|
|
|
56
56
|
## Verifying the Docker image
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
|
-
cosign verify ghcr.io/ferrlabs/ferrflow:
|
|
60
|
-
--certificate-identity-regexp "https://github.com/FerrLabs/FerrFlow
|
|
59
|
+
cosign verify ghcr.io/ferrlabs/ferrflow:5.2.3 \
|
|
60
|
+
--certificate-identity-regexp "^https://github.com/FerrLabs/FerrFlow/.github/workflows/publish.yml@refs/tags/" \
|
|
61
61
|
--certificate-oidc-issuer https://token.actions.githubusercontent.com
|
|
62
62
|
```
|
|
63
63
|
|
|
@@ -68,7 +68,7 @@ The SBOM (`sbom.cdx.json`) is a [CycloneDX](https://cyclonedx.org/) document lis
|
|
|
68
68
|
```bash
|
|
69
69
|
cosign verify-blob \
|
|
70
70
|
--bundle sbom.cdx.json.sigstore.json \
|
|
71
|
-
--certificate-identity-regexp "https://github.com/FerrLabs/FerrFlow
|
|
71
|
+
--certificate-identity-regexp "^https://github.com/FerrLabs/FerrFlow/.github/workflows/publish.yml@refs/tags/" \
|
|
72
72
|
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
|
|
73
73
|
sbom.cdx.json
|
|
74
74
|
```
|
|
@@ -80,7 +80,8 @@ Feed the verified SBOM into your scanner of choice: Grype, Trivy, Snyk, JFrog Xr
|
|
|
80
80
|
In addition to Sigstore signatures, every release also ships a [SLSA build provenance attestation](https://slsa.dev/) generated via [`actions/attest-build-provenance`](https://github.com/actions/attest-build-provenance). It records the workflow run, the source commit SHA, and the build inputs.
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
gh attestation verify ferrflow-linux-x64.tar.gz --repo FerrLabs/FerrFlow
|
|
83
|
+
gh attestation verify ferrflow-linux-x64.tar.gz --repo FerrLabs/FerrFlow \
|
|
84
|
+
--signer-workflow FerrLabs/FerrFlow/.github/workflows/publish.yml
|
|
84
85
|
```
|
|
85
86
|
|
|
86
87
|
## What's not signed
|
|
@@ -20,7 +20,7 @@ Disponible depuis la v5.2.
|
|
|
20
20
|
| `ferrflow-windows-arm64.zip` | `.sig`, `.crt` |
|
|
21
21
|
| `ferrflow-completions.tar.gz` | `.sig`, `.crt` |
|
|
22
22
|
| `sbom.cdx.json` | `.sig`, `.crt` |
|
|
23
|
-
| `ghcr.io/ferrlabs/ferrflow:
|
|
23
|
+
| `ghcr.io/ferrlabs/ferrflow:X.Y.Z` | Signature cosign dans GHCR + Rekor |
|
|
24
24
|
|
|
25
25
|
Tous les sidecars sont téléchargeables depuis la page GitHub Release à côté du binaire.
|
|
26
26
|
|
|
@@ -41,7 +41,7 @@ gh release download "$TAG" --repo FerrLabs/FerrFlow \
|
|
|
41
41
|
# vérifier
|
|
42
42
|
cosign verify-blob \
|
|
43
43
|
--bundle ferrflow-linux-x64.tar.gz.sigstore.json \
|
|
44
|
-
--certificate-identity-regexp "https://github.com/FerrLabs/FerrFlow
|
|
44
|
+
--certificate-identity-regexp "^https://github.com/FerrLabs/FerrFlow/.github/workflows/publish.yml@refs/tags/" \
|
|
45
45
|
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
|
|
46
46
|
ferrflow-linux-x64.tar.gz
|
|
47
47
|
# → Verified OK
|
|
@@ -50,14 +50,14 @@ cosign verify-blob \
|
|
|
50
50
|
Une vérification qui passe signifie :
|
|
51
51
|
|
|
52
52
|
- Les octets du tarball n'ont pas été modifiés depuis que le workflow de release les a signés.
|
|
53
|
-
- L'identité de signature était
|
|
53
|
+
- L'identité de signature était le workflow de release de FerrFlow, `.github/workflows/publish.yml` dans `FerrLabs/FerrFlow` exécuté sur un tag de release, authentifié par l'issuer OIDC de GitHub Actions. Un autre workflow du dépôt ne peut pas produire une signature qui passe cette vérification.
|
|
54
54
|
- La signature est inscrite dans le journal public Rekor : cherchez la valeur du `.sig` sur [search.sigstore.dev](https://search.sigstore.dev/).
|
|
55
55
|
|
|
56
56
|
## Vérifier l'image Docker
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
|
-
cosign verify ghcr.io/ferrlabs/ferrflow:
|
|
60
|
-
--certificate-identity-regexp "https://github.com/FerrLabs/FerrFlow
|
|
59
|
+
cosign verify ghcr.io/ferrlabs/ferrflow:5.2.3 \
|
|
60
|
+
--certificate-identity-regexp "^https://github.com/FerrLabs/FerrFlow/.github/workflows/publish.yml@refs/tags/" \
|
|
61
61
|
--certificate-oidc-issuer https://token.actions.githubusercontent.com
|
|
62
62
|
```
|
|
63
63
|
|
|
@@ -68,7 +68,7 @@ Le SBOM (`sbom.cdx.json`) est un document [CycloneDX](https://cyclonedx.org/) li
|
|
|
68
68
|
```bash
|
|
69
69
|
cosign verify-blob \
|
|
70
70
|
--bundle sbom.cdx.json.sigstore.json \
|
|
71
|
-
--certificate-identity-regexp "https://github.com/FerrLabs/FerrFlow
|
|
71
|
+
--certificate-identity-regexp "^https://github.com/FerrLabs/FerrFlow/.github/workflows/publish.yml@refs/tags/" \
|
|
72
72
|
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
|
|
73
73
|
sbom.cdx.json
|
|
74
74
|
```
|
|
@@ -80,7 +80,8 @@ Injectez le SBOM vérifié dans votre scanner : Grype, Trivy, Snyk, JFrog Xray,
|
|
|
80
80
|
En plus des signatures Sigstore, chaque release embarque aussi une [attestation de provenance SLSA](https://slsa.dev/) générée via [`actions/attest-build-provenance`](https://github.com/actions/attest-build-provenance). Elle enregistre le run du workflow, le SHA du commit source et les inputs de build.
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
gh attestation verify ferrflow-linux-x64.tar.gz --repo FerrLabs/FerrFlow
|
|
83
|
+
gh attestation verify ferrflow-linux-x64.tar.gz --repo FerrLabs/FerrFlow \
|
|
84
|
+
--signer-workflow FerrLabs/FerrFlow/.github/workflows/publish.yml
|
|
84
85
|
```
|
|
85
86
|
|
|
86
87
|
## Ce qui n'est pas signé
|