---
title: "Redis の信頼境界"
description: "セッションと WebAuthn チャレンジを置く Redis の機密性の扱いと対策"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.koyori.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Redis の信頼境界

## 概要

このバックエンドは Redis をセッションストアと同等の機密性で扱う。侵害された Redis は、有効なログインセッションの窃取と同等の影響を及ぼす。

## Redis に保存されるデータ

保存するデータは次のとおりである。

| キー接頭辞 | 内容 | TTL |
|---|---|---|
| （axum-session） | 利用者のセッション ID・属性 | セッション設定に依存 |
| `webauthn:reg:{user_id}` | パスキー登録セッション状態 | 5 分 |
| `webauthn:reg:lock:{user_id}` | 登録フロー排他ロック | 5 分（`CHALLENGE_TTL_SECS` と同一） |
| `webauthn:auth:{challenge_id}` | パスキー認証セッション状態 | 5 分 |
| `webauthn:auth:disc:{challenge_id}` | Discoverable 認証状態 | 5 分 |

## リスク

想定するリスクは次のとおりである。

1. チャレンジの窃取。攻撃者が Redis から登録/認証状態を読み取れると、正当なクライアントの代わりに ceremony を完了できる可能性がある。`GETDEL` によりワンタイム消費だが、読み取り専用の侵害ではリプレイの余地が残る
2. セッション固定・乗っ取り。セッションキーの漏洩はアカウント乗っ取りに直結する
3. 登録ロックのバイパス。ロック TTL 切れ後の並行登録で上限チェックの競合が理論上起こり得る（TTL 5 分）

## 推奨セキュリティ対策

推奨する対策は次のとおりである。

- Redis をプライベートネットワークに配置し、インターネットから直接到達不可にする
- AUTH / TLS（`rediss://`）を有効化する
- 本番では専用 Redis インスタンスを使用し、他アプリと DB 番号を共有しない
- バックアップ・レプリカへのアクセス権を最小化する
- チャレンジはサーバー側のみが読み書きし、クライアント API から Redis キーを推測できない設計を維持する（ランダムな `challenge_id` UUID を使う）

## 関連実装

関連する実装は次のとおりである。

- `crates/service/src/passkey_challenges.rs`: WebAuthn 状態の保存・排他ロック
- `axum_session_redispool`: HTTP セッション

Source: https://docs.koyori.app/dev/design/redis-trust-boundary/index.mdx
