110 lines
3.1 KiB
Markdown
110 lines
3.1 KiB
Markdown
|
# セキュリティセットアップガイド
|
|||
|
|
|
|||
|
|
このドキュメントは、開発環境でAPIキーを安全に管理するための手順を説明します。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔐 初回セットアップ（必須）
|
|||
|
|
|
|||
|
|
### Step 1: 新しいAPIキーを発行
|
|||
|
|
|
|||
|
|
1. [Google AI Studio](https://aistudio.google.com/apikey) にアクセス
|
|||
|
|
2. **重要**: 既存のキー `AIzaSy...` が表示されている場合は、**必ず無効化**してください
|
|||
|
|
3. 新しいAPIキーを発行（「Create API Key」ボタン）
|
|||
|
|
4. 発行されたキーをクリップボードにコピー
|
|||
|
|
|
|||
|
|
### Step 2: ローカル設定ファイルを作成
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# プロジェクトルートで実行
|
|||
|
|
cd c:\Users\maita\posimai-project\ponshu_room_lite
|
|||
|
|
|
|||
|
|
# テンプレートをコピー
|
|||
|
|
cp lib/secrets.local.dart.example lib/secrets.local.dart
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Step 3: APIキーを設定
|
|||
|
|
|
|||
|
|
`lib/secrets.local.dart` をエディタで開き、以下のように編集:
|
|||
|
|
|
|||
|
|
```dart
|
|||
|
|
class SecretsLocal {
|
|||
|
|
/// あなたのGemini APIキーをここに設定してください
|
|||
|
|
static const String geminiApiKey = 'AIzaSy...YOUR_NEW_KEY_HERE';
|
|||
|
|
|
|||
|
|
/// ローカル開発時のAI Proxy URL（オプション）
|
|||
|
|
static const String aiProxyBaseUrl = 'http://100.76.7.3:8080';
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**注意**: `lib/secrets.local.dart` は `.gitignore` に含まれているため、Gitにコミットされません。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚀 アプリの起動
|
|||
|
|
|
|||
|
|
### 開発時（ローカル設定を使用）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
flutter run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
`lib/secrets.local.dart` が存在すれば、自動的にそこからAPIキーを読み込みます。
|
|||
|
|
|
|||
|
|
### リリースビルド時（環境変数を使用）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
flutter build apk --dart-define=GEMINI_API_KEY=AIzaSy...YOUR_KEY
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ✅ セキュリティチェックリスト
|
|||
|
|
|
|||
|
|
- [ ] **Step 1**: 古いAPIキー（`AIzaSyARuYSPqMLXz51hYnWN4gkL9vA4lA-CMmQ`）を無効化
|
|||
|
|
- [ ] **Step 2**: `lib/secrets.local.dart` を作成し、新しいAPIキーを設定
|
|||
|
|
- [ ] **Step 3**: `lib/secrets.local.dart` がGitにコミットされていないことを確認
|
|||
|
|
```bash
|
|||
|
|
git status | grep secrets.local.dart
|
|||
|
|
# 何も表示されなければOK
|
|||
|
|
```
|
|||
|
|
- [ ] **Step 4**: アプリが正常に起動することを確認
|
|||
|
|
```bash
|
|||
|
|
flutter run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔍 トラブルシューティング
|
|||
|
|
|
|||
|
|
### エラー: `Gemini API Key is missing`
|
|||
|
|
|
|||
|
|
**原因**: APIキーが設定されていません
|
|||
|
|
|
|||
|
|
**解決方法**:
|
|||
|
|
1. `lib/secrets.local.dart` が存在するか確認
|
|||
|
|
2. ファイル内の `geminiApiKey` が空文字列でないか確認
|
|||
|
|
3. アプリを再起動
|
|||
|
|
|
|||
|
|
### エラー: `AI解析エラー(Direct): API key not valid`
|
|||
|
|
|
|||
|
|
**原因**: APIキーが無効です
|
|||
|
|
|
|||
|
|
**解決方法**:
|
|||
|
|
1. [Google AI Studio](https://aistudio.google.com/apikey) で新しいキーを発行
|
|||
|
|
2. `lib/secrets.local.dart` を更新
|
|||
|
|
3. アプリを再起動
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📚 参考資料
|
|||
|
|
|
|||
|
|
- [Gemini API ドキュメント](https://ai.google.dev/docs)
|
|||
|
|
- [Flutter環境変数の使い方](https://docs.flutter.dev/deployment/flavors)
|
|||
|
|
- [プロジェクトのアーキテクチャ設計書](docs/ARCHITECTURE_DECISION_RECORD.md)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**更新履歴**:
|
|||
|
|
- 2026-01-21: 初版作成（Claude Code実装後のセキュリティ対策）
|