体系ガイド · 基礎から応用へ

ソフトウェア更新と署名の信頼境界

署名検証を入口に、鍵の信頼・版・期限・配布物の一致・適用失敗を、ローカルの更新履歴で区別します。

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

更新日

この記事の目次
  1. 署名が正しいだけで更新してよいか
  2. 信頼する鍵は配布物とは別の根拠を持つ
  3. 標準の署名APIで改変と別鍵を確かめる
  4. 古い正規の版も別に判断する
  5. 履歴の各行へ受理・拒否の理由を書く
  6. 鍵の更新にも既存の信頼を使う
  7. 検証の後にも適用の失敗がある
  8. オフライン期間と時刻の前提を明らかにする
  9. 課題は署名と採用理由を分けて答える
  10. この記事をロゲイアに質問する理解を確かめる

署名が正しいだけで更新してよいか

ソフトウェア更新では、配布物が途中で変わっていないことに加え、誰の権限で、どの版を、いつまで有効なものとして採用するかを判断します。署名の検証が成功しても、検証に使う鍵をどこから信頼したか、古い版ではないか、期限が切れていないかという問いは残ります。「署名付き」というラベルだけでは、更新を受理する条件を説明できません。

この教材ではローカルの架空の配布物を使い、署名APIで確かめる部分と、更新プロトコルが決める部分を分けます。先に脅威モデルとハッシュ・MACの教材を読んでください。MACの共有鍵と公開鍵署名の違いも踏まえます。既存環境へ更新を配布したり、実アプリケーションを置き換えたりはしません。表の版と時刻は説明用に固定した履歴で、現在公開されている実製品の更新状態ではありません。

信頼する鍵は配布物とは別の根拠を持つ

配布物と一緒に届いた公開鍵を、そのまま無条件に信頼すると、配布物・署名・鍵をまとめて差し替えられる場合に対処できません。検証器は、最初から保持した信頼情報や、既存の信頼から承認された鍵の更新など、別の根拠を必要とします。署名計算の成功は、指定された鍵との関係を示します。その鍵が更新を承認する権限を持つかは別に決めます。

The Update Frameworkでは、root、targets、snapshot、timestampなどの役割を分け、鍵やメタデータの責任を分担します。役割の分離は、一つのオンライン鍵へすべての権限を集めないためにも重要です。具体的な閾値、期限、委任、鍵更新の手順は採用する仕様と実装に従います。この教材の小例を、これらの役割を実装したTUFクライアントとして扱わないでください。信頼する鍵を固定した署名計算の確認だけを、次のコードで実行します。

標準の署名APIで改変と別鍵を確かめる

コードをupdate_signature.pyとして保存し、Python 3.12とOpenSSLのある使い捨て環境でpython3.12 update_signature.pyを実行します。RSAの鍵を二組生成し、架空の配布物のハッシュを含むJSONの正確なバイト列へ、OpenSSLのSHA-256署名を作ります。署名対象の版だけを変更すると検証に失敗し、別の公開鍵でも失敗します。元へ戻した場合の成功も確認します。

実測ではPython 3.12.14とOpenSSLコマンド3.0.13で全assertが成功しました。配布物の変更は、信頼したメタデータのハッシュと一致しないことも確認しています。JSONの並びや空白を含む実際のバイト列へ署名しているため、意味上同じJSONを再整形しても、そのまま同じ署名として扱えるとは限りません。これはAPIの最小例であり、TUFの署名表現や正規化規則を独自に再現したコードではありません。

python
import hashlib
import json
import subprocess
import tempfile
from pathlib import Path

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

with tempfile.TemporaryDirectory(prefix='lavacs-update-') as directory:
    root = Path(directory)
    def p(name): return str(root / name)
    for name in ['release', 'other']:
        assert openssl('genpkey', '-algorithm', 'RSA', '-pkeyopt', 'rsa_keygen_bits:2048', '-out', p(name + '.key')).returncode == 0
        assert openssl('pkey', '-in', p(name + '.key'), '-pubout', '-out', p(name + '.pub')).returncode == 0
    artifact = b'fictional application version eight\n'
    manifest = {'name': 'app.bin', 'version': 8, 'expires': '2026-10-29T00:00:00Z', 'sha256': hashlib.sha256(artifact).hexdigest()}
    original = json.dumps(manifest, sort_keys=True, separators=(',', ':')).encode()
    (root / 'release.json').write_bytes(original)
    assert openssl('dgst', '-sha256', '-sign', p('release.key'), '-out', p('release.sig'), p('release.json')).returncode == 0
    def signature_valid(public_key):
        return openssl('dgst', '-sha256', '-verify', p(public_key), '-signature', p('release.sig'), p('release.json')).returncode == 0
    assert signature_valid('release.pub')
    assert not signature_valid('other.pub')
    (root / 'release.json').write_bytes(original.replace(b'"version":8', b'"version":9'))
    assert not signature_valid('release.pub')
    (root / 'release.json').write_bytes(original)
    assert signature_valid('release.pub')
    assert hashlib.sha256(artifact).hexdigest() == manifest['sha256']
    assert hashlib.sha256(artifact + b'changed').hexdigest() != manifest['sha256']
    print(openssl('version').stdout.strip())
    print('original accepted; wrong key and changed signed bytes rejected')
    print('trusted manifest digest matches original artifact, not changed artifact')

古い正規の版も別に判断する

説明用に、端末が版7までを信頼して記録し、更新開始時刻を2026年10月28日と固定します。正しい権限の鍵で承認された版8で、期限が翌日なら、署名以外の条件も確認して受理へ進めます。同じ鍵で承認された版6は、署名が正しくても、記録済みの版より古いものです。ここでの拒否理由は改変ではなく、巻戻しを認めない方針です。

さらに、署名が正しい版7を長期間見せ続ける場合も考えます。新しい情報がないことと、本当に新しい版が存在しないことを、通信相手の主張だけでは区別できません。期限を持つメタデータは、このような凍結を検出するための条件になります。ただし、時計と保持した信頼状態にも前提があります。版番号をファイル名から読むだけ、あるいは取得時刻だけを毎回更新するだけでは、認証された更新履歴を保ったことにはなりません。

履歴の各行へ受理・拒否の理由を書く

比較表では、元の版8、変更された配布物、別鍵、古い版6、期限切れの版8を分けます。変更された配布物は、信頼したメタデータのハッシュと一致しません。別鍵の行は、その鍵へ権限を与えていないという信頼の条件に反します。古い版と期限切れは、署名を検証する計算が通る場合でも、版と期限の方針により拒否します。

この表は、TUFの検証手順を省略して独自の受理ロジックを採用するためのものではありません。どの条件が必要かを読み分ける練習です。実装では、取得した複数のメタデータが同じ更新の状態に対応するか、長さやハッシュが一致するかなども検査します。役割ごとの承認と、配布物の検証を一つの真偽値へまとめる前に、失敗理由がどの境界のものかを確認できるようにします。

条件署名以外の判断扱い
版8・期限内既存の信頼と版の条件を確認残る検査へ進む
配布物を改変信頼したハッシュと不一致拒否
別の鍵更新権限を承認していない拒否
版6を再配布記録済み版7より古い拒否
期限切れの情報更新開始時刻に有効でない拒否

鍵の更新にも既存の信頼を使う

鍵を入れ替える必要がある場合、次の配布物に新しい鍵を添えるだけでは十分ではありません。どの既存の権限が変更を承認し、新しい権限がどの条件で有効になるかという移行が必要です。TUFのroot更新には、信頼済みの状態から次の状態へ進むための版と署名の規則があります。実装は、その仕様に従って順序と閾値を検査します。

鍵が失われた場合と漏えいした場合では、利用できる承認も異なります。回復手順を事前に設計し、オンラインの署名担当と、より強く保護する権限をどう分けるかを決めます。この教材の鍵は実験ごとに一時生成するため、その運用を実装していません。製品の更新設計では、初期信頼の配布、鍵更新、期限切れ、回復をまとめて検討し、署名関数の呼出しだけを完成条件にしないことが必要です。

検証の後にも適用の失敗がある

配布物の検証が通ったあとでも、書込み失敗、容量不足、設定の互換性、移行処理の失敗で適用を完了できない場合があります。検証と適用を別の段階として扱い、途中の状態を正式な更新済み状態として記録しない設計が必要です。検証前に既存の実行ファイルを上書きしてしまうと、拒否した時点で正常な版まで失う危険があります。

安全に準備して切り替える方式、起動を確かめる方式、失敗時の回復は、配布形式と環境に応じて設計します。運用上の復旧で古い実行環境へ戻すことと、通信相手が古いメタデータを送り付ける巻戻しを無条件に許すことは同じではありません。復旧の権限と信頼状態の扱いを仕様へ含めます。署名が通ったというログだけで、利用者の端末が正常な版で起動できたと断定しないでください。適用と動作確認には別の観測が必要です。

オフライン期間と時刻の前提を明らかにする

端末が長期間通信しない要件では、期限切れを検出したあと、何を継続し、何を更新できない状態として示すかも決めます。期限を無視する例外をその場で足すと、凍結を検出する条件まで失う場合があります。時計のずれや信頼状態の消失を、正常な更新として記録してはいけません。採用する仕組みの回復手順と、利用者へ示す状態を確認し、更新の受理と既存版の継続動作を別の判断として扱います。

課題は署名と採用理由を分けて答える

課題として、署名が正しい版6を、版7まで記録した端末が受理すべきか答えます。説明用の巻戻し禁止方針では拒否します。次に、版8で署名が正しくても期限切れなら、その理由を別に述べます。署名の計算は内容と鍵の関係を示しますが、期限の条件を自動的に満たすわけではありません。

最後に、テストコードでother.pubを信頼するよう変更すれば、誰が署名した配布物でも安全になるか考えます。答えはなりません。検証者が信頼する権限そのものを変更したためです。解答には、初期信頼、署名、版、期限、配布物の一致、適用後の状態を順に書きます。どこまでをAPIで実行し、どこからをプロトコルと運用の設計として説明したかも明記します。これにより、実験の成功を更新システム全体の保証へ広げすぎずに済みます。

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

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

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

学習コースから次を選ぶ