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

証明書のホスト名検証を試す

ローカルのテストCAとTLSサーバを使い、信頼鎖の検証と接続先名の一致を別々に確かめます。

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

更新日

この記事の目次
  1. 暗号化できることと接続相手を確かめること
  2. 使い捨てのCAとSAN付き証明書を作る
  3. 検証を有効なまま三条件を実行する
  4. 成功一件と拒否二件を読み分ける
  5. この小例で検証していないものを挙げる
  6. 負の試験で別の通信エラーを成功扱いしない
  7. 課題は名前と接続先を別に説明する
  8. この記事をロゲイアに質問する理解を確かめる

暗号化できることと接続相手を確かめること

TLSで通信が暗号化されても、それだけで意図した接続先へ届いたと判断できるのでしょうか。ここでは自作のローカルサーバへ接続し、正しい名前、異なる名前、未信頼のCAという三条件を比較します。実在サイトの証明書やブラウザ設定は変更しません。証明書の検証を無効にせず、成功と二種類の拒否が起きることを確かめます。公開鍵・PKI・TLSの総論を先に読んでください。

接続に使うネットワーク上の宛先は127.0.0.1ですが、検証したいサービス名はapp.testです。IPアドレスへ到達することと、証明書が示す名前が意図した名前と一致することを分けて扱います。Pythonのserver_hostnameに渡す値が、この小例ではその名前を指定します。単に接続できたという観測だけでは、正しい名前を検査したことにはなりません。

使い捨てのCAとSAN付き証明書を作る

Python 3.12とOpenSSLのコマンドを用意します。プログラムは一時ディレクトリでCA用の鍵と証明書を作り、そのCAでサーバ証明書へ署名します。サーバ証明書のsubjectAltNameはDNS:app.testです。CAには証明書署名用、サーバにはサーバ認証用の用途を設定し、有効期間は実験用に一日としています。鍵のファイルは一時ディレクトリの外へ配布しません。

クライアントの信頼はSSLContextへ渡すcafileで設定します。OSや既存ブラウザへCAを追加する操作はありません。サーバはループバックの空いているポートへだけバインドします。app.testという名前のDNS登録も不要で、実接続先はコード中の127.0.0.1です。名前解決、接続、検証対象名の三つが同じ文字列でなければならないという思い込みを避け、何を明示的に指定しているか確認します。

検証を有効なまま三条件を実行する

次のコードをcertificate_boundary.pyへ保存し、python3.12 certificate_boundary.pyで実行します。create_default_contextを使い、check_hostnameが真、verify_modeがCERT_REQUIREDであることをassertします。正しい条件ではテストCAを信頼し、名前をapp.testにします。名前の不一致の条件では同じCAを信頼したまま、名前だけをother.testへ変えます。

未信頼CAの条件では名前をapp.testに戻し、テストCAを読み込まない標準の信頼設定を使います。この順番にすることで、名前と信頼の条件を一度に変えて原因を曖昧にしません。サーバ側で負の試験のTLS例外を受け止めるのは、クライアントが意図的にハンドシェイクを拒否するためです。その他のサーバ例外は保存して最後に検査します。無制限に待たないよう、接続と待機にはタイムアウトも置いています。

python
import json
import socket
import ssl
import subprocess
import tempfile
import threading
from pathlib import Path

def openssl(*args):
    subprocess.run(['openssl', *args], check=True, capture_output=True)

