diff --git a/docs/operators/index.md b/docs/operators/index.md index f3d0cfb..42b731f 100644 --- a/docs/operators/index.md +++ b/docs/operators/index.md @@ -18,6 +18,12 @@ Welcome to the operators guide! Operators are typically individuals, members of [Read Handbook](handbook.md){ .md-button .md-button--primary } + - __Security Advisories__ + + Our shared collective knowledge about the latest vulnerabilities, and the most important steps to keep your deployment safe. :lock: + + [Review Advisories](security/index.md){ .md-button .md-button--primary } + Operators are encouraged to submit documentation patches! Sharing is caring :sparkling_heart: diff --git a/docs/operators/security/CCSA-20261021-01.md b/docs/operators/security/CCSA-20261021-01.md new file mode 100644 index 0000000..20d4c29 --- /dev/null +++ b/docs/operators/security/CCSA-20261021-01.md @@ -0,0 +1,102 @@ +--- +title: PHP Remote Code Execution +subtitle: CCSA-20261021-01 +--- +*Coop Cloud Security Advisory 20261021-01* + +??? danger "Recipes known to be affected >" + + | Recipe | Update Status | Notes | + | --- | --- | --- | + | [4get](https://git.coopcloud.tech/coop-cloud/4get) | Pending | 0.7.4+1.0.62 has been deployed. It's is unclear if it has [the fix](https://git.lolcat.ca/lolcat/4get/issues/99). Needs to be confirmed. | + | [akaunting](https://git.coopcloud.tech/coop-cloud/akaunting) | Unmaintained | There appears to be no owner to fix this. | + | [civicrm-backdrop](https://git.coopcloud.tech/coop-cloud/civicrm-backdrop) | Unmaintained | No updates in 2 years | + | [civicrm-wordpress](https://git.coopcloud.tech/coop-cloud/civicrm-wordpress) | Pending | No update since last year | + | [custom-php](https://git.coopcloud.tech/coop-cloud/custom-php) | Pending | | + | [dokuwiki](https://git.coopcloud.tech/coop-cloud/dokuwiki) | Pending | No update in 2 years | + | [drutopia](https://git.coopcloud.tech/coop-cloud/drutopia) | Pending | No update in 2 years | + | [engelsystem](https://git.coopcloud.tech/coop-cloud/engelsystem) | Unmaintained | This is probably unmaintained | + | [farmos](https://git.coopcloud.tech/coop-cloud/farmos) | Pending | No update in 2 years | + | [filerun](https://git.coopcloud.tech/coop-cloud/filerun) | Pending | No update in 2 years | + | [firefly-iii](https://git.coopcloud.tech/coop-cloud/firefly-iii) | Pending | | + | [firefly-iii-importer](https://git.coopcloud.tech/coop-cloud/firefly-iii-importer) | Pending | | + | [h5ai](https://git.coopcloud.tech/coop-cloud/h5ai) | Pending | | + | [hauk](https://git.coopcloud.tech/coop-cloud/hauk) | Pending | | + | [invoiceninja](https://git.coopcloud.tech/coop-cloud/invoiceninja) | Fixed ✅ | Fixed at 1.1.0+5.13 | + | [kanboard](https://git.coopcloud.tech/coop-cloud/kanboard) | Pending | | + | [kimai](https://git.coopcloud.tech/coop-cloud/kimai) | Fixed ✅ | fixed @ `1.14.1+2.70.1` | + | [lichen-markdown](https://git.coopcloud.tech/coop-cloud/lichen-markdown) | Not Affected | Lichen is uses PHP to generate static pages, and thus is not affected by the vulnerabilites. | + | [limesurvey](https://git.coopcloud.tech/coop-cloud/limesurvey) | Pending | | + | [mailu](https://git.coopcloud.tech/coop-cloud/mailu) | Fixed ✅ | There's a upstream mitigation fix in `abra app deploy foo.bar 3.2.1+2024.06.66` pending an Alpine image upgrade.| + | [matomo](https://git.coopcloud.tech/coop-cloud/matomo) | Pending | | + | [mediawiki](https://git.coopcloud.tech/coop-cloud/mediawiki) | Pending | | + | [monica](https://git.coopcloud.tech/coop-cloud/monica) | Pending | | + | [moodle](https://git.coopcloud.tech/coop-cloud/moodle) | Fixed ✅ | | + | [mrbs](https://git.coopcloud.tech/coop-cloud/mrbs) | Fixed ✅ | | + | [nextcloud](https://git.coopcloud.tech/coop-cloud/nextcloud) | Fixed ✅ | Redeploy `14.6.0+33-fpm` or `15.0.0+34.0.5-fpm` for update images, fixed in `15.0.1+34.0.5` | + | [openemr](https://git.coopcloud.tech/coop-cloud/openemr) | Pending | | + | [osticket](https://git.coopcloud.tech/coop-cloud/osticket) | Pending | | + | [phpservermon](https://git.coopcloud.tech/coop-cloud/phpservermon) | Pending | | + | [pixelfed](https://git.coopcloud.tech/coop-cloud/pixelfed) | Pending | | + | [privatebin](https://git.coopcloud.tech/coop-cloud/privatebin) | Pending | | + | [projectsend](https://git.coopcloud.tech/coop-cloud/projectsend) | Pending | | + | [rallly](https://git.coopcloud.tech/coop-cloud/rallly) | Not Affected | Rallley uses a PHP desrialization library in JavaScript. This may be identified as PHP, but it is in fact node.js | + | [renovate](https://git.coopcloud.tech/coop-cloud/renovate) | Not Affected | the image renovate/renovate:41-full from 1.0.1+41-full has the php-cli, however there don't appear to be php web components in the application. | + | [roundcube](https://git.coopcloud.tech/coop-cloud/roundcube) | Pending | | + | [selfoss](https://git.coopcloud.tech/coop-cloud/selfoss) | Pending | | + | [shlink](https://git.coopcloud.tech/coop-cloud/shlink) | Fixed ✅ | `1.0.0+5.1` | + | [wallabag](https://git.coopcloud.tech/coop-cloud/wallabag) | Pending | | + | [wordpress](https://git.coopcloud.tech/coop-cloud/wordpress) | Fixed ✅ | Redeploy `4.1.1+7.1.3` for update images | + | [wordpress-bedrock](https://git.coopcloud.tech/coop-cloud/wordpress-bedrock) | Pending | | + +## Check if your deployment is affected + +1. Review the affected recipes list above. +2. For each app, run `abra app run app -- php -v` and compare to the recommended versions: +> ==PHP 8.5.12, 8.4.27, 8.3.36 and 8.2.35== fix two critical vulnerabilities that can allow unauthenticated remote code execution. All PHP users are strongly encouraged to update immediately. +> — https://www.php.net/archive/2026.php#2026-10-21-5 + +## Mitigation + +!!! warning + Several of the upstream app updates have been released without changes in the Docker version ("tag") number — so unfortunately `abra app upgrade` might not be reliable for ensuring that these updates are applied. + + **Please follow this alternative process, to make sure that these nontraditionally-versioned updates are applied** + +Using the example of updating a Nextcloud instance, currently running `31.0.6`, on `cloud.example.com`: + +1. Undeploy the app immediately! (Hopefully you did this already 🤞): `abra app undeploy cloud.example.com` +2. Consult the table above for whether to "upgrade" or "redeploy" +3. Check your last deployed version: `abra app labels cloud.example.com` -- note the upstream app version, the part after the `+` under "Recipe labels", e.g. in `coop-cloud.cloud_example_com.version 12.0.1+31.0.6-fpm`, we're looking for `31.0.6-fpm`. +4. If you are at any version below the latest (`15.0.0+34.0.5-fpm` in our example), you need to upgrade – see subsection below. **Otherwise, if you were already on the latest version**, and the table below says "redeploy", then deploying the app should get the new version: +5. `abra app deploy cloud.example.com -n` +6. Re-run step #2 of [Checking for affected apps](#check-if-your-deployment-is-affected). + +### Applying prerequisite recipe upgrades + +1. Read recipe and upstream release notes to plan a sequence of migrations, e.g. in this case: + 1. From `12.0.1+31.0.6-fpm` to `13.2.0+32-fpm` + 2. From `13.2.0+32-fpm` to `14.6.0+33-fpm` + 3. From `14.6.0+33-fpm` to `15.0.0+34.0.5-fpm` +2. `abra app deploy cloud.example.com` +3. `abra app upgrade cloud.example.com`; choose the next version in the plan from #1 +4. Wait for the instance to become available again +5. Run `abra app run -u www-data cloud.example.com app -- php occ app:update --all` +6. Repeat steps #3-5 until all updates in the plan are applied +5. Re-run step #2 of [Checking for affected apps](#check-if-your-deployment-is-affected). + +## Automated checking with `cc-runall` + +1. Download or `git clone` the [`cc-runall` script](https://git.coopcloud.tech/toolshed/cc-scripts/src/branch/main/cc-runall) +2. Download `jq` (either through distribution repositories, or [from the same repo](https://git.coopcloud.tech/toolshed/cc-scripts/src/branch/main/bin/jq)) +3. `./cc-runall wordpress app "php -v"` + +## Forensics + +Exploiting these vulnerabilities would likely require multiple attempts. Each attempt has a good chance of crashing the worker it's executed against. This will show up in logs as 500's and 502's. + +A successful attack may not leave these traces, so abcence of evidence is not evidence of absence. However, 500 and 502 spikes are evidence of aborant behavior and attacks are one common cause of such behavior. + +## Upstream Information + +[PHP Advisory](https://www.php.net/archive/2026.php#2026-10-21-5){ .md-button } diff --git a/docs/operators/security/CCSA.md.tmpl b/docs/operators/security/CCSA.md.tmpl new file mode 100644 index 0000000..1b8f190 --- /dev/null +++ b/docs/operators/security/CCSA.md.tmpl @@ -0,0 +1,40 @@ + + + +--- +title: +subtitle: CCSA- +--- +*Coop Cloud Security Advisory + +??? danger "Recipes known to be affected >" + + | Recipe | Update Status | Notes | + | --- | --- | --- | + | [](https://git.coopcloud.tech/coop-cloud/) | | | + +## Check if your deployment is affected + +1. Review the affected recipes list above. +2. For each app, + +## Mitigation + +1. Undeploy the app immediately! (Hopefully you did this already 🤞): `abra app undeploy myapp.example.com` +2. Check your last deployed version: `abra app labels myapp.example.com`. Note the upstream app version, the part after the `+` under "Recipe labels". +3. Consult the table above for special instructions. +4. + +## Forensics + + +## Upstream Information + + +[](){ .md-button } diff --git a/docs/operators/security/index.md b/docs/operators/security/index.md new file mode 100644 index 0000000..0347964 --- /dev/null +++ b/docs/operators/security/index.md @@ -0,0 +1,26 @@ +--- +title: Security Advisories +--- + +!!! warning "Our security is a federated endeavor" + + Maintaining security in Coop Cloud deployments is a federated endeavor. Please use these advisories as a starting point, but check for outdated software versions and vulnerabilities on your own deployments, too. + + Please take your own steps to ensure your operations are protected, and reach out to us if we've missed anything! + + [Coop Cloud Security Matrix](https://matrix.to/#/#coopcloud-security:matrix.org){ .md-button .md-button--primary } + +## Advisories + +Here's what's most important to know: + + +| Advisory | Short Description | Status | +| -------- | ----------------- | ------ | +| [CCSA-20261021-01](CCSA-20261021-01.md) | PHP remote code execution | :lock: Closed | + + diff --git a/mkdocs.yml b/mkdocs.yml index 516ef1d..901bccc 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,8 +79,12 @@ nav: - "Packaging Handbook": maintainers/handbook.md - maintainers/catalogue.md - "Operators": + - operators/index.md - "New operators Tutorial": operators/tutorial.md - "Operators Handbook": operators/handbook.md + - "Security Advisories": + - operators/security/index.md + - operators/security/CCSA-20261021-01.md - "Federation": - federation/index.md - "Bylaws": federation/bylaws.md