Repository navigation
sv 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 levererar Dropbear upstream (taggen som är fäst i
UPSTREAM_VERSION) plus den lilla, granskningsbara patchuppsättningen i
patches/. CI bygger det; du kan reproducera det lokalt.
# en gång: ett Android NDK (r27 eller nyare)
export NDK=/path/to/android-ndk
# bygg varje ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# eller bara en, för att iterera snabbt
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh klonar den fästa upstream-taggen, applicerar patches/*.patch och localoptions.h,
och korskompilerar sedan vddropbear och dropbearkey till module/bin/<abi>/. Utdata är en
dynamisk ELF (file rapporterar dynamically linked, interpreter /system/bin/linker64 … for Android 24), länkad mot bionic-libc som varje Android-enhet redan har. libtomcrypt förblir inbäddat i binären;
endast C-biblioteket är dynamiskt. Se Dynamisk, inte static-PIE.
Binärerna committas inte; de byggs av CI vid varje tagg och bifogas till releasen. Se
.gitignore.
Dropbears lösenordsautentisering är skriven för en vanlig Unix-värd med crypt() och /etc/shadow.
Android har ingetdera, och det krockar med bygget på tre separata ställen. Det här avsnittet
dokumenterar var och en av dem, för det är precis den sortens sak som är smärtsam att återupptäcka. Allt
hanteras av patchen 0003-password-file.patch; inget nedan
lämnas åt slumpen vid körning.
Androids C-bibliotek (bionic) tillhandahåller varken crypt(), crypt_r() eller en shadow-databas. NDK
exponerar ingen <crypt.h>. Så Dropbears standardlösenordsväg, som anropar crypt(password, salt) och
jämför mot /etc/shadow, går helt enkelt inte att bygga eller köra på Android. Det finns inte heller
något libcrypt att länka mot, och att dra in OpenSSL:s libcrypto bara för en lösenordshash vore ett
stort, otympligt beroende för en statisk binär.
Vårt svar: använd inte crypt() alls. Lösenordsautentiseringen verifierar det angivna lösenordet
med PBKDF2-HMAC-SHA256 mot en hashfil (DROPBEAR_PASSWD_FILE), en publik, standard, saltad, itererad
KDF. Filformatet är dokumenterat i patches/README.md.
Redan innan någon kod körs vägrar Dropbear att bygga:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifMed HAVE_CRYPT odefinierat (alltid, på bionic) och lösenordsautentisering påslagen är detta ett hårt
#error. Eftersom vår verifierare aldrig anropar crypt(), tar patchen 0003 bort det här
skyddet. (Den lämnar kontrollen "minst en autentiseringsmetod måste vara påslagen" orörd.)
Dropbear bäddar in en nedbantad libtomcrypt, som faktiskt innehåller PBKDF2 (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). Den uppenbara lösningen är att anropa det. Det fungerar inte, av två
samverkande skäl:
-
Prototypen är dold.
pkcs_5_alg2deklareras bara inuti#ifdef LTC_PKCS_5itomcrypt_pkcs.h. Dropbears egna källfiler kompileras inte medLTC_PKCS_5definierat, så deklarationen är osynlig och kompilatorn felar med implicit function declaration. -
Symbolen finns inte. Värre, själva kroppen av
pkcs_5_alg2ligger också bakom#ifdef LTC_PKCS_5. Dropbears libtomcrypt-bygge definierar det inte, såpkcs_5_2.okompileras till ett tomt objekt: det finns ilibtomcrypt.a, men innehåller ingenpkcs_5_alg2-symbol. Länkningen misslyckas medundefined symbol: pkcs_5_alg2.
Du kan se det själv:
# objektet finns men är tomt (ingen T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> bara en datamarkör, ingen pkcs_5_alg2
# HMAC är däremot fullt kompilerat (Dropbear använder det för SSH-MAC:er):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> definierar hmac_memoryVårt svar: bygga PBKDF2 själva ovanpå primitiverna som Dropbear faktiskt kompilerar. hmac_memory
och den registrerade sha256-hashen finns båda och går att länka, så patchen 0003 implementerar
PBKDF2-HMAC-SHA256 direkt (RFC 2898; ett enda 32-bytes utdatablock, eftersom dkLen == hLen för
SHA-256). Vi deklarerar hmac_memory själva (samma dolda-prototyp-problem som ovan) och objektet dras
ur libtomcrypt.a vid länkning. Resultatet är standard-PBKDF2 och därmed interoperabelt: hashen som
WebUI beräknar med webbläsarens WebCrypto deriveBits är byte för byte identisk med vad servern
beräknar, verifierat mot Pythons hashlib.pbkdf2_hmac som en tredje, oberoende implementation.
Kort sagt: Android ger dig inget
crypt(), och Dropbears inbäddade PBKDF2 kompileras till ingenting. Lösenordsautentiseringen här är ett PBKDF2-HMAC-SHA256 från grunden ovanpå libtomcrypts HMAC, med crypt()-byggskyddet borttaget. Inget OpenSSL/libcrypto, ingen obfuskering, ingen system-shadow.
Binärerna är dynamiska (länkade mot systemets bionic via /system/bin/linker64), inte statiska. Det
spelar roll, och det lärdes på det hårda sättet, på en riktig enhet, inte i CI:
- Ett static-PIE-bygge ser bra ut (
filerapporterar en renstatic-pie executable) och länkar utan fel, men gör en SIGSEGV i samma stund som det körs på enheten (verifierat på en arm64 Android 16-telefon, exit 139, ingen användbar tombstone). Statiska körbara filer på Android är sköra; den pålitliga formen är en vanlig dynamisk binär, vilket också är hur varje etablerad Android-dropbear levereras. - Ett statiskt, non-PIE-bygge startar inte ens: bionic avvisar det med
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Så bygget är dynamiskt (
makeutanSTATIC=1;-pie), och länkar bara bionic-libc, som finns på varje enhet. libtomcrypt är fortfarande statiskt inbäddat i binären, så det finns inget extra bibliotek att leverera.
Lärdom för testning: qemu-aarch64 (qemu-user) är inte ett giltigt smoke test här (det ger också
segfault på dessa binärer), och inte heller ett lyckat compile+link. Kör binären på en riktig arm64
Android-enhet. (Detta validerades på precis detta sätt: daemonen startades
på en alternativ port på en levande enhet och en lösenordsinloggning bekräftades lyckas, med ett
felaktigt lösenord avvisat.)
Servern byggs med --disable-syslog, så den loggar alltid till stderr och upstream-alternativet -E
("log to stderr") finns inte i denna binär; att skicka det skriver ut Invalid option -E och
daemonen startar aldrig. Modulens argumentbyggare skickar därför inte -E.
Interaktiva PTY-sessioner använder openpty(). bionic deklarerar det i <pty.h>, och Dropbears
kors-configure upptäcker det med NDK (HAVE_OPENPTY sätts, HAVE_PTY_H 1), så ingen patch behövs;
PTY:er fungerar direkt. (Icke-interaktiv användning som exec, SFTP, rsync och portvidarebefordran är ändå
inte beroende av det.)
scripts/build-bundles.sh korskompilerar filöverföringsverktygen som dynamiska binärer till
module/bin/<abi>/. CI kör det direkt efter build.sh.
-
rsync (med inbäddat popt + zlib) kompilerar rent så fort du talar om för dess configure att bionic
inte har
lutimes(ac_cv_func_lutimes=no). -
sftp-server och scp kommer från OpenSSH portable, byggda med
--without-openssl(OpenSSH:s inbyggda krypto räcker för dessa två), med ett litet statiskt zlib som detta skript bygger först.
OpenSSH på Android är lika kinkigt som crypt()-historien ovan, eftersom dess configure feldetekterar
flera libc-funktioner vid korskompilering. Skriptet kodar fixen; för protokollet är delarna:
-
Ett cache-seed av funktioner som bionic saknar men som configure tror att det har, så att
compat-versionerna kompileras istället:
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. Utan dessa gör OpenSSH:sdefines.hett#define __sentinel__(tomt), vilket sedan förvanskar bionics eget__attribute__((__sentinel__(1)))i<unistd.h>och varje kompilering misslyckas medexpected ')'. -
En
explicit_bzero-compat som användermemset. bionicsbzeroär ett funktionsliknande makro (inte en riktig symbol), så OpenSSH:s standard-compat, som tar&bzerosom funktionspekare, kompilerar inte. bionic har ingen egenexplicit_bzero. -
Att släppa
xcrypt.oochgetrrsetbyname.ofrån compat-biblioteket.xcrypt.canropargetpwent()/crypt()ovillkorligt (bionic har ingetdera), ochgetrrsetbyname.canvänder resolver-interna delar som bionic inte exponerar. Ingen av dem används avsftp-serverellerscp. -
-Wl,--allow-multiple-definition.reallocarrayär spegelbilden av funktionerna i (1): bionic deklarerar det inte i API 24, så OpenSSH kompilerar sin egen compat, men symbolen finns visst ilibc.a, så de två krockar vid länkning. Att tillåta dubbletten tar bionics, vilket är bra. -
Att NULL-skydda
pw_gecosipwcopy(). bionicsgetpwuid()returnerar ettNULL-pw_gecos(Android håller inget GECOS-fält). OpenSSH:spwcopy()skyddarpw_passwdmotNULLmen intepw_gecos, såsftp-servernårxstrdup(NULL)och gör en SIGSEGV vid start, i samma stund en session öppnas. (scpöver det äldre protokollet anropar aldrigpwcopy, vilket är varför det fungerade medan SFTP inte gjorde det.) Bygget patcharpwcopy()för att slå sammanpw_gecostill"".
De fästa versionerna ligger överst i 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 24Denna dokumentation genererades med Claude (Anthropic) och underhålls av VD171. Rättelser och förbättringar välkomnas; se CONTRIBUTING.md.