CommunityProgramación y desarrollogithub.com

yaklang/type-juggling

Bypass de comparación débil y manipulación de tipos en PHP (`==`). Útil cuando la autenticación, la verificación de HMAC/firmas o la validación de tokens utilizan igualdad laxa, coerción numérica o comparaciones de hash sin tipos estrictos, común en PHP heredado y rutas de código estilo CTF.

¿Qué es type-juggling?

Esta habilidad explota vulnerabilidades de type juggling en PHP, aprovechando comparaciones débiles (`==`) que pueden llevar a coerción numérica y bypass de seguridad. Es especialmente útil en aplicaciones PHP heredadas o desafíos CTF donde la autenticación, verificación de firmas HMAC o validación de tokens se realizan con igualdad laxa en lugar de estricta (`===`). La habilidad proporciona un asistente de línea de comandos (`yak-juggling`) que puede generar y verificar payloads para escenarios comunes, como comparación de hashes MD5/SHA1, comparación de arreglos y coerción de strings numéricos. Funciona en entornos Unix y Windows, utilizando Node.js (versiones LTS 18.x o superiores). Su flujo de trabajo incluye la detección de patrones de comparación débil, la generación automática de payloads según el contexto, y la validación local de los mismos. Es una herramienta fundamental para pentesters y desarrolladores que necesitan identificar y corregir este tipo de fallos en sistemas PHP.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yaklang/hack-skills/tree/main/skills/type-juggling

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace type-juggling?

Bypass de comparación débil y manipulación de tipos en PHP (==). Útil cuando la autenticación, la verificación de HMAC/firmas o la validación de tokens utilizan igualdad laxa, coerción numérica o comparaciones de hash sin tipos estrictos, común en PHP heredado y rutas de código estilo CTF.

Descripción General

Esta habilidad proporciona herramientas para explotar vulnerabilidades de type juggling en PHP. Las comparaciones débiles (==) en PHP pueden conducir a comportamientos inesperados cuando se comparan valores de diferentes tipos, permitiendo a menudo bypass de seguridad.

Plataformas Soportadas

  • Sistemas Unix (macOS, Linux, WSL)
  • Windows (PowerShell, CMD)

Prerrequisitos

  • Node.js: Versión LTS 18.x o superior
  • npm: Normalmente incluido con Node.js

Instalación

npm install -g @yaklang/type-juggling

Uso

Como Asistente de CLI

El comando yak-juggling proporciona varias utilidades:

# Verificar comparación de hash
yak-juggling check-hash <hash_value> <known_plaintext>

# Generar payload para bypass
yak-juggling generate --type <type> --target <target_value>

# Listar tipos de bypass disponibles
yak-juggling list-types

Tipos de Bypass Comunes

TipoDescripciónEjemplo
numericStrings numéricos que se convierten al mismo número"123" == 123 → true
hash-md5Comparación de hash MD5"0e12345..." == "0e67890..." → true
hash-sha1Comparación de hash SHA1"0e12345..." == "0e67890..." → true
arrayComparación de arreglos[] == false → true
booleanCoerción booleana"false" == false → false (¡cuidado!)

Ejemplo de Detección y Bypass

Escenario: Bypass de Autenticación

// Código vulnerable
if ($_POST['password'] == $stored_hash) {
    // Autenticado
}
  1. Detectar el patrón de comparación débil
  2. Determinar el tipo de hash (MD5, SHA1, etc.)
  3. Generar un payload que produzca una comparación verdadera
yak-juggling generate --type hash-md5 --target "0e215962017"

Consideraciones de Seguridad

  • Solo usar en entornos autorizados (pruebas de penetración, CTF, laboratorios)
  • Las aplicaciones modernas de PHP deberían usar === y hash_equals() para comparaciones seguras
  • Esta habilidad es principalmente para demostrar y educar sobre la importancia de la comparación estricta de tipos

Solución de Problemas

ProblemaCausaSolución
comando no encontradonpm global no está en PATHAgregar $(npm root -g)/bin al PATH
Error de permisoPermisos de instalación insuficientesUsar sudo npm install -g o configurar npm correctamente
Versión de Node.js no soportadaNode.js desactualizadoActualizar a Node.js 18.x o superior

Referencias

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

yaklang/401-403-bypass-techniques

401/403 bypass playbook. Use when encountering access-denied responses on admin panels, API endpoints, or restricted paths. Covers path manipulation, HTTP method tampering, header injection, protocol downgrade, and automated bypass tools.

