Repository navigation
pl 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 dostarcza Dropbear upstream (tag przypięty w
UPSTREAM_VERSION) oraz mały, audytowalny zestaw łatek w
patches/. CI go buduje; możesz to odtworzyć lokalnie.
# jednorazowo: Android NDK (r27 lub nowszy)
export NDK=/path/to/android-ndk
# zbuduj każde ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# albo tylko jedno, by iterować szybko
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh klonuje przypięty tag upstream, nakłada patches/*.patch i localoptions.h, a
następnie kompiluje skrośnie vddropbear i dropbearkey do module/bin/<abi>/. Wyjściem jest
dynamiczny ELF (file zgłasza dynamically linked, interpreter /system/bin/linker64 … for Android 24), zlinkowany z libc bionic, którą ma już każde urządzenie z Androidem. libtomcrypt pozostaje wbudowany
w binarkę; dynamiczna jest tylko biblioteka C. Zobacz Dynamiczny, nie static-PIE.
Binarki nie są commitowane; buduje je CI przy każdym tagu i dołącza do wydania. Zobacz
.gitignore.
Uwierzytelnianie hasłem w Dropbear jest napisane dla zwykłego hosta Unix z crypt() i /etc/shadow.
Android nie ma żadnego z nich, i to koliduje z budowaniem w trzech osobnych miejscach. Ten rozdział
dokumentuje każde z nich, bo to dokładnie ten rodzaj rzeczy, który boli przy ponownym odkrywaniu.
Wszystkim zajmuje się łatka 0003-password-file.patch; nic
poniżej nie jest zostawione przypadkowi w czasie działania.
Biblioteka C Androida (bionic) nie dostarcza crypt(), crypt_r() ani bazy shadow. NDK nie udostępnia
żadnego <crypt.h>. Więc standardowa ścieżka hasła w Dropbear, która wywołuje crypt(password, salt) i
porównuje z /etc/shadow, po prostu nie da się zbudować ani uruchomić na Androidzie. Nie ma też żadnego
libcrypt do zlinkowania, a wciąganie libcrypto z OpenSSL tylko dla skrótu hasła byłoby dużą,
niewygodną zależnością dla statycznej binarki.
Nasza odpowiedź: w ogóle nie używać crypt(). Uwierzytelnianie hasłem weryfikuje przedstawione
hasło za pomocą PBKDF2-HMAC-SHA256 wobec pliku skrótu (DROPBEAR_PASSWD_FILE), publicznej,
standardowej, solonej, iterowanej KDF. Format pliku jest udokumentowany w
patches/README.md.
Jeszcze zanim uruchomi się jakikolwiek kod, Dropbear odmawia budowania:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifPrzy niezdefiniowanym HAVE_CRYPT (zawsze, na bionic) i włączonym uwierzytelnianiu hasłem, to twardy
#error. Ponieważ nasz weryfikator nigdy nie wywołuje crypt(), łatka 0003 usuwa tego strażnika.
(Pozostawia nietkniętą kontrolę „co najmniej jedna metoda uwierzytelniania musi być włączona".)
Dropbear wbudowuje okrojony libtomcrypt, który rzeczywiście zawiera PBKDF2 (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). Oczywistą poprawką jest go wywołać. To nie działa, z dwóch nakładających
się powodów:
-
Prototyp jest ukryty.
pkcs_5_alg2jest deklarowany tylko wewnątrz#ifdef LTC_PKCS_5wtomcrypt_pkcs.h. Własne pliki źródłowe Dropbear nie są kompilowane ze zdefiniowanymLTC_PKCS_5, więc deklaracja jest niewidoczna, a kompilator zgłasza błąd implicit function declaration. -
Symbol nie istnieje. Gorzej, samo ciało
pkcs_5_alg2również jest za#ifdef LTC_PKCS_5. Build libtomcrypt w Dropbear tego nie definiuje, więcpkcs_5_2.okompiluje się do pustego obiektu: jest wlibtomcrypt.a, ale nie zawiera żadnego symbolupkcs_5_alg2. Linkowanie kończy się błędemundefined symbol: pkcs_5_alg2.
Możesz to sam zobaczyć:
# obiekt istnieje, ale jest pusty (brak T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> tylko znacznik danych, brak pkcs_5_alg2
# HMAC natomiast jest w pełni skompilowany (Dropbear używa go do MAC-ów SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> definiuje hmac_memoryNasza odpowiedź: zbudować PBKDF2 samodzielnie na prymitywach, które Dropbear rzeczywiście
kompiluje. hmac_memory oraz zarejestrowany skrót sha256 są oba obecne i linkowalne, więc łatka
0003 implementuje PBKDF2-HMAC-SHA256 bezpośrednio (RFC 2898; pojedynczy 32-bajtowy blok wyjściowy, bo
dkLen == hLen dla SHA-256). Deklarujemy hmac_memory samodzielnie (ten sam problem ukrytego prototypu
co wyżej), a obiekt jest wyciągany z libtomcrypt.a przy linkowaniu. Wynikiem jest standardowy PBKDF2,
a więc interoperacyjny: skrót, który WebUI liczy za pomocą WebCrypto deriveBits przeglądarki, jest
bajt w bajt identyczny z tym, który liczy serwer, zweryfikowany wobec hashlib.pbkdf2_hmac Pythona jako
trzeciej, niezależnej implementacji.
W skrócie: Android nie daje ci żadnego
crypt(), a wbudowany PBKDF2 Dropbear jest kompilowany do niczego. Uwierzytelnianie hasłem to tutaj PBKDF2-HMAC-SHA256 od zera na HMAC z libtomcrypt, z usuniętym strażnikiem kompilacji crypt(). Bez OpenSSL/libcrypto, bez zaciemniania, bez systemowego shadow.
Binarki są dynamiczne (zlinkowane z systemowym bionic przez /system/bin/linker64), nie statyczne.
To ma znaczenie i zostało nauczone w trudny sposób, na prawdziwym urządzeniu, nie w CI:
- Build static-PIE wygląda dobrze (
filezgłasza czystystatic-pie executable) i linkuje się bez błędu, ale robi SIGSEGV w chwili, gdy uruchamia się na urządzeniu (zweryfikowane na telefonie arm64 z Androidem 16, exit 139, brak użytecznego tombstone). Statyczne pliki wykonywalne na Androidzie są kruche; niezawodną formą jest zwykła dynamiczna binarka, co jest również sposobem, w jaki dostarczany jest każdy utrwalony dropbear na Androida. - Build statyczny, non-PIE nawet się nie uruchamia: bionic go odrzuca z
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Więc build jest dynamiczny (
makebezSTATIC=1;-pie), linkując tylko libc bionic, obecną na każdym urządzeniu. libtomcrypt wciąż jest statycznie wbudowany w binarkę, więc nie ma dodatkowej biblioteki do dostarczenia.
Lekcja na testy: qemu-aarch64 (qemu-user) nie jest tutaj prawidłowym smoke testem (również robi
segfault na tych binarkach), a udana kompilacja+linkowanie też nie. Uruchom binarkę na prawdziwym
urządzeniu arm64 z Androidem. (To zweryfikowano dokładnie w ten sposób: daemon został uruchomiony na alternatywnym porcie na żywym urządzeniu, a logowanie hasłem
zostało potwierdzone jako udane, z odrzuconym błędnym hasłem.)
Serwer jest budowany z --disable-syslog, więc zawsze loguje do stderr, a opcja -E z upstream ("log
to stderr") nie istnieje w tej binarce; przekazanie jej wypisuje Invalid option -E i daemon nigdy
się nie uruchamia. Dlatego budowniczy argumentów modułu nie przekazuje -E.
Interaktywne sesje PTY używają openpty(). bionic deklaruje je w <pty.h>, a skrośny configure
Dropbear wykrywa je z NDK (HAVE_OPENPTY jest ustawiane, HAVE_PTY_H 1), więc żadna łatka nie jest
potrzebna; PTY działają od razu. (Użycie nieinteraktywne, jak exec, SFTP, rsync i przekazywanie
portów, i tak od tego nie zależy.)
scripts/build-bundles.sh kompiluje skrośnie narzędzia do transferu plików jako dynamiczne binarki do
module/bin/<abi>/. CI uruchamia je zaraz po build.sh.
-
rsync (z wbudowanymi popt + zlib) kompiluje się czysto, gdy tylko powiesz jego configure, że
bionic nie ma
lutimes(ac_cv_func_lutimes=no). -
sftp-server i scp pochodzą z OpenSSH portable, budowane z
--without-openssl(wbudowana krypto OpenSSH wystarcza dla tych dwóch), z małym statycznym zlib, który ten skrypt buduje jako pierwszy.
OpenSSH na Androidzie jest tak samo kapryśny jak historia crypt() powyżej, bo jego configure błędnie
wykrywa kilka funkcji libc przy kompilacji skrośnej. Skrypt koduje poprawkę; dla porządku, elementy to:
-
Seed cache funkcji, których bionic nie ma, ale configure sądzi, że je ma, aby zamiast nich
kompilowane były wersje 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 robi#define __sentinel__(puste), co następnie psuje własny__attribute__((__sentinel__(1)))bionic w<unistd.h>i każda kompilacja kończy się błędemexpected ')'. -
Compat
explicit_bzero, który używamemset.bzerobionic to makro funkcyjne (nie prawdziwy symbol), więc domyślny compat OpenSSH, który bierze&bzerojako wskaźnik funkcji, nie kompiluje się. bionic nie ma własnegoexplicit_bzero. -
Odrzucenie
xcrypt.oigetrrsetbyname.oz biblioteki compat.xcrypt.cwywołujegetpwent()/crypt()bezwarunkowo (bionic nie ma żadnego z nich), agetrrsetbyname.cużywa wewnętrznych elementów resolvera, których bionic nie udostępnia. Żadne z nich nie jest używane przezsftp-serveraniscp. -
-Wl,--allow-multiple-definition.reallocarrayto lustrzane odbicie funkcji z (1): bionic nie deklaruje go w API 24, więc OpenSSH kompiluje własny compat, ale symbol jak najbardziej istnieje wlibc.a, więc oba kolidują przy linkowaniu. Dopuszczenie duplikatu bierze ten z bionic, co jest w porządku. -
Zabezpieczenie
pw_gecosprzed NULL wpwcopy().getpwuid()bionic zwracaNULL-owepw_gecos(Android nie trzyma pola GECOS).pwcopy()OpenSSH zabezpieczapw_passwdprzedNULL, ale niepw_gecos, więcsftp-serverdochodzi doxstrdup(NULL)i robi SIGSEGV przy starcie, w chwili, gdy otwiera się sesja. (scpprzez protokół legacy nigdy nie wywołujepwcopy, dlatego działał, podczas gdy SFTP nie.) Build łatapwcopy(), by scalićpw_gecosdo"".
Przypięte wersje znajdują się na górze 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 24Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.