
Amazon CloudFront の Origin mTLS が WebSocket と gRPC に対応したので ALB オリジンで試してみた
はじめに
2026-11-18 に、Amazon CloudFront の Origin mTLS が WebSocket と gRPC のトラフィックに対応しました。
Origin mTLS は、CloudFront がオリジンへクライアント証明書を提示し、オリジンがそれを検証する機能です。この記事では ALB をオリジンにして、HTTP、WebSocket、gRPC(unary と双方向ストリーミング)を1つのクライアント証明書で通せるかを試しました。
構成と設定
全体構成
リクエストは、クライアント、CloudFront、ALB(HTTPS、mTLS verify)、EC2 の順に通ります。ALB のターゲットグループは、HTTP と WebSocket 用(ProtocolVersion が HTTP1)と、gRPC 用(ProtocolVersion が GRPC)の2つです。パス /echo.Echo/* のリクエストを gRPC 側へ振り分けました。
クライアント証明書
openssl で自前の CA を作り、EKU に TLS Client Authentication を持つ ECDSA P-256 のクライアント証明書を発行します。EKU は次の設定ファイルで指定し、client-ext.cnf として保存します。
basicConstraints = CA:FALSE
keyUsage = digitalSignature
extendedKeyUsage = clientAuth
次のコマンドで ca.key、ca.pem、client.key、client.pem を作り、クライアント証明書を us-east-1 の ACM へ import します。
openssl ecparam -name prime256v1 -genkey -noout -out ca.key
openssl req -x509 -new -key ca.key -sha256 -days 30 -subj '/CN=cf-origin-mtls-test-ca' \
-addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -out ca.pem
openssl ecparam -name prime256v1 -genkey -noout -out client.key
openssl req -new -key client.key -subj '/CN=cloudfront-origin-client' -out client.csr
openssl x509 -req -in client.csr -CA ca.pem -CAkey ca.key -CAcreateserial -days 30 -sha256 \
-extfile client-ext.cnf -out client.pem
aws acm import-certificate --region us-east-1 \
--certificate fileb://client.pem --private-key fileb://client.key --certificate-chain fileb://ca.pem
import で得られた証明書 ARN の末尾の ID が、後述のディストリビューション設定の ${CLIENT_CERT_ID} に入ります。
ALB の mTLS
CA 証明書を S3 に置いてトラストストアを作り、HTTPS リスナーに --mutual-authentication Mode=verify を付けます。リスナーには、ホスト名 origin.example.com に一致する ACM のパブリック証明書を使いました(オリジンのサーバー証明書は、公的に信頼された CA の発行である必要があります)。
aws s3api put-object --bucket "$BUCKET" --key ca-bundle.pem --body ca.pem
aws elbv2 create-trust-store --name mtls-verify-ts \
--ca-certificates-bundle-s3-bucket "$BUCKET" --ca-certificates-bundle-s3-key ca-bundle.pem
aws elbv2 create-listener --load-balancer-arn "$ALB_ARN" --protocol HTTPS --port 443 \
--certificates CertificateArn="$SERVER_CERT_ARN" --ssl-policy ELBSecurityPolicy-TLS13-1-2-2021-06 \
--mutual-authentication Mode=verify,TrustStoreArn="$TRUST_STORE_ARN" \
--default-actions Type=forward,TargetGroupArn="$TG_HTTP"
aws elbv2 create-rule --listener-arn "$LISTENER_ARN" --priority 10 \
--conditions Field=path-pattern,Values='/echo.Echo/*' --actions Type=forward,TargetGroupArn="$TG_GRPC"
ディストリビューション
ディストリビューションの主な設定は次のとおりです。
- オリジン: DomainName は ALB に付けたホスト名、OriginProtocolPolicy は https-only、OriginSslProtocols は TLSv1.2
- Origin mTLS: CustomOriginConfig の中の OriginMtlsConfig に、ACM のクライアント証明書の ARN を指定
- HttpVersion: http2
- デフォルトビヘイビア: POST などを含む7メソッドを許可、キャッシュポリシーは Managed-CachingDisabled、オリジンリクエストポリシーは Managed-AllViewerExceptHostHeader
/echo.Echo/*のビヘイビア: デフォルトビヘイビアと同じ設定で、GrpcConfig の Enabled を true にする
distribution-config.json
次の JSON を distribution-config.json として保存します。${ACCOUNT_ID} と ${CLIENT_CERT_ID} は自分の環境の値へ、DomainName の origin.example.com は ALB に付けたホスト名へ置き換えます。
{
"CallerReference": "mtls-verify-1119",
"Comment": "origin mTLS with WebSocket and gRPC",
"Enabled": true,
"HttpVersion": "http2",
"Origins": {
"Quantity": 1,
"Items": [
{
"Id": "alb-mtls",
"DomainName": "origin.example.com",
"CustomOriginConfig": {
"HTTPPort": 80,
"HTTPSPort": 443,
"OriginProtocolPolicy": "https-only",
"OriginSslProtocols": {
"Quantity": 1,
"Items": [
"TLSv1.2"
]
},
"OriginReadTimeout": 30,
"OriginKeepaliveTimeout": 5,
"OriginMtlsConfig": {
"ClientCertificateArn": "arn:aws:acm:us-east-1:${ACCOUNT_ID}:certificate/${CLIENT_CERT_ID}"
}
}
}
]
},
"DefaultCacheBehavior": {
"TargetOriginId": "alb-mtls",
"ViewerProtocolPolicy": "https-only",
"AllowedMethods": {
"Quantity": 7,
"Items": [
"GET",
"HEAD",
"OPTIONS",
"PUT",
"POST",
"PATCH",
"DELETE"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"GET",
"HEAD"
]
}
},
"CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
"OriginRequestPolicyId": "b689b0a8-53d0-40ab-baf2-68738e2966ac"
},
"CacheBehaviors": {
"Quantity": 1,
"Items": [
{
"PathPattern": "/echo.Echo/*",
"TargetOriginId": "alb-mtls",
"ViewerProtocolPolicy": "https-only",
"AllowedMethods": {
"Quantity": 7,
"Items": [
"GET",
"HEAD",
"OPTIONS",
"PUT",
"POST",
"PATCH",
"DELETE"
],
"CachedMethods": {
"Quantity": 2,
"Items": [
"GET",
"HEAD"
]
}
},
"GrpcConfig": {
"Enabled": true
},
"CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
"OriginRequestPolicyId": "b689b0a8-53d0-40ab-baf2-68738e2966ac"
}
]
}
}
aws cloudfront create-distribution --distribution-config file://distribution-config.json
Managed-AllViewerExceptHostHeader は Host 以外のビューアーヘッダーをオリジンへ転送するため、WebSocket のハンドシェイクに必要な Sec-WebSocket-* も転送されます。WebSocket 専用のビヘイビアは作らず、デフォルトビヘイビアで通しています。
gRPC は HTTP/2 を使うため、ディストリビューション全体の HttpVersion を http2 にしています。Origin mTLS に WebSocket や gRPC 専用の設定はなく、ここまでの通常の設定に OriginMtlsConfig を加えただけです。
動作確認
以降の $CF_DOMAIN は、ディストリビューションのドメイン名(xxxx.cloudfront.net)です。クライアントはどれも証明書を持たずに CloudFront へ接続します。EC2 上の検証用サーバーは、ALB が付ける X-Amzn-Mtls-Clientcert-* ヘッダーの値(ALB が検証したクライアント証明書の情報)を応答に入れて返します。
WebSocket
Python の websockets で、CloudFront 経由で接続するクライアントを用意します。client/ws_client.py として保存します。
import asyncio
import sys
from websockets.asyncio.client import connect
async def main(url: str) -> None:
async with connect(url) as ws:
print("handshake:", ws.response.status_code, ws.response.reason_phrase)
print("first message:", await ws.recv())
for text in ("hello", "world"):
await ws.send(text)
print("echo:", await ws.recv())
asyncio.run(main(sys.argv[1]))
docker run --rm -v "$PWD/client:/app:ro" -w /app python:3.12-slim \
sh -c "pip install -q websockets && python ws_client.py wss://$CF_DOMAIN/ws"
WebSocket では、クライアント証明書の情報が最初のメッセージに入ります。
handshake: 101 Switching Protocols
first message: {"hello": "origin", "mtls": {"serial-number": "2E41B678…6F675B", "issuer": "CN=cf-origin-mtls-test-ca", "subject": "CN=cloudfront-origin-client"}}
echo: origin-echo: hello
echo: origin-echo: world
gRPC
検証用の proto は次のとおりです。origin/echo.proto として保存します。
syntax = "proto3";
package echo;
service Echo {
rpc Unary(Msg) returns (Msg);
rpc Bidi(stream Msg) returns (stream Msg);
}
message Msg {
string text = 1;
}
gRPC のリクエストパスは /パッケージ名.サービス名/メソッド名 の形です。この proto ではパッケージ名が echo、サービス名が Echo なので、ビヘイビアと ALB のルールのパスは /echo.Echo/* になります。
unary は grpcurl で呼びました。gRPC では、クライアント証明書の情報が応答ヘッダー x-origin-mtls-subject に入ります。出力からは date、via、x-amz-* などのヘッダーの行を省いています。
docker run --rm -i -v "$PWD/origin:/proto:ro" fullstorydev/grpcurl -v \
-import-path /proto -proto echo.proto -d '{"text":"hello"}' $CF_DOMAIN:443 echo.Echo/Unary
Response headers received:
content-type: application/grpc
server: CloudFront
x-cache: Miss from cloudfront
x-origin-mtls-subject: CN=cloudfront-origin-client
Response contents:
{
"text": "origin-echo: hello"
}
Response trailers received:
(empty)
Sent 1 request and received 1 response
双方向ストリーミングでは、3件のメッセージを標準入力から送りました。
printf '{"text":"one"}\n{"text":"two"}\n{"text":"three"}\n' | \
docker run --rm -i -v "$PWD/origin:/proto:ro" fullstorydev/grpcurl -v \
-import-path /proto -proto echo.proto -d @ $CF_DOMAIN:443 echo.Echo/Bidi
Response headers received:
content-type: application/grpc
server: CloudFront
x-cache: Miss from cloudfront
x-origin-mtls-subject: CN=cloudfront-origin-client
Response contents:
{
"text": "origin-echo: one"
}
Response contents:
{
"text": "origin-echo: two"
}
Response contents:
{
"text": "origin-echo: three"
}
Response trailers received:
(empty)
Sent 3 requests and received 3 responses
HTTP
同じディストリビューションに送った HTTP リクエストも、設定を変えずに通りました。HTTP では、クライアント証明書の情報が応答本文に入ります。
curl -sS -i https://$CF_DOMAIN/hello
HTTP/2 200
content-type: application/json; charset=utf-8
server: Python/3.11 websockets/17.4
x-cache: Miss from cloudfront
{
"path": "/hello",
"mtls": {
"serial-number": "2E41B678…6F675B",
"issuer": "CN=cf-origin-mtls-test-ca",
"subject": "CN=cloudfront-origin-client"
}
}
ALB が検証した証明書
検証用サーバーのログに、WebSocket のハンドシェイク、gRPC の unary 呼び出し、双方向ストリーミング呼び出しの記録が残っていました。どれも subject、issuer、serial-number は同じで、HTTP の応答本文の値とも一致します。CloudFront は HTTP、WebSocket、gRPC のどれでも、同じクライアント証明書を提示しています。
{"kind": "ws-handshake", "mtls": {"serial-number": "2E41B678…6F675B", "issuer": "CN=cf-origin-mtls-test-ca", "subject": "CN=cloudfront-origin-client"}, "extra": ""}
{"kind": "grpc-unary", "mtls": {"serial-number": "2E41B678…6F675B", "issuer": "CN=cf-origin-mtls-test-ca", "subject": "CN=cloudfront-origin-client"}, "extra": ""}
{"kind": "grpc-bidi", "mtls": {"serial-number": "2E41B678…6F675B", "issuer": "CN=cf-origin-mtls-test-ca", "subject": "CN=cloudfront-origin-client"}, "extra": ""}
ALB へ直接つないだ場合
CloudFront を経由せず、クライアント証明書なしで ALB(verify モード)へ直接つないだ結果です。WebSocket と gRPC(unary のみ)は、CloudFront 経由で使ったコマンドの接続先を ALB のホスト名(origin.example.com)に替えて実行しました。HTTP は次のコマンドです。
curl -sS -v https://origin.example.com/hello
curl の -v 出力を見ると、TLS ハンドシェイクのうちサーバー証明書の検証までは成功していました。どのクライアントでも HTTP ステータスは返らず、結果は次のとおりでした。
| クライアント | 結果 |
|---|---|
| curl(HTTP) | リクエスト送信時に接続がリセットされた(curl: (16) Send failure、exit 16) |
| Python の websockets(WebSocket) | ハンドシェイクが成立しない(InvalidMessage: did not receive a valid HTTP response) |
| grpcurl(gRPC unary) | 接続を確立できず期限切れになった(Failed to dial target host "origin.example.com:443": context deadline exceeded) |
クライアント証明書を付けて ALB へ直接リクエストすると、応答本文が返りました。
curl -sS --cert client.pem --key client.key https://origin.example.com/hello
まとめ
通常の設定に OriginMtlsConfig を足すだけで、WebSocket と gRPC でも、CloudFront は HTTP と同じクライアント証明書を提示し、ALB の mTLS(verify)を通ることを確認できました。
CloudFront 開発者ガイドでは、Origin mTLS と併用できない機能として、組み込み POP、VPC オリジン、Lambda@Edge の origin request / origin response トリガーが挙げられています。
AWS 内のオリジンの保護には、OAC や VPC オリジンなどを使えますが、CloudFront と AWS 外のオリジンの間の認証を強めたい場合は、今回サポートされた Origin mTLS をお試しください。







