仕組み

EC2上の SSM Agent は、起動するとSSMのエンドポイント(ssm / ssmmessages)へアウトバウンドで接続し、待機している。ローカルで aws ssm start-session を実行すると、SSMのサービスがこの既存の通信路の中にデータチャネルを作り、ローカルPC上の Session Manager プラグインとEC2上のエージェントの間がつながる。

つまり、EC2のセキュリティグループのインバウンドルールは空のままでよい。外部から見えるポートがないため、SSH踏み台よりも攻撃面が小さくなる。

ポートフォワード用に、AWSが用意しているSSMドキュメントは次の2つだ。

SSMドキュメント転送先SSM Agentのバージョン
AWS-StartPortForwardingSessionEC2自身のポート2.3.672.0 以降
AWS-StartPortForwardingSessionToRemoteHostEC2から到達できる別ホスト(RDSなど)3.1.1374.0 以降

前提条件(AWS側)

1. SSM Agent

Amazon Linux 2023 / Amazon Linux 2 や、AWS提供のWindows Server AMIには SSM Agent がプリインストールされている。古いAMIから作ったEC2はバージョンが古いことがあるので、リモートホスト転送を使う場合は特に確認しておく。

EC2上でバージョン確認(Amazon Linux)
$ sudo systemctl status amazon-ssm-agent
$ rpm -q amazon-ssm-agent

2. 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 になっていればよい。

PowerShell / bash 共通
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 をインストールする。公式のインストーラーを使うのが確実だ。

OSAWS CLI v2 のインストール
Windowsmsiexec.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)を使う場合

PowerShell / bash 共通
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)に保存される。ログインには有効期限があるので、期限が切れたら次のコマンドでログインし直す。

PowerShell / bash 共通
aws sso login --profile dev

B. IAM ユーザーのアクセスキーを使う場合

PowerShell / bash 共通
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 が想定どおりなら準備完了だ。

PowerShell / bash 共通
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 プラグイン

OSSession 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へのポートフォワードだけ許可し、シェルには入らせない」といった制御ができる。

IAMポリシーの例(JSON)
{
  "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 だ。

macOS / Linux(bash)
aws ssm start-session \
  --target i-0123456789abcdef0 \
  --document-name AWS-StartPortForwardingSession \
  --parameters '{"portNumber":["8080"],"localPortNumber":["18080"]}'
Windows(PowerShell)
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 パラメーターに転送先を指定する。

macOS / Linux(bash)
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"]}'
Windows(PowerShell)
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 で接続
psql -h localhost -p 15432 -U postgres -d appdb

DBeaver や 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 のタグを付けている前提)。

connect-db.ps1
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 を解説する。

→ PART 03 — EC2 Instance Connect Endpointでポートフォワードへ