Presentando php2shell-test: Un Arnés Purple-Team de Ciclo Cerrado para Auditar RCE en PHP y Validar Tu Pila de Detección

Conoce php2shell-test, nuestro arnés open-source GPL-2.0 de verificación purple-team, cazador de artefactos en disco y suite validada de reglas Sigma, ModSecurity y auditd para auditar vectores RCE en PHP y comprobar tu pila de detección.

php2shell-test Arnés Purple-Team de Ciclo Cerrado para RCE en PHP y Validación de Detección
🧪
Lanzamiento de Herramienta Open Source: php2shell-test Tras nuestro análisis técnico de PHP2Shell (CVE-2026-109618 y CVE-2026-109619), publicamos php2shell-test: un arnés de verificación purple-team de ciclo cerrado bajo licencia GPL-2.0, cazador de artefactos en disco y conjunto validado de reglas Sigma, ModSecurity y auditd diseñado para demostrar si código PHP externo puede llegar a tu intérprete y si tu SIEM/WAF realmente lo detecta.

Cuando se publica una vulnerabilidad crítica en PHP —ya sea corrupción de memoria en el motor central como PHP2Shell (CVE-2026-109618 y CVE-2026-109619), abuso de session.upload_progress, evasión de filtros de subida de archivos o deserialización insegura con unserialize()—, los equipos de seguridad se hacen inmediatamente dos preguntas:

1. "¿Puede código PHP enviado por un atacante llegar al intérprete en este servidor — sí o no?"
2. "Y si puede llegar, ¿nuestra pila de detección (WAF, SIEM, auditd) realmente lo habría visto?"

La mayoría de los escáneres convencionales responden mal a ambas preguntas. Si apuntas un escáner genérico a tu entorno de pruebas, o bien disparará cargas útiles a ciegas cantando victoria ante una página de error que devuelve 200 OK, o bien informará "0 vulnerabilidades" cuando en realidad acaba de depositar un archivo .php sin ejecutar dentro de tu directorio web, a solo una directiva .htaccess o AddType de distancia de convertirse en Ejecución Remota de Código (RCE).

Peor aún: ningún escáner tradicional cierra el ciclo con el equipo defensivo (Blue Team). Obtienes un PDF estático mientras tus reglas de ModSecurity, Sigma y auditd permanecen sin validar frente a los Indicadores de Compromiso (IOCs) reales.

Por eso construimos y liberamos php2shell-test.


1. Filosofía: Un Arnés de Ciclo Cerrado, No un Arma Ofensiva

php2shell-test es un arnés de verificación para sistemas propios o bajo autorización explícita por escrito. Está diseñado deliberadamente para que no pueda convertirse en una herramienta de ataque:

  • Jamás ejecuta comandos del sistema (system(), exec(), passthru()) en el servidor objetivo.
  • Jamás abre una shell, nunca inicia conexiones inversas de red y nunca extrae ni modifica datos existentes.
  • Es estrictamente de solo lectura por defecto: cualquier prueba capaz de escribir archivos en el servidor está bloqueada detrás del flag --allow-write y devuelve SKIPPED a menos que se autorice explícitamente.

En lugar de implantar web shells, la herramienta conecta cuatro etapas alrededor de un único token canario UUIDv4 por ejecución:

        ┌────────────────────────┐
        │  runner/php_rce_test.py│   1. Prueba la matriz de 14 vectores y verifica ejecución
        └───────────┬────────────┘
                    │ imprime un token canario UUIDv4 + lista exacta de IOCs
                    ▼
        ┌────────────────────────┐
        │  detection/hunt.sh     │   2. Busca qué quedó realmente en disco y en logs
        └───────────┬────────────┘
                    │ confirma o refuta el veredicto de la capa HTTP
                    ▼
        ┌────────────────────────┐
        │  detection/*           │   3. Reglas Sigma / ModSecurity / auditd / SIEM
        └───────────┬────────────┘      validadas contra los IOCs exactos de la corrida
                    │
                    ▼
        ┌────────────────────────┐
        │  detection/mitigations │   4. Aplica correcciones en código y php.ini, y repite
        │  _reference.md         │      hasta lograr 0 EXPLOITABLE / 0 INCONCLUSIVE
        └────────────────────────┘

2. El Modelo de Veredicto por Canario: Por Qué Importa INCONCLUSIVE

Cada prueba en runner/php_rce_test.py (un script en Python 3 sin dependencias externas) inserta un token único UUIDv4 dentro de un pequeño programa PHP inofensivo de solo lectura (el canario):

<?php
echo "CANARY:<token>\n";
echo "UID:" . getmyuid() . "\n";
echo "PHP:" . PHP_VERSION . "\n";
/* Más SAPI, php_uname(), cwd, disable_functions, open_basedir, docroot */
?>

