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

Cloud Native Security Whitepaper v2 #747

Closed
21 tasks done
PushkarJ opened this issue Aug 10, 2021 · 53 comments
Closed
21 tasks done

Cloud Native Security Whitepaper v2 #747

PushkarJ opened this issue Aug 10, 2021 · 53 comments

Comments

@PushkarJ
Copy link
Collaborator

PushkarJ commented Aug 10, 2021

Working draft (RFC ends April 27): https://docs.google.com/document/d/1fftLBt3XjDzyYQisEKH3TZXL1QnT_cHIbBnFtW98UOs/edit

Description

Original security whitepaper (#138) was published in Nov 2020, about 9 months ago. It is now time to update the paper and publish v2 by Kubecon EU 2022 (by which time paper will be 18 months old) to ensure the content stays relevant and useful.

Impact

Since publication of v1, Security TAG has made a lot of progress through ongoing work on several supplementary docs, websites, audio version, maps and other papers. In general, the security understanding of cloud native environments has also evolved with growing focus on ransomware and supply chain security. We have also received feedback on the paper's content and its distribution through cloud native security survey and retrospective.

Additionally, there have been several small updates in the repo, made to the original content that have improved the readability and quality of the paper. Bringing this all together merits publishing the second version, in accordance, with original goal of keeping the content always up to date.

Scope

Several tasks are in progress and there are some that would need further work

Tasks

Meta Deliverables:

  • Decide whether audio version and translations trail written copy with n-1 cadence or do we publish it together
  • Consider renaming the whitepaper to something else based on the content
  • Consider different format of artifacts for v2 (epub, html, mobi)
  • Revisit distribution strategy so that the content reaches the intended audience i.e. end users
  • Track the citations for CNSWP v1 and add it in appendix of v2

Meta tasks:


Project Schedule

TODO Milestone Estimated time Actual date
✔️ Audience, Goals, & refining scope 1 week Nov 30 2021
✔️ Tasking Assignment 1 week Dec 7 2021
✔️ Content Rough-in 2-3 weeks Feb 28 2022
✔️ Collaborative Review 2 weeks March 15 2022
✔️ Executive Summary and content wrap up 2 weeks March 30 2022
✔️ Narrative Voice 1-2 weeks March 30 2022
✔️ Final Group Review 1 week April 6 2022
✔️ Community Review / Public comment adjudication 2-3 weeks April 27 2022
✔️ CNCF publishing engagement ~2-3 weeks May 7 2022
✔️ Addition to the repo 1 week May 15 2022
✔️ Blog post and publishing coordination 2-3 weeks May 15 2022
@PushkarJ PushkarJ added proposal common precursor to project, for discussion & scoping triage-required Requires triage labels Aug 10, 2021
@chasemp
Copy link
Contributor

chasemp commented Aug 11, 2021

Seems like a lot of great metadata and organization tie in. What's the thinking on revising the content itself? (not suggesting just asking)

Interested in helping potentially :)

@TheFoxAtWork TheFoxAtWork removed the triage-required Requires triage label Aug 11, 2021
@pratiklotia
Copy link

thanks for detailed info, Pushkar. I'm interested in contributing.

@axelsimon
Copy link
Contributor

Tagging myself as i'm interested in participating in this!

@PushkarJ
Copy link
Collaborator Author

Seems like a lot of great metadata and organization tie in. What's the thinking on revising the content itself? (not suggesting just asking)

Interested in helping potentially :)

Hey Chase, great to see you are interested to continue the work from v1. My thinking for revising the existing content itself is to update the content for brevity, remove mention of things that are deprecated in favor of new state of the art.

Additionally, would love to cross link sections in #737 to each section in the whitepaper so folks can jump to implementation details or recommendation from a requirement as part of an engaging learning experience :)

@ragashreeshekar
Copy link
Collaborator

This sounds good @PushkarJ, I'm interested to join.

@sayantani11
Copy link
Contributor

Sounds good. Interested to join.

@mayocream
Copy link
Contributor

Sounds good. Interested in contributing.

@TheFoxAtWork
Copy link
Collaborator

revisit STAG leadership rep in January

@stale
Copy link

stale bot commented Nov 2, 2021

This issue has been automatically marked as inactive because it has not had recent activity.

@stale stale bot added inactive No activity on issue/PR and removed inactive No activity on issue/PR labels Nov 2, 2021
@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Nov 2, 2021

Our friendly bot, reminded me that it is time to start working on version 2!!

I will bring this up in our weekly call tomorrow (11/03) and we can get started on this :) Excited 🎉

@lumjjb
Copy link
Collaborator

lumjjb commented Nov 2, 2021

Perfect, please remind me to bring up some of the discussions we had with NIST around ideas to augment the whitepaper !

@captainarcher
Copy link
Contributor

captainarcher commented Nov 3, 2021

I am interested in helping on this @PushkarJ

@faisalrazzak
Copy link

For the NIST SSDF mapping work, I would like to contribute as well.

@JonZeolla
Copy link
Contributor

@PushkarJ I'm interested in helping with v2

@PushkarJ PushkarJ changed the title [Proposal] Cloud Native Security Whitepaper v2 Cloud Native Security Whitepaper v2 Nov 4, 2021
@jedsalazar
Copy link

I am interested in helping with this!

@savitharaghunathan
Copy link
Member

@PushkarJ I am late to the party. Interested in helping out if you haven't maxed out on volunteers.

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Nov 4, 2021

