Skip to content

Commit 78fdf20

Browse files
committed
Index hosted attestations: Add optional timestamps
Sigstore public good instance is transitioning to Rekor v2 transparency log: This log no longer includes integrated time in the log entries and external timestamps are then needed.
1 parent bdda06f commit 78fdf20

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

source/specifications/index-hosted-attestations.rst

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,13 @@ object is provided as pseudocode below.
8585
and certificate.
8686
"""
8787
88+
timestamps: list[bytes] | None
89+
"""
90+
Optional list of base64 encoded RFC3161 timestamp responses. Timestamps
91+
are optional if `transparency_entries` only contains entries with an
92+
integrated_time.
93+
"""
94+
8895
A full data model for each object in ``transparency_entries`` is provided in
8996
:ref:`appendix`. Attestation objects **SHOULD** include one or more
9097
transparency log entries, and **MAY** include additional keys for other
@@ -285,7 +292,9 @@ In addition to the above required steps, a verifier **MAY** additionally verify
285292
``verification_material.transparency_entries`` on a policy basis, e.g. requiring
286293
at least one transparency log entry or a threshold of entries. When verifying
287294
transparency entries, the verifier **MUST** confirm that the inclusion time for
288-
each entry lies within the signing certificate's validity period.
295+
each entry lies within the signing certificate's validity period: Inclusion time
296+
is either embedded in the entry (``integrated_time``) or provided as RFC3161
297+
timestamp in ``verification_material.timestamps``.
289298

290299
.. _appendix:
291300

0 commit comments

Comments
 (0)