`OCIRepository`/cosign verification: support TSA-only trusted roots (no transparency log) for private Sigstore instances like GitHub Artifact Attestations
维护者通常 1 天内回复
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 68/100
- Issue 类型
- 功能
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- go
调研方向
Start with internal/oci/cosign/cosign.go and NewCosignVerifier, then locate OCIRepositoryVerification and its trusted-root handling. Verify the proposed explicit TSA-only option accepts roots with no tlogs while preserving certificate identity checks, and run or extend the repository’s existing verification coverage to confirm both successful and rejected identities.
由索引模型根据 Issue 内容生成。
描述
(generated with claude sonnet 5)
Summary
OCIRepository.spec.verify.trustedRootSecretRef currently requires the supplied trusted_root.json to contain at least one transparency-log (Rekor) entry, and the underlying verification also requires at least one Certificate Transparency SCT on the signing certificate. Both requirements are hard-coded with no way to opt out via the CRD, even though the sigstore/cosign library that Flux already depends on fully supports skipping both checks in favor of RFC 3161 timestamp-only verification (CheckOpts.IgnoreTlog + CheckOpts.UseSignedTimestamps + CheckOpts.IgnoreSCT, exposed on the cosign CLI as --insecure-ignore-tlog --use-signed-timestamps --insecure-ignore-sct).
This makes it impossible to verify artifacts signed by private/enterprise Sigstore instances that don't operate a public transparency log or CT log by design — for example, GitHub's private Sigstore instance used for Artifact Attestations on private/internal repositories. GitHub explicitly does not log these to any transparency log (that's the entire point of the private instance — avoiding leaking private repo/workflow metadata into a public, permanent record), and substitutes an embedded RFC 3161 timestamp instead.
Current behavior
internal/oci/cosign/cosign.go, NewCosignVerifier:
rekorURL, err := rekorURLFromTrustedRoot(customRoot)
if err != nil {
return nil, fmt.Errorf("unable to extract Rekor URL from trusted root: %w", err)
}
If the supplied trusted root has zero tlogs entries, verifier construction fails outright before any signature/attestation checking is attempted.
Separately, even once past that, verification of a bundle with no CT-logged certificate fails with:
failed to verify signed certificate timestamp: only able to verify 0 SCT entries; unable to meet threshold of 1
Reproduction
- Sign/attest an OCI artifact using a private Sigstore instance whose trusted root has no transparency log (e.g.
gh attestation trusted-root's private-instance entry has"tlogs": []and relies solely ontimestampAuthorities). - Configure an
OCIRepositorywithverify.provider: cosign,verify.trustedRootSecretRefpointing at that trusted root, noverify.secretRef. - Reconciliation fails at verifier construction (
unable to extract Rekor URL from trusted root: no transparency log entries found in trusted root), before any signature is even checked.
Proposed solution
Add an explicit opt-in to OCIRepositoryVerification (naming to match cosign's own CLI convention), e.g.:
verify:
provider: cosign
trustedRootSecretRef:
name: private-sigstore-trusted-root
trustedInfrastructure: true # new field
When set, NewCosignVerifier skips rekorURLFromTrustedRoot/newRekorClient entirely and instead sets:
checkOpts.IgnoreTlog = true
checkOpts.UseSignedTimestamps = true
checkOpts.IgnoreSCT = true
This mirrors cosign's own --private-infrastructure / --insecure-ignore-tlog --use-signed-timestamps --insecure-ignore-sct combination almost exactly, and requires no changes elsewhere — the RFC 3161 timestamp and TSA cert chain needed for verification already flow through the same checkOpts.TrustedMaterial built from the supplied trusted root.
Evidence this works
I prototyped this exact change against a local fluxcd/source-controller checkout (pinned sigstore/cosign/v3 v3.0.6) and verified it end-to-end against a real OCI artifact carrying a real actions/attest@v4-produced Sigstore v3 bundle attestation (discovered via cosign.GetBundles/cosign.VerifyImageAttestations, so this also confirms Flux's existing bundle-discovery path already picks up actions/attest-produced attestations with no other changes needed):
- Correct
matchOIDCIdentity→ verification succeeds. - Deliberately wrong identity → verification fails closed with a clear certificate-identity-mismatch error, confirming this doesn't weaken identity-based access control, only the transparency-log/CT-log requirement.
Alternatives considered
- Inferring "TSA-only mode" automatically whenever the supplied trusted root has zero tlogs, rather than an explicit field. I'd lean against this for a real PR — it could silently downgrade security if a trusted root ends up empty due to misconfiguration rather than intentional design, whereas an explicit opt-in makes the tradeoff visible in the
OCIRepositoryspec itself.
Offer
Happy to open a PR for this if the approach (explicit opt-in field, mirroring cosign's own --private-infrastructure naming) sounds reasonable to maintainers.
- 主要语言
- Go
- 星标
- 285
- 派生
- 259
- 平均合并
- 2 天 14 小时
- 30 天内合并 PR
- 16
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
fluxcd/source-controller 的其他 Issue
-
OCIRepository: pick the Helm chart layer automatically when the first layer is a provenance file未关闭
难度 2/5 1-3 小时 新手友好度 78/100
fluxcd/source-controller#2198 ·
维护者通常 1 天内回复
-
Improve documentation on debugging the controller locally可能重新可做 @Bryandero98 于 36 天前认领,目前没有进行中的 PR。 未关闭area/docs good first issue help wanted
难度 2/5 1-3 小时 新手友好度 82/100
fluxcd/source-controller#666 · 2 条评论 ·
维护者通常 1 天内回复
-
area/oci enhancement
难度 5/5 一周以上 新手友好度 35/100
fluxcd/source-controller#2180 ·
维护者通常 1 天内回复
-
难度 4/5 3-5 天 新手友好度 45/100
fluxcd/source-controller#2150 ·
维护者通常 1 天内回复
-
GitRepository `.spec.ref.commit` + `.spec.ref.branch` does not shallow clone, contrary to the docs未关闭
难度 5/5 一周以上 新手友好度 42/100
fluxcd/source-controller#2146 · 2 条评论 ·
维护者通常 1 天内回复
查看 fluxcd/source-controller 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 63/100
维护者通常 1 天内回复
-
[Bug]: APIGW request ID headers are inconsistent between server and client可能已有人在做 @zouxingyuks 今天认领。 未关闭product/backlog
难度 2/5 1-3 小时 新手友好度 74/100
TencentBlueKing/bk-nodemgr#3782 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 91/100
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 84/100
praetorianer777/Dynamo#53 ·
维护者通常 1 天内回复
-
internal test setup
难度 2/5 1-3 小时 新手友好度 76/100
SAP/terraform-provider-scc#430 ·