EICEとは

EC2 Instance Connect Endpoint は、2023年6月に提供が始まったVPC内のエンドポイントだ。ローカルPCからAWSのAPI(IAMで認証)を通してエンドポイントに接続し、そこからVPC内のEC2のプライベートIPへ TCPで中継する。

  • EC2にパブリックIPも、SSM Agentも不要
  • NAT Gateway や VPCエンドポイント(SSM用)も不要
  • エンドポイント自体の追加料金はなし(別AZのEC2へ接続する場合はAZ間データ転送料がかかる)

名前が似ている「EC2 Instance Connect」(一時的なSSH公開鍵をEC2に送り込む仕組み)とは別物だ。EICEは「ネットワークの経路」を提供するもので、SSHの認証自体は通常どおりキーペアなどで行う。

知っておくべき制約

項目制約
転送先のポート22(SSH)と 3389(RDP)のみ。それ以外を指定すると The specified RemotePort is not valid. Specify either 22 or 3389 as the RemotePort というエラーになる
1回の接続時間最大1時間(3,600秒)。IAMポリシーでさらに短くできる
同時接続数1エンドポイントあたり20
エンドポイント数1VPCに1つ、1サブネットに1つ、1リージョンあたり5つ(いずれも引き上げ不可)
用途管理用の通信向け。大量のデータ転送はスロットリングされる

⚠️ 「EICEでRDSに直接つなぐ」記事に注意

提供開始直後は RDS のポートへも直接トンネルを張れたため、その手順を紹介する記事が残っている。現在は上のエラーで拒否されるので、RDSへは後述の方法で接続する。

エンドポイントの作成

マネジメントコンソールでは「VPC > エンドポイント > エンドポイントを作成」で、タイプに「EC2 Instance Connect Endpoint」を選び、VPC・サブネット・セキュリティグループを指定する。作成完了(状態が Available になる)まで数分かかる。

AWS CLI で作成
aws ec2 create-instance-connect-endpoint \
  --subnet-id subnet-0123456789abcdef0 \
  --security-group-ids sg-0eice0000000000000

# 状態の確認(create-complete になれば利用可能)
aws ec2 describe-instance-connect-endpoints \
  --query "InstanceConnectEndpoints[].[InstanceConnectEndpointId,State,SubnetId]" --output table

1VPCに1つしか作れないので、VPC内のどのサブネットのEC2にも経路が届くサブネット(通常はプライベートサブネットのどれか)に置く。

セキュリティグループの設計

EICE用とEC2用でセキュリティグループを分け、セキュリティグループ同士を参照させるのが分かりやすい。

セキュリティグループルール
EICE用(sg-eice)インバウンド:なし/アウトバウンド:TCP 22(と必要なら 3389)→ 宛先 sg-ec2
EC2用(sg-ec2)インバウンド:TCP 22(と必要なら 3389)← ソース sg-eice

これで、インターネットからも、VPC内の他のホストからもSSHできず、EICE経由だけが通る状態になる。なお「クライアントIPの保持」を有効にした場合は、EC2側に届く送信元がクライアントのIPになるため、ルールの書き方が変わる点に注意する。

IAMポリシー

トンネルを張る操作は ec2-instance-connect:OpenTunnel で制御する。条件キーでポート・接続先IP・最大接続時間を絞れる。

IAMポリシーの例(JSON)
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "OpenTunnelSshOnly",
      "Effect": "Allow",
      "Action": "ec2-instance-connect:OpenTunnel",
      "Resource": "arn:aws:ec2:ap-northeast-1:123456789012:instance-connect-endpoint/eice-0123456789abcdef0",
      "Condition": {
        "NumericEquals": { "ec2-instance-connect:remotePort": "22" },
        "IpAddress": { "ec2-instance-connect:privateIpAddress": "10.0.10.0/24" },
        "NumericLessThanEquals": { "ec2-instance-connect:maxTunnelDuration": "3600" }
      }
    },
    {
      "Sid": "DescribeForCli",
      "Effect": "Allow",
      "Action": ["ec2:DescribeInstances", "ec2:DescribeInstanceConnectEndpoints"],
      "Resource": "*"
    }
  ]
}

open-tunnel でSSH・RDPに接続

SSH(ProxyCommand で1回ずつ張る)

最も手軽なのは、SSHの ProxyCommand に open-tunnel を指定する方法だ。SSHのたびにトンネルが張られ、終了すると閉じる。

bash / PowerShell 共通
ssh -i my-key.pem ec2-user@i-0123456789abcdef0 -o ProxyCommand="aws ec2-instance-connect open-tunnel --instance-id i-0123456789abcdef0"

AWS CLI v2 には、これを1コマンドにまとめた aws ec2-instance-connect ssh もある。

さらに簡単な書き方
aws ec2-instance-connect ssh --instance-id i-0123456789abcdef0 --connection-type eice --private-key-file my-key.pem

ローカルポートで待ち受ける(ポートフォワード)

--local-port を付けると、ローカルのポートで待ち受けるトンネルになる。WinSCP や RDP クライアントなど、ProxyCommand を使えないアプリから接続するときはこちらを使う。

SSHをlocalhost:2222で待ち受け
aws ec2-instance-connect open-tunnel --instance-id i-0123456789abcdef0 --remote-port 22 --local-port 2222

# 別のターミナルから
ssh -i my-key.pem -p 2222 ec2-user@localhost
Windows Server へ RDP(localhost:13389)
aws ec2-instance-connect open-tunnel --instance-id i-0123456789abcdef0 --remote-port 3389 --local-port 13389

# リモートデスクトップ接続(mstsc)で localhost:13389 に接続

RDSへ接続したい場合

EICEの転送先は22番に限られるが、EICE経由のSSHの中で -L によるポートフォワードを行うことで、RDSへも到達できる。経路は「ローカル → EICE → EC2(SSH)→ RDS」になる。

RDS for PostgreSQL を localhost:15432 に転送
ssh -i my-key.pem -N \
  -L 15432:mydb.xxxxxxxxxxxx.ap-northeast-1.rds.amazonaws.com:5432 \
  -o ProxyCommand="aws ec2-instance-connect open-tunnel --instance-id %h" \
  ec2-user@i-0123456789abcdef0

%h はSSHの接続先ホスト名(ここではインスタンスID)に置き換わる。この方法でもトンネルは最大1時間で切れるため、長時間の作業には向かない。RDSへの接続が主目的なら、SSM(PART 02)のほうが素直だ。

SSMとの使い分け

状況おすすめ
SSM Agent を入れられないOS・アプライアンス(サードパーティのAMIなど)にSSHしたいEICE
NAT Gateway もSSM用VPCエンドポイントもない検証用VPCで、とりあえずSSHしたいEICE
RDS・ElastiCache など任意のポートへ転送したいSSM
1時間を超えて接続し続けたいSSM
SSHキーの配布・管理をなくしたいSSM

✅ 次の記事では…

PART 04 では、従来のSSH踏み台によるポートフォワードと、22番を開けずに済む「SSH over SSM」を解説する。

→ PART 04 — SSH踏み台とSSH over SSMへ