Repository navigation
docs(security): document stored asset CSP for 6.6 - #2616
Draft
Jonas Elfering (keulinho) wants to merge 6 commits into
Draft
Jonas Elfering (keulinho) wants to merge 6 commits into
Jonas Elfering (keulinho) wants to merge 6 commits into
Conversation
Developer Docs healthcheckStatus: Completed with |
3 of 5 tasks
Jonas Elfering (keulinho)
requested review from
Jens (jenskueper),
Niklas Dzösch (ndzoesch),
Soner (shyim) and
l.tepner (sw54904)
October 15, 2026 11:32
l.tepner (sw54904)
approved these changes
Oct 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
PageRefreferences where relevant.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.