実践：暗号化された健康データで計算するPythonチュートリアル

暗号化データのまま計算を可能にする準同型暗号を解説。TenSEALライブラリを使い、復号化せずに医療データ分析を行う実践的な方法を学びます。

2025年12月12日読了時間 10分

このページの内容

革新的なヘルステックアプリケーションを構築한다고想像してみてください。ユーザーのバイオメトリクスデータ（例：過去1週間の平均安静時心拍数）に関する洞察に満ちた分析を提供したいと考えています。しかし、適切なデータセキュリティを確保することは依然として課題です。

導入

平均安静時心拍数などのユーザーに関する洞察に満ちた分析を提供したいと考えています。このデータは非常に機密性が高いため、重大な課題となります。データ漏洩が発生すると、個人の健康情報が露出し、ユーザーへの信頼の致命的な損失と重大な法的結果を招く可能性があります。

従来の方法では、サーバー側で平均などの計算を実行するために、データの復号化が必要でした。計算中のこの瞬間、平文データが脆弱になります。暗号化されたデータに対して直接計算を実行できたらどうでしょうか？これが**同型暗号（HE：Homomorphic Encryption）**の約束であり、まるで魔法のような暗号技術です。これにより、第三者のサービス（クラウドサーバーなど）が暗号文を処理および計算し、復号化された結果が、平文に対して実行された演算の結果と同一になる暗号化された結果を生成できます。

このチュートリアルでは、実用的なPythonの例を構築することで、同型暗号の謎を解明します。以下のことを行います：

機密性の高い健康データ（例：日次心拍数測定値）のリストを取得します。
TenSEALと呼ばれる強力なPythonライブラリを使用して、「クライアントサイド」でデータを暗号化します。
暗号化されたデータを「サーバー」に送信し、サーバー側で復号鍵を持たずに平均心拍数を計算します。
暗号化された平均値をクライアントに返し安全に復号化します。

このハンズオンアプローチにより、プライバシー保護機能を構築するために高度な暗号技術を活用する方法を示します。これはデータプライバシーの時代における重要なスキルです。

前提条件：

知識：Pythonの確かな理解。事前の暗号学の知識は必須ではありません。
ツール：Python 3.7+ と tenseal ライブラリ。

問題の理解：ヘルステックにおけるプライバシーのパラドックス

ヘルステック業界はパラドックスに直面しています。より多くのデータを収集するほど、パーソナライズされた効果的なサービス提供が可能になります。しかし、心拍数や睡眠パターンからゲノム配列までを含むこの豊富なデータは、攻撃者の主要な標的となっています。

現在のソリューションとその限界：

保存時暗号化と転送時暗号化：データベースに保存されているとき（保存時）とネットワーク経由で送信されているとき（転送時）にデータを暗号化することが標準的な做法です。これは不可欠ですが、重大な脆弱性が残ります：計算のためにデータを復号化する必要があります。
匿名化：これはデータセットから個人識別情報（PII）を剥离することを意味します。有用ですが、再識別攻撃はますます高度になっており、パーソナライズされた分析では、特定のユーザーにデータをリンクバックする必要がある 경우가よくあります。

我々のアプローチ：暗号文での計算 同型暗号は「計算の脆弱性」問題を解決します。サーバーは、元の機密情報を決して見ることなく、ユーザーデータの分析を実行し、機械学習モデルをトレーニングし、インサイトを導出できます。これは、安全なクラウドコンピューティング、医学研究における多者間コラボレーション、真にプライベートな個人分析への新しい可能性を開きます。このチュートリアルでは、実数（または近似数）の計算のために特別に設計されたCKKS（Cheon-Kim-Kim-Song）スキームを使用します。これはバイオメトリクスデータに最適です。

前提条件：環境のセットアップ

始める前に、環境を準備しましょう。tenseal ライブラリをインストールする必要があります。

ターミナルを開き、次のコマンドを実行します：

bash

pip install tenseal

インストールを確認するには、Pythonインタープリタを開始し、ライブラリをインポートします：

python

import tenseal as ts
print(ts.__version__)

エラーなしでインストールされたバージョン番号が表示されるはずです。

ステップ1：同型暗号コンテキストの作成

任意の TenSEAL アプリケーションの最初のステップは、TenSEALContext を作成することです。このオブジェクトは、暗号化スキームのすべての重要なパラメータ（公開鍵、秘密鍵、セキュリティレベルと計算能力を定義する設定など）を保持します。

何をしているか

CKKS暗号化スキームのコンテキストを設定します。3つの重要なパラメータを定義する必要があります：

