MachScope

Una herramienta nativa de análisis de binarios para macOS que ofrece análisis de Mach-O, desensamblado ARM64 y depuración de procesos. Construida completamente en Swift sin dependencias externas.

Características

Característica	Descripción
Análisis Mach-O	Cabeceras, segmentos, secciones, símbolos, dylibs, cadenas
Firmas de código	Entitlements, CDHash, información de firma, ID de equipo
Desensamblado ARM64	Decodificador completo de instrucciones con anotación PAC
Depuración de procesos	Adjuntar, puntos de interrupción, memoria, registros
Biblioteca Swift	Incorporar en tus propios proyectos
Salida JSON	Formato de salida amigable para scripts

¿Por qué MachScope?

Swift puro — Sin dependencias, fácil de construir e integrar
Nativo ARM64 — Construido para Apple Silicon, entiende instrucciones PAC
Todo en uno — Analiza + Desensambla + Depura en una sola herramienta
Biblioteca + CLI — Úsalo independientemente o intégralo en tus proyectos Swift
Bien probado — Más de 319 pruebas con manejo exhaustivo de errores

Inicio rápido

# Build
swift build

# Parse a binary
swift run machscope parse /bin/ls

# Parse a macOS app
swift run machscope parse /Applications/Calculator.app/Contents/MacOS/Calculator

# View entitlements
swift run machscope parse /Applications/Safari.app/Contents/MacOS/Safari --entitlements

# JSON output
swift run machscope parse /bin/ls --json

Instalación

Homebrew

brew install sadopc/tap/machscope

Compilar desde el código fuente

git clone https://github.com/sadopc/machscope.git
cd MachScope
swift build -c release

Instalación global (opcional)

sudo cp .build/release/machscope /usr/local/bin/

Uso

Comando parse

Analiza la estructura del binario Mach-O:

# Basic analysis
machscope parse /bin/ls

# Full analysis
machscope parse /bin/ls --all

# Specific sections
machscope parse /path/to/binary --symbols
machscope parse /path/to/binary --dylibs
machscope parse /path/to/binary --strings
machscope parse /path/to/binary --signatures
machscope parse /path/to/binary --entitlements

# JSON output for scripting
machscope parse /bin/ls --json --all > analysis.json

Comando disasm

Desensambla código ARM64:

# List functions
machscope disasm /bin/ls --list-functions

# Disassemble from address
machscope disasm /bin/ls --address 0x100003f40 --length 50

# Show instruction bytes
machscope disasm /bin/ls --show-bytes

Comprobar permisos

Mira qué funciones están disponibles:

machscope check-permissions

Output:

Feature               Status      Notes
------------------------------------------------------------
Static Analysis       ✓ Ready     No special permissions needed
Disassembly           ✓ Ready     No special permissions needed
Debugger              ✗ Denied    Missing debugger entitlement

Comando debug

Adjuntar a procesos en ejecución (requiere firma):

# First, sign with debugger entitlement
codesign --force --sign - --entitlements Resources/MachScope.entitlements .build/debug/machscope

# Enable Developer Tools in System Settings > Privacy & Security

# Attach to process
machscope debug <pid>

Uso como biblioteca Swift

Añade MachScope a tu Package.swift:

dependencies: [
    .package(url: "https://github.com/sadopc/machscope.git", from: "1.0.0")
]

Luego úsalo en tu código:

import MachOKit
import Disassembler

// Parse a binary
let binary = try MachOBinary(path: "/bin/ls")
print("CPU: \(binary.header.cpuType)")
print("Segments: \(binary.segments.count)")

// Check entitlements
if let signature = try binary.parseCodeSignature(),
   let entitlements = signature.entitlements {
    for key in entitlements.keys {
        print("\(key): \(entitlements[key] ?? "nil")")
    }
}

// Disassemble
let disasm = ARM64Disassembler(binary: binary)
let result = try disasm.disassembleFunction("_main", from: binary)
for instruction in result.instructions {
    print(disasm.format(instruction))
}

Requisitos

macOS 14.0 (Sonoma) o posterior
Swift 6.0 o posterior
ARM64 (Apple Silicon) — Se admite análisis de x86_64, pero la herramienta se ejecuta en ARM64

Documentación

Estructura del proyecto

MachScope/
├── Sources/
│   ├── MachOKit/        # Core Mach-O parsing library
│   ├── Disassembler/    # ARM64 instruction decoder
│   ├── DebuggerCore/    # Process debugging
│   └── MachScope/       # CLI application
├── Tests/               # Test suites (319+ tests)
├── Resources/           # Entitlements for code signing
└── docs/                # Documentation

¿Para quién es esto?

Desarrolladores iOS/macOS — Inspeccionar binarios, verificar entitlements antes del envío a la App Store
Investigadores de seguridad — Triage y análisis rápido de binarios
Estudiantes — Aprender el formato Mach-O con código Swift legible
Constructores de herramientas — Integrar MachOKit en tus propios proyectos Swift
Jugadores de CTF — Análisis rápido de binarios

Comparación con otras herramientas

La principal ventaja de MachScope: biblioteca nativa Swift que puedes integrar en tus propias herramientas.

Licencia

Licencia MIT — Consulta LICENSE para más detalles.

Contribuciones

¡Contribuciones bienvenidas! Primero lee la Guía de contribución.

# Run tests before submitting
swift test

# Format code
xcrun swift-format -i -r Sources/ Tests/

Agradecimientos

Documentación de Mach-O de Apple
Manual de referencia de arquitectura ARM
La comunidad Swift

Historial de estrellas

Hecho con ❤️ en Swift

MachScope	Swift	✅ Sí	✅ Sí	✅ Sí
otool	C	❌ No	❌ No	❌ No
objdump	C	❌ No	❌ No	❌ No
jtool2	C	❌ No	✅ Sí	❌ No
Hopper	—	❌ No	✅ Sí	❌ No

Más Populares

machscope