IAM認証トークンの期限は何に効くのか
RDSのIAM認証トークンの有効期間は15分で、効くのは接続を開く瞬間の認証だけです。確立済みのセッションは切れません。
長時間動くAIツールがRDSへIAM認証で接続すると、「15分でトークンが切れて接続が落ちる」と心配されがちです。AWSのドキュメントによると、トークンは認証にだけ使われ、確立後のセッションには影響しません。期限切れのトークンで新規接続を要求したときに、その要求が拒否されます。つまり設計の焦点は「既存接続の維持」ではなく「新規接続のたびに有効なトークンを使うこと」です。
接続プールで何が壊れるのか
壊れるのはプールの補充時です。起動時に1度だけ取得したトークンを使い回すと、15分後の新規接続が失敗します。
典型的な失敗は、アプリ起動時にトークンを1回発行して接続文字列へ埋め込む実装です。最初の接続は成功しますが、プールが接続を破棄して再作成する段階で、古いトークンが使われます。AWSのトラブルシューティングでは、トークン発行後15分を超えた再利用が ExpiredToken エラーの原因とされ、キャッシュと再利用のロジックを見直すよう案内されています。
対策は次の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の追加メモリが必要とされるため、小さなインスタンスでは事前に確認してください。
資格情報全般の保管とローテーションはエージェントのシークレット管理で扱っています。基盤設計から運用の定着までは、Kuu株式会社のAI Opsで伴走しています。
参考
- IAM database authentication for MariaDB, MySQL, and PostgreSQL
- Connecting to your DB instance using IAM authentication
- Troubleshooting for IAM DB authentication
- AWS IAM Authentication Plugin(AWS JDBC Driver)
まとめ
RDSのIAM認証トークンは15分で期限が切れますが、効くのは新規接続の認証だけで、確立済みセッションの寿命とは別の問題です。接続プールでは、物理接続を作るたびにトークンを発行し、接続寿命を揺らして再接続の集中を避けます。期限切れとスロットリングは別々の指標で監視してください。自社のAIツール基盤に合わせた接続設計は、Kuu株式会社にご相談ください。