poly_modulus_degree：このパラメータはセキュリティレベルと単一のベクトルに暗号化する値の数を左右します。2の累乗である必要があります。
coeff_mod_bit_sizes：これは係数モジュラスで使用される素数のサイズを定義します。「乗算深度」に影響します—ノイズ成長が暗号文を復号不能にする前に、暗号化されたデータに対して実行できる乗算回数。
global_scale：これは暗号化された実数の精度を決定します。 essentially working with fixed-point numbers, and this scale factor defines where the decimal point is.

実装

python

# src/create_context.py
import tenseal as ts

def create_context():
    """
    同型暗号用のTenSEALコンテキストを作成して設定します。
    """
    context = ts.context(
        ts.SCHEME_TYPE.CKKS,
        poly_modulus_degree=8192,
        coeff_mod_bit_sizes=[60, 40, 40, 60]
    )
    context.generate_galois_keys()
    context.global_scale = 2**40
    
    return context

if __name__ == '__main__':
    ctx = create_context()
    print("✅ TenSEALコンテキストが正常に作成されました。")
    print(f"    パラメータ: poly_modulus_degree={ctx.poly_modulus_degree()}, global_scale=2^{ctx.global_scale.bit_length()-1}")

    # コンテキストは秘密鍵を保持します
    secret_key = ctx.secret_key()
    
    # 秘密鍵を含まないコンテキストの公開バージョンも作成できます
    public_ctx = ctx.copy()
    public_ctx.make_context_public() # 秘密鍵を削除
    
    print("🔑 コンテキストが秘密鍵を含んでいる: ", ctx.is_private())
    print("🔑 公開コンテキストが秘密鍵を含んでいる: ", public_ctx.is_private())

動作の仕組み

CKKS スキームでコンテキストを初期化します。poly_modulus_degree が8192は一般的で安全な選択です。coeff_mod_bit_sizes リストは、連鎖された乗算の一定数を可能にします。また、ベクトルのすべての要素を合計するための重要なステップであるベクトル回転操作を実行するために必要な galois_keys も生成します。最後に、make_context_public() は、サーバーに送信できるコンテキストのバージョンを作成し、復号化に必要な秘密鍵を crucially lacks ながら公開鍵と評価鍵を含みます。

ステップ2：クライアントサイドの暗号化

コンテキストの準備ができたので、クライアントの役割をシミュレートしましょう。ユーザーは、サーバー個々の数値を開示することなく平均を求めたい1週間分の安静時心拍数データを持っています。

何をしているか

心拍数を表す浮動小数点数のリストを取り、単一の CKKSVector に暗号化します。このベクトルオブジェクトは、すべてのデータポイントを1つの暗号化されたエンティティにバンドルします。

実装

python

# src/client.py
import tenseal as ts
from create_context import create_context

def encrypt_health_data(context, data):
    """数値のリストをCKKSベクトルに暗号化します。"""
    return ts.ckks_vector(context, data)

if __name__ == '__main__':
    # (クライアントサイド)
    # 1. 秘密鍵を持つコンテキストを作成
    context = create_context()

    # 2. サンプル機密健康データ
    heart_rate_data = [72.5, 71.0, 73.2, 69.8, 70.5, 74.1, 71.7]
    print(f"平文データ（クライアント）: {heart_rate_data}")
    
    # 3. データを暗号化
    encrypted_heart_rates = encrypt_health_data(context, heart_rate_data)
    print(f"🔒 データがCKKSベクトルに正常に暗号化されました。")
    
    # 4. 暗号化されたデータと公開コンテキストをシリアル化して送信準備
    serialized_encrypted_vector = encrypted_heart_rates.serialize()
    
    # 公開コンテキストを作成してシリアル化
    public_context = context.copy()
    public_context.make_context_public()
    serialized_public_context = public_context.serialize()
    
    # これはサーバーに送信するものです
    # このチュートリアルでは、オブジェクトを直接渡します
    # 実際のアプリでは、これはAPI呼び出しになります
    #
    # server_receives(serialized_public_context, serialized_encrypted_vector)

動作の仕組み

ts.ckks_vector() 関数は、コンテキストと数値のリストを受け取ります。数値を多項式にエンコードし、コンテキスト内に 저장された 공개鍵을 사용하여暗号化します。結果は、すべての心拍数データを暗号化された状態で保持する単一の CKKSVector オブジェクトです。

ステップ3：暗号化されたデータでのサーバーサイド計算

