バックエンドをプロキシする
バックエンドプロキシエンドポイントは、/_api パスを 1 つの HTTPS URL へ転送します。ページは同一オリジンの fetch のままです。Edge がオリジンへ接続し、タイムアウトとサイズ上限を適用し、プライベートアドレスを拒否します。
プロキシエンドポイントは ウェブコンソールではまだ管理できません。エージェント、CLI、または API を使ってください。
このページは公開中の distribution があることを前提とします。まだの場合は 最初のサイトを公開する から始めてください。以降、その distribution は acme-marketing(d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)とします。
パスを割り当てる
オリジンは DNS ホスト名付きの https である必要があります。IP リテラル、localhost、プライベート、リンクローカル、メタデータアドレスは拒否されます。{splat} は訪問者パスの残りを上流 URL にコピーします。ホスト名には置けません。
エンドポイントマップの JSON フィールドは runtime です。runtime を送るとマップ全体が置き換わります。ほかの /_api パスがある場合は、同じ更新に含めないと消えます。
acme-marketing で POST と PUT の /_api/crm/* を
https://crm.example.com/hooks/{splat} にプロキシして。
既存のエンドポイントはすべて残して。応答はキャッシュしないで。edge api PATCH /v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 --input - <<'EOF'
{
"runtime": {
"api": {
"routes": [
{
"match": "/_api/crm/*",
"proxy": "https://crm.example.com/hooks/{splat}",
"methods": ["POST", "PUT"],
"cache_ttl_seconds": 0
}
]
}
}
}
EOFcurl -s -X PATCH \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"runtime": {
"api": {
"routes": [
{
"match": "/_api/crm/*",
"proxy": "https://crm.example.com/hooks/{splat}",
"methods": ["POST", "PUT"],
"cache_ttl_seconds": 0
}
]
}
}
}'エージェントは edge_distribution_update を実行します。プロキシの既定キャッシュ TTL は 0 です。ページからは fetch("/_api/crm/lead", { method: "POST", headers: { "content-type": "application/json", "x-amz-content-sha256": "<hex>" }, body }) — ハッシュはそのボディの小文字 hex SHA-256 です。そうしないとエッジは 400 を返します。訪問者の Cookie は転送されません。リダイレクトは追従しません。
接続失敗、応答しないオリジン、安全でないアドレスは 502 を返します。タイムアウトは 10 秒です。制限 を参照してください。
認証情報とストリーミング
訪問者に見せてはいけない秘密を付けるには、proxy_auth を追加します。典型的には { "target": "header", "name": "Authorization", "value": "Bearer …" } です。ヘッダーを優先してください。クエリパラメータにすると秘密が上流 URL に入り、ログやトレースに残ることがあります。distribution あたり最大 5 件です。読み取りでは値がなく { configured: true } が返ります。その形を送り返すと保存済みの秘密を保ち、新しい value を送るとローテーションします。
ストリーミングするオリジン(SSE、チャンクのチャット)では "proxy_mode": "stream" を設定します。ステータスとヘッダーが訪問者に出たあとは、ストリームは再試行されません。ボディの途中でオリジンが落ちると、訪問者はすでに 200 を見てから途切れたペイロードになることがあります。
バッファされた GET/HEAD は、同じタイムアウト内で接続失敗または 502/503/504 を 1 回再試行します。
次に読む
- データオブジェクトを配信する
- エンドポイントを追加する — 関数ランタイム
- エンドポイント