Repository navigation
es BUILDING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
VD Dropbear entrega el Dropbear upstream (la etiqueta fijada en
UPSTREAM_VERSION) más el conjunto de parches pequeño y auditable en
patches/. La CI lo compila; puedes reproducirlo localmente.
# una vez: un Android NDK (r27 o más nuevo)
export NDK=/path/to/android-ndk
# compila cada ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# o solo uno, para iterar rápido
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh clona la etiqueta upstream fijada, aplica patches/*.patch y localoptions.h, y
luego compila de forma cruzada vddropbear y dropbearkey en module/bin/<abi>/. La salida es un ELF
dinámico (file informa dynamically linked, interpreter /system/bin/linker64 … for Android 24),
enlazado contra la libc bionic que todo dispositivo Android ya tiene. libtomcrypt queda incrustado
dentro del binario; solo la biblioteca C es dinámica. Véase Dinámico, no static-PIE.
Los binarios no se commitean; los compila la CI en cada etiqueta y se adjuntan a la release.
Véase .gitignore.
La autenticación por contraseña de Dropbear está escrita para un host Unix normal con crypt() y
/etc/shadow. Android no tiene ninguno de los dos, y eso choca con la compilación en tres lugares
distintos. Esta sección documenta cada uno de ellos, porque es exactamente el tipo de cosa dolorosa de
redescubrir. Todo ello lo gestiona el parche
0003-password-file.patch; nada de lo de abajo se deja al azar
en tiempo de ejecución.
La biblioteca C de Android (bionic) no proporciona crypt(), crypt_r(), ni una base de datos shadow.
El NDK no expone ningún <crypt.h>. Así que la ruta estándar de contraseña de Dropbear, que llama a
crypt(password, salt) y compara contra /etc/shadow, simplemente no puede compilarse ni ejecutarse
en Android. Tampoco hay ningún libcrypt al que enlazar, y traer el libcrypto de OpenSSL solo para un
hash de contraseña sería una dependencia grande y torpe para un binario estático.
Nuestra respuesta: no usar crypt() en absoluto. La autenticación por contraseña verifica la
contraseña presentada con PBKDF2-HMAC-SHA256 contra un archivo de hash (DROPBEAR_PASSWD_FILE), una
KDF pública, estándar, con salt e iterada. El formato del archivo está documentado en
patches/README.md.
Antes incluso de que corra cualquier código, Dropbear se niega a compilar:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifCon HAVE_CRYPT sin definir (siempre, en bionic) y la autenticación por contraseña habilitada, esto es
un #error rígido. Como nuestro verificador nunca llama a crypt(), el parche 0003 elimina este
guard. (Deja intacta la comprobación de "al menos un método de autenticación debe estar habilitado".)
Dropbear incrusta un libtomcrypt recortado, que sí contiene PBKDF2 (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). El arreglo obvio es llamarlo. No funciona, por dos razones que se suman:
-
El prototipo está oculto.
pkcs_5_alg2se declara solo dentro de#ifdef LTC_PKCS_5entomcrypt_pkcs.h. Los propios archivos fuente de Dropbear no se compilan conLTC_PKCS_5definido, así que la declaración queda invisible y el compilador da error de implicit function declaration. -
El símbolo no existe. Peor aún, el cuerpo de
pkcs_5_alg2también está tras#ifdef LTC_PKCS_5. La compilación de libtomcrypt de Dropbear no lo define, así quepkcs_5_2.ocompila a un objeto vacío: está enlibtomcrypt.a, pero no contiene ningún símbolopkcs_5_alg2. El enlace falla conundefined symbol: pkcs_5_alg2.
Puedes verlo tú mismo:
# el objeto existe pero está vacío (sin T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> solo un marcador de datos, sin pkcs_5_alg2
# el HMAC, en cambio, está totalmente compilado (Dropbear lo usa para los MAC de SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> define hmac_memoryNuestra respuesta: construir PBKDF2 nosotros mismos sobre las primitivas que Dropbear sí compila.
hmac_memory y el hash sha256 registrado están ambos presentes y enlazables, así que el parche
0003 implementa PBKDF2-HMAC-SHA256 directamente (RFC 2898; un único bloque de salida de 32 bytes, ya
que dkLen == hLen para SHA-256). Declaramos hmac_memory nosotros mismos (el mismo problema de
prototipo oculto de arriba) y el objeto se extrae de libtomcrypt.a en el enlace. El resultado es
PBKDF2 estándar y por tanto interoperable: el hash que la WebUI calcula con el WebCrypto
deriveBits del navegador es byte a byte idéntico al que calcula el servidor, verificado contra el
hashlib.pbkdf2_hmac de Python como una tercera implementación independiente.
En resumen: Android no te da ningún
crypt(), y el PBKDF2 incrustado de Dropbear se compila a nada. La autenticación por contraseña aquí es un PBKDF2-HMAC-SHA256 desde cero sobre el HMAC de libtomcrypt, con el guard de compilación de crypt() eliminado. Sin OpenSSL/libcrypto, sin ofuscación, sin shadow del sistema.
Los binarios son dinámicos (enlazados contra la bionic del sistema vía /system/bin/linker64), no
estáticos. Esto importa, y se aprendió por las malas, en un dispositivo real, no en la CI:
- Una compilación static-PIE parece estar bien (
fileinforma unstatic-pie executablelimpio) y enlaza sin error, pero da SIGSEGV en el instante en que corre en el dispositivo (verificado en un teléfono arm64 Android 16, exit 139, sin tombstone útil). Los ejecutables estáticos en Android son frágiles; la forma fiable es un binario dinámico normal, que también es como se entrega todo dropbear de Android consolidado. - Una compilación estática, no-PIE ni siquiera arranca: bionic la rechaza con
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Así que la compilación es dinámica (
makesinSTATIC=1;-pie), enlazando solo la libc bionic, presente en todo dispositivo. libtomcrypt sigue incrustado estáticamente en el binario, así que no hay biblioteca extra que entregar.
Lección para probar: qemu-aarch64 (qemu-user) no es un smoke test válido aquí (también da
segfault en estos binarios), y un compile+link exitoso tampoco lo es. Ejecuta el binario en un
dispositivo Android arm64 real. (Esto se validó exactamente así: el daemon se lanzó en un puerto alternativo en un dispositivo vivo y se confirmó que un
inicio de sesión por contraseña tenía éxito, con una contraseña incorrecta rechazada.)
El servidor se compila con --disable-syslog, así que siempre registra en stderr y la opción -E del
upstream ("log to stderr") no existe en este binario; pasarla imprime Invalid option -E y el
daemon nunca arranca. Por eso el constructor de argumentos del módulo no pasa -E.
Las sesiones PTY interactivas usan openpty(). bionic lo declara en <pty.h>, y el configure cruzado
de Dropbear lo detecta con el NDK (HAVE_OPENPTY se establece, HAVE_PTY_H 1), así que no hace falta
ningún parche; los PTY funcionan de inmediato. (El uso no interactivo como exec, SFTP, rsync y reenvío
de puertos no depende de él de todos modos.)
scripts/build-bundles.sh compila de forma cruzada las herramientas de transferencia de archivos como
binarios dinámicos en module/bin/<abi>/. La CI lo ejecuta justo después de build.sh.
-
rsync (con popt + zlib incluidos) compila limpio en cuanto le dices a su configure que bionic no
tiene
lutimes(ac_cv_func_lutimes=no). -
sftp-server y scp vienen de OpenSSH portable, compilados con
--without-openssl(la cripto integrada de OpenSSH basta para estos dos), con un pequeño zlib estático que este script compila primero.
OpenSSH en Android es tan quisquilloso como la historia de crypt() de arriba, porque su configure
detecta mal varias funciones de la libc al compilar de forma cruzada. El script codifica el arreglo;
para que conste, las piezas son:
-
Un seed de caché de funciones que bionic no tiene pero que configure cree que tiene, para que se
compilen en su lugar las versiones compat:
recallocarray,close_range,getentropy,getrandom,nl_langinfo,setpwent/getpwent/endpwent,crypt,futimes,lutimes,strtonum,pledge,explicit_bzero. -
-DHAVE_ATTRIBUTE__SENTINEL__=1 -DHAVE_ATTRIBUTE__NONNULL__=1. Sin ellos, eldefines.hde OpenSSH hace#define __sentinel__(vacío), lo que luego estropea el propio__attribute__((__sentinel__(1)))de bionic en<unistd.h>y toda compilación falla conexpected ')'. -
Un compat de
explicit_bzeroque usamemset. Elbzerode bionic es una macro parecida a una función (no un símbolo real), así que el compat por defecto de OpenSSH, que toma&bzerocomo puntero a función, no compila. bionic no tiene unexplicit_bzeropropio. -
Descartar
xcrypt.oygetrrsetbyname.ode la biblioteca compat.xcrypt.cllama agetpwent()/crypt()incondicionalmente (bionic no tiene ninguno de los dos), ygetrrsetbyname.cusa internos del resolver que bionic no expone. Ninguno de los dos lo usansftp-serverniscp. -
-Wl,--allow-multiple-definition.reallocarrayes la imagen especular de las funciones en (1): bionic no la declara en la API 24, así que OpenSSH compila su propio compat, pero el símbolo sí existe enlibc.a, así que los dos chocan en el enlace. Permitir el duplicado toma el de bionic, lo cual está bien. -
Proteger
pw_gecoscontra NULL enpwcopy(). Elgetpwuid()de bionic devuelve unpw_gecosNULL(Android no guarda campo GECOS). Elpwcopy()de OpenSSH protegepw_passwdcontraNULLpero nopw_gecos, así quesftp-serverllega axstrdup(NULL)y da SIGSEGV al arrancar, en el instante en que se abre una sesión. (scpsobre el protocolo legado nunca llama apwcopy, por eso funcionaba mientras SFTP no.) La compilación parcheapwcopy()para coalescerpw_gecosa"".
Las versiones fijadas están en la parte superior de scripts/build-bundles.sh (ZLIB_VERSION,
RSYNC_VERSION, OPENSSH_VERSION).
git clone --depth 1 --branch "$(cat UPSTREAM_VERSION)" https://github.com/mkj/dropbear /tmp/db
cp patches/localoptions.h /tmp/db/localoptions.h
for p in patches/*.patch; do patch -p1 -d /tmp/db < "$p"; done
cd /tmp/db
TC="$NDK/toolchains/llvm/prebuilt/linux-x86_64/bin"
./configure --host=aarch64-linux-android --disable-zlib --disable-syslog \
CC="$TC/aarch64-linux-android24-clang"
make PROGRAMS="dropbear dropbearkey" -j"$(nproc)"
file ./dropbear # -> dynamically linked, interpreter /system/bin/linker64, for Android 24Esta documentación se generó con Claude (Anthropic) y la mantiene VD171. Las correcciones y mejoras son bienvenidas; consulta CONTRIBUTING.md.