Skip to content

Roadmap reviews #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,8 +155,8 @@ contributing guidelines, and more.
We have a new release schedule for our reviews as our roadmap now applies to the
calendar year.

- End of April 2023
- End of August 2023
- [End of April 2023](/roadmap-reviews/2023/review_1_april_23.md)
- [End of August 2023](/roadmap-reviews/2023/review_2_august_23.md)
- End of December 2023

We will use these slots to release our roadmap reviews and depending on the
Expand Down
75 changes: 75 additions & 0 deletions roadmap-reviews/2023/review_1_april_23.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# ROADMAP review (End of April '23)

This is a retrospective review for the first evaluation period of the 2023
[roadmap](/ROADMAP.md).

## Change in in-toto Governance

Though not recorded as an item in the roadmap, in-toto's biggest update in this
period was the change in governance model and the formation of the in-toto
Steering Committee (ITSC). Previously, in-toto's governance had one Consensus
Builder who oversaw the community. The new governance model was
[proposed](https://github.com/in-toto/community/pull/3) by Santiago
Torres-Arias, then the Consensus Builder for in-toto, and was approved by other
maintainers and community members along with the [ITSC
charter](https://github.com/in-toto/community/pull/4). Following this, the
in-toto community was invited to [nominate and vote on the
members](https://github.com/in-toto/community/issues/5) of the first ITSC. The
members are Santiago Torres-Arias (Purdue University), Justin Cappos (New York
University), Jack Kelly (ControlPlane), Cole Kennedy (TestifySec), and Trishank
Karthik Kuppusamy (Datadog).

## in-toto v1.0

The in-toto specification was updated with several clarifications to prepare for
its v1.0 release. In addition, the specification started a security audit
courtesy of the CNCF and OSTIF. [Some security
reports](https://github.com/in-toto/docs/security/advisories) were published for
the specification as part of this effort.

## in-toto Attestations

The [in-toto Attestation
Framework](https://github.com/in-toto/attestation/releases/tag/v1.0) reached its
v1.0 milestone. This was accompanied by a concerted effort to improve the
framework's tooling. These changes make it easier for developers to adopt
in-toto's attestations and the different vetted predicates.

## ITEs

This review period also saw several ITE updates. First, Aditya Sirish A
Yelgundhalli joined the roster of ITE editors. He joins the current ITE editors
Santiago Torres-Arias, Justin Cappos, and Trishank Karthik Kuppusamy.

The most significant ITE update is the acceptance of
[ITE-6](https://github.com/in-toto/ITE/blob/master/ITE/6/README.adoc). This was
paired with the aforementioned release of v1.0 of the in-toto Attestation
Framework.

This period also saw the introduction of
[ITE-10](https://github.com/in-toto/ITE/pull/38) that describes how in-toto
layouts must be updated to support attestations. The ITE details how in-toto's
artifact rules can be used with attestations representing different predicate
types, as well as how existing policy or expression languages can be used for
certain attribute checks that previously required complicated inspection
scripts.

## Implementations

This period was relatively quiet for in-toto's implementations. The most
significant update to in-toto's Python reference implementation added support
for DSSE, using semantics described in
[ITE-5](https://github.com/in-toto/ITE/blob/master/ITE/5/README.adoc). in-toto's
Go implementation received support for the Provenance format defined in SLSA v1,
with work underway to merge efforts with the in-toto Attestation Framework's
tooling for the predicate.

Apart from these updates, in-toto's Python and Go implementations also started a
security audit alongside the in-toto specification.

## Community

The in-toto community continued to grow, spurred on by the new governance model
and events like KubeCon + CloudNativeCon EU. As always, we're excited to see
in-toto develop with participation from community members from a variety of
backgrounds, open source, academia, and industry.
49 changes: 49 additions & 0 deletions roadmap-reviews/2023/review_2_august_23.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# ROADMAP review (End of August '23)

This is the second review of the in-toto [roadmap](/ROADMAP.md) for 2023.

## in-toto v1.0

During this period, the in-toto specification reached the v1.0 milestone. The
v1.0 specification adheres to or recommends (as appropriate) ITEs 1, 2, 3, 4,
and 5. Future versions of the specification are expected to incorporate the
ITE-6 and above, i.e., the Attestation Framework and more.

## ITEs

The ITE-10 proposal was split into two ITEs,
[10](https://github.com/in-toto/ITE/blob/master/ITE/10/README.adoc) and
[11](https://github.com/in-toto/ITE/pull/50). The new ITE-10 focuses exclusively
on how the in-toto layouts can use existing semantics like artifact rules with
attestations. The ITE was accepted as a draft.

ITE-11, on the other hand, describes the use of expression languages like Common
Expression Language (CEL) for attribute checks in layouts. With ITE-11, in-toto
adopters can stop relying on complicated inspection scripts for relatively
simple checks, instead defining such checks within the layout itself. Both
ITE-10 and ITE-11 are being actively prototyped ahead of their adoption in
in-toto implementations.

## Implementations

Following the conclusion of the in-toto security audit, the in-toto Python
implementation received several updates including a breaking change that led to
the release of [v2.0.0](https://github.com/in-toto/in-toto/releases/tag/v2.0.0).
The implementation also published two [security
advisories](https://github.com/in-toto/in-toto/security/advisories) with one
CVE. These were accompanied by a detailed
[blog post](https://in-toto.io/security-audit-23/) describing the outcome of the
audit with all the findings.

The audit unearthed no issues with in-toto's Go implementation. That said, the
implementation received other updates such as experimental support for DSSE,
introduced via
[ITE-5](https://github.com/in-toto/ITE/blob/master/ITE/5/README.adoc).

## Graduation

Following various milestones such as v1.0 releases and the completion of the
security audit, the in-toto Steering Committee decided it was time to apply for
graduation at the CNCF. This proposal is [currently
open](https://github.com/cncf/toc/pull/1162) pending further action from the
CNCF TOC.