Skip to content

Commit 457f84c

Browse files
Update security-plugin.md
1 parent 6381efe commit 457f84c

1 file changed

Lines changed: 17 additions & 3 deletions

File tree

guides/hosting/installation-updates/security-plugin.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,23 @@ bin/console cache:clear
4343

4444
After installing a plugin update, clear the cache again so newly added fixes are loaded.
4545

46+
::: warning
47+
Installing or updating the plugin does **not** update Shopware's Composer dependencies. If `composer.lock` still pins an outdated version of Shopware or a bundled library such as Symfony or Twig, the installation stays vulnerable even with the plugin active.
48+
49+
After installing or updating the plugin, check for and apply dependency updates in the environment where your project is built, then deploy:
50+
51+
```bash
52+
composer audit
53+
composer update <package-name> --with-all-dependencies
54+
bin/console cache:clear
55+
```
56+
57+
Update only the packages the audit reports rather than running a blanket `composer update`. See [Third-party dependencies](#third-party-dependencies).
58+
:::
59+
4660
## How fixes work
4761

48-
Every fix in the plugin corresponds to a published security advisory and is identified by its GHSA id — the [GitHub Security Advisory](https://docs.github.com/en/code-security/security-advisories) identifier under which the vulnerability is published, for example [`GHSA-9v5m-39wh-5chq`](https://github.com/shopware/shopware/security/advisories/GHSA-9v5m-39wh-5chq). All applicable fixes are active by default once the plugin is activated.
62+
Every fix in the plugin corresponds to a published security advisory and is identified by its GHSA id — the [GitHub Security Advisory](https://docs.github.com/en/code-security/security-advisories) identifier under which the vulnerability is published, for example [`GHSA-9v5m-39wh-5chq`](https://github.com/shopware/shopware/security/advisories/GHSA-9v5m-39wh-5chq). You can browse all published Shopware advisories on the [Shopware security advisories page](https://github.com/shopware/shopware/security/advisories). All applicable fixes are active by default once the plugin is activated.
4963

5064
You can review and manage the fixes under *Settings > Extensions > Security Plugin* in the Administration. For each fix, the page shows a short description and a link to the official advisory with the technical details and severity.
5165

@@ -86,9 +100,9 @@ The one-click button writes to the `composer.json` of the application server tha
86100

87101
## Third-party dependencies
88102

89-
The Security Plugin only fixes issues in Shopware's own code. It does **not** backport fixes for the third-party libraries your installation depends on. Symfony above all, but also Twig and others, are direct dependencies of Shopware itself and publish their own security advisories. When such a library is affected, the fix lives in the dependency and reaches your installation only through a Composer update (see below), or through a Shopware update that requires the patched version.
103+
The Security Plugin only fixes issues in Shopware's own code. It does **not** backport fixes for the third-party libraries your installation depends on. We recommend checking [Symfony security advisories](https://symfony.com/blog/category/security-advisories), [Twig security advisories](https://github.com/twigphp/Twig/security/advisories), and similar resources for other direct dependencies of Shopware. When such a library is affected, the fix lives in the dependency and reaches your installation only through a Composer update (see below), or through a Shopware update that requires the patched version.
90104

91-
The *Settings > Extensions > Security Plugin* page page includes a dependency check that compares all installed Composer packages against the public advisory database of [packagist.org](https://packagist.org) and lists known vulnerabilities, similar to running `composer audit` on the server.
105+
The *Settings > Extensions > Security Plugin* page includes a dependency check that compares all installed Composer packages against the public advisory database of [packagist.org](https://packagist.org) and lists known vulnerabilities, similar to running `composer audit` on the server.
92106

93107
For this check, the names and versions of your installed packages are transmitted to packagist.org; the result is cached for one hour. Advisories that are excluded through the `advisories` policy in `composer.json` described above are not reported again.
94108

0 commit comments

Comments
 (0)