Skip to content
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

Added revised controls.yaml #193

Merged
merged 7 commits into from
Feb 19, 2025
Merged

Conversation

eddie-knight
Copy link
Contributor

@eddie-knight eddie-knight commented Feb 19, 2025

Preview

This applies changes aligned with the new schema being developed in coordination with our friends on the FINOS Common Cloud Controls project, to enable knowledge sharing and shared tooling over time.

Copy link
Contributor

@SecurityCRob SecurityCRob left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as discussed with Eddie

Copy link
Contributor

@funnelfiasco funnelfiasco left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm in favor with the general direction of this, but I'm nacking it so it doesn't accidentally get merged while we address

  • Updating docs
  • Updating the template
  • Updating tooling

I do think it would help to have a brief description of the conceptual changes here from what we currently have.

@eddie-knight eddie-knight marked this pull request as ready for review February 19, 2025 20:33
@eddie-knight eddie-knight marked this pull request as draft February 19, 2025 20:33
Signed-off-by: Eddie Knight <knight@linux.com>
Signed-off-by: Eddie Knight <knight@linux.com>
Signed-off-by: Eddie Knight <knight@linux.com>
Signed-off-by: Eddie Knight <knight@linux.com>
Signed-off-by: Eddie Knight <knight@linux.com>
@eddie-knight eddie-knight marked this pull request as ready for review February 19, 2025 21:40
Comment on lines 20 to 21
* DCO signoff (via `git commit -s` -- [OSPS-LE-01](https://baseline.openssf.org/#osps-le-01))
* All checks must pass ([OSPS-QA-04](https://baseline.openssf.org/#osps-qa-04))
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will need to be updated with the new ID scheme.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we hit this and the README together in a follow-up PR?

README.md Outdated
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The whole structure section will need to be updated, I think.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we update this in a follow-on PR to review the whole README?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The rendered output in your preview doesn't list e.g. OSPS-AC-01.01 under all levels, only Level 1. My understanding of why we now list each level in the yaml suggests that in the rendered version, we should controls in each of the applicable levels.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you're talking about the top overview, right? It took a bit of elbow grease, but the intent here is to only display it on the minimum level it applies to, so we don't have duplicates up top.

I don't think we ended up with any cases where something from a lower level will NOT be needed in a higher.

Do you think we need any changes here?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you're talking about the top overview, right? It took a bit of elbow grease, but the intent here is to only display it on the minimum level it applies to, so we don't have duplicates up top.

I am, but I disagree with the intent. Right now, that's the only way for a project to make a "checklist" of things that they need to do at a given level. Since we haven't done this in the past, though, I'm willing to address that in a follow-up.

Signed-off-by: Eddie Knight <knight@linux.com>
Copy link
Contributor

@funnelfiasco funnelfiasco left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If @eddie-knight promises to address the outstanding documentation issues, I'm willing to accept this. :-)

Signed-off-by: Eddie Knight <knight@linux.com>
@eddie-knight eddie-knight merged commit 05f502f into ossf:main Feb 19, 2025
2 checks passed
@eddie-knight eddie-knight deleted the feat/new-schema branch February 19, 2025 22:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants