
Amazon CloudFront Functions でネットワーク呼び出しを試してみた
はじめに
2026年11月18日に、CloudFront Functions でネットワーク呼び出しがサポートされ、外部 API などを cf.fetch() と cf.beacon() で呼び出せるようになりました。
cf.fetch() は、オリジンへリクエストを送って応答を受け取るメソッドです。関数から API エンドポイントを呼び、その応答でリクエストの処理方法を決められます。たとえば、次のような使い方があります。
- AI エージェントの権限と使用予算を確認して、承認されたリクエストだけを API や MCP サーバーに届ける
- セキュリティサービスや不正検出サービスにリクエストのシグナルを送り、不正なトラフィックをブロックまたは検証する
cf.beacon() は、応答を待たずにリクエストを送るメソッドです。キャッシュから配信するコンテンツでも、ビューアへの応答を遅らせずにバックグラウンドで分析イベントを送れます。
この記事では、OAC を設定した S3 と Lambda 関数 URL をオリジンにして、cf.fetch() と cf.beacon() を試した結果を紹介します。
検証の構成
cf.fetch() と cf.beacon() の宛先は、同じディストリビューションに登録したオリジンの ID とパスで指定します。
この記事のディストリビューションは、S3 用の s3-config と Lambda 関数 URL 用の auth-api の2つのオリジンを持ちます。ビヘイビアと関数の対応は次のとおりです。
| ビヘイビア | ビヘイビアのオリジン | 紐づける関数 | 関数が呼ぶオリジン |
|---|---|---|---|
| 既定 | s3-config |
t1-response(viewer response) | s3-config |
/t2/* |
s3-config |
t2-auth(viewer request) | auth-api |
/t3/* |
s3-config |
t3-beacon(viewer request) | auth-api |
オリジンの準備
S3 バケットに、検証で返す次のオブジェクトを置きます。
| キー | 内容 |
|---|---|
config/experiments.json |
後述の「S3 の設定ファイル」で示す JSON |
index.html |
hello |
t2/ok.txt |
ok-body |
t3/page.txt |
cached page |
S3 バケットとオブジェクトの作成コマンド
aws s3api create-bucket --bucket amzn-s3-demo-bucket --create-bucket-configuration LocationConstraint=ap-northeast-1
aws s3api put-object --bucket amzn-s3-demo-bucket --key config/experiments.json --body experiments.json --content-type application/json
aws s3api put-object --bucket amzn-s3-demo-bucket --key index.html --body index.html --content-type text/html
aws s3api put-object --bucket amzn-s3-demo-bucket --key t3/page.txt --body page.txt --content-type text/plain
aws s3api put-object --bucket amzn-s3-demo-bucket --key t2/ok.txt --body t2-ok.txt --content-type text/plain
受け側として、関数 URL を持つ Lambda 関数を1つ用意します(以降は「受け側の Lambda」と表記します)。この関数は、認可 API(/auth)と beacon の受信(/beacon)を兼ねます。
受け側の Lambda のコードと作成コマンド
index.mjs:
// 検証用の受け側。認可 API と beacon 受信を1つの関数 URL で兼ねる。
const json = (status, body, extra = {}) => ({
statusCode: status,
headers: { 'content-type': 'application/json', ...extra },
body: JSON.stringify(body),
});
export const handler = async (event) => {
const method = event.requestContext.http.method;
const path = event.rawPath;
const query = event.rawQueryString || '';
const headers = event.headers || {};
const body = event.body
? event.isBase64Encoded
? Buffer.from(event.body, 'base64').toString('utf8')
: event.body
: '';
// 受け側で何が届いたかを CloudWatch Logs に残す
console.log(
'RECV ' +
JSON.stringify({
method,
path,
query,
sha256: headers['x-amz-content-sha256'] || null,
bodyLength: body.length,
}),
);
if (path === '/auth' && method === 'POST') {
const parsed = JSON.parse(body);
const token = String(parsed.token || '');
if (token.endsWith('ok')) return json(200, { userId: 'u-123' });
if (token.endsWith('deny')) return json(403, { error: 'forbidden' });
return json(401, { error: 'unknown token' });
}
if (path === '/beacon') {
console.log('BEACON ' + JSON.stringify({ method, query, body }));
return json(200, { received: true });
}
return json(404, { error: 'not found' });
};
index.mjs を zip にして function.zip として保存します。実行ロールは、Lambda を信頼するポリシー(trust.json)で作り、AWSLambdaBasicExecutionRole を付けてから関数を作成します。
trust.json:
{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}
aws iam create-role --role-name devio1119-cff-lambda-role --assume-role-policy-document file://trust.json
aws iam attach-role-policy --role-name devio1119-cff-lambda-role --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
aws lambda create-function --function-name devio1119-cff-api --runtime nodejs22.x --handler index.handler --role arn:aws:iam::<ACCOUNT_ID>:role/devio1119-cff-lambda-role --zip-file fileb://function.zip --timeout 10 --architectures arm64
s3-config は S3 と OAC、auth-api は Lambda 関数 URL と OAC で構成します。OAC を S3 用と Lambda 用に1つずつ作り、Lambda 関数には認証タイプ AWS_IAM の関数 URL を作成します。
OAC と関数 URL の作成コマンド
aws cloudfront create-origin-access-control --origin-access-control-config Name=devio1119-cff-s3\,SigningProtocol=sigv4\,SigningBehavior=always\,OriginAccessControlOriginType=s3
aws cloudfront create-origin-access-control --origin-access-control-config Name=devio1119-cff-lambda\,SigningProtocol=sigv4\,SigningBehavior=always\,OriginAccessControlOriginType=lambda
aws lambda create-function-url-config --function-name devio1119-cff-api --auth-type AWS_IAM
関数の作成と紐づけ
関数は JavaScript runtime 2.0(cloudfront-js-2.0)で作成して公開します。この記事では、設定を読む t1-response、認可の t2-auth、beacon を送る t3-beacon を使います。次のコマンドは t1-response の例で、ほかの関数も同じ手順で作ります。
aws cloudfront create-function --name devio1119-t1-response --function-config Comment=devio1119\ t1-response\,Runtime=cloudfront-js-2.0 --function-code fileb://t1-response.js
aws cloudfront publish-function --name devio1119-t1-response --if-match <ETag>
公開した関数を、ディストリビューションのビヘイビアに紐づけます。既定のビヘイビアには、t1-response を viewer response に紐づけます。
ディストリビューションの設定
aws cloudfront create-distribution --distribution-config file://distribution-config.json
distribution-config.json:
{
"CallerReference": "devio1119-1795052864",
"Comment": "devio1119 cloudfront functions network calls",
"Enabled": true,
"DefaultRootObject": "index.html",
"PriceClass": "PriceClass_200",
"HttpVersion": "http2",
"Origins": {
"Quantity": 2,
"Items": [
{
"Id": "s3-config",
"DomainName": "amzn-s3-demo-bucket.s3.ap-northeast-1.amazonaws.com",
"OriginAccessControlId": "<S3_OAC_ID>",
"S3OriginConfig": {
"OriginAccessIdentity": ""
}
},
{
"Id": "auth-api",
"DomainName": "<FUNCTION_URL_ID>.lambda-url.ap-northeast-1.on.aws",
"OriginAccessControlId": "<LAMBDA_OAC_ID>",
"CustomOriginConfig": {
"HTTPPort": 80,
"HTTPSPort": 443,
"OriginProtocolPolicy": "https-only",
"OriginSslProtocols": {
"Quantity": 1,
"Items": [
"TLSv1.2"
]
}
}
}
]
},
"DefaultCacheBehavior": {
"TargetOriginId": "s3-config",
"ViewerProtocolPolicy": "https-only",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"GET",
"HEAD"
]
},
"CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
"Compress": true,
"FunctionAssociations": {
"Quantity": 1,
"Items": [
{
"EventType": "viewer-response",
"FunctionARN": "arn:aws:cloudfront::<ACCOUNT_ID>:function/devio1119-t1-response"
}
]
}
},
"CacheBehaviors": {
"Quantity": 2,
"Items": [
{
"TargetOriginId": "s3-config",
"ViewerProtocolPolicy": "https-only",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"GET",
"HEAD"
]
},
"CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
"Compress": true,
"FunctionAssociations": {
"Quantity": 1,
"Items": [
{
"EventType": "viewer-request",
"FunctionARN": "arn:aws:cloudfront::<ACCOUNT_ID>:function/devio1119-t2-auth"
}
]
},
"PathPattern": "/t2/*"
},
{
"TargetOriginId": "s3-config",
"ViewerProtocolPolicy": "https-only",
"AllowedMethods": {
"Quantity": 2,
"Items": [
"GET",
"HEAD"
]
},
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e58f6",
"Compress": true,
"FunctionAssociations": {
"Quantity": 1,
"Items": [
{
"EventType": "viewer-request",
"FunctionARN": "arn:aws:cloudfront::<ACCOUNT_ID>:function/devio1119-t3-beacon"
}
]
},
"PathPattern": "/t3/*"
}
]
}
}
ディストリビューションの作成後に、create-distribution の出力にあるディストリビューション ID を条件にして、バケットポリシーと Lambda の許可を設定します。
バケットポリシーと Lambda の許可
bucket-policy.json:
{"Version":"2012-10-17","Statement":[{"Sid":"AllowCloudFrontServicePrincipal","Effect":"Allow","Principal":{"Service":"cloudfront.amazonaws.com"},"Action":"s3:GetObject","Resource":"arn:aws:s3:::amzn-s3-demo-bucket/*","Condition":{"StringEquals":{"AWS:SourceArn":"arn:aws:cloudfront::<ACCOUNT_ID>:distribution/<DISTRIBUTION_ID>"}}}]}
aws s3api put-bucket-policy --bucket amzn-s3-demo-bucket --policy file://bucket-policy.json
aws lambda add-permission --function-name devio1119-cff-api --statement-id AllowCloudFrontInvokeFunctionUrl --action lambda:InvokeFunctionUrl --principal cloudfront.amazonaws.com --source-arn arn:aws:cloudfront::<ACCOUNT_ID>:distribution/<DISTRIBUTION_ID> --function-url-auth-type AWS_IAM
aws lambda add-permission --function-name devio1119-cff-api --statement-id AllowCloudFrontInvokeFunction --action lambda:InvokeFunction --principal cloudfront.amazonaws.com --source-arn arn:aws:cloudfront::<ACCOUNT_ID>:distribution/<DISTRIBUTION_ID>
cf.fetch()
S3 の設定ファイル
S3 の config/experiments.json に、次の JSON を置きます。
{"activeExperiment":"exp-blue-2026"}
viewer response の関数は、この JSON を cf.fetch() で読み、activeExperiment の値を x-experiment 応答ヘッダーに追加します。
import cf from 'cloudfront';
async function handler(event) {
const response = event.response;
const r = await cf.fetch('/config/experiments.json', {
originId: 's3-config',
includeBody: true,
});
if (r.ok) {
const config = await r.json();
response.headers['x-experiment'] = { value: config.activeExperiment };
}
return response;
}
クライアントが受け取る応答に x-experiment が付きます。
$ curl -sS -i https://d111111abcdef8.cloudfront.net/\?r=2
HTTP/2 200
x-experiment: exp-blue-2026
x-cache: Miss from cloudfront
hello
Lambda 関数 URL の認可 API
認可の関数(t2-auth)は、Authorization ヘッダーの値を JSON にして認可 API(/auth)へ POST します。応答が 2xx ならリクエストを通し、それ以外なら 403 を返します。
import cf from 'cloudfront';
const crypto = require('crypto');
async function handler(event) {
const request = event.request;
const auth = request.headers['authorization'];
if (!auth) {
return { statusCode: 401, statusDescription: 'Unauthorized' };
}
const body = JSON.stringify({ token: auth.value, uri: request.uri });
const headers = { 'content-type': 'application/json' };
// Lambda 関数 URL への POST は、本文の SHA-256 を関数側で付ける必要がある
headers['x-amz-content-sha256'] = crypto.createHash('sha256').update(body).digest('hex');
const response = await cf.fetch('/auth', {
originId: 'auth-api',
method: 'POST',
headers: headers,
body: body,
includeBody: true,
});
if (!response.ok) {
console.log('authorize returned ' + response.status);
return {
statusCode: 403,
statusDescription: 'Forbidden',
headers: { 'x-fn-authorize-status': { value: String(response.status) } },
};
}
const result = await response.json();
request.headers['x-user-id'] = { value: result.userId };
return request;
}
受け側の Lambda は、トークンの末尾が ok か deny かによって応答を返し分けます。t2-auth を /t2/* の viewer request に紐づけ、Authorization ヘッダーを変えながら次のように curl で送ります。
curl -i -H 'Authorization: Bearer abc-ok' https://d111111abcdef8.cloudfront.net/t2/ok.txt
| 入力(Authorization ヘッダー) | 認可 API の応答 | クライアントへの応答 |
|---|---|---|
| ヘッダーなし | 呼ばない | 401 |
| Bearer abc-ok | 200 | 200、本文 ok-body |
| Bearer abc-deny | 403 | 403、x-fn-authorize-status: 403 |
Lambda 関数 URL へ本文つきで POST するときは、関数で本文の SHA-256 を計算して x-amz-content-sha256 ヘッダーに入れます。
cf.beacon()
beacon の送信
次の関数を /t3/* の viewer request に紐づけます。関数は cf.beacon() を await せずに呼びます。?mode= で beacon のメソッドを切り替え、?id= で受け側のログと突き合わせます。
import cf from 'cloudfront';
const crypto = require('crypto');
// ?mode= で beacon のメソッドを切り替える
// post : POST + x-amz-content-sha256 つき
// get : 本文なしの GET
// ?id= は受け側のログと突き合わせるための印
function handler(event) {
const request = event.request;
const qs = request.querystring;
const mode = qs.mode ? qs.mode.value : 'post';
const id = qs.id ? qs.id.value : 'none';
if (mode === 'get') {
cf.beacon('/beacon?id=' + id, {
originId: 'auth-api',
});
} else {
const body = JSON.stringify({ id: id, mode: mode, uri: request.uri });
const headers = {
'content-type': 'application/json',
'x-amz-content-sha256': crypto.createHash('sha256').update(body).digest('hex'),
};
cf.beacon('/beacon', {
originId: 'auth-api',
method: 'POST',
headers: headers,
body: body,
});
}
return request;
}
クライアントからのリクエストはすべて GET です。表の POST は、関数内の cf.beacon() が受け側へ送るメソッドです。
| クライアントのリクエスト(GET /t3/page.txt に付けたクエリ) | beacon のメソッド | 受け側の Lambda に届いたか |
|---|---|---|
| ?mode=post&id=m1 | POST | 届いた |
| ?mode=get&id=g1 | GET(本文なし) | 届いた |
受け側の Lambda のロググループ /aws/lambda/devio1119-cff-api では、BEACON の行で届いた内容を確認できます。
BEACON {"method":"POST","query":"","body":"{\"id\":\"m1\",\"mode\":\"post\",\"uri\":\"/t3/page.txt\"}"}
BEACON {"method":"GET","query":"id=g1","body":""}
まとめ
CloudFront Functions が同じディストリビューションのオリジンへ HTTP リクエストを送れるようになりました(Free プランとマルチテナントのディストリビューションを除きます)。
1回の関数実行で使えるネットワーク呼び出しは1回、応答を待てるのは1秒まで、リクエストボディとレスポンスボディはそれぞれ 10 KB までです。認証・認可のカスタマイズや、トレース情報の取得などが必要な場合にお試しください。








