🚛
AWSで大容量ファイルを安全に配信する
API-GW では 10MB までのペイロード制限があり、大容量ファイルをフロントエンドで DL できない問題がある。
CloudFront の Lambda@Edge を利用して、JWT 認証を行い、大容量ファイルを配信できる構成にする。
構成図

API スタック
- API Gateway(JWT 発行用)
- Lambda(API ログイン処理)
- Cognito User Pool(ユーザ管理用)
配信スタック
- CloudFront ディストリビューション
- S3 バケット(大容量ファイル格納用)
- Lambda@Edge(JWT 認証用)
- リージョン
us-east-1必須
- リージョン
CloudFront のポイント
- オリジンに S3 バケットを指定
- OAC (Origin Access Control) を設定して、CloudFront からのみ S3 にアクセス可能にする
- Lambda@Edge の紐づけは、event type:
Viewer Requestを指定する
event type
CloudFront におけるイベントタイプは、Lambda@Edge を実行するタイミングを指定できる
API-GW のリクエスト、統合リクエスト、統合レスポンス、レスポンスみたいなイメージ
(認証失敗時って早期リターンできるのかな?)
| イベントタイプ | 説明 |
|---|---|
| ビューアリクエスト | リクエストがオリジンに転送される前処理を制御できる。 |
| オリジンリクエスト | オリジンに転送されるリクエストを変更できる。 |
| オリジンレスポンス | オリジンからのレスポンスを変更できる。 |
| ビューアレスポンス | レスポンスヘッダの追加や変更ができる。 |
Lambda@Edge 関数をトリガーできる CloudFront イベント
https://docs.aws.amazon.com/ja_jp/AmazonCloudFront/latest/DeveloperGuide/lambda-cloudfront-trigger-events.html
Lambda@Edge のポイント
- リージョン
us-east-1にデプロイする必要がある - JWT の検証には
amazon-cognito-identity-jsoraws-jwt-verifyライブラリを利用することを推奨 - 制約事項あり
- 環境変数の使用不可
- SSM パラメータストアならいけるかも?
- パッケージサイズ
- Viewer Request: 1MB 制限
- Origin Request: 3MB 制限
- タイムアウト
- Viewer Request:max 5 秒
- Origin Request:max 30 秒
- 環境変数の使用不可
Cognito ID トークンについて
ID トークンは下記の情報をエンコードしている。
- ヘッダ
- alg: 署名アルゴリズム
- kid: 鍵 ID
- 主なペイロード
- iss: 発行者
- sub: ユーザ識別子
- aud: クライアント ID
- exp: 有効期限
- iat: 発行時間
- email: ユーザメールアドレス
- email_verified: メールアドレス検証済みフラグ
ID トークンの検証ポイント
aws-jwt-verify ライブラリを利用する場合、下記だけで OK
import { CognitoJwtVerifier } from "aws-jwt-verify";
// ポイント1 : 自前Cognitoユーザプールの情報を指定
// Cognito User Pool 用の JWT 検証器を作成
// tokenUseとは、検証するトークンの種類を指定 ("id" or "access")らしい
const verifier = CognitoJwtVerifier.create({
userPoolId: "your USER_POOL_ID",
clientId: "your CLIENT_ID",
tokenUse: "id",
});
exports.handler = async (event) => {
const request = getRequest(event); // いい感じにeventからリクエストを取得
const authHeader = request.headers["authorization"]?.[0]?.value;
// ポイント2 : Authorization ヘッダの Bearer プレフィックスは除去
const token = authHeader.replace("Bearer ", "");
try {
// ポイント3 : verify メソッドで署名とクレームを検証
const payload = await verifier.verify(token);
console.log("Token is valid. Payload:", payload);
return request;
} catch (err) {
console.log("Token verification failed:", err);
return {
status: "401",
statusDescription: "Unauthorized",
};
}
};
ID トークンを素の Cognito エンドポイントで検証する場合
- リクエストの JWT ヘッダーから kid (Key ID)を取得
- 自前の Cognito ユーザプールに問い合わせて公開鍵を取得
https://cognito-idp.{region}.amazonaws.com/{userPoolId}/.well-known/jwks.json
- 手順 1 で取得した kid に対応する公開鍵で RS256 署名を検証
import * as jwt from "jsonwebtoken";
import axios from "axios";
exports.handler = async (event) => {
const request = getRequest(event); // いい感じにeventからリクエストを取得
const authHeader = request.headers["authorization"]?.[0]?.value;
const token = authHeader.replace("Bearer ", "");
try {
// ポイント1 : JWTヘッダーからkid (Key ID)を取得
const decodedHeader = jwt.decode(token, { complete: true });
const kid = decodedHeader.header.kid;
// ポイント2 : Cognito公開鍵をダウンロード
const jwksUrl = `https://cognito-idp.${process.env.AWS_REGION}.amazonaws.com/${process.env.USER_POOL_ID}/.well-known/jwks.json`;
const response = await axios.get(jwksUrl);
const jwks = response.data;
// ポイント3 : kidに対応する公開鍵でRS256署名を検証
const publicKey = getPublicKeyFromJwks(jwks, kid);
jwt.verify(token, publicKey, { algorithms: ["RS256"] });
// ポイント4 : クレームの検証 (例: exp, aud)
// 発行日時(exp)やクライアントID(aud)の検証を追加実装することを推奨
// 割愛
// --------------------------------------------------------------------
console.log("Token is valid.");
return request;
} catch (err) {
console.log("Token verification failed:", err);
return {
status: "401",
statusDescription: "Unauthorized",
};
}
};
function getPublicKeyFromJwks(jwks, kid) {
const key = jwks.keys.find((key) => key.kid === kid);
if (!key) {
throw new Error("Public key not found in JWKS");
}
// JWKSからPEM形式の公開鍵を生成する処理を実装
// 割愛
return convertJwkToPem(key);
}
ポッキーの日投稿なのにポッキー食べてない
なう(2025/11/11 23:41:06)
Discussion