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

Add security concepts to doc/book/security #4564

Open
StackScribe opened this issue Sep 19, 2021 · 3 comments
Open

Add security concepts to doc/book/security #4564

StackScribe opened this issue Sep 19, 2021 · 3 comments
Labels
documentation Jenkins documentation, including user and developer docs, solution pages, etc.

Comments

@StackScribe
Copy link
Contributor

StackScribe commented Sep 19, 2021

Add some conceptual and background information to the top file in the Security section:

  • Jenkins is a fully distributed build system; briefly explain the security ramifications
  • Security concepts (least privilege, know the system, defense in depth, etc)
  • Brief view of how Jenkins executes a Pipeline as background to understanding security settings and practices.
  • Pulled info about different users who control what Pipeline actually executes from controller-isolation.adoc. Note that this means that the start of controller-isolation.adoc is a bit bumpy. I plan to rewrite that in a separate PR to keep this PR from getting unwieldy but let me know if you prefer that I fix that file here.

Other existing material in this file will be moved to other files that discuss the same issue. Separate tickets filed for rewrites of other files in this section.

@StackScribe StackScribe added the documentation Jenkins documentation, including user and developer docs, solution pages, etc. label Sep 19, 2021
@daniel-beck
Copy link
Contributor

Jenkins is a fully distributed build system; briefly explain the security ramifications

https://www.jenkins.io/doc/book/security/controller-isolation/ does some of that.

@StackScribe
Copy link
Contributor Author

#4612

@StackScribe
Copy link
Contributor Author

@daniel-beck The "fully distributed build system" stuff should be in the intro to this chapter and, for a topic sentence, I like the phraseology that is there now and that came from you a couple years ago. But the material in https://www.jenkins.io/doc/book/security/controller-isolation/ adds depth; I will pull that into this introductory section so that "Controller Isolation" can just concentrate on the distributed configuration. Does that seem appropriate?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Jenkins documentation, including user and developer docs, solution pages, etc.
Projects
None yet
Development

No branches or pull requests

2 participants