Track vulnerabilities like this one.
Sign up free to get alerted when software you use is affected.
TYPO3 PharStreamWrapper Can Be Bypassed
published 2 years ago
Summary
A security risk exists in the PharStreamWrapper, a tool used to protect against certain types of attacks. If an attacker can manipulate how the wrapper handles exceptions, they may be able to bypass its protections and potentially access sensitive data. To mitigate this risk, developers should review their custom applications and ensure they properly return to the original operating sequence of the PharStreamWrapper.
What to do
- Update typo3 phar-stream-wrapper to version 2.0.1.
- Update typo3 phar-stream-wrapper to version 3.0.1.
Affected software
| Ecosystem | Vendor | Product | Affected versions |
|---|---|---|---|
| composer | typo3 | phar-stream-wrapper |
>= 1.0.0, < 2.0.1 >= 3.0.0, < 3.0.1 Fix: upgrade to 2.0.1
|
Original advisory text
By-passing Protection of PharStreamWrapper Interceptor
Insecure deserialization is a vulnerability which occurs when untrusted data is used to abuse the logic of an application. In July 2018, the vulnerability of insecure deserialization when executing Phar archives was addressed by removing the known attack vector in the TYPO3 core. For more details read the corresponding TYPO3 advisory.
In addition, a new interceptor was introduced to protect possible (but unknown) vulnerabilities in 3rd party components like TYPO3 extensions. Basically, the PharStreamWrapper intercepts direct invocations of Phar archives and allows or denies further processing based on individual rules.
Recently, the PharStreamWrapper was extracted from the TYPO3 core and released as standalone package under the MIT license. It is now available for any PHP driven project.
The stream wrapper overwrites the existing Phar handling of PHP, applies its own assertions and then restores the native PHP Phar handling for the corresponding commands (e.g. file_exists, include, fopen) to continue processing. After that, the native PHP Phar handling gets disabled and is overwritten by the logic of the PharStreamWrapper again. This is the only way to control invocations of Phar archives as PHP only allows a single handler for each corresponding stream.
We were informed that exception and error handlers in custom applications (e.g. TYPO3 extensions) sometimes didn't return to the original operating sequence of the PharStreamWrapper. A possible consequence was that the unprotected native PHP Phar handling remained active and therefore became vulnerable for the basic issue of insecure deserialization again.
Examples
Take a look at the following examples showing how the handling is by-passed in custom application code.
Scenario A: Exception thrown from code organized in a Phar archive
```
try {
include('phar://path-to-archive/good-archive.phar');
} catch (\Throwable $throwable) {
// not doing much here, continue execution
}
// the insecure value can be anything that is or was user-submitted
// and cannot be trusted in terms of security, $_GET is just used as example
$insecureValue = $_GET['path'];
// the value might be 'phar://path-to-archive/malicious-archive.phar'
file_exists($insecureValue);
```
Scenario B: Errors converted to exceptions and thrown when interacting with archive contents
```
// set error handler in order to convert errors to exceptions
set_error_handler(function($errno, $errstr, $errfile, $errline, array $errcontext) {
throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
});
// interacting with Phar archive
try {
$resource = opendir('phar://path-to-archive/good-archive.phar/non-existing-path/');
closedir($resource);
} catch (\Throwable $throwable) {
// not doing much here, continue execution
}
// the insecure value can be anything that is or was user-submitted
// and cannot be trusted in terms of security, $_GET is just used as example
$insecureValue = $_GET['path'];
// the value might be 'phar://path-to-archive/malicious-archive.phar'
file_exists($insecureValue);
```
In addition, a new interceptor was introduced to protect possible (but unknown) vulnerabilities in 3rd party components like TYPO3 extensions. Basically, the PharStreamWrapper intercepts direct invocations of Phar archives and allows or denies further processing based on individual rules.
Recently, the PharStreamWrapper was extracted from the TYPO3 core and released as standalone package under the MIT license. It is now available for any PHP driven project.
The stream wrapper overwrites the existing Phar handling of PHP, applies its own assertions and then restores the native PHP Phar handling for the corresponding commands (e.g. file_exists, include, fopen) to continue processing. After that, the native PHP Phar handling gets disabled and is overwritten by the logic of the PharStreamWrapper again. This is the only way to control invocations of Phar archives as PHP only allows a single handler for each corresponding stream.
We were informed that exception and error handlers in custom applications (e.g. TYPO3 extensions) sometimes didn't return to the original operating sequence of the PharStreamWrapper. A possible consequence was that the unprotected native PHP Phar handling remained active and therefore became vulnerable for the basic issue of insecure deserialization again.
Examples
Take a look at the following examples showing how the handling is by-passed in custom application code.
Scenario A: Exception thrown from code organized in a Phar archive
```
try {
include('phar://path-to-archive/good-archive.phar');
} catch (\Throwable $throwable) {
// not doing much here, continue execution
}
// the insecure value can be anything that is or was user-submitted
// and cannot be trusted in terms of security, $_GET is just used as example
$insecureValue = $_GET['path'];
// the value might be 'phar://path-to-archive/malicious-archive.phar'
file_exists($insecureValue);
```
Scenario B: Errors converted to exceptions and thrown when interacting with archive contents
```
// set error handler in order to convert errors to exceptions
set_error_handler(function($errno, $errstr, $errfile, $errline, array $errcontext) {
throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
});
// interacting with Phar archive
try {
$resource = opendir('phar://path-to-archive/good-archive.phar/non-existing-path/');
closedir($resource);
} catch (\Throwable $throwable) {
// not doing much here, continue execution
}
// the insecure value can be anything that is or was user-submitted
// and cannot be trusted in terms of security, $_GET is just used as example
$insecureValue = $_GET['path'];
// the value might be 'phar://path-to-archive/malicious-archive.phar'
file_exists($insecureValue);
```
Type
CWE-502Deserialization of Untrusted Data
Timeline
Published5 Jun 2024
Updated6 Mar 2026
First seen6 Mar 2026
Sources
GHSA-4v5g-8pq2-32m2 · GHSA
Track software like this
Free during beta