CodeQL runner: Command-line options that make GitHub access tokens visible to other processes are now deprecated

Summary

Github's CodeQL action is provided to run CodeQL-based code scanning on non-GitHub CI/CD systems and requires a GitHub access token to connect to a GitHub repository. The runner and its documentation previously suggested passing the GitHub token as a command-line parameter to the process instead of reading it from a file, standard input, or an environment variable. This approach made the token visible to other processes on the same machine, for example in the output of the ps command. If the CI system publicly exposes the output of ps, for example by logging the output, then the GitHub access token can be exposed beyond the scope intended. Users of the CodeQL runner on 3rd-party systems, who are passing a GitHub token via the --github-auth flag, are affected. This applies to both GitHub.com and GitHub Enterprise users. Users of the CodeQL Action on GitHub Actions are not affected. The --github-auth flag is now considered insecure and deprecated. The undocumented --external-repository-token flag has been removed. To securely provide a GitHub access token to the CodeQL runner, users should do one of the following instead: Use the --github-auth-stdin flag and pass the token on the command line via standard input OR set the GITHUB_TOKEN environment variable to contain the token, then call the command without passing in the token. The old flag remains present for backwards compatibility with existing workflows. If the user tries to specify an access token using the --github-auth flag, there is a deprecation warning printed to the terminal that directs the user to one of the above options. All CodeQL runner releases codeql-bundle-20210304 onwards contain the patches. We recommend updating to a recent version of the CodeQL runner, storing a token in your CI system's secret storage mechanism, and passing the token to the CodeQL runner using --github-auth-stdin or the GITHUB_TOKEN environment variable. If still using the old flag, ensure that process output, such as from ps, is not persisted in CI logs.

Refferences