🔐 Raspberry Pi Pico W – Hardware Security Module (HSM)

概要 (Overview)

このプロジェクトは Raspberry Pi Pico / Pico W を用いた 軽量ハードウェアセキュリティモジュール (HSM) の実装です。

MASTER_SEED を内部に安全に保持し、 以下のような暗号処理をローカル・USB・Wi-Fi越しに提供します：

• デバイス固有の鍵派生（unique_id ベース）
• AES-GCM 暗号化 / 復号
• HMAC-SHA256（EncryptSecureDEC / JAES 用）
• RSA 鍵生成 / 署名 / 検証
• 低消費電力スリープ
• Wi-Fi（REST API）/ BLEによる通信（オプション）

✨ 主な特徴 (Features)

• unique_id() を用いたデバイス固有キー生成
• MASTER_SEED の安全な内部保存
• AES-GCM / RSA2048 の暗号処理
• Wi-Fi REST API によるリモートHSM
• BLE対応（任意）
• 操作ごとのLEDインジケータ
• 非操作時の自動スリープ
• BootSel ボタンで強制安全リセット
• Python / CLI / EncryptSecureDEC / JAES から利用可能

🚀 クイックスタート (Quick Start)

1. ファームウェアをPicoに書き込み

セットアップマニュアルはこちら

動作確認済み開発ボードはこちら

main.py と boot.py を Pico 内部ストレージへコピーします。

main.pyのMASTER_SEEDは最低 128bit（英数字22文字以上）
実運用では 256bit（英数字43文字以上） のランダム値を使用してください。
これは一般的な暗号モジュールで推奨される鍵強度に準じています。

2. Pythonクライアント（例）

from PicoHSM import PicoHSM_HMAC

hsm = PicoHSM_HMAC()
mac = hsm.hmac(b"hello pico-hsm")

print(mac.hex())

EncryptSecureDEC(サブスクリプション版) / RSA-Cryptors で使用可能です。

🛡 セキュリティ (Security)

• MASTER_SEED は Pico内部に安全に保存（外部へ露出しない）
• Wi-Fi 認証情報は永続保存しない
• USB通信はJSONベースの単純プロトコル
• BootSel リセットで信頼状態に復元可能

📜 ライセンス (License)

MIT License
© 2025 Tomoya Koga