El veredicto se determina de forma mecánica según lo que regresa por HTTP:

Observación HTTP Significado Veredicto y Código de Salida
CANARY:<token> presente en la respuesta El código PHP enviado llegó al intérprete y se ejecutó. EXPLOITABLE (Salida 2)
<token> presente como código fuente <?php crudo El archivo aterrizó en disco y es accesible vía web, pero no fue interpretado como PHP. INCONCLUSIVE (Salida 1)
Nada encontrado en las URLs probadas Nada se ejecutó ni apareció en la capa HTTP evaluada. NOT_EXPLOITABLE (Salida 0)

La distinción entre las dos primeras filas es la razón de ser de esta herramienta. Un archivo subido al directorio web que devuelve su código fuente sin ejecutar es un hallazgo real (INCONCLUSIVE), nunca un "no vulnerable". Y como un error HTTP 404 no demuestra que el archivo no se haya escrito en /tmp o fuera del webroot, el arnés te entrega el token canario para verificar la verdad en disco con hunt.sh.


3. La Matriz de 14 Pruebas en Detalle

  1. Controles de Línea Base (baseline.reachable, baseline.notfound, baseline.txt_parsed):Verifican que el servidor esté activo y que una ruta inexistente (/zz-<token>-nonexistent.php) no devuelva 200 OK. Si tu aplicación devuelve códigos 200 falsos en páginas no encontradas, ningún resultado de subida de archivos es fiable.
  2. Matriz de Subida de Archivos (upload.extensions, upload.traversal, upload.htaccess):Con --allow-write, evalúa 13 variantes de extensión (.php, .phtml, .php5, .php7, .phar, .phps, mayúsculas/minúsculas como .PhP, punto final .php. y dobles extensiones .php.jpg / .jpg.php), salto de directorios (../) e inyección de manejadores mediante .htaccess (AddType application/x-httpd-php .t<token>).
  3. Inclusión Local de Archivos (LFI) y Wrappers (lfi.php_input, lfi.php_data, lfi.filter_read, lfi.traversal, lfi.log_poison):Evalúa flujos php://input, data://text/plain;base64,..., lectura de código fuente y credenciales vía php://filter/read=convert.base64-encode/resource=..., recorrido de rutas y envenenamiento del encabezado User-Agent en los registros de acceso de Apache/Nginx.
  4. Progreso de Subida de Sesión y Deserialización (session.upload_progress, deser.gadget, deser.sink_probe):Prueba la inyección multipart de PHP_SESSION_UPLOAD_PROGRESS en archivos de sesión (/tmp/sess_<token>) y cadenas de gadgets de deserialización (unserialize()) configurables mediante CLI.

4. Cerrando el Ciclo: Caza en Disco (hunt.sh) y Reglas Validadas

Paso A: Verificación en el Servidor con detection/hunt.sh

./detection/hunt.sh <token-canario> /var/www/html /srv/app /tmp

hunt.sh busca en el sistema de archivos y en los registros cualquier rastro del token canario: comentarios del canario en disco, permisos y propietario de archivos creados, archivos de sesión sess_<token> en /tmp o /var/lib/php/sessions, modificaciones recientes a .htaccess, entradas envenenadas en logs y eventos de auditd. Al final, imprime los comandos exactos de limpieza comentados con # para revisar la evidencia antes de borrarla.

Paso B: Reglas Sigma, ModSecurity y auditd

  • 7 Reglas Sigma (detection/sigma_php_rce.yml): Seis reglas para logs web y una para auditd, con identificadores UUIDv5 deterministas generados a partir del título de cada regla.
  • 14 Reglas ModSecurity / Coraza (detection/modsecurity_php.conf):
    • 12 Reglas de Bloqueo en Fase 1/2 (950010–950020, 950023): Bloquean wrappers PHP, lecturas base64, código PHP en User-Agent, extensiones peligrosas (incluyendo punto final .php. con la regla 950023), subidas de .htaccess, PHP_SESSION_UPLOAD_PROGRESS y objetos serializados.
    • 2 Reglas Críticas de Respuesta en Fase 5 (950021 y 950022): Inspeccionan el cuerpo de la respuesta HTTP en busca de CANARY:<32 hex>. Son las únicas reglas capaces de distinguir entre un ataque bloqueado en la entrada y una ejecución real ocurrida en el servidor.
  • Reproducción sin WAF (detection/replay_rules.py): Permite evaluar las 14 expresiones regulares de ModSecurity directamente contra el tráfico capturado de la prueba incluso en entornos donde aún no hay un WAF instalado (logrando 14/14 detecciones en el laboratorio vulnerable).

