@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.
@@ -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:vX.Y.Z` | Cosign signature in GHCR + Rekor |
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 a workflow running in `FerrLabs/FerrFlow` triggered by GitHub Actions' OIDC issuer.
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:v5.2.3 \
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:vX.Y.Z` | Signature cosign dans GHCR + Rekor |
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 un workflow exécuté dans `FerrLabs/FerrFlow` déclenché par l'issuer OIDC de GitHub Actions.
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:v5.2.3 \
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é
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ferrflow/doc",
3
- "version": "7.26.11",
3
+ "version": "7.26.13",
4
4
  "description": "Documentation for FerrFlow, the universal semantic versioning CLI. Rendered at ferrflow.com/docs.",
5
5
  "license": "MIT",
6
6
  "repository": {