テーマ別の解説テーマ:AWSのDB:設計・比較・接続調査
RDSに接続できない:接続元・エンドポイント・TLS・認証の確認順
RDSの接続障害は、同じ接続元から同じ接続先への1回の試行を、到達した段階ごとに調べます。 DBエンジンとエンドポイントを確定し、DNS・通信経路・TLS・DB認証・操作権限を分けましょう。availableという状態だけでは、アプリの接続成功は分かりません。
DBエンジンに合う接続条件を選び、観測した段階から次に調べる対象を絞れる。
RDSの管理範囲と、接続元・接続先の違いを知っている方向けです。本文の観測は架空です。実DBへ試行したり、接続文字列や認証情報を入力する機能はありません。
まず、どの接続の失敗かを固定する
| 確認すること | 区別したいこと |
|---|---|
| DBエンジンと構成 | SQL Server/MySQL/PostgreSQL、Auroraならwriter/reader等の役割 |
| 接続元と時刻 | アプリ、VPC内の端末、社内PCなど。別の場所で成功しても同じ条件ではない |
| endpointと設定されたport | DNS名、DBインスタンス/クラスター等の種類。以前のIPや別portへ向けていないか |
| クライアント条件 | ドライバー、DB名、認証方式、TLS/証明書検証の設定 |
| 実際の観測 | DNS/TCP/TLS/ログイン/SQL操作のどこまで確認できたか |
エンジンごとの接続条件を混ぜない
| 対象 | 確認する接続条件 | 取り違えやすいこと |
|---|---|---|
| RDS for SQL Server | 設定されたendpoint/port、SQL Server用クライアント、対応するSQL/Windows認証等 | AWSコンソールのIAM権限だけでDBへログインできるとは限らない |
| RDS for MySQL / PostgreSQL | 対応クライアント、DB名とユーザー、設定されたport、TLS方式 | 別エンジンのクライアント設定やDB名の扱いを流用しない |
| IAM DB認証を使う構成 | MariaDB/MySQL/PostgreSQLの対応条件、DB側の準備、トークンとTLS | すべてのRDSエンジンが同じトークン認証を使うわけではない |
| Auroraの通常クラスター | 書込みはwriter、読取りは目的に合うendpointとDB権限 | reader名だけを権限制御と扱わず、replicaなしの例外も考える |
以下の架空例ではPostgreSQLを5432、MySQLを3306、SQL Serverを1433と設定したことにします。実環境では、製品名から推測せずその接続先に設定されたportを確認します。DBの管理APIやWeb画面へ到達できることも、SQL接続の確認とは別です。
各段階で、分かったことと未確認を分ける
- 宛先と通信経路 → TLSとDB認証TCPだけではログイン未確認
- TLSとDB認証 → 必要なDB操作ログイン後も操作権限は別
- 宛先と通信経路
- 接続元、DNS、portと往復の経路。
- TLSとDB認証
- 暗号化・相手の検証とDBの本人確認。
- 必要なDB操作
- 選んだDBと主体でSQLを実行できるか。
| 観測 | 言えること | まだ言えないこと |
|---|---|---|
| DNS名を解決できた | その接続元・時点で名前からアドレスを得た | そのIPへ接続できる、意図したDBにログインできる |
| 同じ宛先portでTCPが開いた | その試行のTCP接続は成立 | TLSの検証、DB認証、SELECT/UPDATEの成功 |
| TLSの証明書検証が失敗 | 証明書・名前・信頼・クライアント条件を調べる材料 | パスワードが誤っている、DB権限が足りない |
| DB認証の拒否応答を得た | その相手から認証段階の応答を受けた | 指定したDBとユーザーが正しい、業務のSQLを実行できる |
| SELECTが成功した | そのDB主体に、その対象の読取りが成功 | 他DBやUPDATEまで許可されている |
例C1〜C3:観測から、調べる範囲を変える
3例は異なる接続元・エンジンの架空の観測です。例示のアドレスは実DBではありません。C1のDNS結果、C2のTLSエラー、C3の認証拒否を、1本の試行の結果として混ぜません。
| 例 | 接続条件と観測 | 次に調べること |
|---|---|---|
| C1:PostgreSQL | private DB、port5432。社内PCはVPN等の私設経路なし。DNSは10.8.1.20、TCPはtimeout | private宛の承認された経路、送信元、route、SG/NACL/端末FW等。DNSだけで到達済みにしない |
| C2:MySQL | VPC内アプリ、port3306。同じ宛先でTCP成立、TLSの名前検証失敗、ログイン未実施 | 使っているendpointと証明書の名前、CAの信頼、ドライバー/TLS設定。DBパスワードを先に変えない |
| C3:SQL Server | VPC内アプリ、port1433。TLS検証成立、DBから認証拒否。AWSコンソールの閲覧は可能 | DBの認証方式・ログイン/ユーザー・指定DBを確認。IAMでコンソールを見られることをDB認証の代わりにしない |
接続できたように見せる変更で終わらせない
| 避けたい対処 | 代わりに確認すること |
|---|---|
| 原因未確認でpublic化や全送信元の許可 | 必要な接続元と承認された経路、対象portへの必要最小限の制御 |
| 証明書検証を外して解決済みにする | 正しいendpoint、CA、証明書名、クライアント/エンジンのTLS条件 |
| すべてのDB権限を与える | 必要なDB・主体・対象操作を絞り、認証と認可を分ける |
| IPを固定して切替後も使い続ける | endpointのDNSとキャッシュ、接続プール/再接続の動作を確認 |
private DBへは、許可されたVPC内の接続元や、設計されたVPNなどの私設経路から接続する構成もあります。インターネットから直接到達させることを、RDS利用の共通前提にしません。経路を追加・変更する際は、その環境の管理者と必要な範囲を決めます。
エンジンと症状が分かったら、固有の調査へ進む
- エンジン・構成・接続元・時刻・endpoint種別・設定portをそろえる。
- 同じ試行でDNS/TCP/TLS/認証/操作のどこまで到達したかを記録する。
- その段階に対応する設定とエンジンの公式資料を確認する。
- 必要な範囲だけ修正し、同じ条件で接続と業務操作を再確認する。
- SQL ServerならSSMS/TLSとログイン/ユーザーの専用教材へ進む。Auroraならwriter/readerの役割も確認する。
観測と次の調査を対応させる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 接続元・エンジン・宛先・時刻を固定する。
- 観測した段階と未確認を分ける。
- C1/C2/C3それぞれの次の調査を説明する。
- 必要な修正後、同じ条件で業務結果まで確認する。
理解を確かめる: TLSエラーが消えた。これでアプリのDB接続・操作は全部正常?
まだです。同じ接続元・宛先でTLS検証が成功した事実と、DB認証・指定DBへの操作・期待する業務結果を別に確認します。
前の段階の改善は、後の段階の成功を証明しないためです。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件接続元/endpoint/port/経路/アクセス制御を対応。一般的なpublic化案を一律の対処としない。
参照した本文まず、どの接続の失敗かを固定する エンジンごとの接続条件を混ぜない 各段階で、分かったことと未確認を分ける エンジンと症状が分かったら、固有の調査へ進む
確認した内容・条件availableと接続元からの到達性、endpointとportを別に確認。必ずpublicにする必要はない。
参照した本文まず、どの接続の失敗かを固定する エンジンごとの接続条件を混ぜない エンジンと症状が分かったら、固有の調査へ進む
確認した内容・条件MySQLクライアント、endpoint/設定port、DB認証とIAM認証の条件。
参照した本文まず、どの接続の失敗かを固定する エンジンごとの接続条件を混ぜない エンジンと症状が分かったら、固有の調査へ進む
確認した内容・条件PostgreSQL用クライアントとDB名・endpoint/設定port。外部アクセスの簡略説明をVPN等へ一般化しない。
参照した本文まず、どの接続の失敗かを固定する エンジンごとの接続条件を混ぜない エンジンと症状が分かったら、固有の調査へ進む
確認した内容・条件対応はMariaDB/MySQL/PostgreSQLの条件付き。SQL Serverへトークン方式を流用しない。
参照した本文エンジンごとの接続条件を混ぜない
確認した内容・条件接続単位の分散。replicaがない場合はprimaryへ接続し書込みも可能なので、権限制御の代用にしない。
参照した本文エンジンごとの接続条件を混ぜない
確認した内容・条件通常クラスターの現primary接続、書込みと読取り、障害切替後の再接続/DNS。
確認した内容・条件暗号化とサーバー証明書の同一性検証を区別。CA・版・各ドライバーの条件を確認。
確認した内容・条件接続元からの経路とVPC制御。障害切替で変わるIPを固定接続先にしない。
参照した本文接続できたように見せる変更で終わらせない
確認した内容・条件公開/非公開の経路と制御。privateへ承認された私設経路があるケースを含め、publicを必須にしない。
参照した本文接続できたように見せる変更で終わらせない