yaklang/active-directory-acl-abuse

Active Directory ACL abuse playbook. Use when exploiting misconfigured AD permissions including GenericAll, WriteDACL, DCSync rights, shadow credentials, LAPS reading, GPO abuse, and BloodHound-guided attack paths.

yaklang/active-directory-certificate-services

AD Certificate Services attack playbook. Use when targeting misconfigured AD CS for privilege escalation via ESC1-ESC13 template abuse, NTLM relay to enrollment, CA officer abuse, and certificate-based persistence.

yaklang/active-directory-kerberos-attacks

Kerberos attack playbook for Active Directory. Use when targeting AD authentication via AS-REP roasting, Kerberoasting, golden/silver/diamond tickets, delegation abuse, or pass-the-ticket attacks.

yaklang/ai-ml-security

AI/ML security playbook. Use when assessing model supply chain attacks (pickle RCE, poisoned weights), adversarial examples, model poisoning, model stealing, data privacy attacks (membership inference, model inversion), and autonomous agent security risks.

yaklang/android-pentesting-tricks

Android pentesting playbook. Use when testing Android applications for SSL pinning bypass, exported component abuse, WebView vulnerabilities, intent redirection, root detection bypass, tapjacking, and backup extraction during authorized mobile security assessments.

yaklang/anti-debugging-techniques

Anti-debugging detection and bypass playbook. Use when reversing protected binaries that detect debuggers via ptrace, PEB flags, timing checks, or signal/exception handlers on Linux and Windows.

yaklang/api-auth-and-jwt-abuse

API authentication and JWT abuse playbook. Use when testing bearer tokens, API keys, claim trust, header spoofing, rate limits, and API auth boundary weaknesses.

yaklang/api-authorization-and-bola

API authorization and BOLA testing playbook. Use when APIs expose object identifiers, nested resources, hidden writable fields, or weak function-level authorization.

yaklang/api-recon-and-docs

API reconnaissance and documentation review playbook. Use when discovering endpoints, schemas, versions, OpenAPI specs, hidden docs, and surface area for API testing.

yaklang/api-sec

Entry P1 category router for API security. Use when choosing between API recon, authorization, token abuse, and hidden-parameter workflows before any deeper API topic skill.

yaklang/arbitrary-write-to-rce

Arbitrary write to RCE playbook. Use when you have an arbitrary write primitive (from heap exploitation, format string, or OOB write) and need to convert it into code execution by targeting GOT, hooks, _IO_FILE vtable, exit_funcs, TLS_dtor_list, modprobe_path, .fini_array, or C++ vtables.

yaklang/authbypass-authentication-flaws

Authentication bypass testing playbook. Use when assessing login flows, password reset logic, account recovery, MFA bypass, token predictability, brute-force resistance, and session boundary flaws.

yaklang/auth-sec

Entry P1 category router for authentication and authorization. Use when testing login flows, sessions, object authorization, JWT, OAuth, CORS, CSRF, and enterprise SSO weaknesses before any deeper auth topic skill.

yaklang/binary-protection-bypass

Binary protection bypass playbook. Use when identifying and bypassing ASLR, PIE, NX/DEP, stack canary, RELRO, FORTIFY_SOURCE, CET, and MTE protections in ELF binaries to enable exploitation.

yaklang/browser-exploitation-v8

Browser and V8 exploitation playbook. Use when exploiting JavaScript engine vulnerabilities including JIT type confusion, incorrect bounds elimination, and V8 sandbox bypass to achieve renderer RCE and sandbox escape in Chrome/Chromium.

yaklang/business-logic-vuln

Entry P1 category router for business logic testing. Use when workflow abuse, race conditions, pricing flaws, or multi-step state attacks matter more than parser-level input injection.

yaklang/business-logic-vulnerabilities

Business logic vulnerability playbook. Use when reasoning about workflows, race conditions, price manipulation, coupon abuse, state machines, and multi-step authorization gaps.

yaklang/classical-cipher-analysis

Classical cipher analysis playbook. Use when encountering substitution ciphers, Vigenere, transposition, XOR, or encoded text in CTF challenges that requires frequency analysis, Kasiski examination, or known-plaintext cryptanalysis.

yaklang/clickjacking

Clickjacking playbook. Use when testing whether target pages can be framed, whether X-Frame-Options or CSP frame-ancestors are properly configured, and whether UI redress attacks can trigger sensitive actions.

Skills relacionados