セキュリティ設計
GitHub Issue: #15 セキュリティ設計書 → #53 設計書更新
脅威モデル
mermaid
graph TB
subgraph Threats["脅威ソース"]
direction LR
T1["環境変数の漏洩<br/>(ps, /proc, ログ)"]
T2["ファイルシステム経由<br/>(.env, .zshrc 平文)"]
T3["ネットワーク盗聴<br/>(中間者攻撃)"]
T4["デバイス間転送<br/>(キーの平文送信)"]
T5["メモリダンプ<br/>(スワップ, コアダンプ)"]
T6["不正アプリ<br/>(Keychain アクセス)"]
end
subgraph Defenses["AI KeyChain 防御策"]
direction LR
D1["Proxy モード<br/>(環境変数にキー露出なし)"]
D2["Keychain 専用保存<br/>(ファイル書き出しなし)"]
D3["localhost 限定バインド<br/>(外部接続拒否)"]
D4["P-256 ECDH + AES-GCM<br/>(暗号化転送)"]
D5["都度取得・最小保持<br/>(メモリ露出最小化)"]
D6["アクセスグループ制限<br/>(ThisDeviceOnly)"]
end
T1 -.->|対策| D1
T2 -.->|対策| D2
T3 -.->|対策| D3
T4 -.->|対策| D4
T5 -.->|対策| D5
T6 -.->|対策| D6
style Threats fill:#FEE2E2,stroke:#DC2626
style Defenses fill:#D1FAE5,stroke:#059669セキュリティレベル比較
| 方式 | 環境変数露出 | ファイル露出 | ネットワーク | 利便性 |
|---|---|---|---|---|
| .env ファイル | ✅ 露出 | ✅ 露出 | - | ★★★ |
| .zshrc export | ✅ 露出 | ✅ 露出 | - | ★★☆ |
| Standard モード | ✅ 露出 | ❌ なし | - | ★★☆ |
| Proxy モード | ❌ なし | ❌ なし | localhost のみ | ★★★ |
Keychain アクセス制御
kSecAttrAccessible の選定
kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly| 属性 | 意味 |
|---|---|
| AfterFirstUnlock | ユーザーが 1 回ロック解除した後はアクセス可能 |
| ThisDeviceOnly | iCloud Keychain で同期しない (セキュリティ優先) |
なぜこの設定？
WhenUnlockedだとスリープ復帰ごとにアクセス不可になり利便性が下がるAfterFirstUnlockは起動後 1 回のロック解除で以降アクセス可能ThisDeviceOnlyでデバイス間の漏洩リスクを排除
Keychain クエリ構成
swift
let query: [String: Any] = [
kSecClass as String: kSecClassGenericPassword,
kSecAttrService as String: "com.aieo.aikeychain",
kSecAttrAccount as String: envVarName, // "ANTHROPIC_API_KEY"
kSecValueData as String: tokenData, // UTF-8 encoded
kSecAttrAccessible as String: kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly
]Proxy サーバーセキュリティ
localhost 限定バインド
swift
let params = NWParameters.tcp
params.acceptLocalOnly = true // 外部ネットワークからの接続を拒否
let listener = try NWListener(using: params, on: NWEndpoint.Port(rawValue: port)!)acceptLocalOnly = trueにより、127.0.0.1からの接続のみ受付- 外部ネットワークからのリクエストは OS レベルで拒否される
- ファイアウォール設定不要
リクエスト処理の安全性
| チェック | 内容 |
|---|---|
| ホスト検証 | ProxyRoute.route(for:) に一致するホストのみ転送 |
| ルート未定義 | 404 を返却 (任意のホストへの転送を防止) |
| Keychain 失敗 | 500 を返却 (キーなしで上流に送信しない) |
| HTTPS 強制 | 上流への転送は常に https:// |
プロキシ設定ファイルのライフサイクル
~/.aikeychain_proxy ← プロキシ起動時に生成、停止時に削除.zshrc のフックはプロキシのヘルスチェックを行い、応答がない場合は設定ファイルを自動削除:
bash
if [ -f ~/.aikeychain_proxy ]; then
_aikp=$(grep -om1 'localhost:[0-9]*' ~/.aikeychain_proxy | head -1 | cut -d: -f2)
if [ -n "$_aikp" ] && (echo >/dev/tcp/127.0.0.1/$_aikp) 2>/dev/null; then
source ~/.aikeychain_proxy
else
rm -f ~/.aikeychain_proxy # プロキシ未稼働なら設定を削除
fi
unset _aikp
fi重要
プロキシ未稼働時に BASE_URL 環境変数が残ると、全ての AI API 呼び出しが失敗する。 ヘルスチェック + 自動削除でこの問題を防止している。
デバイス間キー転送の暗号化
暗号化方式
| 要素 | アルゴリズム |
|---|---|
| 鍵交換 | P-256 ECDH (Elliptic Curve Diffie-Hellman) |
| 鍵導出 | HKDF-SHA256 (32 バイト) |
| データ暗号化 | AES-256-GCM (認証付き暗号) |
転送フロー
mermaid
sequenceDiagram
participant A as デバイス A (受信側)
participant B as デバイス B (送信側)
Note over A: 1. キーペア生成
A->>A: P-256 秘密鍵を Keychain に保存<br/>tag: "com.aieo.aikeychain.sharekey"
A->>B: .aikeychain-pub (公開鍵)
Note over B: 2. 暗号化
B->>B: エフェメラル P-256 キーペア生成
B->>B: ECDH(ephemeral秘密鍵, A公開鍵) → 共有シークレット
B->>B: HKDF-SHA256(共有シークレット) → AES鍵
B->>B: AES-256-GCM.seal(キーデータJSON)
B->>A: .aikeychain (暗号化ファイル)
Note over A: 3. 復号
A->>A: ECDH(A秘密鍵, ephemeral公開鍵) → 共有シークレット
A->>A: HKDF-SHA256(共有シークレット) → AES鍵
A->>A: AES-256-GCM.open(暗号化データ)
A->>A: JSON パース → Keychain にインポートファイル形式
公開鍵ファイル (.aikeychain-pub):
json
{
"version": 1,
"publicKey": "<base64 x963 representation>"
}暗号化ファイル (.aikeychain):
json
{
"version": 1,
"ephemeralPublicKey": "<base64 x963>",
"encryptedData": "<base64 AES-256-GCM sealed box>",
"keyCount": 5
}秘密鍵の保管
| 項目 | 値 |
|---|---|
| 保存先 | macOS Keychain |
| タグ | "com.aieo.aikeychain.sharekey" |
| 形式 | P-256 rawRepresentation (32 bytes) |
| アクセス | AfterFirstUnlockThisDeviceOnly |
Entitlements
xml
<dict>
<key>keychain-access-groups</key>
<array>
<string>$(AppIdentifierPrefix)com.aieo.aikeychain</string>
</array>
<key>com.apple.security.network.client</key>
<true/>
</dict>| Entitlement | 用途 |
|---|---|
keychain-access-groups | アプリ固有の Keychain グループ |
com.apple.security.network.client | ProxyServer から上流 API への HTTPS 接続 |
トークンバリデーション
入力されたトークンのプレフィックスをチェックし、誤入力を防止する。
| Service | Expected Prefix | Example |
|---|---|---|
| Anthropic | sk-ant- | sk-ant-api03-xxxxx |
| OpenAI | sk- | sk-xxxxx |
| GitHub | ghp_ or gho_ | ghp_xxxxx |
| GitLab | glpat- | glpat-xxxxx |
| xAI | xai- | xai-xxxxx |
| Tailscale | tskey- | tskey-client-xxxxx |
| Slack | xapp- or xoxb- | xapp-1-xxxxx |
注意
プレフィックスチェックは 警告のみ で、保存をブロックはしない。 サービス側がプレフィックス形式を変更する可能性があるため。
クリップボード自動クリア
トークン値をクリップボードにコピーした場合、30 秒後に自動クリア する。
swift
func copyToClipboard(_ value: String) {
NSPasteboard.general.clearContents()
NSPasteboard.general.setString(value, forType: .string)
DispatchQueue.main.asyncAfter(deadline: .now() + 30) {
NSPasteboard.general.clearContents()
}
}セキュリティチェックリスト
- [x] Keychain にのみシークレットを保存 (ファイル書き出しなし)
- [x] SecureField で入力中のマスキング
- [x] メモリ上でのトークン保持を最小化 (都度取得)
- [x] クリップボード 30 秒自動クリア
- [x] Keychain アクセスグループ制限
- [x] ThisDeviceOnly で iCloud 同期無効
- [x] Proxy: localhost 限定バインド (acceptLocalOnly)
- [x] Proxy: HTTPS 強制 (上流転送)
- [x] Proxy: ヘルスチェック付き設定ファイルライフサイクル
- [x] 転送: P-256 ECDH + AES-256-GCM 暗号化
- [x] 転送: エフェメラルキーによる前方秘匿性
- [x] Export 時の平文警告表示