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

(MODULES-8491) Warn about install_options secrets #147

Merged
merged 1 commit into from
Feb 27, 2019
Merged

(MODULES-8491) Warn about install_options secrets #147

merged 1 commit into from
Feb 27, 2019

Conversation

michaeltlombardi
Copy link

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 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_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.

@ferventcoder
Copy link

@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 Show resolved Hide resolved
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`
Copy link

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

Copy link
Author

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.

@michaeltlombardi
Copy link
Author

@ferventcoder altered wording in commit from 'guaranteed' to 'likely' - do you have info on automatic redacting I can point to?

@michaeltlombardi michaeltlombardi marked this pull request as ready for review February 27, 2019 17:03
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.
@RandomNoun7 RandomNoun7 merged commit c875d20 into puppetlabs:master Feb 27, 2019
@michaeltlombardi michaeltlombardi deleted the ticket/masterMODULES-8491 branch February 27, 2019 17:27
chelnak added a commit that referenced this pull request May 12, 2022
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.
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.

5 participants