実験・実装 · 基礎から応用へ

TLS証明書チェーンを検証する

一時的なルート・中間・サーバー証明書を作り、信頼経路とホスト名の検査を別々に確かめます。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 通信前に証明書の条件を分けて試す
  2. 信頼する証明書を明示する
  3. 三つの戻り値をassertで確認する
  4. 中間証明書は信頼アンカーではない
  5. 名前・有効期間・用途を分けて考える
  6. TLS接続全体を検証したとは言わない
  7. この記事をロゲイアに質問する理解を確かめる

通信前に証明書の条件を分けて試す

TLSの接続が失敗したとき、証明書の信頼経路と、接続先の名前が合うかは別の検査です。この実験ではOpenSSL3系とPythonを使い、ローカルに一時的なルート、中間CA、サーバー証明書を作ります。外部サイトへの接続も、システム全体の信頼ストアの変更も行いません。正常な検証、名前が違う検証、中間証明書を渡さない検証の三つを比較します。公開鍵の署名が数学的に正しいだけで、意図したサービスへ接続していると判断してはいけない理由を、条件を一つずつ変えて確かめます。

信頼する証明書を明示する

実験用ルートは、このコードの検査でだけCAfileとして指定します。自分で作った自己署名証明書を、普段使うブラウザやOSへ登録する必要はありません。中間CAにはCAとして発行できる制約を、末端にはサーバー認証の用途とlab.exampleのsubjectAltNameを付けます。秘密鍵は一時ディレクトリに置き、プログラム終了時にそのディレクトリと一緒に削除します。これらの鍵は実験用であり、実際のサービスの鍵や認証局を置き換えるためのものではありません。実験を行う場所と信頼する範囲を限定します。

三つの戻り値をassertで確認する

コードは正常な経路と名前で終了コード0になることを確認します。次に同じ証明書と経路のままwrong.exampleを指定し、0以外になることを確かめます。最後は名前を正しく戻し、中間証明書だけを渡さずに失敗を確認します。標準出力に表示された短い文言だけで判定せず、終了コードを検査します。証明書を作成する途中の処理が失敗した場合は先へ進まず、例外で止めます。OpenSSLの版や設定によってエラーメッセージの言葉は違い得るため、特定の文字列を成功条件として固定しません。

Python 3 + OpenSSL 3
import pathlib, subprocess, tempfile
with tempfile.TemporaryDirectory(prefix="tls-chain-lab-") as folder:
    work = pathlib.Path(folder)
    def openssl(*args, ok=True):
        result = subprocess.run(["openssl", *args], cwd=work, capture_output=True, text=True)
        if ok and result.returncode:
            raise RuntimeError(result.stderr)
        return result
    openssl("req", "-x509", "-newkey", "rsa:2048", "-nodes", "-days", "1",
            "-subj", "/CN=Local Lab Root", "-keyout", "root.key", "-out", "root.pem",
            "-addext", "basicConstraints=critical,CA:TRUE",
            "-addext", "keyUsage=critical,keyCertSign,cRLSign")
    openssl("req", "-new", "-newkey", "rsa:2048", "-nodes", "-subj", "/CN=Local Lab Intermediate",
            "-keyout", "intermediate.key", "-out", "intermediate.csr")
    (work/"ca.ext").write_text("basicConstraints=critical,CA:TRUE,pathlen:0\nkeyUsage=critical,keyCertSign,cRLSign\n")
    openssl("x509", "-req", "-in", "intermediate.csr", "-CA", "root.pem", "-CAkey", "root.key",
            "-CAcreateserial", "-days", "1", "-extfile", "ca.ext", "-out", "intermediate.pem")
    openssl("req", "-new", "-newkey", "rsa:2048", "-nodes", "-subj", "/CN=lab.example",
            "-keyout", "leaf.key", "-out", "leaf.csr")
    (work/"leaf.ext").write_text("basicConstraints=critical,CA:FALSE\nkeyUsage=critical,digitalSignature,keyEncipherment\nextendedKeyUsage=serverAuth\nsubjectAltName=DNS:lab.example\n")
    openssl("x509", "-req", "-in", "leaf.csr", "-CA", "intermediate.pem", "-CAkey", "intermediate.key",
            "-CAcreateserial", "-days", "1", "-extfile", "leaf.ext", "-out", "leaf.pem")
    common = ["verify", "-purpose", "sslserver", "-CAfile", "root.pem"]
    assert openssl(*common, "-untrusted", "intermediate.pem", "-verify_hostname", "lab.example", "leaf.pem").returncode == 0
    assert openssl(*common, "-untrusted", "intermediate.pem", "-verify_hostname", "wrong.example", "leaf.pem", ok=False).returncode != 0
    assert openssl(*common, "-verify_hostname", "lab.example", "leaf.pem", ok=False).returncode != 0
    print("chain and hostname assertions passed")

中間証明書は信頼アンカーではない

untrustedとして渡す中間証明書は、経路を組み立てるための候補です。それを渡しただけで、新しい信頼アンカーとして採用したことにはなりません。今回の信頼の出発点はCAfileで指定したルートです。実際のサーバーが中間証明書を送る構成でも、何を信頼するかはクライアント側の設定と方針に依存します。欠けた中間を別経路から取得できる実装もありますが、この実験にはその配布先を設定していません。あるクライアントで成功したことを、全てのクライアントで同じ経路が完成する保証とは考えないようにします。

名前・有効期間・用途を分けて考える

同じ証明書でも、想定する名前が変われば照合結果が変わります。今回の失敗は、署名を書き換えたからではなく、検査する名前を変えたためです。有効期間や用途、CAの制約も検証に関わり、システム時計が大きくずれていれば別の理由で失敗する場合があります。エラーを一律に無視するオプションを付けると、どの検査が守っていた保証を失うかが分からなくなります。まず失敗理由を分離し、正しい名前と適切なチェーンを与えることで検査を通す、という順番を守ります。

TLS接続全体を検証したとは言わない

この実験が確認するのは、ローカルで生成した証明書群に対する経路と名前の検査です。実際のTLSハンドシェイク、秘密鍵の接続時の保有、失効情報の運用、ネットワークの到達性、アプリの認可は検証していません。証明書が受理されたサービスでも、返す情報が正しいとは限りません。実行記録にはOpenSSLの版、三つの終了状態、使った検査名、外部通信をしなかったことを残します。生成した鍵や証明書を通常の環境へ持ち込まず、終了後に一時ファイルが残っていないことも確認します。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 21

学習コースから次を選ぶ