No hard limit on contributors. So everyone is welcome!!

@sayantani11
Copy link
Contributor

Interested to help!

@sachinkumarsingh092
Copy link

Hi @PushkarJ, I'm interested in helping out with this. Just one suggestion: Can we use LaTeX for the paper instead of google docs? IMO it will produce a much better-looking and version-controlled whitepaper. WDYT?

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Dec 5, 2021

Hi All, Just added new dedicated issues that represent the deliverables for v2.

Please check the description of this parent issue for more context. The issues with "Need Owner" prefix are the ones up for grabs. If you want to work on them, please add a comment on that particular issue so one of the Tech Leads / Chairs can assign it to you! There can be more than one assignee to the same issue as long as you all can collaborate and divide the work between yourselves :)

As a reminder, we will reconvene meeting in Jan but don't let that stop you from making progress on them in an async manner. Also, its okay to make updates on a google doc or hackmd or wherever for your first draft. We will pull them all together into one place when we meet together!! Good luck and leave a comment if you have any questions.

@bredamatt
Copy link

Interested in helping out as well!

Best,
Mattia

@captainarcher
Copy link
Contributor

I can take ownership of these three:
#827
#832
#833

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Jan 7, 2022

Thank you @sayantani11 , @savitharaghunathan , @devadvocado , @faisalrazzak , @captainarcher , @mateuszpruchniak for raising your hand up to take ownership of the deliverable issues.

Let's meet up in the upcoming week Jan 12, Wed, 9-9:45 AM PT to get together and discuss your progress and plans for completing these deliverables. Bring your questions and let's have some fun at work :) . If you want to add the meeting to your calendars, please click on this link.

The meeting minutes and zoom details can be found here.

NOTE: For others who are interested to contribute you are welcome to join as we always have more to do and help each other out!

Leave a comment here or find me on CNCF slack (channel: #tag-security-whitepaper) if you have trouble joining the meeting!

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Jan 13, 2022

Thank you all for meeting today ❤️!!

Please hop on over to slack and check out the next steps

@fdegir
Copy link

fdegir commented Mar 16, 2022

I made a comment on SSF RFC doc regarding the potential benefits of generating some kind of delta report in addition to SBOM itself in order to ease the effort to identify issues as they happen and components that cause them. The reason for this is that if one has a delta report, it would limit the no of components to work with as oppose to SBOMs with potentially thousands of components while working with issues.

@lumjjb pointed this issue as a place to highlight the topic of delta report and I also found the cloud-native-security-whitepaper-v2
where page 36 looks like the potential place to talk about delta report. However, I wanted to get opinion of the community about this idea before going and commenting on the doc.

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Apr 5, 2022

@fdegir go ahead and make your updates. Correct page number though would be 34-35 under supply chain security

@fdegir
Copy link

fdegir commented Apr 6, 2022

Thanks @PushkarJ. Added a new paragraph on page 35.

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Apr 6, 2022

Whitepaper v2 is now open for Public comment. RFC stage ends April 27 2022. You can find the paper for review here: https://docs.google.com/document/d/1fftLBt3XjDzyYQisEKH3TZXL1QnT_cHIbBnFtW98UOs/edit

@jkowall
Copy link
Contributor

jkowall commented Apr 9, 2022

Left comments, rewrote parts of it, and hopefully improved it after an extensive review. Sorry, I was not aware this was being revised, I should have tried to join some calls but not enough time.

@PushkarJ
Copy link
Collaborator Author

@jkowall thank you so much for your generous updates and exhaustive read!! The paper is in better shape because of it :)

@jkowall
Copy link
Contributor

jkowall commented Apr 14, 2022

@PushkarJ my pleasure, feel free to move me to author or reviewer. I am happy to take another look anytime or add sections as needed.

@PushkarJ
Copy link
Collaborator Author

@jkowall already added you as reviewer :) We are bit late in terms of timeline to add new content/section though but please open an issue (suggestion) with what you have in mind, so we don't lose track of it and can figure out which artifact (perhaps v3 of this paper) we could incorporate it in.

@p0bailey
Copy link

Hi @PushkarJ,

Thanks for the great work, just wanted to highlight an error inside the PDF https://github.com/cncf/tag-security/blob/main/security-whitepaper/v2/CNCF_cloud-native-security-whitepaper-May2022-v2.pdf

In the PDF figure 4 is a duplication of distribute whereas figure 4 should be Deploy figure 4

Thanks,

Phillip

@PushkarJ
Copy link
Collaborator Author

@p0bailey sorry for the delayed response. You are absolutely right. The markdown seems to not have this discrepancy (anymore). So we will fix this in the next update to the PDF

@PushkarJ
Copy link
Collaborator Author

PushkarJ commented Sep 7, 2022

Closing this issue now with creation of #975 . Thank you all for the wonderful collaboration, contributions and camaraderie.

Great opportunity to lead creation and publication of the next version for existing and new contributors. More details in the linked issue and I will be happy to chat more if anyone has more questions :)

@PushkarJ PushkarJ closed this as completed Sep 7, 2022
@p0bailey
Copy link

@PushkarJ thanks for the heads up. Looking forward to downloading the updated PDF. Great work!

Phillip

@lumjjb lumjjb moved this from Projects to Completed in Roadmap 2022-2023 Feb 27, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
project work of the group Q2-2022
Projects
Development

No branches or pull requests