-
Notifications
You must be signed in to change notification settings - Fork 68
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
(MODULES-8491) Warn about install_options secrets
#147
(MODULES-8491) Warn about install_options secrets
#147
Conversation
|
@michaeltlombardi it's not a guarantee they will leak - there is some redaction of the arguments passed in. If it is detected they have secrets choco will not show those items. |
README.md
Outdated
| @@ -594,6 +594,16 @@ This is the **only** place in Puppet where backslash separators should be used. | |||
| Note that backslashes in double-quoted strings *must* be double-escaped and | |||
| backslashes in single-quoted strings *may* be double-escaped. | |||
|
|
|||
| > **Note on Secrets in `install_options` | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This shouldn't be a markdown quote. Note should have ** before and after
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Changed to **WARNING** about... and dropped block quotes.
|
@ferventcoder altered wording in commit from 'guaranteed' to 'likely' - do you have info on automatic redacting I can point to? |
This commit adds a warning note to the package parameter documentation on `install_options`, clarifying that it is _possible_ that secrets will leak during a debug run and **likely** that they will leak to the Chocolatey log on the machine in any case. The warning further advises users who need to use a secret in their `install_options` to do the following: 1. Never run in debug mode with production credentials. 2. Acquire a C4B license and use the `--package-parameters-sensitive` flag to redact the values from the Chocolatey log.
Prior to this commit, there was no guidance in the README that warned users about the risks of passing secrets via install_options. It looks like it existed at some point in the past but was removed when we migrated to an automatically generated REFERENCE.md. This commit adds the original warning back in to the README that was introduced in GH-147.
This commit adds a warning note to the package parameter documentation
on
install_options, clarifying that it is possible that secretswill leak during a debug run and guaranteed that they will leak
to the Chocolatey log on the machine in any case.
The warning further advises users who need to use a secret in their
install_optionsto do the following:--package-parameters-sensitiveflag to redact the values from the Chocolatey log.