
CVE-2026-111943の研究向けに、極小のEC秘密鍵を扱うOpenSSL s_serverテストツール。
Alpine Linux と OpenSSL s_server を基盤とした軽量で自動化されたコンテナ型テストツールで、小さな整数を楕円曲線秘密鍵として使用するテストを行うためのものです。
2階層の楕円曲線(EC)証明書チェーン(CA + サーバー)を生成し、カスタム SAN 拡張(IP アドレスとドメイン名)でサーバー証明書に署名し、実行されたすべての OpenSSL コマンドをキャプチャしてエコー表示し、-WWW または -www モードで実行中に証明書と鍵がどのように作成されたかを説明するライブ HTML レポートを配信します。
fullchain.pem にバンドルします。CHAIN_MODE=c1)、または利用可能なすべてのパスの組み合わせ(CHAIN_MODE=all)のいずれかを配信します。s バイト入力: EC 秘密鍵スカラー $s$ を 16 進文字列(例: 0xdeadbeef1337 や deadbeef...)または小さな整数(例: 42)として直接受け付け、正確な 16 進スカラーを生成された EC 秘密鍵に埋め込むことで、openssl ec -text が priv: の下に正確なバイトを表示するようにします。S_BYTES、SERVER_S_BYTES、CA_S_BYTES。CA_CURVE、SERVER_CURVE、またはフォールバック CURVE(例: prime256v1、secp384r1、secp521r1)。CA_SUBJECT と SERVER_SUBJECT。DOMAINS と IPS(カンマまたはスペース区切り)。WWW_MODE(WWW、www、HTTP)。PORT(デフォルト 4433)。fullchain.pem、tls.crt)と秘密鍵が /certs にマウントされているかを自動検出し、それらを代わりに配信します。openssl x509 -text -noout と openssl ec -text -noout)とともにエコー表示します。-WWW モードでは、https://<host>:<port>/index.html にアクセスすると、ワンクリックで PEM ファイルをダウンロードできるこの完全なレポートがレンダリングされます。chart/)と ArgoCD Application(argocd/)。s バイト(16 進)で実行docker run -p 4433:4433 \
-e S_BYTES="0xdeadbeef1337" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
openssl ec -in server.key.pem -text -noout を実行すると、秘密鍵のスカラーが次のように表示されます:
priv:
00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:
00:00:00:00:00:00:00:00:00:00:00:de:ad:be:ef:
13:37
s で実行するdocker run -p 4433:4433 \
-e S_BYTES="42" \
-e DOMAINS="localhost,test.internal" \
-e IPS="127.0.0.1,192.168.1.100" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
docker run -p 4433:4433 \
-e SERVER_S_BYTES="0xdeadbeef" \
-e CA_S_BYTES="0x1337c0de" \
-e CA_CURVE="prime256v1" \
-e SERVER_CURVE="prime256v1" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
事前に生成された証明書(Let's Encrypt や Vault の証明書など)がある場合:
docker run -p 4433:4433 \
-v /path/to/my/certs:/certs:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
fullchain.pem(または tls.crt)と privkey.pem(または tls.key / server.key)が /certs 内に存在する場合、コンテナは新しい証明書を生成せずにそれらを検査して直接提供します。
鍵 $a$(サーバー、スカラー $s$)と $b$(CA、スカラー $s+1$ または CA_S_BYTES)は決定論的であるため、中間鍵 $b$ は外部ルート CA($c_1, c_2, \dots$)によって事前に署名しておくことができ、またルートをマウントして起動時に自動的に署名させることもできます。
クロス署名されたチェーン PEM を /certs/chains/ に配置します:
/certs/chains/c1.pem($c_1$ によって署名された $b$ を含み、オプションで $c_1$ も含む)/certs/chains/c2.pem($c_2$ によって署名された $b$ を含み、オプションで $c_2$ も含む)# Serve specific cross-signed path (a -> b_c1 -> c1)
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CA_S_BYTES="0x02" \
-e CHAIN_MODE="c1" \
-v /path/to/chains:/certs/chains:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
# Serve all paths concatenated in fullchain.pem (a -> b_c1 + b_c2)
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CA_S_BYTES="0x02" \
-e CHAIN_MODE="all" \
-v /path/to/chains:/certs/chains:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
ボリュームマウントを使用しない CI/CD や軽量な実行の場合:
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CHAIN_MODE="all" \
-e EXTRA_CHAIN_PEM="$(cat extra_chain.pem)" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
外部ルート CA 証明書と秘密鍵を /certs/roots/ にマウントします:
/certs/roots/c1.crt および /certs/roots/c1.key起動時に、コンテナはルート $c_1$ によって署名された鍵 $b$ の中間証明書を自動的に生成し、CHAIN_MODE="c1" または CHAIN_MODE="all" で利用可能にします。
-WWW モードで、HTML レポートを取得します:
# Insecure (skip CA verification)
curl -k https://localhost:4433/index.html
# Download the generated CA certificate
curl -k -O https://localhost:4433/ca.crt.pem
# Secure request using the downloaded CA
curl --cacert ca.crt.pem https://localhost:4433/index.html
s_clientターミナルで接続し、証明書チェーンを検査します:
openssl s_client -connect localhost:4433 -showcerts
| 変数 | デフォルト | 説明 |
|---|---|---|
S_BYTES / SERVER_S_BYTES | チャート内の 0x01 | サーバー EC 秘密鍵の正確な整数(例: 1、42)または16進スカラー(0xdeadbeef...)。 |
CA_S_BYTES | 導出値 ($s+1$) | CA EC 秘密鍵の正確な整数または16進スカラー。 |
ROOTS / CHAINS | c1,c2 (チャート内) | ルート CA / チェーン名のカンマ区切りリスト。2~10個のイングレスと対応するポートを自動導出します(単一チェーンの場合は all を省略)。 |
ROOT_S_BYTES | 0x10,0x20 (チャート内) | ルート CA 用の正確なスカラーのカンマ区切りリスト。 |
CHAIN_MODE | default | プライマリチェーンの組み立てモード: default ($a \rightarrow b$)、<name>、または all。 |
CHAINS_DIR | /certs/chains | 事前署名済みの中間証明書またはクロスチェーン PEM ファイルを含むディレクトリ。 |
ROOTS_DIR | /certs/roots | 中間証明書の自動署名用に、ルート CA の .crt と .key のペアを含むディレクトリ。 |
EXTRA_CHAIN_PEM | 空 | 中間チェーンの組み立てに含める生の PEM 証明書文字列。 |
CHAIN_FILE | 空 | 含める特定の中間チェーン PEM ファイルへのパス。 |
WWW_MODE | WWW | openssl s_server のモード(WWW はファイルを配信、www は組み込みステータスページを配信、HTTP はヘッダーを含める)。 |
PORT | 4433 | s_server が待ち受ける TCP ポート。 |
CA_CURVE | prime256v1 | CA 鍵用の楕円曲線。 |
SERVER_CURVE | prime256v1 | サーバー鍵用の楕円曲線。 |
CURVE | prime256v1 | CA とサーバーの両方に個別設定がない場合のフォールバック曲線。 |
CA_SUBJECT | /CN=Test OpenSSL CA/O=Test Lab/C=CA | CA の X.509 サブジェクト。 |
SERVER_SUBJECT | /CN=localhost/O=Test Lab/C=CA | サーバー証明書の X.509 サブジェクト。 |
DOMAINS | tiny-key-s-server.jskw.dev,localhost | DNS SAN のカンマまたはスペース区切りリスト。 |
IPS | 127.0.0.1 | IP SAN のカンマまたはスペース区切りリスト。 |
CA_DAYS | 3650 | CA 証明書の有効期間(日数)。 |
SERVER_DAYS | 365 | サーバー証明書の有効期間(日数)。 |
CERTS_DIR | /certs | マウントされた証明書と鍵を確認するディレクトリ。 |
EXTRA_S_SERVER_ARGS | 空 | openssl s_server に直接渡される追加の CLI フラグ。 |
すべてのテストは、ホストシステムを変更することなく、一時的な Docker コンテナ内でクリーンに実行できるように設計されています:
tests/test_scalar_s_bytes.sh: スカラー生成をテストし、openssl ec -text が正確なユーザー指定の16進値を表示することを検証します。tests/test_chain_generation.sh: CA作成、サーバーCSR署名、SAN注入、および openssl verify をテストします。tests/test_s_server_behavior.sh: curl を用いた -WWW および -www のレスポンスセマンティクスをテストします。tests/test_volume_override.sh: 既存の証明書を含む外部ボリュームのマウントをテストします。tests/test_full_docker_app.sh: ビルドされたイメージの完全なエンドツーエンド統合テスト。tests/test_cross_signed_chains.sh: 中間クロス署名($a \rightarrow b \rightarrow c_1 / c_2$)とマルチトラストアンカーのクライアント検証をテストします。tests/test_chain_modes.sh: 実行時の CHAIN_MODE パス解決(default、名前付きパス c1、および all)をテストします。tests/test_multi_port_server.sh: 動的マルチルート導出(ROOTS=c1,c2)、コンパニオン s_server リスナー、および単一チェーンとマルチチェーンのポート割り当てをテストします。tests/run_all_tests.sh: すべてのテストスクリプトを統括します。