
Análisis de Triage de Alto Octanaje
[][docs]
[
][tests]
[
][codecov]
[
][pypi]
__ __ High Octane Triage Analysis __
|| _||______ __ __________ _____ ||
|| \||___ \__| ____/ ______/___ / ____\ ||
==||=====|| | __/ |/ \ /==| / __ \ __\===]|
'======|| | \ | | \_ _| \ ___/| | ||
||____ /__|___|__/ / | \____]| | ||
=========''====\/=========/ /==|__|=====|__|======'
\ /
\/
Binary Refinery™ es una colección de scripts de Python que implementan transformaciones de datos binarios, como compresión y cifrado.
A menudo nos referiremos a él simplemente como refinery, que también es el nombre del paquete correspondiente.
Los scripts están diseñados para leer la entrada exclusivamente desde stdin y escribir la salida en stdout.
La filosofía principal es que cada script debe ser una unidad en el sentido de que hace un trabajo,
y las unidades individuales pueden combinarse en pipelines con el operador de tubería | en la línea de comandos para realizar tareas más complejas.
El enfoque principal del proyecto es el triaje de malware,
y es un intento de implementar algo como CyberChef en la línea de comandos.
Crea un entorno virtual de Python. Necesitas Python 3.11 o posterior. Instala refinery así:
python -m pip install -U pip
python -m pip install -U --no-cache-dir binary-refinery[extended]
Ejecuta las unidades con -h para aprender cómo funcionan, busca en la [documentación][] o usa el comando binref para encontrarlas.
Mira [un video reciente][VOD3] si quieres verlo en acción.
Pero también, lee el resto de este readme.
No hay un calendario de lanzamientos, pero las versiones se publican con mucha frecuencia y se recomienda actualizar periódicamente. Las correcciones de errores no se documentan fuera de GIT, pero todos los demás cambios (es decir, las nuevas funcionalidades) se documentan en el registro de cambios. Sígueme en [Mastodon][] para recibir novedades sobre versiones especialmente relevantes.
El texto de ayuda que se muestra al ejecutar una unidad con el modificador -h o --help es su documentación principal.
La [documentación generada automáticamente][documentación] contiene una recopilación de esa salida para cada unidad en el nivel superior,
pero también contiene la especificación de los tres conceptos fundamentales del kit de herramientas:
[enmarcado][frame], [argumentos multibin][argformats] y [metavariables][meta].
La búsqueda de texto completo de la descripción y el texto de ayuda de cada unidad también está disponible en la línea de comandos,
mediante el comando binref proporcionado. Reconociendo el hecho de que la documentación de referencia puede resultar algo árida,
hay un esfuerzo continuo por producir una serie de tutoriales; recomiendo encarecidamente echarles un vistazo.
Además de eso, recopilo recursos adicionales (incluidos algunos producidos por terceros) a continuación.
[!NOTE]
Refinery todavía está en fase alfa y la interfaz puede cambiar a veces, es decir, las unidades y los parámetros pueden eliminarse o renombrarse. Por lo tanto, puede ocurrir que líneas de comandos específicas de videos y publicaciones de blog antiguos ya no funcionen.
2021/08] [OALabs][OA] tuvo la amabilidad de dejarme [mostrar el kit de herramientas en un video destacado][VOD1].
En el video, básicamente recorro el contenido de
el primer tutorial.2021/11] [Johannes Bader][JB] escribió una increíble [publicación de blog][BLOG] sobre el análisis de malspam con binary refinery.2024/03] [Malware Analysis For Hedgehogs][MH] hizo [un video sobre el desempaquetado de una muestra de XWorm][VOD2] usando refinery.2024/11] [the CyberYeti][CY] me invitó [a presentar refinery en directo][VOD3].2025/06] Estuve [de nuevo en directo][VOD4] con [the CyberYeti][CY], esta vez es un poco más crudo.
Todos los errores que se pueden ver aquí fueron corregidos. 😉Las demostraciones incluyen de nuevo muestras de la sección de ejemplos a continuación y de los tutoriales.
The Binary Refinery es (c) 2019 Jesko Hüttenhain, y se publica bajo una [Licencia BSD de 3 cláusulas][license]. Este repositorio también contiene una copia del texto completo de la licencia. Si quieres hacer algo con él que no esté cubierto por esta licencia, no dudes en contactar al autor.
Refinery requiere al menos Python 3.11. Se recomienda instalarlo en su propio [entorno virtual][venv]: El paquete puede arrastrar muchas dependencias, e instalarlo en tu Python global es algo propenso a conflictos de versiones. Además, dado que el kit de herramientas introduce un gran número de comandos nuevos, hay una buena probabilidad de que algunos de ellos entren en conflicto en algunos sistemas, y mantenerlos en su propio entorno virtual separado es una forma de evitarlo.
Si quieres tener todos los comandos de refinery disponibles en tu shell en todo momento (es decir, sin tener que cambiar a un entorno virtual personalizado),
también tienes la opción de elegir un prefijo para la instalación,
que se colocará delante de cada shim de comando que se instale.
Por ejemplo, si eliges r. como prefijo, entonces la unidad [emit][] se instalará como el comando r.emit.
Un beneficio adicional es que puedes escribir r. y pulsar Tab dos veces para obtener una lista de todos los comandos de refinery disponibles.
Ten en cuenta, sin embargo, que no se asume ningún prefijo en la documentación y que es un objetivo de desarrollo de refinery no entrar en conflicto en la mayoría de los sistemas.
El autor no usa un prefijo y proporciona esta opción como una red de seguridad.
La forma más sencilla de instalar y actualizar refinery es mediante pip. Asegúrate de ejecutar primero la versión más reciente:
python -m pip install -U pip
Luego simplemente instala el paquete refinery:
pip install -U --no-cache-dir binary-refinery
Si deseas elegir un prefijo para todas las unidades, puedes especificarlo mediante la variable de entorno REFINERY_PREFIX.
Por ejemplo, el siguiente comando instalará refinery en el entorno Python actual con el prefijo r. en Linux:
REFINERY_PREFIX=r. pip install -U --no-cache-dir binary-refinery
En Windows, tendrías que ejecutar los siguientes comandos:
set REFINERY_PREFIX=r.
pip install -U --no-cache-dir binary-refinery
Especificar el prefijo especial ! tendrá el efecto de que no se creen comandos de shell en absoluto,
y binary refinery se instalará únicamente como biblioteca.
Establezca REFINERY_NO_EXTENSIONS=1 para instalar sin extensiones de Cython;
refinery entonces utiliza implementaciones en Python puro (mucho más lentas) de varios algoritmos.