# RDSのIAM認証と接続プールの期限設計

> RDSのIAM認証トークンの有効期間は15分ですが、確立済みセッションには影響しません。接続プールでは新規接続のたびに再発行する設計が要点です。

- Canonical: https://kuucorp.com/blog/rds-iam-agent-connection-pool-token-expiry/
- Date: 2026-11-14
- Last modified: 2026-11-14
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
## IAM認証トークンの期限は何に効くのか

> RDSのIAM認証トークンの有効期間は15分で、効くのは接続を開く瞬間の認証だけです。確立済みのセッションは切れません。

長時間動くAIツールがRDSへIAM認証で接続すると、「15分でトークンが切れて接続が落ちる」と心配されがちです。AWSのドキュメントによると、トークンは認証にだけ使われ、確立後のセッションには影響しません。期限切れのトークンで新規接続を要求したときに、その要求が拒否されます。つまり設計の焦点は「既存接続の維持」ではなく「新規接続のたびに有効なトークンを使うこと」です。

## 接続プールで何が壊れるのか

> 壊れるのはプールの補充時です。起動時に1度だけ取得したトークンを使い回すと、15分後の新規接続が失敗します。

典型的な失敗は、アプリ起動時にトークンを1回発行して接続文字列へ埋め込む実装です。最初の接続は成功しますが、プールが接続を破棄して再作成する段階で、古いトークンが使われます。AWSのトラブルシューティングでは、トークン発行後15分を超えた再利用が `ExpiredToken` エラーの原因とされ、キャッシュと再利用のロジックを見直すよう案内されています。

対策は次の3点です。

1. 物理接続を作るたびにトークンを生成する（パスワード固定ではなくコールバックで供給する）
2. プールの接続最大寿命を、トークンのキャッシュ期間より前に収める
3. 認証失敗時は新しいトークンで1回だけ再試行する

## ドライバとプールのどこで再発行するのか

> AWS JDBC Driverのプラグインは、トークンを既定で14分30秒キャッシュし、認証失敗時に新規発行で1回再試行します。

AWS JDBC DriverのIAM認証プラグインは、有効なキャッシュがなければ新しいトークンを生成します。キャッシュ期間は `iamExpiration` で変更でき、既定は14分30秒です。キャッシュ済みトークンでログインに失敗した場合は、新規発行したトークンで1回再試行します。ドライバがこの機能を持たない言語やプールでは、接続を作る直前にSDKの `generate-db-auth-token` 相当を呼ぶ処理を自前で差し込みます。

注意点が3つあります。

- トークンは約1KB以上になり得るため、ドライバやツールが途中で切り詰めると認証に失敗する
- 一時的な認証情報で発行した場合、接続要求の時点でその認証情報も有効でなければならない
- トークン生成にはカスタムのRoute 53レコードではなく、DBインスタンスのエンドポイントを使う

## 再接続の集中と負荷はどう抑えるのか

> 短時間に新規接続を作りすぎるとIAM認証はスロットリングされます。AWSはRDS Proxyによる接続の再利用を案内しています。

プールの全接続が同時に寿命を迎えると、再接続が一斉に走ります。AWSは短時間に多数の新規接続を要求すると `ThrottlingException` になるとして、RDS Proxyで確立済みの接続を再利用することを推奨しています。接続寿命には揺らぎを持たせ、再接続を分散させてください。

運用では、CloudWatchの `IamDbAuthConnectionFailureInvalidToken` と `IamDbAuthConnectionFailureThrottling` を監視します。これで期限切れ型とスロットリング型を切り分けられます。なお、CloudTrailはIAM認証を記録しないため、DB側のエラーログをCloudWatch Logsへ出力する設定も有効です。IAM認証にはDBインスタンス側で300〜1000 MiBの追加メモリが必要とされるため、小さなインスタンスでは事前に確認してください。

資格情報全般の保管とローテーションは[エージェントのシークレット管理](/blog/agent-secret-management-rotation/)で扱っています。基盤設計から運用の定着までは、Kuu株式会社の[AI Ops](https://kuucorp.com/services/ai-ops/)で伴走しています。

## 参考

- [IAM database authentication for MariaDB, MySQL, and PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- [Connecting to your DB instance using IAM authentication](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.Connecting.html)
- [Troubleshooting for IAM DB authentication](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.Troubleshooting.html)
- [AWS IAM Authentication Plugin（AWS JDBC Driver）](https://github.com/aws/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md)

## まとめ

RDSのIAM認証トークンは15分で期限が切れますが、効くのは新規接続の認証だけで、確立済みセッションの寿命とは別の問題です。接続プールでは、物理接続を作るたびにトークンを発行し、接続寿命を揺らして再接続の集中を避けます。期限切れとスロットリングは別々の指標で監視してください。自社のAIツール基盤に合わせた接続設計は、Kuu株式会社にご相談ください。
