> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証

> AI Helpdesk API へのアクセスには API キーによる認証が必要です。リクエストには `X-API-Key` ヘッダーで API キーを指定します。

## API キーの取得

1. [Admina 管理画面](https://assist.i.moneyforward.com/)にログインします
2. 右上のユーザー設定メニューから **設定** を選択します
3. 左側のナビゲーションメニューで **API キー** を選択します
4. **新しい API キーを作成** ボタンをクリックします
5. API キーの名前を入力し、有効期限を設定する場合は期限日を入力します
6. **作成** ボタンをクリックして API キーを生成します
7. 表示された API キーを安全な場所にコピーして保存します

発行された API キーは `mb_live_` プレフィックスを含む 47 文字程度の文字列です（例: `mb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）。

<Info>
  API キーは一度しか表示されません。必ず安全な場所に保存してください。
</Info>

## リクエストへの認証情報の追加

すべての API リクエストには、`X-API-Key` ヘッダーに API キーを含めます。

### ヘッダー形式

```text theme={null}
X-API-Key: YOUR_API_KEY
```

### cURL での使用例

```bash theme={null}
curl -H "X-API-Key: YOUR_API_KEY" \
  https://assist.i.moneyforward.com/api/v1/sessions
```

### JavaScript での使用例

```javascript theme={null}
const response = await fetch('https://assist.i.moneyforward.com/api/v1/sessions', {
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});
```

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

* API キーをソースコードやクライアント側のコードに埋め込まないでください
* 環境変数やシークレット管理システムを使用して API キーを管理してください
* 不要になった API キーは削除してください
* 定期的に API キーをローテーションすることを検討してください
* 意外な場所からの API アクセスを監視してください

## 認証エラー

`X-API-Key` ヘッダーが欠落しているか無効な場合、HTTP 401 とともに以下の形式のレスポンスが返されます。

```json theme={null}
{
  "ok": false,
  "error": "Missing or invalid API key"
}
```

エラーが発生したら、`X-API-Key` ヘッダーの値と API キーの有効期限を確認してください。