Repository navigation
it 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 distribuisce il Dropbear upstream (il tag fissato in
UPSTREAM_VERSION) più il piccolo set di patch verificabile in
patches/. La CI lo compila; puoi riprodurlo in locale.
# una volta sola: un Android NDK (r27 o più recente)
export NDK=/path/to/android-ndk
# compila ogni ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# oppure solo una, per iterare in fretta
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh clona il tag upstream fissato, applica patches/*.patch e localoptions.h, poi
cross-compila vddropbear e dropbearkey in module/bin/<abi>/. L'output è un ELF dinamico (file
riporta dynamically linked, interpreter /system/bin/linker64 … for Android 24), collegato alla libc
bionic che ogni dispositivo Android ha già. libtomcrypt resta incorporato nel binario; solo la libreria
C è dinamica. Vedi Dinamico, non static-PIE.
I binari non vengono committati; li compila la CI a ogni tag e vengono allegati alla release. Vedi
.gitignore.
L'autenticazione con password di Dropbear è scritta per un normale host Unix con crypt() e
/etc/shadow. Android non ha né l'uno né l'altro, e questo si scontra con la build in tre punti
distinti. Questa sezione documenta ciascuno di essi, perché è esattamente il tipo di cosa doloroso da
riscoprire. Tutto è gestito dalla patch
0003-password-file.patch; nulla di quanto segue è lasciato al
caso a runtime.
La libreria C di Android (bionic) non fornisce crypt(), crypt_r(), né un database shadow. L'NDK non
espone alcun <crypt.h>. Quindi il percorso standard della password di Dropbear, che chiama
crypt(password, salt) e confronta con /etc/shadow, semplicemente non può essere compilato né
eseguito su Android. Non c'è nemmeno alcun libcrypt a cui collegarsi, e tirare dentro il libcrypto
di OpenSSL solo per un hash di password sarebbe una dipendenza grande e scomoda per un binario statico.
La nostra risposta: non usare crypt() affatto. L'auth con password verifica la password
presentata con PBKDF2-HMAC-SHA256 contro un file di hash (DROPBEAR_PASSWD_FILE), una KDF
pubblica, standard, con salt e iterata. Il formato del file è documentato in
patches/README.md.
Ancora prima che qualsiasi codice giri, Dropbear si rifiuta di compilare:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifCon HAVE_CRYPT non definito (sempre, su bionic) e l'auth con password abilitata, questo è un #error
rigido. Poiché il nostro verificatore non chiama mai crypt(), la patch 0003 rimuove questo
guard. (Lascia intatto il controllo "almeno un metodo di auth deve essere abilitato".)
Dropbear incorpora un libtomcrypt ridotto, che contiene davvero PBKDF2 (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). La correzione ovvia è chiamarlo. Non funziona, per due ragioni che si
sommano:
-
Il prototipo è nascosto.
pkcs_5_alg2è dichiarato solo dentro#ifdef LTC_PKCS_5intomcrypt_pkcs.h. I file sorgente propri di Dropbear non sono compilati conLTC_PKCS_5definito, quindi la dichiarazione è invisibile e il compilatore dà errore di implicit function declaration. -
Il simbolo non esiste. Peggio, il corpo di
pkcs_5_alg2è anch'esso dietro#ifdef LTC_PKCS_5. La build di libtomcrypt di Dropbear non lo definisce, quindipkcs_5_2.ocompila in un oggetto vuoto: è inlibtomcrypt.a, ma non contiene alcun simbolopkcs_5_alg2. Il link fallisce conundefined symbol: pkcs_5_alg2.
Puoi vederlo tu stesso:
# l'oggetto esiste ma è vuoto (nessun T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> solo un marcatore di dati, nessun pkcs_5_alg2
# l'HMAC, invece, è compilato per intero (Dropbear lo usa per i MAC di SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> definisce hmac_memoryLa nostra risposta: costruire PBKDF2 noi stessi sulle primitive che Dropbear davvero compila.
hmac_memory e l'hash sha256 registrato sono entrambi presenti e collegabili, quindi la patch 0003
implementa PBKDF2-HMAC-SHA256 direttamente (RFC 2898; un singolo blocco di output di 32 byte, dato che
dkLen == hLen per SHA-256). Dichiariamo hmac_memory noi stessi (stesso problema di prototipo
nascosto di sopra) e l'oggetto viene tirato da libtomcrypt.a al link. Il risultato è PBKDF2 standard e
quindi interoperabile: l'hash che la WebUI calcola con il WebCrypto deriveBits del browser è
identico byte per byte a quello che calcola il server, verificato contro hashlib.pbkdf2_hmac di Python
come terza implementazione indipendente.
In breve: Android non ti dà alcun
crypt(), e il PBKDF2 incorporato di Dropbear è compilato a nulla. L'auth con password qui è un PBKDF2-HMAC-SHA256 da zero sopra l'HMAC di libtomcrypt, con il guard di build di crypt() rimosso. Niente OpenSSL/libcrypto, niente offuscamento, niente shadow di sistema.
I binari sono dinamici (collegati alla bionic di sistema via /system/bin/linker64), non statici.
Questo conta, ed è stato imparato nel modo duro, su un dispositivo reale, non in CI:
- Una build static-PIE sembra a posto (
fileriporta unstatic-pie executablepulito) e collega senza errori, ma va in SIGSEGV nell'istante in cui gira sul dispositivo (verificato su un telefono arm64 Android 16, exit 139, nessun tombstone utile). Gli eseguibili statici su Android sono fragili; la forma affidabile è un normale binario dinamico, che è anche il modo in cui viene distribuito ogni dropbear Android consolidato. - Una build statica, non-PIE non parte nemmeno: bionic la rifiuta con
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Quindi la build è dinamica (
makesenzaSTATIC=1;-pie), collegando solo la libc bionic, presente su ogni dispositivo. libtomcrypt resta incorporato staticamente nel binario, quindi non c'è alcuna libreria extra da distribuire.
Lezione per i test: qemu-aarch64 (qemu-user) non è uno smoke test valido qui (anch'esso va in
segfault su questi binari), e nemmeno un compile+link riuscito lo è. Esegui il binario su un
dispositivo Android arm64 reale. (Questo è stato validato esattamente così: il daemon è stato avviato su una porta alternativa su un dispositivo vivo e
un login con password è stato confermato come riuscito, con una password sbagliata rifiutata.)
Il server è compilato con --disable-syslog, quindi logga sempre su stderr e l'opzione -E
dell'upstream ("log to stderr") non esiste in questo binario; passarla stampa Invalid option -E e
il daemon non parte mai. Perciò il costruttore di argomenti del modulo non passa -E.
Le sessioni PTY interattive usano openpty(). bionic lo dichiara in <pty.h>, e il configure
cross di Dropbear lo rileva con l'NDK (HAVE_OPENPTY viene impostato, HAVE_PTY_H 1), quindi nessuna
patch è necessaria; i PTY funzionano da subito. (L'uso non interattivo come exec, SFTP, rsync e
port-forwarding comunque non ne dipende.)
scripts/build-bundles.sh cross-compila gli strumenti di trasferimento file come binari dinamici in
module/bin/<abi>/. La CI lo esegue subito dopo build.sh.
-
rsync (con popt + zlib incorporati) compila pulito non appena dici al suo configure che bionic non
ha
lutimes(ac_cv_func_lutimes=no). -
sftp-server e scp vengono da OpenSSH portable, compilati con
--without-openssl(la crypto integrata di OpenSSH basta per questi due), con un piccolo zlib statico che questo script compila per primo.
OpenSSH su Android è pignolo quanto la storia di crypt() qui sopra, perché il suo configure rileva
male diverse funzioni della libc in cross-compilazione. Lo script codifica la correzione; per
memoria, i pezzi sono:
-
Un seed di cache delle funzioni che bionic non ha ma che configure crede di avere, così che al
loro posto vengano compilate le versioni 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. Senza di essi, ildefines.hdi OpenSSH fa#define __sentinel__(vuoto), che poi rovina il__attribute__((__sentinel__(1)))stesso di bionic in<unistd.h>e ogni compilazione fallisce conexpected ')'. -
Un compat di
explicit_bzeroche usamemset. Ilbzerodi bionic è una macro simile a funzione (non un vero simbolo), quindi il compat di default di OpenSSH, che prende&bzerocome puntatore a funzione, non compila. bionic non ha unexplicit_bzeroproprio. -
Scartare
xcrypt.oegetrrsetbyname.odalla libreria compat.xcrypt.cchiamagetpwent()/crypt()incondizionatamente (bionic non ha né l'uno né l'altro), egetrrsetbyname.cusa interni del resolver che bionic non espone. Nessuno dei due è usato dasftp-serveroscp. -
-Wl,--allow-multiple-definition.reallocarrayè l'immagine speculare delle funzioni in (1): bionic non la dichiara in API 24, quindi OpenSSH compila il proprio compat, ma il simbolo esiste eccome inlibc.a, così i due collidono al link. Permettere il duplicato prende quello di bionic, il che va bene. -
Proteggere
pw_gecosda NULL inpwcopy(). Ilgetpwuid()di bionic restituisce unpw_gecosNULL(Android non tiene un campo GECOS). Ilpwcopy()di OpenSSH proteggepw_passwddaNULLma nonpw_gecos, quindisftp-serverraggiungexstrdup(NULL)e va in SIGSEGV all'avvio, nell'istante in cui una sessione si apre. (scpsul protocollo legacy non chiama maipwcopy, ecco perché funzionava mentre SFTP no.) La build applica una patch apwcopy()per coalescerepw_gecosa"".
Le versioni fissate stanno in cima a 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 24Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.