O projeto está em desenvolvimento. Só a última release recebe correções de segurança.
Não abra issue pública para falha de segurança.
Use o reporte privado do GitHub: aba Security do repositório → Report a vulnerability (https://github.com/PiluTech/toolkit/security/advisories/new). Inclua:
- a versão ou o commit afetado e o SO;
- os passos para reproduzir, o resultado esperado e o obtido;
- o impacto que você enxerga (por exemplo: download sem verificação, execução de comando não declarado, escalada de privilégio, segredo no log).
O projeto é mantido por uma pessoa, então a resposta é por melhor esforço. A correção e a divulgação são combinadas com quem reportou.
Qualquer caso em que uma destas regras não se cumpra é uma vulnerabilidade:
- Nenhum download sem SHA-256. O binário (via bootstrap), apps
url, appsgithub-releasee scripts usados por receitas são conferidos antes de executar ou instalar. Sem hash conhecido, a operação é recusada, sem opção para pular.url:sha256obrigatório no catálogo.github-release:checksums.txtda release, ou odigestpublicado pelo GitHub, ousha256fixado no catálogo.- Bootstraps (
scripts/bootstrap/unix.sh,win.ps1):checksums.txtda mesma release do binário; se o hash divergir ou o binário não constar no arquivo, abortam sem instalar. Instalam só no PATH do usuário, semsudonem administrador. Ounix.shé testado com release falsa e checksums adulterados (scripts/bootstrap/unix_test.sh). - O arquivo baixado fica num diretório temporário e só é usado depois que o hash confere.
- Nenhum
curl | bashde terceiros dentro de receitas. - Extração segura: arquivos zip e tar com caminho absoluto,
..ou link simbólico para fora do destino são recusados. - Privilégio mínimo:
sudosó nos comandos que precisam e elevação no Windows só quando algo escolhido exige admin. - Logs sem segredos:
GITHUB_TOKEN, cabeçalhosAuthorizatione comandos marcados como secretos são mascarados. - Hash de pacote do winget nunca é ignorado:
--ignore-security-hashnão é usado em hipótese alguma.
A release é feita localmente (scripts/release.sh): binários estáticos dos 6 alvos, checksums.txt calculado
depois da assinatura e, no macOS, binários assinados com Developer ID e notarizados. As credenciais de
notarização (key id, issuer e a chave .p8, lida do 1Password na hora para um arquivo temporário 600
apagado ao final) nunca ficam no repositório, nem o nome da identidade de assinatura. O script só compila com a árvore limpa e a tag da versão em HEAD, e só apaga o --out se ele for um subdiretório do repositório. A criação da release no GitHub é um passo manual.
- Vulnerabilidades nos próprios gerenciadores (winget, Homebrew, apt, dnf, pacman, Flatpak) ou nos apps instalados: reporte ao projeto de origem.
- Pacotes maliciosos publicados pelo próprio dono de um repositório de origem. O hash protege contra adulteração no caminho, não contra um autor mal-intencionado. Abra uma issue comum se um app do catálogo deve sair.