Repository navigation
WAMF v0.4.3 Security Maintenance Release
WAMF v0.4.3 is a security maintenance release addressing embedded navigation URL validation and strengthening automated security regression testing.
This release incorporates the security fixes merged through PR #4 and the release preparation changes merged through PR #5.
It retains Python 3.11, the CPU TFLite classifier, existing application dependency pins and AMD64 deployment scope.
Changes
Security: Embedded Navigation (CodeQL #15)
Improved embedded navigation security by parsing link destinations using the browser's URL API and restricting permitted schemes to HTTP and HTTPS.
Unsafe or malformed destinations are rejected to prevent native clicks from executing potentially malicious URLs.
The fix preserves:
- Relative and internal navigation links.
- Fragment navigation.
- External HTTP/HTTPS links.
- Home Assistant
embed=hanavigation.
Security Regression Testing
Expanded automated regression coverage for:
- Permitted and rejected URL formats.
- Daily-summary and date navigation.
- Login redirects.
- Embedded navigation.
- Browser history behaviour.
Chromium CI Reliability
Updated browser testing to install the pinned Playwright 1.63.0 Chromium headless shell.
Affected command-line browser tests now prefer the headless shell, improving CI reliability while preserving existing security assertions and timeouts.
Test HTML Parsing (CodeQL #16–#18)
Replaced regex-based HTML extraction in security tests with Python's standard-library HTMLParser.
Additional tests cover tag and attribute case variations, HTML comments, quoted delimiters and preservation of inline JavaScript.
Upgrade Guidance
Stop WAMF cleanly before upgrading.
Back up configuration, database and media together, and retain the previous image or checkout for rollback.
Preserve existing:
- Volume mounts and storage paths.
- Network ports.
- Credentials.
- Session secrets.
No configuration, database or media migration is introduced in v0.4.3.
The local-build Docker Compose example uses:
wamf:0.4.3
The published container image is:
ghcr.io/wamf-project/wamf:0.4.3
For reproducible deployments, use the explicit version tag rather than relying on latest.
Refer to the repository's Docker testing and upgrade documentation for detailed instructions.
Retained Security Risks
The release security review on 28 October 2026 found no open GitHub CodeQL, Dependabot or secret-scanning alerts.
CodeQL alert #15 is closed.
This does not establish that WAMF or its dependencies are vulnerability-free.
Protobuf 3.20.3
Two known vulnerabilities remain:
These vulnerabilities are documented and their GitHub alerts have been dismissed as accepted risks, not patched.
TFLite Support 0.4.4 requires protobuf <4, preventing an isolated upgrade to the patched protobuf versions while retaining the existing dependency stack.
The existing compatibility-risk decision remains applicable.
Packaging and Setup Security
Previously documented packaging-tool and setup-token operational limitations remain.
Deployments should:
- Restrict access to startup logs.
- Disable setup request-body capture.
- Use HTTPS or a trusted tunnel for remote setup.
Runtime and Platform Limitations
Existing root-container, Flask runtime, Debian and native-library limitations remain.
The successful release validation does not establish that all underlying dependencies are free from vulnerabilities.
Validation
Automated Tests
The full Python 3.11 test suite completed successfully:
1,860 passed, 0 skipped
All release PR and post-merge pytest and CodeQL checks passed.
Version metadata was verified for consistency, and application dependency declarations remain unchanged.
Docker Image Validation
The v0.4.3 Linux/AMD64 release candidate was successfully built and tested in an isolated environment.
Validation confirmed:
- OCI image label reports version
0.4.3. - Runtime, administration interface and health API report version
0.4.3. - Web interface responds with HTTP 200.
- Authenticated health endpoint responds with HTTP 200.
- Unauthenticated health access correctly returns HTTP 401.
- Database and archive storage health checks pass.
- No unexpected startup errors occur.
The isolated smoke test did not exercise live Frigate or MQTT connectivity.
Temporary test resources were removed after validation, with existing containers, images, volumes and repository files preserved.
A separate v0.4.3 image-security scan has not been established by this validation.
Publication
Release tag: v0.4.3
Source commit: eb6d298
The tag-triggered Docker publishing workflow completed successfully.
The manual publishing workflow remains intentionally pinned to the historical v0.4.2 source and must not be used for v0.4.3 publication.
WAMF v0.4.3 is a security-focused maintenance release.
It introduces no new application features, configuration migrations or dependency upgrades.
Development of WAMF v0.5.0 Kingfisher continues separately.