約 3 分で読めます

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

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の追加メモリが必要とされるため、小さなインスタンスでは事前に確認してください。

資格情報全般の保管とローテーションはエージェントのシークレット管理で扱っています。基盤設計から運用の定着までは、Kuu株式会社のAI Opsで伴走しています。

参考

まとめ

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

関連記事

Claude on Google Cloud 2方式の選定設計:統制と機能差GPU推論キャパシティ調達戦略——予約とスポットの使い分けAIエージェント基盤のオートスケーリング設計RAGエージェント向けベクトルDB選定——pgvector・Weaviate・Qdrant・Pineconeの使い分け