5. Ingeniería Probada en Batalla: Lecciones Reales del Laboratorio

El repositorio incluye un laboratorio Docker autocontenido (docker compose up --build -d, escuchando exclusivamente en 127.0.0.1:8080) con una mitad vulnerable (/vuln/) y una mitad endurecida (/hardened/) que comparten el mismo php.ini, además de 45 pruebas unitarias sin dependencias (python3 tests/test_runner.py).

Durante la construcción y validación de extremo a extremo descubrimos y blindamos casos borde fascinantes:

  1. La Trampa del Guion Largo UTF-8 en unserialize(): El formato serializado de PHP (s:<n>:"...") exige la longitud en bytes, no en caracteres. Como el comentario de nuestro canario incluía un guion largo (—, que mide 1 carácter en len() de Python pero 3 bytes en UTF-8), el conteo de Python quedaba 2 bytes corto y PHP rechazaba la carga con Error at offset 1014 of 1019 bytes devolviendo HTTP 200. Implementamos php_strlen() en bytes validado por fakelab.serialized_lengths_ok().
  2. La Regla del Segmento Final en AddType de Apache: Apache evalúa directivas AddType contra el último segmento de extensión, por lo que usar .t<token> de un solo segmento permitió validar de forma fiable si AllowOverride está activo.
  3. Archivos de Sesión de 0 Bytes por session.upload_progress.cleanup=1: Por defecto, PHP limpia el progreso de subida apenas termina una petición rápida, dejando un archivo sess_<token> vacío de 0 bytes. El arnés ahora distingue explícitamente entre un archivo de sesión vacío (INCONCLUSIVE) y una ruta inexistente o rechazada (NOT_EXPLOITABLE).
  4. Patrones en Mayúsculas con t:lowercase en ModSecurity: Si una regla de ModSecurity aplica la transformación t:lowercase pero su expresión regular contiene letras mayúsculas, jamás coincidirá con ningún tráfico. Nuestra suite de pruebas ahora verifica automáticamente que ninguna regla con t:lowercase contenga mayúsculas.
  5. El Cuelgue Infinito de /dev/stdout en Contenedores Apache: Las imágenes oficiales php:*-apache enlazan /var/log/apache2/access.log a /dev/stdout, haciendo que un grep -R se quede colgado leyendo una tubería infinita. Nuestro laboratorio configura un archivo real en disco y hunt.sh filtra con find -type f.

6. Guía Rápida: Pruébalo en 60 Segundos

# 1. Clonar el repositorio y ejecutar las 45 pruebas unitarias del arnés
git clone https://git.colibrisec.org/ColibriSec/php2shell-test.git
cd php2shell-test
python3 tests/test_runner.py

# 2. Levantar el laboratorio local (expuesto solo en 127.0.0.1:8080)
docker compose up --build -d

# 3. Ejecutar la matriz completa contra la mitad vulnerable (sale con código 2: 10 EXPLOITABLE)
python3 runner/php_rce_test.py --base http://127.0.0.1:8080 --allow-write

# 4. Cazar los artefactos generados dentro del contenedor usando el token impreso
docker compose cp detection/hunt.sh php-lab:/tmp/hunt.sh
docker compose exec php-lab bash /tmp/hunt.sh <token> /var/www/html

# 5. Validar las 14 reglas de ModSecurity contra las peticiones reales (14/14 coincidencias)
python3 detection/replay_rules.py --base http://127.0.0.1:8080 --allow-write

# 6. Verificar que los endpoints endurecidos devuelven 0 EXPLOITABLE (sale con código 0)
python3 runner/php_rce_test.py --base http://127.0.0.1:8080 --allow-write \
  --upload-path /hardened/upload.php \
  --include-path /hardened/include.php \
  --deser-path /hardened/deser.php

# 7. Apagar el laboratorio
docker compose down
📦
Código Abierto y Disponible Ahora php2shell-test está disponible bajo licencia GPL-2.0-only y es mantenido por el equipo de ColibriSec.
Repositorio oficial: git.colibrisec.org/ColibriSec/php2shell-test
Artículo anterior: Diseccionando PHP2Shell (CVE-2026-109618 y CVE-2026-109619): Análisis Técnico de RCE Pre-Autenticación en el Núcleo de PHP, Mitigación y Parches

Read more