Repository navigation
cs 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 dodává Dropbear upstream (tag připnutý v
UPSTREAM_VERSION) plus malou, auditovatelnou sadu patchů v
patches/. CI jej sestavuje; můžeš to reprodukovat lokálně.
# jednorázově: Android NDK (r27 nebo novější)
export NDK=/path/to/android-ndk
# sestav každé ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# nebo jen jedno, pro rychlé iterace
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh naklonuje připnutý upstream tag, aplikuje patches/*.patch a localoptions.h a poté
křížově zkompiluje vddropbear a dropbearkey do module/bin/<abi>/. Výstupem je dynamický ELF
(file hlásí dynamically linked, interpreter /system/bin/linker64 … for Android 24), slinkovaný proti
bionic libc, kterou každé zařízení s Androidem už má. libtomcrypt zůstává vestavěný v binárce; dynamická
je jen knihovna C. Viz Dynamický, ne static-PIE.
Binárky se necommitují; sestavuje je CI při každém tagu a připojuje je k vydání. Viz
.gitignore.
Autentizace heslem v Dropbearu je napsaná pro běžný unixový host s crypt() a /etc/shadow. Android
nemá ani jedno, a to naráží na sestavení na třech samostatných místech. Tato sekce dokumentuje každé
z nich, protože je to přesně ten druh věci, který je bolestivé znovu objevovat. Vše řeší patch
0003-password-file.patch; nic níže není za běhu ponecháno
náhodě.
Knihovna C Androidu (bionic) neposkytuje crypt(), crypt_r() ani databázi shadow. NDK nevystavuje
žádné <crypt.h>. Takže standardní cesta hesla v Dropbearu, která volá crypt(password, salt) a
porovnává proti /etc/shadow, jednoduše nejde na Androidu sestavit ani spustit. Není ani žádné
libcrypt, se kterým by se dalo slinkovat, a tahat libcrypto z OpenSSL jen kvůli hashi hesla by byla
velká, nemotorná závislost pro statickou binárku.
Naše odpověď: crypt() vůbec nepoužívat. Autentizace heslem ověřuje předložené heslo pomocí
PBKDF2-HMAC-SHA256 proti souboru hashů (DROPBEAR_PASSWD_FILE), veřejné, standardní, solené,
iterované KDF. Formát souboru je zdokumentován v patches/README.md.
Ještě než se spustí jakýkoli kód, Dropbear odmítne sestavení:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifS nedefinovaným HAVE_CRYPT (vždy, na bionicu) a zapnutou autentizací heslem je tohle tvrdý #error.
Protože náš ověřovač nikdy nevolá crypt(), patch 0003 tuto kontrolu odstraňuje. (Ponechává
nedotčenou kontrolu „musí být zapnutá alespoň jedna metoda autentizace".)
Dropbear vestavuje ořezaný libtomcrypt, který PBKDF2 skutečně obsahuje (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). Zřejmou opravou je jej zavolat. Nefunguje to, ze dvou skládajících se
důvodů:
-
Prototyp je skrytý.
pkcs_5_alg2je deklarován pouze uvnitř#ifdef LTC_PKCS_5vtomcrypt_pkcs.h. Vlastní zdrojové soubory Dropbearu se nekompilují s definovanýmLTC_PKCS_5, takže deklarace je neviditelná a kompilátor selže s implicit function declaration. -
Symbol neexistuje. Hůř, samotné tělo
pkcs_5_alg2je také za#ifdef LTC_PKCS_5. Build libtomcrypt v Dropbearu jej nedefinuje, takžepkcs_5_2.ose zkompiluje do prázdného objektu: je vlibtomcrypt.a, ale neobsahuje žádný symbolpkcs_5_alg2. Linkování selže sundefined symbol: pkcs_5_alg2.
Můžeš si to ověřit sám:
# objekt existuje, ale je prázdný (žádné T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> jen datová značka, žádné pkcs_5_alg2
# HMAC je naopak plně zkompilován (Dropbear jej používá pro MAC v SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> definuje hmac_memoryNaše odpověď: sestavit PBKDF2 sami nad primitivy, které Dropbear skutečně kompiluje. hmac_memory
i registrovaný hash sha256 jsou oba přítomné a linkovatelné, takže patch 0003 implementuje
PBKDF2-HMAC-SHA256 přímo (RFC 2898; jediný 32bajtový výstupní blok, protože dkLen == hLen pro
SHA-256). hmac_memory deklarujeme sami (stejný problém se skrytým prototypem jako výše) a objekt se při
linkování vytáhne z libtomcrypt.a. Výsledkem je standardní PBKDF2, a tedy interoperabilní: hash, který
WebUI počítá pomocí WebCrypto deriveBits prohlížeče, je bajt po bajtu identický s tím, co počítá
server, ověřeno proti hashlib.pbkdf2_hmac v Pythonu jako třetí, nezávislé implementaci.
Stručně: Android ti nedá žádné
crypt()a vestavěné PBKDF2 Dropbearu je zkompilováno do ničeho. Autentizace heslem je tu PBKDF2-HMAC-SHA256 od nuly nad HMAC z libtomcrypt, s odstraněnou kontrolou sestavení crypt(). Žádné OpenSSL/libcrypto, žádná obfuskace, žádné systémové shadow.
Binárky jsou dynamické (slinkované proti systémovému bionicu přes /system/bin/linker64), ne
statické. Na tom záleží a bylo to naučeno tvrdě, na skutečném zařízení, ne v CI:
- Build static-PIE vypadá v pořádku (
filehlásí čistýstatic-pie executable) a slinkuje se bez chyby, ale udělá SIGSEGV v okamžiku, kdy se spustí na zařízení (ověřeno na telefonu arm64 s Androidem 16, exit 139, žádný užitečný tombstone). Statické spustitelné soubory na Androidu jsou křehké; spolehlivou formou je běžná dynamická binárka, což je také způsob, jakým se dodává každý zavedený dropbear pro Android. - Build statický, non-PIE se ani nespustí: bionic jej odmítne s
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Takže build je dynamický (
makebezSTATIC=1;-pie), linkující jen bionic libc, přítomnou na každém zařízení. libtomcrypt je stále staticky vestavěný v binárce, takže není žádná knihovna navíc k dodání.
Lekce pro testování: qemu-aarch64 (qemu-user) zde není platný smoke test (na těchto binárkách také
padá segfaultem), a úspěšná kompilace+linkování také ne. Spusť binárku na skutečném zařízení arm64 s
Androidem. (Tohle bylo validováno přesně takto: daemon
byl spuštěn na alternativním portu na živém zařízení a přihlášení heslem bylo potvrzeno jako úspěšné, se
zamítnutým chybným heslem.)
Server je sestaven s --disable-syslog, takže vždy loguje do stderr a upstreamová volba -E ("log to
stderr") v této binárce neexistuje; její předání vypíše Invalid option -E a daemon se nikdy
nespustí. Builder argumentů modulu proto -E nepředává.
Interaktivní relace PTY používají openpty(). bionic jej deklaruje v <pty.h> a křížový configure
Dropbearu jej detekuje pomocí NDK (HAVE_OPENPTY se nastaví, HAVE_PTY_H 1), takže žádný patch není
potřeba; PTY fungují rovnou. (Neinteraktivní použití jako exec, SFTP, rsync a přesměrování portů na
něm stejně nezávisí.)
scripts/build-bundles.sh křížově kompiluje nástroje pro přenos souborů jako dynamické binárky do
module/bin/<abi>/. CI jej spouští hned po build.sh.
-
rsync (s vestavěnými popt + zlib) se zkompiluje čistě, jakmile jeho configure řekneš, že bionic
nemá
lutimes(ac_cv_func_lutimes=no). -
sftp-server a scp pocházejí z OpenSSH portable, sestavené s
--without-openssl(vestavěná krypto OpenSSH pro tyto dva stačí), s malým statickým zlib, který tento skript sestaví jako první.
OpenSSH na Androidu je stejně vybíravé jako příběh crypt() výše, protože jeho configure při křížové
kompilaci špatně detekuje několik funkcí libc. Skript opravu kóduje; pro pořádek jsou díly:
-
Seed cache funkcí, které bionicu chybí, ale configure si myslí, že je má, aby se místo nich
zkompilovaly verze 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. Bez nichdefines.hOpenSSH udělá#define __sentinel__(prázdné), což pak zmrší vlastní__attribute__((__sentinel__(1)))bionicu v<unistd.h>a každá kompilace selže sexpected ')'. -
Compat
explicit_bzero, který používámemset.bzerobionicu je makro podobné funkci (ne skutečný symbol), takže výchozí compat OpenSSH, který bere&bzerojako ukazatel na funkci, se nezkompiluje. bionic nemá vlastníexplicit_bzero. -
Vyřazení
xcrypt.oagetrrsetbyname.oz knihovny compat.xcrypt.cvolágetpwent()/crypt()bezpodmínečně (bionic nemá ani jedno) agetrrsetbyname.cpoužívá vnitřnosti resolveru, které bionic nevystavuje. Ani jedno není používánosftp-serveraniscp. -
-Wl,--allow-multiple-definition.reallocarrayje zrcadlovým obrazem funkcí z (1): bionic jej v API 24 nedeklaruje, takže OpenSSH kompiluje vlastní compat, ale symbol vlibc.aexistuje, takže oba při linkování kolidují. Povolení duplikátu vezme ten z bionicu, což je v pořádku. -
Ošetření
pw_gecosproti NULL vpwcopy().getpwuid()bionicu vracíNULL-ovépw_gecos(Android nevede pole GECOS).pwcopy()OpenSSH ošetřujepw_passwdprotiNULL, ale nepw_gecos, takžesftp-serverdosáhnexstrdup(NULL)a udělá SIGSEGV při startu, v okamžiku, kdy se otevře relace. (scppřes legacy protokolpwcopynikdy nevolá, proto fungoval, zatímco SFTP ne.) Build patchujepwcopy(), aby sloučilpw_gecosna"".
Připnuté verze jsou nahoře v 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 24Tato dokumentace byla vytvořena pomocí Claude (Anthropic) a spravuje ji VD171. Opravy a vylepšení jsou vítány; viz CONTRIBUTING.md.