Repository navigation
vi 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 cung cấp Dropbear upstream (tag được ghim trong
UPSTREAM_VERSION) cùng bộ patch nhỏ, có thể kiểm toán trong
patches/. CI biên dịch nó; bạn có thể tái tạo cục bộ.
# một lần: một Android NDK (r27 trở lên)
export NDK=/path/to/android-ndk
# biên dịch mọi ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# hoặc chỉ một, để lặp nhanh
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh clone tag upstream được ghim, áp dụng patches/*.patch và localoptions.h, rồi biên
dịch chéo vddropbear và dropbearkey vào module/bin/<abi>/. Đầu ra là một ELF động (file báo
dynamically linked, interpreter /system/bin/linker64 … for Android 24), liên kết với libc bionic mà
mọi thiết bị Android đã có sẵn. libtomcrypt vẫn được nhúng bên trong tệp nhị phân; chỉ thư viện C là
động. Xem Động, không phải static-PIE.
Các tệp nhị phân không được commit; chúng được CI biên dịch ở mỗi tag và đính kèm vào bản phát hành.
Xem .gitignore.
Xác thực bằng mật khẩu của Dropbear được viết cho một máy chủ Unix thông thường với crypt() và
/etc/shadow. Android không có cả hai, và điều đó xung đột với quá trình biên dịch ở ba chỗ riêng
biệt. Phần này ghi lại từng chỗ, vì đây đúng là loại việc gây đau đớn khi phải khám phá lại. Tất cả được
xử lý bởi patch 0003-password-file.patch; không có gì bên dưới
bị phó mặc cho may rủi lúc chạy.
Thư viện C của Android (bionic) không cung cấp crypt(), crypt_r(), hay một cơ sở dữ liệu shadow. NDK
không phơi bày bất kỳ <crypt.h> nào. Vậy nên đường đi mật khẩu tiêu chuẩn của Dropbear, vốn gọi
crypt(password, salt) và so sánh với /etc/shadow, đơn giản là không thể biên dịch hay chạy trên
Android. Cũng không có libcrypt nào để liên kết, và kéo libcrypto của OpenSSL vào chỉ vì một hash mật
khẩu sẽ là một phụ thuộc lớn, vụng về cho một tệp nhị phân tĩnh.
Câu trả lời của chúng tôi: không dùng crypt() chút nào. Xác thực mật khẩu kiểm tra mật khẩu được
cung cấp bằng PBKDF2-HMAC-SHA256 đối chiếu với một tệp hash (DROPBEAR_PASSWD_FILE), một KDF công
khai, chuẩn, có salt và lặp. Định dạng tệp được ghi lại trong patches/README.md.
Ngay cả trước khi bất kỳ mã nào chạy, Dropbear từ chối biên dịch:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifVới HAVE_CRYPT không được định nghĩa (luôn luôn, trên bionic) và xác thực mật khẩu được bật, đây là một
#error cứng. Vì trình xác minh của chúng tôi không bao giờ gọi crypt(), patch 0003 loại bỏ bộ bảo
vệ này. (Nó giữ nguyên kiểm tra "ít nhất một phương thức xác thực phải được bật".)
Dropbear nhúng một libtomcrypt đã cắt gọt, vốn thực sự chứa PBKDF2 (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c). Cách sửa hiển nhiên là gọi nó. Nó không hoạt động, vì hai lý do cộng dồn:
-
Nguyên mẫu bị ẩn.
pkcs_5_alg2chỉ được khai báo bên trong#ifdef LTC_PKCS_5trongtomcrypt_pkcs.h. Các tệp nguồn của chính Dropbear không được biên dịch vớiLTC_PKCS_5được định nghĩa, nên khai báo bị vô hình và trình biên dịch báo lỗi implicit function declaration. -
Biểu tượng không tồn tại. Tệ hơn, thân của
pkcs_5_alg2cũng nằm sau#ifdef LTC_PKCS_5. Bản build libtomcrypt của Dropbear không định nghĩa nó, nênpkcs_5_2.obiên dịch thành một đối tượng rỗng: nó nằm tronglibtomcrypt.a, nhưng không chứa biểu tượngpkcs_5_alg2nào. Việc liên kết thất bại vớiundefined symbol: pkcs_5_alg2.
Bạn có thể tự thấy điều này:
# đối tượng tồn tại nhưng rỗng (không có T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> chỉ một dấu dữ liệu, không có pkcs_5_alg2
# HMAC thì ngược lại được biên dịch đầy đủ (Dropbear dùng nó cho các MAC của SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> định nghĩa hmac_memoryCâu trả lời của chúng tôi: tự xây PBKDF2 trên các nguyên thủy mà Dropbear thực sự biên dịch.
hmac_memory và hash sha256 đã đăng ký đều hiện diện và có thể liên kết, nên patch 0003 triển khai
PBKDF2-HMAC-SHA256 trực tiếp (RFC 2898; một khối đầu ra 32 byte duy nhất, vì dkLen == hLen với
SHA-256). Chúng tôi tự khai báo hmac_memory (cùng vấn đề nguyên mẫu bị ẩn như trên) và đối tượng được
kéo từ libtomcrypt.a khi liên kết. Kết quả là PBKDF2 chuẩn và do đó tương thích: hash mà WebUI tính
bằng WebCrypto deriveBits của trình duyệt giống hệt từng byte với hash mà máy chủ tính, được kiểm
chứng đối chiếu với hashlib.pbkdf2_hmac của Python như một triển khai thứ ba, độc lập.
Tóm lại: Android không cho bạn
crypt()nào, và PBKDF2 nhúng của Dropbear biên dịch thành số không. Xác thực mật khẩu ở đây là một PBKDF2-HMAC-SHA256 từ đầu trên HMAC của libtomcrypt, với bộ bảo vệ build crypt() đã bị gỡ. Không OpenSSL/libcrypto, không làm rối, không shadow hệ thống.
Các tệp nhị phân là động (liên kết với bionic hệ thống qua /system/bin/linker64), không phải tĩnh.
Điều này quan trọng, và đã học được theo cách khó khăn, trên thiết bị thật, không phải trong CI:
- Một bản build static-PIE trông ổn (
filebáo mộtstatic-pie executablesạch sẽ) và liên kết không lỗi, nhưng SIGSEGV ngay khoảnh khắc nó chạy trên thiết bị (được kiểm chứng trên điện thoại arm64 Android 16, exit 139, không có tombstone hữu ích). Tệp thực thi tĩnh trên Android dễ vỡ; dạng đáng tin cậy là một tệp nhị phân động thông thường, cũng là cách mọi dropbear Android lâu đời được phân phối. - Một bản build tĩnh, non-PIE thậm chí không khởi động: bionic từ chối nó với
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic. - Vậy nên bản build là động (
makekhông cóSTATIC=1;-pie), chỉ liên kết libc bionic, hiện diện trên mọi thiết bị. libtomcrypt vẫn được nhúng tĩnh vào tệp nhị phân, nên không có thư viện phụ nào để phân phối.
Bài học cho việc kiểm thử: qemu-aarch64 (qemu-user) không phải một smoke test hợp lệ ở đây (nó cũng
segfault trên các tệp nhị phân này), và một compile+link thành công cũng không. Chạy tệp nhị phân trên
một thiết bị Android arm64 thật. (Điều này được xác thực chính xác theo cách này: daemon được khởi chạy trên một cổng thay thế trên thiết bị sống và một lần đăng nhập bằng
mật khẩu được xác nhận là thành công, với mật khẩu sai bị từ chối.)
Máy chủ được build với --disable-syslog, nên nó luôn ghi log ra stderr và tùy chọn -E của upstream
("log to stderr") không tồn tại trong tệp nhị phân này; truyền nó in ra Invalid option -E và daemon
không bao giờ khởi động. Vì vậy bộ dựng đối số của module không truyền -E.
Các phiên PTY tương tác dùng openpty(). bionic khai báo nó trong <pty.h>, và configure chéo của
Dropbear phát hiện nó bằng NDK (HAVE_OPENPTY được đặt, HAVE_PTY_H 1), nên không cần patch nào;
PTY hoạt động ngay. (Việc dùng phi tương tác như exec, SFTP, rsync và chuyển tiếp cổng dù sao cũng không
phụ thuộc vào nó.)
scripts/build-bundles.sh biên dịch chéo các công cụ truyền tệp thành tệp nhị phân động vào
module/bin/<abi>/. CI chạy nó ngay sau build.sh.
-
rsync (với popt + zlib nhúng) biên dịch sạch ngay khi bạn báo cho configure của nó rằng bionic
không có
lutimes(ac_cv_func_lutimes=no). -
sftp-server và scp đến từ OpenSSH portable, build với
--without-openssl(crypto tích hợp của OpenSSH là đủ cho hai cái này), với một zlib tĩnh nhỏ mà script này build trước.
OpenSSH trên Android khó tính y như câu chuyện crypt() ở trên, vì configure của nó phát hiện sai vài
hàm libc khi biên dịch chéo. Script mã hóa bản sửa; để ghi nhận, các mảnh là:
-
Một seed cache của các hàm mà bionic thiếu nhưng configure tưởng là có, để thay vào đó các phiên
bản compat được biên dịch:
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. Thiếu chúng,defines.hcủa OpenSSH làm#define __sentinel__(rỗng), sau đó làm hỏng chính__attribute__((__sentinel__(1)))của bionic trong<unistd.h>và mọi biên dịch thất bại vớiexpected ')'. -
Một compat
explicit_bzerodùngmemset.bzerocủa bionic là một macro giống hàm (không phải biểu tượng thật), nên compat mặc định của OpenSSH, vốn lấy&bzerolàm con trỏ hàm, không biên dịch được. bionic không cóexplicit_bzeroriêng. -
Loại bỏ
xcrypt.ovàgetrrsetbyname.okhỏi thư viện compat.xcrypt.cgọigetpwent()/crypt()vô điều kiện (bionic không có cái nào), vàgetrrsetbyname.cdùng nội bộ resolver mà bionic không phơi bày. Cả hai đều không đượcsftp-serverhayscpdùng. -
-Wl,--allow-multiple-definition.reallocarraylà hình ảnh phản chiếu của các hàm ở (1): bionic không khai báo nó ở API 24, nên OpenSSH biên dịch compat riêng, nhưng biểu tượng thì vẫn tồn tại tronglibc.a, nên hai cái va chạm khi liên kết. Cho phép bản trùng lặp sẽ lấy của bionic, điều đó ổn. -
Bảo vệ
pw_gecoskhỏi NULL trongpwcopy().getpwuid()của bionic trả vềpw_gecosbằngNULL(Android không giữ trường GECOS).pwcopy()của OpenSSH bảo vệpw_passwdkhỏiNULLnhưng không bảo vệpw_gecos, nênsftp-serverchạm tớixstrdup(NULL)và SIGSEGV lúc khởi động, ngay khoảnh khắc một phiên mở ra. (scpqua giao thức cũ không bao giờ gọipwcopy, đó là lý do nó hoạt động trong khi SFTP thì không.) Bản build vápwcopy()để gộppw_gecosthành"".
Các phiên bản được ghim nằm ở đầu 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 24Tài liệu này được tạo bằng Claude (Anthropic) và được duy trì bởi VD171. Chúng tôi hoan nghênh các chỉnh sửa và cải tiến; xem CONTRIBUTING.md.