Repository navigation
v3.5.0
From finding secrets to getting them rotated, and from hearing about Spillkit to seeing it work.
Added
leak planturns a scan report into a rotation checklist, most dangerous first: anything that can create resources or read data, then anything with billing attached, then anything that grants further access, then the rest, oldest first within each. Every item says where the secret is revoked, links to its section of the rotation guide and names theleak rotaterecipe where one exists. An unidentified secret right next to a known one (an AWS secret key under its key ID) is kept as its own item but rotated with its pair. Output:rotation-plan.mdwith checkboxes for the incident issue and a print-readyrotation-plan.htmlwith a TLP label. The order comes fromscripts/secret-types.txt, a catalog of gitleaks rules that a test keeps in step with the guide.leak rotaterotates an AWS access key, an Entra ID app registration secret, a Google Cloud service account key or an Azure storage account key, one step at a time: check, replace, disable, delete (renew for storage keys). Without--applyit is a dry run that prints every step with its exact command. The new secret goes from the provider's CLI straight into AWS Secrets Manager, Azure Key Vault or Google Secret Manager (--store) through a pipe: never shown, never written to disk, never in a command line; if the store refuses it, the new credential is deleted again. Disabling and deleting ask for the key ID first. Every applied step is logged with its UTC time inrotation-log.tsv.leak demobuilds a repository with a leak made for the purpose (random keys that work nowhere) and runs audit, scan, plan and a rotation dry run on it, in about a minute.- One-line install:
curl -fsSL https://github.com/aboutBilal/spillkit/releases/latest/download/install.sh | bash. It checks the release's SHA-256 and, when cosign is installed, its Sigstore signature (--require-signaturemakes that mandatory), installs under~/.localwithout root, and runs on the bash 3.2 that macOS ships. Releases now carryinstall.shand its signature. - GitLab groups in
leak audit-org:--gitlab <group>, including subgroups, withGITLAB_TOKEN(read_api) for private projects andGITLAB_URLfor self-managed GitLab. Forks and archived projects are skipped.
Changed
leak scanandleak auditnow point toleak planas the next step;leak doctoralso reports the cloud CLIsleak rotateuses and cosign.- The runbook, cheat sheet, rotation guide, README and home page show the new commands. 51 tests, up from 41.