魔法が起こる場所です。「サーバー」は暗号化されたベクトルと公開コンテキストを受け取ります。そのタスクは、秘密鍵を持たずに、ベクトル内の数値の平均を計算することです。

平均は sum(values) / count(values) として計算されます。2つのステップで実行できます：

合計：暗号化されたベクトルの要素を同型的に合計します。
除算：暗号化された合計を要素数の公開カウント（同値にに乗算而已）で同型的に除算します。

何をしているか

ベクトルの要素を合計するために、「ローテートして合計」戦略を使用します。ベクトルが [v1, v2, v3, v4] であるとします。1位置把它 rotate して [v2, v3, v4, v1] を取得し、元のものに追加します。このプロセスを繰り返し、各ステップで合計される要素の数を2倍にしていき、すべての要素がベクトルの各スロットに累積されるまで続けます。最後に、結果のベクトルに 1/n を掛けて平均を取得します。

実装

python

# src/server.py
import math

def calculate_encrypted_average(public_context, encrypted_vector):
    """
    暗号化されたベクトルの平均を計算するために同型演算を実行します。
    """
    # サーバーは復号化せずにベクトルのサイズを取得できます
    n_values = len(encrypted_vector)

    # 1. ベクトルのすべての要素を同型的に合計
    # これは最も複雑なステップです。水平合計を達成するためにローテーションを使用します。
    encrypted_sum = encrypted_vector.sum()
        
    print("🖥️  サーバー: 暗号化された合計が計算されました。")

    # 2. 平均を取得するために値の数逆数将它乗算
    # 平文の数による除算は、その逆数による乗算と同等です。
    encrypted_average = encrypted_sum * (1 / n_values)
    print(f"🖥️  サーバー: {1/n_values:.4f} を乗算して暗号化された平均を計算しました。")
    
    return encrypted_average

if __name__ == '__main__':
    # このブロックは完全なパイプラインをシミュレートします
    
    # ====== クライアントサイド ======
    from create_context import create_context
    import tenseal as ts

    # 1. セットアップ
    context = create_context()
    heart_rate_data = [72.5, 71.0, 73.2, 69.8, 70.5, 74.1, 71.7]
    print(f"平文データ（クライアント）: {heart_rate_data}")
    print(f"平文平均: {sum(heart_rate_data) / len(heart_rate_data):.2f}")

    # 2. 暗号化
    encrypted_heart_rates = ts.ckks_vector(context, heart_rate_data)
    print("🔒 クライアント: データが暗号化されました。")
    
    # ====== データ転送（クライアント -> サーバー） ======
    # 実際のアプリでは、HTTP/RPC経由でシリアル化して送信します
    serialized_vector = encrypted_heart_rates.serialize()
    public_context = context.copy()
    public_context.make_context_public()
    serialized_context = public_context.serialize()

    # ====== サーバーサイド ======
    # サーバーは公開コンテキストと暗号化されたデータのみを保持します
    server_context = ts.context_from(serialized_context)
    server_encrypted_vector = ts.ckks_vector_from(server_context, serialized_vector)
    
    print("☁️  サーバー: 暗号化されたデータと公開コンテキストを受け取りました。")
    
    # 3. 計算
    encrypted_average = calculate_encrypted_average(server_context, server_encrypted_vector)
    
    # ====== データ転送（サーバー -> クライアント） ======
    serialized_encrypted_average = encrypted_average.serialize()
    
    # ====== クライアントサイド ======
    # 4. 復号化
    print("🔙 クライアント: 暗号化された平均を受け取りました。")
    result_vector = ts.ckks_vector_from(context, serialized_encrypted_average) # 秘密鍵を持つ元のコンテキストを使用
    decrypted_average = result_vector.decrypt() # 結果は最初のスロットにあります
    
    print("======== 結果 ========")
    print(f"✅ 復号化された平均心拍数: {decrypted_average:.2f}")
    print("=========================")

動作の仕組み

TenSEAL の encrypted_vector.sum() メソッドは、複雑な「ローテートして合計」ロジックを抽象化します。生成したガロア鍵を使用して効率的なローテーションと加算を実行し、最終的に元のすべての要素の合計である各要素を持つ新しい暗号化されたベクトルを生成します。

次に、encrypted_sum * (1 / n_values) は、暗号化された合計と平文（暗号化されていない）数の間で要素ごとの乗算を実行します。CKKSスキームはこの操作をシームレスにサポートします。サーバーは теперь、平均を表す暗号化されたベクトルを保持し、それをクライアントに戻すことができます。

