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 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 table1VPCに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・最大接続時間を絞れる。
{
"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のたびにトンネルが張られ、終了すると閉じる。
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 を使えないアプリから接続するときはこちらを使う。
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@localhostaws 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」になる。
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」を解説する。