Repository navigation
v1.2.0
v1.2.0
Security hardening release. Adds full SSRF protection, Chromium sandbox,
non-root containers, strict CSP, signed images, and SBOMs.
Highlights
- SSRF hardening — All outbound HTTP from analysis handlers now goes
throughsafeFetch, which validates the URL protocol, resolves DNS,
rejects private/internal IPs (RFC1918, CGNAT, link-local, loopback,
multicast, IPv6 ULA, IPv4-mapped, cloud metadata 169.254.169.254),
pins the connection to the validated IP to defeat DNS rebinding, and
re-validates every redirect target. SetRECON_ALLOW_PRIVATE_IPS=1
to opt out for local testing. - Chromium sandbox — The screenshot handler no longer launches
Chromium with--no-sandbox. The container needscap_add: SYS_ADMINsecurity_opt: seccomp=unconfinedfor the user-namespace sandbox to
initialize. Application-layer SSRF guard remains the primary defense.
- Non-root containers —
api,web, andcliimages all run as
non-root (UID 10001 for api/cli, UID 101 nginx for web). Read-only
rootfs,cap_drop: ALL,no-new-privileges. Web nginx now listens on
8080 (unprivileged) and the compose port mapping is updated. - Strict CSP + security headers —
Content-Security-Policy,
X-Frame-Options: DENY,X-Content-Type-Options: nosniff,
Referrer-Policy: strict-origin-when-cross-origin,Permissions-Policy
baked into the nginx config. HSTS opt-in viaHSTS_HEADERenv. - Signed images — Release images are signed with cosign keyless OIDC
via GitHub Actions identity. Verify with
cosign verify --certificate-identity-regexp 'https://github.com/BrunoAFK/recon-web' --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' ghcr.io/brunoafk/recon-web/api:v1.2.0. - SBOM — Each release image now has an SPDX-JSON SBOM attached to
the GitHub release artifacts.
Breaking changes
- CORS default is now
false(was*). To allow cross-origin
browser access, setAPI_CORS_ORIGIN=https://your.app(comma-separated
for multiple origins). - Web container listens on 8080 internally (was 80). The compose
file is updated; if you wrote your own deployment, update the upstream
port mapping. - Helm chart removed. It was unmaintained and not production-hardened.
Use Docker Compose for production. K8s users can write a fresh chart
against the v1.2.0 images. - Chromium screenshot requires elevated container privileges
(SYS_ADMIN+seccomp=unconfined). The compose file already sets
these. If you run the api container outside compose, you must add
these flags or screenshots will fail with a sandbox error.
Bug fixes
- Default rate limit raised from 100 / 10 minutes (effectively no
per-burst protection) to 200 / 1 minute. Per-route auth limits are
added by downstream overlays. isPrivateIPnow correctly handles IPv4-mapped IPv6 addresses, IPv6
ULAs, link-local, multicast, and CGNAT — previously it missed all of
these.
CI/CD
- New
id-token: writepermission for cosign OIDC. - New cosign install + sign step in the
docker-pushjob for all three
images on every release. - New syft SBOM generation + GitHub release artifact attach.
Docker images
docker pull ghcr.io/brunoafk/recon-web/api:v1.2.0
docker pull ghcr.io/brunoafk/recon-web/web:v1.2.0
docker pull ghcr.io/brunoafk/recon-web/cli:v1.2.0Verify signatures:
cosign verify \
--certificate-identity-regexp 'https://github.com/BrunoAFK/recon-web/.github/workflows/ci.yml@.*' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
ghcr.io/brunoafk/recon-web/api:v1.2.0