クライアントは、結果を受け取り、元の context（秘密鍵を含む）を使用してメッセージを復号化し、最終的で正確な平均を取得します。

パフォーマンスの考慮事項

同型暗号は強力ですが、免费ではありません。計算は平文の対応物よりも著しく遅く、メモリ集約的です。

レイテンシ：暗号化されたデータの暗号化、復号化、特に計算には時間がかかります。単純な平均ではミリ秒ですが、複雑な機械学習モデルでは数秒または数分かかる可能性があります。
暗号文サイズ：シリアル化された暗号化されたベクトルは、元の平文データよりもはるかに大きくなります。7つの浮動小数点数（56バイト）のリストは、数百キロバイトの暗号文になる可能性があります。
パラメータ調整：CKKSスキームのセキュリティとパフォーマンスは、コンテキストパラメータ（poly_modulus_degree、coeff_mod_bit_sizes）に大きく依存します。より大きなパラメータはより多くのセキュリティを提供し、より複雑な計算（より多くの乗算）を可能にしますが、より遅くなります。使用事例に合った正しいパラメータを選択することは、慎重なバランス取りです。

セキュリティのベストプラクティス

鍵管理：秘密鍵は、このシステムで最も重要な要素です。クライアントのデバイスを離れることは決してありません。標準的な安全な鍵管理実践が最も重要です。
パラメータ選択：確立された、安全なパラメータを使用してください。TenSEAL のデフォルトは良い出発点ですが、本番システムでは、推奨されるセキュリティレベル（例：128ビットセキュリティ）のために暗号文学の文献を参照してください。
サイドチャネル攻撃：サーバーはデータを見ませんが、計算時間とメモリアクセスパターンを観察できます。高リスクなシナリオでは、これらの「サイドチャネル」が情報をリークする可能性がありますそのような攻撃に強いシステムの設計は、高度なトピックです。
独自の暗号技術を作らない：TenSEAL（Microsoft SEALの上に構築）のような、よく吟味され、同業者-reviewed のライブラリを常に使用してください。

結論

暗号化されたデータで計算を実行する完全なエンドツーエンドの例を successfully through しました。機密性の高い心拍数データを暗号化するクライアントとして役割を果たし、元の数値を決して見ずに平均を計算するサーバーに切り替えました。この強力なプライバシー保護技術は、もはやただの理論的ではありません。TenSEAL のようなライブラリを通じて、Python開発者がアクセスできるようになりました。

HEにはパフォーマンスのトレードオフがありますが、ヘルスケアや金融などの機密性の高い分野で特に、セキュアなアプリケーションの新しいクラスを構築する能力を取得します。

読者の次のステップ：

分散や単純な線形回帰の計算など、他の計算で Experiment してみてください。
コンテキストパラメータを変更することのパフォーマンス impact を調べます。
ファイルをシミュレートするためにより現実的なクライアント-サーバー interaction をシミュレートするために、コンテキストと暗号化されたベクトルをファイルにシリアル化してみてください。

参考資料

公式ドキュメント：TenSEAL GitHub Repository
基盤ライブラリ：Microsoft SEAL
参考資料：A Step-by-Step Fully Homomorphic Encryption Example with TenSEAL

クイックリファレンス

側面	重要な情報
トピック	開発
関連性	患者教育と認識
アクション	医療提供者との協議
頻度	ケアチームのおすすめに応じて
証拠	現在の臨床ガイドラインに基づく

よくある質問

Q: これが自分に該当するかどうかはどうすればわかりますか？ A: あなたの個人的な病史と家族歴について医療提供者と相談し、あなたの個々のリスク要因を評価し、適切な次のステップを決定してください。

Q: 医師に何を聞くべきですか？ A: 良い質問には次のようなものがあります：「私の結果は何を意味しますか？」「私のオプションは何ですか？」「どのようなライフスティングの変更が役に立ちますか？」「いつフォローアップすべきですか？」

Q: 役立つライフスティングの変更はありますか？ A: ほとんどの健康状態は、基本的な対策から恩恵を受けます：バランスの取れた栄養、定期的な身体活動（週150分以上）、質の高い睡眠（7〜9時間）、ストレス管理、タバコの回避。

医療免责声明

この記事は教育の目的に限り使用されており、医学的アドバイスを构成するものではありません。健康、治療、またはケアに関する決定する前に、常に資格のある医療提供者と相談してください。個人の状況は異なり、ある人に適切なことが別の人に appropriate ではないかもしれません。

緊急事態が発生した場合は、直ちに119番（またはお住まいの地域の緊急番号）に電話してください。

すべての記事に戻る