Amazon CloudFront の Origin mTLS が WebSocket と gRPC に対応したので ALB オリジンで試してみた

Amazon CloudFront の Origin mTLS が WebSocket と gRPC に対応したので ALB オリジンで試してみた

ALB をオリジンにして、WebSocket と gRPC でも CloudFront の Origin mTLS を使えるか試しました。1つのクライアント証明書で、HTTP、WebSocket、gRPC のどれも ALB の mTLS(verify)を通りました。
2026.11.19

はじめに

2026-11-18 に、Amazon CloudFront の Origin mTLS が WebSocket と gRPC のトラフィックに対応しました。

https://aws.amazon.com/about-aws/whats-new/2026/11/amazon-cloudfront-origin-mtls-websockets-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 トリガーが挙げられています。

https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-enable-mtls-distributions.html

AWS 内のオリジンの保護には、OAC や VPC オリジンなどを使えますが、CloudFront と AWS 外のオリジンの間の認証を強めたい場合は、今回サポートされた Origin mTLS をお試しください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事