Repository navigation
nl 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 levert de Dropbear upstream (de tag vastgezet in
UPSTREAM_VERSION) plus de kleine, controleerbare patchset in
patches/. De CI bouwt het; je kunt het lokaal reproduceren.
# eenmalig: een Android NDK (r27 of nieuwer)
export NDK=/path/to/android-ndk
# bouw elke ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# of slechts één, om snel te itereren
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh kloont de vastgezette upstream-tag, past patches/*.patch en localoptions.h toe, en
cross-compileert dan vddropbear en dropbearkey naar module/bin/<abi>/. De uitvoer is een
dynamische ELF (file meldt dynamically linked, interpreter /system/bin/linker64 … for Android 24), gelinkt tegen de bionic-libc die elk Android-toestel al heeft. libtomcrypt blijft ingebed in het
binary; alleen de C-bibliotheek is dynamisch. Zie Dynamisch, geen static-PIE.
De binaries worden niet gecommit; ze worden bij elke tag door de CI gebouwd en aan de release
gehecht. Zie .gitignore.
De wachtwoordauthenticatie van Dropbear is geschreven voor een normale Unix-host met crypt() en
/etc/shadow. Android heeft geen van beide, en dat botst op drie aparte plekken met de build. Dit
deel documenteert ze allemaal, want het is precies het soort ding dat pijnlijk is om opnieuw te
ontdekken. Alles wordt afgehandeld door patch
0003-password-file.patch; niets hieronder wordt tijdens runtime
aan het toeval overgelaten.
De C-bibliotheek van Android (bionic) biedt geen crypt(), crypt_r(), noch een shadow-database. De
NDK stelt geen <crypt.h> beschikbaar. Dus het standaard wachtwoordpad van Dropbear, dat crypt(password, salt) aanroept en vergelijkt met /etc/shadow, kan simpelweg niet gebouwd of uitgevoerd worden op
Android. Er is ook geen libcrypt om tegen te linken, en OpenSSL's libcrypto binnenhalen enkel voor
een wachtwoord-hash zou een grote, onhandige afhankelijkheid zijn voor een statisch binary.
Ons antwoord: crypt() helemaal niet gebruiken. Wachtwoord-auth verifieert het aangeboden
wachtwoord met PBKDF2-HMAC-SHA256 tegen een hash-bestand (DROPBEAR_PASSWD_FILE), een publieke,
standaard, gesalte, geïtereerde KDF. Het bestandsformaat is gedocumenteerd in
patches/README.md.
Nog voordat er code draait, weigert Dropbear te bouwen:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifMet HAVE_CRYPT niet gedefinieerd (altijd, op bionic) en wachtwoord-auth ingeschakeld, is dit een harde
#error. Omdat onze verifier nooit crypt() aanroept, verwijdert patch 0003 deze guard. (De
controle "ten minste één auth-methode moet ingeschakeld zijn" blijft intact.)
Dropbear bedt een uitgeklede libtomcrypt in, die PBKDF2 wel degelijk bevat (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). De voor de hand liggende fix is het aanroepen. Dat werkt niet, om twee
elkaar versterkende redenen:
-
Het prototype is verborgen.
pkcs_5_alg2wordt alleen binnen#ifdef LTC_PKCS_5intomcrypt_pkcs.hgedeclareerd. Dropbears eigen bronbestanden worden niet metLTC_PKCS_5gedefinieerd gecompileerd, dus de declaratie is onzichtbaar en de compiler faalt met implicit function declaration. -
Het symbool bestaat niet. Erger nog, de body van
pkcs_5_alg2zit zelf achter#ifdef LTC_PKCS_5. Dropbears libtomcrypt-build definieert het niet, duspkcs_5_2.ocompileert naar een leeg object: het zit inlibtomcrypt.a, maar bevat geenpkcs_5_alg2-symbool. Het linken faalt metundefined symbol: pkcs_5_alg2.
Je kunt dit zelf zien:
# het object bestaat maar is leeg (geen T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> alleen een datamarkering, geen pkcs_5_alg2
# HMAC daarentegen is volledig gecompileerd (Dropbear gebruikt het voor SSH-MAC's):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> definieert hmac_memoryOns antwoord: PBKDF2 zelf bouwen op de primitieven die Dropbear wel compileert. hmac_memory en
de geregistreerde sha256-hash zijn beide aanwezig en linkbaar, dus patch 0003 implementeert
PBKDF2-HMAC-SHA256 rechtstreeks (RFC 2898; een enkel uitvoerblok van 32 bytes, aangezien dkLen == hLen voor SHA-256). We declareren hmac_memory zelf (zelfde probleem van verborgen prototype als
hierboven) en het object wordt bij het linken uit libtomcrypt.a gehaald. Het resultaat is standaard
PBKDF2 en dus interoperabel: de hash die de WebUI berekent met de WebCrypto deriveBits van de
browser is byte voor byte identiek aan wat de server berekent, geverifieerd tegen Pythons
hashlib.pbkdf2_hmac als een derde, onafhankelijke implementatie.
Kort gezegd: Android geeft je geen
crypt(), en Dropbears ingebedde PBKDF2 wordt tot niets gecompileerd. Wachtwoord-auth is hier een PBKDF2-HMAC-SHA256 vanaf nul boven op libtomcrypts HMAC, met de crypt()-build-guard verwijderd. Geen OpenSSL/libcrypto, geen obfuscatie, geen systeem-shadow.
De binaries zijn dynamisch (gelinkt tegen de systeem-bionic via /system/bin/linker64), niet
statisch. Dit is belangrijk, en het werd op de harde manier geleerd, op een echt toestel, niet in
de CI:
- Een static-PIE-build lijkt in orde (
filemeldt een schonestatic-pie executable) en linkt foutloos, maar doet een SIGSEGV op het moment dat hij op het toestel draait (geverifieerd op een arm64 Android 16-telefoon, exit 139, geen bruikbare tombstone). Statische executables op Android zijn broos; de betrouwbare vorm is een normaal dynamisch binary, wat ook de manier is waarop elke gevestigde Android-dropbear wordt geleverd. - Een statische, non-PIE-build start niet eens: bionic weigert hem met
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Dus de build is dynamisch (
makezonderSTATIC=1;-pie), en linkt alleen de bionic-libc, op elk toestel aanwezig. libtomcrypt blijft statisch in het binary ingebed, dus er is geen extra bibliotheek om te leveren.
Les voor het testen: qemu-aarch64 (qemu-user) is hier geen geldige smoke test (het geeft ook een
segfault op deze binaries), en een geslaagde compile+link evenmin. Draai het binary op een echt arm64
Android-toestel. (Dit is op precies deze manier gevalideerd: de
daemon werd op een alternatieve poort op een live toestel gestart en een wachtwoord-login werd bevestigd
als geslaagd, met een fout wachtwoord afgewezen.)
De server wordt met --disable-syslog gebouwd, dus logt hij altijd naar stderr en de upstream-optie
-E ("log to stderr") bestaat niet in dit binary; hem meegeven print Invalid option -E en de
daemon start nooit. De argumentenbouwer van de module geeft -E daarom niet mee.
Interactieve PTY-sessies gebruiken openpty(). bionic declareert het in <pty.h>, en Dropbears
cross-configure detecteert het met de NDK (HAVE_OPENPTY wordt gezet, HAVE_PTY_H 1), dus is geen
patch nodig; PTY's werken meteen. (Niet-interactief gebruik zoals exec, SFTP, rsync en port-forwarding
hangt er sowieso niet van af.)
scripts/build-bundles.sh cross-compileert de bestandsoverdracht-tools als dynamische binaries naar
module/bin/<abi>/. De CI draait het direct na build.sh.
-
rsync (met ingebedde popt + zlib) compileert schoon zodra je zijn configure vertelt dat bionic
geen
lutimesheeft (ac_cv_func_lutimes=no). -
sftp-server en scp komen van OpenSSH portable, gebouwd met
--without-openssl(OpenSSH's ingebouwde crypto volstaat voor deze twee), met een kleine statische zlib die dit script eerst bouwt.
OpenSSH op Android is net zo lastig als het crypt()-verhaal hierboven, omdat zijn configure
verscheidene libc-functies verkeerd detecteert bij cross-compileren. Het script codeert de fix; voor
de volledigheid zijn de onderdelen:
-
Een cache-seed van functies die bionic mist maar die configure denkt te hebben, zodat in plaats
daarvan de compat-versies gecompileerd worden:
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. Zonder deze doet OpenSSH'sdefines.heen#define __sentinel__(leeg), wat vervolgens bionics eigen__attribute__((__sentinel__(1)))in<unistd.h>verminkt en elke compilatie faalt metexpected ')'. -
Een
explicit_bzero-compat diememsetgebruikt. bionicsbzerois een functie-achtige macro (geen echt symbool), dus OpenSSH's standaard-compat, die&bzeroals functiepointer neemt, compileert niet. bionic heeft geen eigenexplicit_bzero. -
xcrypt.oengetrrsetbyname.oweglaten uit de compat-bibliotheek.xcrypt.croeptgetpwent()/crypt()onvoorwaardelijk aan (bionic heeft geen van beide), engetrrsetbyname.cgebruikt resolver-interna die bionic niet blootstelt. Geen van beide wordt gebruikt doorsftp-serverofscp. -
-Wl,--allow-multiple-definition.reallocarrayis het spiegelbeeld van de functies in (1): bionic declareert het niet in API 24, dus OpenSSH compileert zijn eigen compat, maar het symbool bestaat wel degelijk inlibc.a, dus de twee botsen bij het linken. Het duplicaat toestaan neemt dat van bionic, wat prima is. -
pw_gecostegen NULL beschermen inpwcopy(). bionicsgetpwuid()geeft eenNULL-pw_gecosterug (Android houdt geen GECOS-veld bij). OpenSSH'spwcopy()beschermtpw_passwdtegenNULLmaar nietpw_gecos, dussftp-serverbereiktxstrdup(NULL)en doet een SIGSEGV bij het starten, op het moment dat een sessie opent. (scpvia het legacy-protocol roeptpwcopynooit aan, daarom werkte het terwijl SFTP niet werkte.) De build patchtpwcopy()ompw_gecostot""samen te voegen.
De vastgezette versies staan bovenaan 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 24Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.