仕組み
EC2上の SSM Agent は、起動するとSSMのエンドポイント(ssm / ssmmessages)へアウトバウンドで接続し、待機している。ローカルで aws ssm start-session を実行すると、SSMのサービスがこの既存の通信路の中にデータチャネルを作り、ローカルPC上の Session Manager プラグインとEC2上のエージェントの間がつながる。
つまり、EC2のセキュリティグループのインバウンドルールは空のままでよい。外部から見えるポートがないため、SSH踏み台よりも攻撃面が小さくなる。
ポートフォワード用に、AWSが用意しているSSMドキュメントは次の2つだ。
| SSMドキュメント | 転送先 | SSM Agentのバージョン |
|---|---|---|
AWS-StartPortForwardingSession | EC2自身のポート | 2.3.672.0 以降 |
AWS-StartPortForwardingSessionToRemoteHost | EC2から到達できる別ホスト(RDSなど) | 3.1.1374.0 以降 |
前提条件(AWS側)
1. SSM Agent
Amazon Linux 2023 / Amazon Linux 2 や、AWS提供のWindows Server AMIには SSM Agent がプリインストールされている。古いAMIから作ったEC2はバージョンが古いことがあるので、リモートホスト転送を使う場合は特に確認しておく。
$ sudo systemctl status amazon-ssm-agent
$ rpm -q amazon-ssm-agent2. EC2のIAMロール(インスタンスプロファイル)
EC2に、AWS管理ポリシー AmazonSSMManagedInstanceCore を付けたIAMロールを割り当てる。これがないとエージェントがSSMに登録されず、マネージドノードとして認識されない。
3. SSMエンドポイントへの経路
プライベートサブネットのEC2がSSMに接続するには、次のどちらかが必要だ。
- NAT Gateway 経由でインターネット上のSSMエンドポイントへ出る
- インターフェイス型VPCエンドポイント を作る:
com.amazonaws.<region>.ssmとcom.amazonaws.<region>.ssmmessages(エージェントのバージョンや用途によってはec2messagesも)
⚠️ VPCエンドポイントのセキュリティグループ
インターフェイス型VPCエンドポイントには、EC2からの HTTPS(443)のインバウンド を許可するセキュリティグループを付ける。また、VPCの「DNSホスト名」「DNS解決」を有効にし、エンドポイントの「プライベートDNS名」を有効にしておく。これらが抜けていると、エージェントが接続できず TargetNotConnected になる。
4. 転送先(RDS)のセキュリティグループ
RDSへ転送する場合、RDSのセキュリティグループで 中継EC2のセキュリティグループからのDBポート(例: 5432) を許可する。EC2側のアウトバウンドがデフォルト(全許可)でなければ、そちらも確認する。
登録の確認
ここまで設定したら、EC2がマネージドノードとして登録されているかを確認する。PingStatus が Online になっていればよい。
aws ssm describe-instance-information --query "InstanceInformationList[].[InstanceId,PingStatus,AgentVersion]" --output table前提条件(ローカル側)
ローカルPCには AWS CLI v2 と Session Manager プラグイン の2つが必要だ。プラグインはAWS CLIとは別配布なので、入れ忘れが多い。
AWS CLI v2 とプロファイルの準備
まず AWS CLI v2 をインストールする。公式のインストーラーを使うのが確実だ。
| OS | AWS CLI v2 のインストール |
|---|---|
| Windows | msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi(または同じURLのインストーラーをダウンロードして実行) |
| macOS | 公式の AWSCLIV2.pkg をダウンロードして実行 |
| Linux | 公式の zip(awscli-exe-linux-x86_64.zip など)を展開し、sudo ./aws/install |
インストールしたら、ターミナルを開き直して aws --version で aws-cli/2.x.x と表示されることを確認する。
次に、接続に使うプロファイルを作る。プロファイルは「どのアカウントに、どの権限で接続するか」をまとめた設定で、この記事のコマンドでは --profile dev のように指定している。組織で IAM Identity Center(旧 AWS SSO)を使っているなら、アクセスキーを手元に置かずに済む A の方法を選ぶ。
A. IAM Identity Center(SSO)を使う場合
aws configure sso
SSO session name (Recommended): my-sso
SSO start URL [None]: https://d-xxxxxxxxxx.awsapps.com/start
SSO region [None]: ap-northeast-1
SSO registration scopes [sso:account:access]:
(ブラウザが開くので、サインインしてアクセスを許可する)
(使うアカウントとロール=許可セットを選ぶ)
Default client Region [None]: ap-northeast-1
CLI default output format [None]: json
Profile name [...]: dev設定は ~/.aws/config(Windows は %USERPROFILE%\.aws\config)に保存される。ログインには有効期限があるので、期限が切れたら次のコマンドでログインし直す。
aws sso login --profile devB. IAM ユーザーのアクセスキーを使う場合
aws configure --profile dev
AWS Access Key ID [None]: AKIA****************
AWS Secret Access Key [None]: ****************************************
Default region name [None]: ap-northeast-1
Default output format [None]: jsonどちらの方法でも、最後に「誰として、どのアカウントに」接続しているかを確認しておく。Account と Arn が想定どおりなら準備完了だ。
aws sts get-caller-identity --profile dev
{
"UserId": "AROAXXXXXXXXXXXXXXXXX:taro@example.com",
"Account": "123456789012",
"Arn": "arn:aws:sts::123456789012:assumed-role/AWSReservedSSO_PortForwardUser_0123456789abcdef/taro@example.com"
}💡 毎回 --profile を付けたくない場合
環境変数 AWS_PROFILE にプロファイル名を入れておくと、--profile を省略できる。PowerShell なら $env:AWS_PROFILE = "dev"、bash なら export AWS_PROFILE=dev。ただし、環境変数 AWS_ACCESS_KEY_ID が残っているとそちらが優先されることがある。同じプロファイルを Python(boto3)から使う場合の注意点は boto3 PART 02 で解説している。
Session Manager プラグイン
| OS | Session Manager プラグインのインストール |
|---|---|
| Windows | 公式のインストーラー SessionManagerPluginSetup.exe をダウンロードして実行 |
| macOS | 公式のバンドル版インストーラー、または Homebrew(brew install --cask session-manager-plugin) |
| Linux | 公式の rpm / deb パッケージ |
インストール後、ターミナルを開き直してから確認コマンドを実行する。次のメッセージが出れば成功だ。
> session-manager-plugin
The Session Manager plugin was installed successfully. Use the AWS CLI to start a session.接続するユーザーのIAMポリシー
ポートフォワードを実行するIAMユーザー(またはIAM Identity Centerの許可セット)には、ssm:StartSession が必要だ。使うSSMドキュメントと接続先EC2を絞るのがポイントで、こうしておくと「このメンバーはDB用の中継EC2へのポートフォワードだけ許可し、シェルには入らせない」といった制御ができる。
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "StartPortForwardingOnly",
"Effect": "Allow",
"Action": "ssm:StartSession",
"Resource": [
"arn:aws:ec2:ap-northeast-1:123456789012:instance/i-0123456789abcdef0",
"arn:aws:ssm:ap-northeast-1::document/AWS-StartPortForwardingSession",
"arn:aws:ssm:ap-northeast-1::document/AWS-StartPortForwardingSessionToRemoteHost"
]
},
{
"Sid": "ManageOwnSessions",
"Effect": "Allow",
"Action": ["ssm:TerminateSession", "ssm:ResumeSession"],
"Resource": "arn:aws:ssm:*:*:session/${aws:userid}-*"
}
]
}💡 インスタンスIDではなくタグで絞る
中継EC2を作り直すたびにポリシーを書き換えたくない場合は、"Resource": "arn:aws:ec2:*:*:instance/*" とし、Condition に "StringEquals": {"ssm:resourceTag/Role": "db-bastion"} のようなタグ条件を付ける。
パターンA:EC2自身のポートへ転送
EC2上で動いているWebアプリ(8080番)を、ローカルの localhost:18080 で開く例。使うドキュメントは AWS-StartPortForwardingSession だ。
aws ssm start-session \
--target i-0123456789abcdef0 \
--document-name AWS-StartPortForwardingSession \
--parameters '{"portNumber":["8080"],"localPortNumber":["18080"]}'aws ssm start-session `
--target i-0123456789abcdef0 `
--document-name AWS-StartPortForwardingSession `
--parameters "portNumber=8080,localPortNumber=18080"⚠️ PowerShell で JSON を渡すとエラーになりやすい
bash 向けの '{"portNumber":["8080"]}' をそのまま PowerShell に貼ると、ダブルクォートの扱いの違いで Error parsing parameter '--parameters' になりがちだ。PowerShell では上のように キー=値,キー=値 の短縮構文を使うと確実。行の継続はバッククォート(`)、コマンドプロンプトでは ^ を使う。
パターンB:EC2経由でRDSへ転送
実務で一番使うのがこちら。中継EC2を経由して、RDS for PostgreSQL(5432番)をローカルの localhost:15432 に転送する。使うドキュメントは AWS-StartPortForwardingSessionToRemoteHost で、host パラメーターに転送先を指定する。
aws ssm start-session \
--target i-0123456789abcdef0 \
--document-name AWS-StartPortForwardingSessionToRemoteHost \
--parameters '{"host":["mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com"],"portNumber":["5432"],"localPortNumber":["15432"]}'aws ssm start-session `
--target i-0123456789abcdef0 `
--document-name AWS-StartPortForwardingSessionToRemoteHost `
--parameters "host=mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com,portNumber=5432,localPortNumber=15432"host の名前解決は中継EC2側で行われる。そのため、RDSのエンドポイント名(プライベートIPに解決される名前)をそのまま書けばよい。Aurora なら、書き込み用にはクラスターエンドポイント、参照用にはリーダーエンドポイントを指定する。
ElastiCache(6379)や VPC内の OpenSearch(443)も、host と portNumber を変えるだけで同じように転送できる。
接続確認
コマンドが成功すると、次のように表示されて待ち受け状態になる。このターミナルは閉じずにそのままにしておく。
Starting session with SessionId: dev-user-0a1b2c3d4e5f67890
Port 15432 opened for sessionId dev-user-0a1b2c3d4e5f67890.
Waiting for connections...別のターミナルやDBクライアントから localhost:15432 に接続する。接続が来ると、待ち受け側に Connection accepted for session [...] と表示される。
psql -h localhost -p 15432 -U postgres -d appdbDBeaver や A5:SQL Mk-2 などのGUIクライアントでは、ホストに localhost、ポートに 15432 を指定するだけだ。クライアント側で「SSHトンネル」の設定は不要。終了するときは、待ち受け中のターミナルで Ctrl + C を押す。
💡 SSL接続とホスト名の検証
RDSにSSLで接続し、証明書のホスト名検証(PostgreSQL の sslmode=verify-full など)を有効にしていると、接続先が localhost のため検証に失敗する。開発用途なら sslmode=require(暗号化のみ)にするか、hosts ファイルでRDSのエンドポイント名を 127.0.0.1 に向けて、その名前で接続する。
接続スクリプトにまとめる
毎回インスタンスIDとRDSのエンドポイントを調べるのは面倒なので、タグからインスタンスIDを引いて接続するスクリプトにしておくと便利だ。以下は PowerShell の例(中継EC2に Name=db-bastion のタグを付けている前提)。
param(
[string]$Profile = "dev",
[string]$DbHost = "mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com",
[int] $RemotePort = 5432,
[int] $LocalPort = 15432
)
# タグ Name=db-bastion で起動中のインスタンスIDを取得
$instanceId = aws ec2 describe-instances `
--profile $Profile `
--filters "Name=tag:Name,Values=db-bastion" "Name=instance-state-name,Values=running" `
--query "Reservations[0].Instances[0].InstanceId" --output text
if (-not $instanceId -or $instanceId -eq "None") {
Write-Error "中継EC2が見つからないか、停止しています。"
exit 1
}
Write-Host "Forwarding localhost:$LocalPort -> ${DbHost}:$RemotePort via $instanceId"
aws ssm start-session --profile $Profile `
--target $instanceId `
--document-name AWS-StartPortForwardingSessionToRemoteHost `
--parameters "host=$DbHost,portNumber=$RemotePort,localPortNumber=$LocalPort"注意点
- 中継EC2は小さくてよい:トンネルの中継だけなら、t4g.nano / t3.nano クラスで足りる。使わない時間は停止しておけばコストも抑えられる
- ECSタスクも中継役にできる:ECS Exec を有効にしたタスクを
--target ecs:<クラスター名>_<タスクID>_<コンテナのランタイムID>と指定すれば、EC2を置かずに転送できる - セッションの内容はログに残らない:Session Manager はポートフォワードとSSHのセッションの中身を記録しない。「誰がいつ接続したか」は CloudTrail の
StartSessionイベントで追う(PART 05 参照) - 大量データの転送には向かない:数GB単位のダンプ取得などは、EC2上で実行してS3経由で受け渡すほうが速く安定する
✅ 次の記事では…
PART 03 では、SSM Agent を入れられないEC2にも使える EC2 Instance Connect Endpoint を解説する。