Repository navigation
th 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 ส่งมอบ Dropbear upstream (แท็กที่ปักหมุดใน
UPSTREAM_VERSION) พร้อมชุดแพตช์เล็กๆ ที่ตรวจสอบได้ใน patches/
CI สร้างมัน คุณสามารถทำซ้ำได้ในเครื่องของคุณ
# ครั้งเดียว: Android NDK (r27 หรือใหม่กว่า)
export NDK=/path/to/android-ndk
# สร้างทุก ABI (arm64-v8a armeabi-v7a x86 x86_64)
./scripts/build.sh
# หรือเพียงหนึ่งตัว เพื่อวนซ้ำอย่างรวดเร็ว
ABIS="arm64-v8a" ./scripts/build.shscripts/build.sh โคลนแท็ก upstream ที่ปักหมุด นำ patches/*.patch และ localoptions.h มาใช้ แล้ว
คอมไพล์ข้าม vddropbear และ dropbearkey ไปยัง module/bin/<abi>/ เอาต์พุตเป็น ELF แบบ ไดนามิก
(file รายงานว่า dynamically linked, interpreter /system/bin/linker64 … for Android 24) ซึ่งลิงก์กับ
bionic libc ที่ทุกอุปกรณ์ Android มีอยู่แล้ว libtomcrypt ยังคงฝังอยู่ภายในไบนารี มีเพียงไลบรารี C เท่านั้น
ที่เป็นไดนามิก ดู ไดนามิก ไม่ใช่ static-PIE
ไบนารี ไม่ถูกคอมมิต ถูกสร้างโดย CI ในทุกแท็กและแนบไปกับรีลีส ดู .gitignore
การยืนยันตัวตนด้วยรหัสผ่านของ Dropbear เขียนขึ้นสำหรับโฮสต์ Unix ปกติที่มี crypt() และ /etc/shadow
Android ไม่มีทั้งสองอย่าง และนั่นปะทะกับการสร้างในสามจุดแยกกัน หัวข้อนี้บันทึกแต่ละจุดไว้ เพราะมันเป็น
สิ่งที่เจ็บปวดเวลาต้องมาค้นพบใหม่อย่างแท้จริง ทั้งหมดนี้จัดการโดยแพตช์
0003-password-file.patch ไม่มีสิ่งใดด้านล่างถูกปล่อยให้เป็นเรื่อง
ของโชคในเวลารันไทม์
ไลบรารี C ของ Android (bionic) ไม่มี crypt(), crypt_r() หรือฐานข้อมูล shadow NDK ไม่เปิดเผย
<crypt.h> ใดๆ ดังนั้นเส้นทางรหัสผ่านมาตรฐานของ Dropbear ที่เรียก crypt(password, salt) และเทียบกับ
/etc/shadow จึงไม่สามารถสร้างหรือรันบน Android ได้เลย อีกทั้งไม่มี libcrypt ให้ลิงก์ และการดึง
libcrypto ของ OpenSSL มาเพียงเพื่อแฮชรหัสผ่านก็จะเป็นการพึ่งพาขนาดใหญ่และเทอะทะสำหรับไบนารีแบบสแตติก
คำตอบของเรา: ไม่ใช้ crypt() เลย การยืนยันตัวตนด้วยรหัสผ่านตรวจสอบรหัสผ่านที่ให้มาด้วย
PBKDF2-HMAC-SHA256 เทียบกับไฟล์แฮช (DROPBEAR_PASSWD_FILE) ซึ่งเป็น KDF ที่เปิดเผย เป็นมาตรฐาน มีเกลือ
และวนซ้ำ รูปแบบไฟล์มีบันทึกไว้ใน patches/README.md
ก่อนที่โค้ดใดจะทำงานด้วยซ้ำ Dropbear ปฏิเสธที่จะสร้าง:
#if DROPBEAR_SVR_PASSWORD_AUTH && !HAVE_CRYPT
#error "DROPBEAR_SVR_PASSWORD_AUTH requires `crypt()'."
#endifเมื่อ HAVE_CRYPT ไม่ถูกนิยาม (เสมอ บน bionic) และเปิดการยืนยันตัวตนด้วยรหัสผ่าน นี่คือ #error ที่
เด็ดขาด เนื่องจากตัวตรวจสอบของเราไม่เคยเรียก crypt() แพตช์ 0003 จึง ลบตัวป้องกันนี้ออก (โดยคงการ
ตรวจสอบ «ต้องเปิดใช้งานวิธีการยืนยันตัวตนอย่างน้อยหนึ่งวิธี» ไว้ไม่แตะต้อง)
Dropbear ฝัง libtomcrypt แบบตัดทอน ซึ่ง มี PBKDF2 อยู่จริง (pkcs_5_alg2,
src/misc/pkcs5/pkcs_5_2.c) การแก้ที่เห็นได้ชัดคือเรียกใช้มัน มันไม่ทำงาน ด้วยสองเหตุผลที่เสริมกัน:
-
โปรโตไทป์ถูกซ่อน
pkcs_5_alg2ถูกประกาศเฉพาะภายใน#ifdef LTC_PKCS_5ในtomcrypt_pkcs.hไฟล์ซอ ร์ส ของ Dropbear เองไม่ได้คอมไพล์โดยนิยามLTC_PKCS_5ดังนั้นการประกาศจึงมองไม่เห็น และคอมไพเลอร์ ล้มเหลวด้วย implicit function declaration -
สัญลักษณ์ไม่มีอยู่ แย่กว่านั้น ตัวบอดี ของ
pkcs_5_alg2เองก็อยู่หลัง#ifdef LTC_PKCS_5การสร้าง libtomcrypt ของ Dropbear ไม่ได้นิยามมัน ดังนั้นpkcs_5_2.oจึงคอมไพล์เป็น อ็อบเจกต์ว่าง: มันอยู่ในlibtomcrypt.aแต่ไม่มีสัญลักษณ์pkcs_5_alg2เลย การลิงก์ล้มเหลวด้วยundefined symbol: pkcs_5_alg2
คุณเห็นสิ่งนี้ได้ด้วยตนเอง:
# อ็อบเจกต์มีอยู่แต่ว่าง (ไม่มี T pkcs_5_alg2):
llvm-nm build/dropbear-*/libtomcrypt/src/misc/pkcs5/pkcs_5_2.o
# -> มีเพียงเครื่องหมายข้อมูล ไม่มี pkcs_5_alg2
# ในทางกลับกัน HMAC ถูกคอมไพล์เต็มที่ (Dropbear ใช้สำหรับ MAC ของ SSH):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> นิยาม hmac_memoryคำตอบของเรา: สร้าง PBKDF2 ด้วยตนเองบนไพรมิทีฟที่ Dropbear คอมไพล์ จริง ทั้ง hmac_memory และแฮช
sha256 ที่ลงทะเบียนไว้ต่างก็มีอยู่และลิงก์ได้ ดังนั้นแพตช์ 0003 จึงใช้งาน PBKDF2-HMAC-SHA256 โดยตรง
(RFC 2898; บล็อกเอาต์พุต 32 ไบต์เพียงบล็อกเดียว เพราะ dkLen == hLen สำหรับ SHA-256) เราประกาศ
hmac_memory เอง (ปัญหาโปรโตไทป์ซ่อนเดียวกับด้านบน) และอ็อบเจกต์ถูกดึงจาก libtomcrypt.a ตอนลิงก์ ผลลัพธ์
คือ PBKDF2 มาตรฐานและจึงทำงานร่วมกันได้: แฮชที่ WebUI คำนวณด้วย WebCrypto deriveBits ของเบราว์เซอร์
เหมือนกันทีละไบต์กับที่เซิร์ฟเวอร์คำนวณ ตรวจสอบเทียบกับ hashlib.pbkdf2_hmac ของ Python ในฐานะการใช้งานที่
สามที่เป็นอิสระ
โดยสรุป: Android ไม่ให้
crypt()ใดๆ แก่คุณ และ PBKDF2 ที่ฝังของ Dropbear ก็ถูกคอมไพล์เป็นศูนย์ การยืนยันตัวตนด้วยรหัสผ่านที่นี่คือ PBKDF2-HMAC-SHA256 ที่สร้างจากศูนย์บน HMAC ของ libtomcrypt โดยนำตัว ป้องกันการสร้าง crypt() ออก ไม่มี OpenSSL/libcryptoไม่มีการทำให้สับสน ไม่มี shadow ของระบบ
ไบนารีเป็นแบบ ไดนามิก (ลิงก์กับ bionic ของระบบผ่าน /system/bin/linker64) ไม่ใช่สแตติก สิ่งนี้สำคัญ
และได้เรียนรู้มาด้วยวิธียากลำบาก บนอุปกรณ์จริง ไม่ใช่ใน CI:
- การสร้าง static-PIE ดู เหมือนไม่มีปัญหา (
fileรายงานstatic-pie executableที่สะอาด) และลิงก์ โดยไม่มีข้อผิดพลาด แต่ เกิด SIGSEGV ในทันทีที่มันรันบนอุปกรณ์ (ตรวจสอบบนโทรศัพท์ arm64 Android 16, exit 139, ไม่มี tombstone ที่เป็นประโยชน์) ไฟล์ปฏิบัติการสแตติกบน Android เปราะบาง รูปแบบที่เชื่อถือได้คือ ไบนารีไดนามิกปกติ ซึ่งก็เป็นวิธีที่ dropbear สำหรับ Android ที่ตั้งมั่นทุกตัวถูกส่งมอบเช่นกัน - การสร้าง สแตติก ไม่ใช่ PIE ไม่แม้แต่จะเริ่มทำงาน: bionic ปฏิเสธมันด้วย
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionic - ดังนั้นการสร้างจึงเป็น ไดนามิก (
makeโดยไม่มีSTATIC=1;-pie) โดยลิงก์เฉพาะ bionic libc ที่มีอยู่ บนทุกอุปกรณ์ libtomcrypt ยังคงฝังแบบสแตติกในไบนารี จึงไม่มีไลบรารีเพิ่มเติมที่ต้องส่งมอบ
บทเรียนสำหรับการทดสอบ: qemu-aarch64 (qemu-user) ไม่ใช่ smoke test ที่ถูกต้อง ที่นี่ (มันก็ segfault
บนไบนารีเหล่านี้) และ compile+link ที่สำเร็จก็ไม่ใช่เช่นกัน รันไบนารีบนอุปกรณ์ Android arm64 จริง (สิ่งนี้ได้รับการตรวจสอบด้วยวิธีนี้พอดี: เปิดดีมอนบนพอร์ตสำรองบนอุปกรณ์ที่ใช้งานจริง และ
ยืนยันว่าการเข้าสู่ระบบด้วยรหัสผ่านสำเร็จ ขณะที่รหัสผ่านผิดถูกปฏิเสธ)
เซิร์ฟเวอร์ถูกสร้างด้วย --disable-syslog จึงบันทึกไปยัง stderr เสมอ และตัวเลือก -E ของ upstream («log to
stderr») ไม่มีอยู่ ในไบนารีนี้ การส่งมันจะพิมพ์ Invalid option -E และดีมอนจะไม่เริ่มทำงานเลย ดังนั้น
ตัวสร้างอาร์กิวเมนต์ของโมดูลจึงไม่ส่ง -E
เซสชัน PTY แบบโต้ตอบใช้ openpty() bionic ประกาศมันใน <pty.h> และ configure แบบข้ามของ Dropbear
ตรวจพบมันด้วย NDK (HAVE_OPENPTY ถูกตั้ง, HAVE_PTY_H 1) ดังนั้น ไม่ต้องใช้แพตช์ใดๆ PTY ทำงานได้ทันที
(การใช้งานแบบไม่โต้ตอบ เช่น exec, SFTP, rsync และการส่งต่อพอร์ต อย่างไรก็ไม่ขึ้นกับมัน)
scripts/build-bundles.sh คอมไพล์ข้ามเครื่องมือถ่ายโอนไฟล์เป็นไบนารีไดนามิกไปยัง module/bin/<abi>/
CI รันมันทันทีหลัง build.sh
-
rsync (พร้อม popt + zlib ที่ฝัง) คอมไพล์อย่างสะอาดทันทีที่คุณบอก configure ของมันว่า bionic ไม่มี
lutimes(ac_cv_func_lutimes=no) -
sftp-server และ scp มาจาก OpenSSH portable สร้างด้วย
--without-openssl(คริปโตในตัวของ OpenSSH เพียงพอสำหรับสองตัวนี้) พร้อม zlib สแตติกเล็กๆ ที่สคริปต์นี้สร้างก่อน
OpenSSH บน Android จุกจิกพอๆ กับเรื่องราวของ crypt() ด้านบน เพราะ configure ของมันตรวจพบฟังก์ชัน libc
หลายตัวผิดพลาดเมื่อคอมไพล์ข้าม สคริปต์เข้ารหัสการแก้ไขไว้ เพื่อเป็นบันทึก ชิ้นส่วนต่างๆ มีดังนี้:
-
seed แคชของฟังก์ชันที่ bionic ขาด แต่ configure คิดว่ามี เพื่อให้เวอร์ชัน 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หากไม่มีสิ่งเหล่านี้defines.hของ OpenSSH จะทำ#define __sentinel__(ว่าง) ซึ่งจากนั้นทำให้__attribute__((__sentinel__(1)))ของ bionic เองใน<unistd.h>เสียหาย และทุกการคอมไพล์ล้มเหลวด้วยexpected ')' -
compat ของ
explicit_bzeroที่ใช้memsetbzeroของ bionic เป็นแมโครคล้ายฟังก์ชัน (ไม่ใช่ สัญลักษณ์จริง) ดังนั้น compat เริ่มต้นของ OpenSSH ที่รับ&bzeroเป็นตัวชี้ฟังก์ชันจึงคอมไพล์ไม่ได้ bionic ไม่มีexplicit_bzeroของตัวเอง -
การทิ้ง
xcrypt.oและgetrrsetbyname.oจากไลบรารี compatxcrypt.cเรียกgetpwent()/crypt()แบบไม่มีเงื่อนไข (bionic ไม่มีทั้งคู่) และgetrrsetbyname.cใช้ภายในของ resolver ที่ bionic ไม่เปิดเผย ทั้งคู่ไม่ถูกใช้โดยsftp-serverหรือscp -
-Wl,--allow-multiple-definitionreallocarrayเป็นภาพสะท้อนของฟังก์ชันในข้อ (1): bionic ไม่ได้ ประกาศ มันใน API 24 ดังนั้น OpenSSH จึงคอมไพล์ compat ของตัวเอง แต่ สัญลักษณ์ นั้นมีอยู่จริงในlibc.aดังนั้นทั้งคู่จึงชนกันตอนลิงก์ การอนุญาตให้ซ้ำจะเลือกของ bionic ซึ่งไม่เป็นไร -
การป้องกัน
pw_gecosจาก NULL ในpwcopy()getpwuid()ของ bionic คืนค่าpw_gecosเป็นNULL(Android ไม่เก็บฟิลด์ GECOS)pwcopy()ของ OpenSSH ป้องกันpw_passwdจากNULLแต่ไม่ป้องกันpw_gecosดังนั้นsftp-serverจึงไปถึงxstrdup(NULL)และ SIGSEGV ตอนเริ่มต้น ในทันทีที่เซสชันเปิดขึ้น (scpผ่านโปรโตคอลเก่าไม่เคยเรียกpwcopyจึงเป็นเหตุผลที่มันทำงานได้ขณะที่ SFTP ไม่ได้) การสร้างแพตช์pwcopy()เพื่อรวมpw_gecosให้เป็น""
เวอร์ชันที่ปักหมุดอยู่ด้านบนของ 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 24เอกสารนี้สร้างขึ้นด้วย Claude (Anthropic) และดูแลโดย VD171 ยินดีรับการแก้ไขและการปรับปรุง ดู CONTRIBUTING.md