with tempfile.TemporaryDirectory(prefix='lavacs-tls-') as directory:
    root = Path(directory)
    def p(name): return str(root / name)
    openssl('req', '-x509', '-newkey', 'rsa:2048', '-nodes', '-sha256', '-days', '1', '-subj', '/CN=LavaCS disposable test CA', '-addext', 'basicConstraints=critical,CA:TRUE', '-addext', 'keyUsage=critical,keyCertSign,cRLSign', '-keyout', p('ca.key'), '-out', p('ca.pem'))
    openssl('req', '-new', '-newkey', 'rsa:2048', '-nodes', '-subj', '/CN=app.test', '-keyout', p('server.key'), '-out', p('server.csr'))
    (root / 'extensions.cnf').write_text('subjectAltName=DNS:app.test\nbasicConstraints=critical,CA:FALSE\nkeyUsage=critical,digitalSignature,keyEncipherment\nextendedKeyUsage=serverAuth\n')
    openssl('x509', '-req', '-in', p('server.csr'), '-CA', p('ca.pem'), '-CAkey', p('ca.key'), '-CAcreateserial', '-days', '1', '-sha256', '-extfile', p('extensions.cnf'), '-out', p('server.pem'))
    server_context = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
    server_context.load_cert_chain(p('server.pem'), p('server.key'))
    listener = socket.socket()
    listener.bind(('127.0.0.1', 0))
    listener.listen(3)
    listener.settimeout(10)
    port = listener.getsockname()[1]
    server_errors = []
    def serve():
        try:
            for _ in range(3):
                conn, _ = listener.accept()
                with conn:
                    try:
                        with server_context.wrap_socket(conn, server_side=True) as tls:
                            tls.sendall(b'ok')
                    except ssl.SSLError:
                        pass  # Negative client tests intentionally reject this handshake.
        except Exception as error:
            server_errors.append(repr(error))
    thread = threading.Thread(target=serve, daemon=True)
    thread.start()
    observations = []
    try:
        for case, name, trust_ca in [('correct', 'app.test', True), ('wrong-name', 'other.test', True), ('untrusted-ca', 'app.test', False)]:
            context = ssl.create_default_context(cafile=p('ca.pem')) if trust_ca else ssl.create_default_context()
            assert context.check_hostname and context.verify_mode == ssl.CERT_REQUIRED
            try:
                with socket.create_connection(('127.0.0.1', port), timeout=5) as raw:
                    with context.wrap_socket(raw, server_hostname=name) as tls:
                        assert tls.recv(2) == b'ok'
                assert case == 'correct'
                observations.append({'case': case, 'accepted': True})
            except ssl.SSLCertVerificationError as error:
                assert case != 'correct'
                observations.append({'case': case, 'accepted': False, 'verifyCode': error.verify_code, 'reason': error.verify_message})
    finally:
        thread.join(timeout=12)
        listener.close()
    assert not thread.is_alive() and not server_errors, server_errors
    assert [x['accepted'] for x in observations] == [True, False, False]
    print(json.dumps({'openssl': ssl.OPENSSL_VERSION, 'observations': observations}))

成功一件と拒否二件を読み分ける

実測ではPython 3.12.14がリンクするOpenSSL 3.5.8で、correctは成功、wrong-nameとuntrusted-caはSSLCertVerificationErrorになりました。名前の不一致にはverifyCode 62、未信頼CAには20が記録されています。これらはこの環境の観測値です。別の版の表示文言まで固定の仕様だとはせず、拒否した条件、例外の種類、検証理由を保存してください。証明書の生成に使うOpenSSLコマンドの版と、Pythonがリンクする版も別に確認できます。

正しい名前と信頼したCAの両方が揃った成功ケースがあるため、単にサーバが起動しなかった結果と区別できます。また、二つの拒否は異なる問いへの答えです。信頼したCAが署名していても、別名の証明書は意図した相手を示しません。名前が合っていても、信頼の根拠がなければ受け入れません。「証明書が存在する」だけでは、この二つの検査を通ったことにはならないのです。

この小例で検証していないものを挙げる

この実験は、テストCAを明示して接続先名を検査する範囲です。失効情報の取得、公開の信頼ストアの運用、鍵の更新、相互TLS、実際のロードバランサの設定を一通り検証したものではありません。証明書が期限内であることも通常の検証の一部ですが、ここでは期限切れを待つ試験は実装していません。成功から、本番TLSの全条件が完成したとは結論しないでください。

また、TLSで相手を確認できても、アプリケーションの操作権限まで決まるわけではありません。正しいサービスへつながった後、どの利用者がどの文書を読めるかは認証・認可の問題です。エラーが出たときにcheck_hostname=FalseやCERT_NONEへ変えると、今回分けて確認した境界を消してしまいます。意図したCA、名前、証明書の用途、時刻、接続経路を調べ、どの条件が満たされなかったかを直す順序を取ります。

負の試験で別の通信エラーを成功扱いしない

名前の不一致の試験は、接続失敗なら何でもよいとはしていません。コードはSSLCertVerificationErrorを受け止め、それ以外の接続拒否やタイムアウトは通常の失敗として残します。サーバが停止していたためにつながらなかった結果を、名前の検証が働いた証拠にはできません。正しい条件の成功、二つの検証エラー、サーバ側の異常がないことを合わせて、想定した境界で拒否されたと説明します。

課題は名前と接続先を別に説明する

課題として、ネットワーク上の宛先を変えず、server_hostnameだけをother.testへ変えたときの結果を説明します。解答は、ループバックへは接続できても、証明書のSANにその名前がないため拒否される、です。次に、信頼するCAだけを外した条件は、名前がapp.testでも信頼鎖の根拠を失うと説明します。同じ「TLS失敗」という見出しで済ませず、変更した条件を言葉にしてください。

最後に、検証エラーが出たから通信を暗号化する価値がないという結論が妥当か考えます。答えは妥当ではありません。意図した相手を確認する検査が働いた結果であり、その失敗を調べる必要があります。提出する記録にはPythonとリンク先OpenSSLの版、生成コマンドの版、三つの名前と信頼条件、受理・拒否、検証理由を含めます。秘密鍵の内容や再利用可能な資格情報は記録へ入れません。

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

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

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

学習コースから次を選ぶ