Skip to content

docs(security): document stored asset CSP for 6.6 - #2616

Draft
Jonas Elfering (keulinho) wants to merge 6 commits into
v6.6from
codex/static-html-svg-csp-v6.6
Draft

Jonas Elfering (keulinho) wants to merge 6 commits into
v6.6from
codex/static-html-svg-csp-v6.6

Conversation

@keulinho

@keulinho Jonas Elfering (keulinho) commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Document stored-asset CSP protection for Shopware 6.6. Update the Apache, Nginx and Caddy examples for stored HTML and SVG. Application-rendered pages and bundled HTML applications retain their existing behavior. Preserve version-specific installer and recovery routing.

Add XSS on stored assets to the security reference, linking to the webserver and reverse-cache guidance. Explain that a dedicated CDN serving assets from a different CDN URL needs manual response-header configuration. Reverse proxies must preserve the origin CSP, including cached responses; Shopware's default Fastly and Varnish configurations already do so. Existing webserver configurations must be updated and deployed. The reverse-cache guide remains unchanged; no VCL snippets or new proxy policies are documented.

Related links

Checklist

  • I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
  • No pages were moved, renamed, or deleted; no redirects are needed.
  • Spelling checks pass without wordlist additions.
  • Any required dependent changes in downstream modules have already been merged and published.
  • This pull request is ready for review.

Notes

Markdown lint passes for the server examples using the current docs configuration; spelling and link checks pass for the security reference. The Apache example places the policy directly in its existing virtual-host block and is identical to the current-docs version, which passes Apache syntax validation and 12 HTTP cases with a fixture PHP front controller. Missing HTML media also retains the application's policy. Earlier validation of the unchanged 6.6 Nginx config block passed native syntax validation and 13 HTTP cases; the Caddy config block matches the validated current-docs example. Origin CSP propagation was verified against the existing Varnish configs and adapted Fastly snippets locally. No full documentation-site build or live Fastly validation was performed. Keep this draft until the linked webserver configuration changes are available. The closed 6.4 and 6.5 documentation PRs remain closed.

@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with failure.
Repository: shopware/docs
Commit: 16555fd
Preview: No Vercel preview URL was found in the workflow logs.
Workflow run: #5660

@keulinho Jonas Elfering (keulinho) changed the title docs(hosting): align static asset CSP on 6.6 docs(security): document stored asset CSP for 6.6 Oct 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants