Repository navigation
ja 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
と報告します)、すべての Android 端末がすでに持つ bionic libc にリンクされます。libtomcrypt はバイナ
リ内に埋め込まれたままで、動的なのは C ライブラリだけです。動的、static-PIE ではない
を参照してください。
バイナリは コミットされません。タグごとに CI がビルドし、リリースに添付します。
.gitignore を参照してください。
Dropbear のパスワード認証は、crypt() と /etc/shadow を備えた通常の Unix ホスト向けに書かれていま
す。Android には どちらもありません。これはビルドと三つの別々の箇所で衝突します。本節はそのそれぞ
れを記録します。まさに再発見するのが苦痛な類いのものだからです。これらはすべてパッチ
0003-password-file.patch が処理し、以下の何ひとつ実行時に運任
せにしていません。
Android の C ライブラリ(bionic)は crypt() も crypt_r() も shadow データベースも提供しません。NDK
は <crypt.h> を一切公開しません。したがって crypt(password, salt) を呼び /etc/shadow と比較する
Dropbear の標準パスワード経路は、Android ではそもそもビルドも実行もできません。リンクする libcrypt
もなく、パスワードハッシュのためだけに OpenSSL の libcrypto を引き込むのは、静的バイナリにとって大き
く不格好な依存になります。
私たちの答え: 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()'."
#endifHAVE_CRYPT が未定義(bionic では常に)でパスワード認証が有効だと、これは強い #error です。私たち
の検証器は crypt() を決して呼ばないので、パッチ 0003 は このガードを削除します。(「少なくとも
一つの認証方式が有効でなければならない」という検査はそのまま残します。)
Dropbear は切り詰めた libtomcrypt を埋め込んでおり、そこには PBKDF2 が 実際に 含まれています
(pkcs_5_alg2, src/misc/pkcs5/pkcs_5_2.c)。当然の修正はそれを呼ぶことです。それは動きません。重な
り合う二つの理由からです:
-
プロトタイプが隠れている。
pkcs_5_alg2はtomcrypt_pkcs.h内の#ifdef LTC_PKCS_5の中でしか 宣言されません。Dropbear 自身の ソースファイルはLTC_PKCS_5を定義してコンパイルされないため、宣 言は不可視で、コンパイラは implicit function declaration で失敗します。 -
シンボルが存在しない。 さらに悪いことに、
pkcs_5_alg2の 本体 自体も#ifdef LTC_PKCS_5の後 ろにあります。Dropbear の libtomcrypt ビルドはそれを定義しないので、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 は SSH の MAC に使う):
llvm-nm build/dropbear-*/libtomcrypt/src/mac/hmac/hmac_memory.o
# -> hmac_memory を定義私たちの答え: Dropbear が 実際に コンパイルするプリミティブの上に PBKDF2 を自分で構築することで
す。hmac_memory と登録済みの sha256 ハッシュはどちらも存在しリンク可能なので、パッチ 0003 は
PBKDF2-HMAC-SHA256 を直接実装します(RFC 2898。SHA-256 では dkLen == hLen なので、32 バイトの出力ブ
ロック一つ)。hmac_memory を自分で宣言し(上と同じ隠れプロトタイプの問題)、オブジェクトはリンク時に
libtomcrypt.a から引き出されます。結果は標準の PBKDF2 であり、したがって相互運用可能です。WebUI がブ
ラウザの WebCrypto deriveBits で計算するハッシュは、サーバーが計算するものとバイト単位で一致し、
第三の独立実装として Python の hashlib.pbkdf2_hmac に対して検証されています。
要するに: Android は
crypt()を何も与えず、Dropbear の埋め込み PBKDF2 は無に等しくコンパイルさ れます。ここでのパスワード認証は libtomcrypt の HMAC の上にゼロから作った PBKDF2-HMAC-SHA256 で、 crypt() のビルドガードは除去されています。OpenSSL/libcryptoなし、難読化なし、システムの shadow な し。
バイナリは 動的 です(/system/bin/linker64 経由でシステムの bionic にリンク)。静的ではありませ
ん。これは重要で、CI ではなく 実機で 苦労して学びました:
-
static-PIE ビルドは一見問題なく見え(
fileはきれいなstatic-pie executableを報告)、エラーな くリンクしますが、端末で実行した瞬間に SIGSEGV します(arm64 の Android 16 端末で確認、exit 139、 有用な tombstone なし)。Android の静的実行ファイルは脆く、信頼できる形は通常の動的バイナリです。これ は定着したすべての Android 版 dropbear の配布形態でもあります。 -
静的・非 PIE ビルドは起動すらしません。bionic が
executable's TLS segment is underaligned … needs to be at least 64 for ARM64 Bionicで拒否します。 - したがってビルドは 動的 です(
STATIC=1なしのmake;-pie)。あらゆる端末に存在する bionic libc だけをリンクします。libtomcrypt は今も静的にバイナリへ埋め込まれるので、配布する追加ライブラリは ありません。
テストの教訓: qemu-aarch64(qemu-user)はここでは有効なスモークテストではありません(これらのバ
イナリでも segfault します)。コンパイル+リンクの成功も同様です。実機の arm64 Android 端末でバイナ
リを実行してください。 (これはまさにこの方法で検証しました。デ
ーモンを稼働中の端末の代替ポートで起動し、パスワードログインの成功を確認し、誤ったパスワードは拒否され
ました。)
サーバーは --disable-syslog でビルドされるため常に stderr へログ出力し、upstream の -E(「log to
stderr」)オプションはこのバイナリに 存在しません。渡すと Invalid option -E が出力され、デーモン
は決して起動しません。そのためモジュールの引数ビルダーは -E を渡しません。
対話的な PTY セッションは openpty() を使います。bionic は <pty.h> でそれを宣言し、Dropbear のクロス
configure は 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 を伴います。
Android 上の OpenSSH は上の crypt() の話と同じくらい扱いにくいです。クロスコンパイル時に configure
がいくつかの libc 関数を誤検出するからです。スクリプトはその修正を符号化しています。記録として、その断
片は次のとおりです:
-
bionic に欠けているが configure があると思い込む関数のキャッシュ seed。代わりに 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。 これらがないと OpenSSH のdefines.hが#define __sentinel__(空)を行い、すると<unistd.h>にある bionic 自身の__attribute__((__sentinel__(1)))を壊し、すべてのコンパイルがexpected ')'で失敗します。 -
memsetを使うexplicit_bzeroの compat。 bionic のbzeroは関数風マクロ(本物のシンボルで はない)なので、&bzeroを関数ポインタとして取る OpenSSH の既定の compat はコンパイルできません。 bionic には自前のexplicit_bzeroがありません。 -
compat ライブラリから
xcrypt.oとgetrrsetbyname.oを除外。xcrypt.cは無条件にgetpwent()/crypt()を呼び(bionic にはどちらもない)、getrrsetbyname.cは bionic が公開しない resolver の内部を使います。どちらもsftp-serverやscpは使いません。 -
-Wl,--allow-multiple-definition。reallocarrayは (1) の関数群の鏡像です。bionic は API 24 でそれを 宣言しない ので OpenSSH は自前の compat をコンパイルしますが、シンボル はlibc.aに 確かに存在するので、二つはリンク時に衝突します。重複を許すと bionic のものが採られ、それで問題ありま せん。 -
pwcopy()でpw_gecosを NULL から守る。 bionic のgetpwuid()はNULLのpw_gecosを返し ます(Android は GECOS フィールドを保持しません)。OpenSSH のpwcopy()は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 を参照してください。