- Release files get a SHA256SUMS file and a Sigstore-signed build provenance attestation (gh attestation verify). - The workflows read the repo only. A new release job, which runs no build tools, is the only one that can write: it uploads the files with gh and pushes the version bump. The third-party release actions are gone. - Every action is pinned to a commit SHA, esptool and the libraries to exact versions. The release tag reaches the shell through env, and set_version.sh rejects tags that aren't versions. - New workflows: CodeQL (C++ via the native build, JS, Python, Actions), OpenSSF Scorecard, zizmor. Dependabot moves the action pins. - SECURITY.md: private reporting, checking a download. README badges. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.9 KiB
Security
Reporting a vulnerability
Please don't open a public issue. Report it privately through GitHub's vulnerability reporting and give the firmware version, the board, and the steps to reproduce it.
Fixes go into the latest release only, so check that the problem is still there in it.
The Home Assistant integration has its own repo and its own reporting page.
What the device protects against
The device is meant for a local network. In the Secured mode every route and the socket need a login. The threat model, what is in scope and what isn't, is in docs/SECURITY_PLAN.md and ADR 0006. Don't expose the device to the internet.
Checking a download
Each release file (.bin, .zip) comes with a signed attestation that this repo's build workflow built it from the release's commit. Check one with the GitHub CLI:
gh attestation verify SomfyController.ino.esp32.bin --repo cjkas/ESPSomfy-RTS
Or compare the checksums with the release's SHA256SUMS file:
sha256sum --check --ignore-missing SHA256SUMS
Releases before 4.0.2 have neither.
How the build is kept clean
- Every action in the workflows is pinned to a commit, and libraries to exact versions. Dependabot proposes action updates after a week's cooldown.
- The workflows can only read the repo by default. Only the release job can write, and it runs no build tools.
- CodeQL scans the C++, the web UI, the Python scripts and the workflows on every PR. zizmor lints the workflows, and OpenSSF Scorecard rates the repo's practices. Findings are on the repo's Security tab.