Edge Security Acceleration:ドメイン名の設定

事前準備

ドメイン名の関連付け と ルート の両方で、アカウントにアクティブなサイトが必要です。

アクティブなサイトとは、プランを購入済みで、NS レコードまたは CNAME レコードを使用して接続されているサイトのことです。

適切な設定方法の選択

ドメインバインディングの使用

ドメイン名の関連付け を使用して、ドメイン名からのすべてのトラフィックを特定の Functions and Pages サービスに転送して処理します。

ドメインバインディング機能を使用すると、Functions and Pages サービスをご利用サイトのドメイン名にリンクできます。ドメイン名がバインドされると、それを使用して Functions and Pages サービスに直接アクセスできます。Functions and Pages サービスにバインドされるドメイン名は、アクティブなサイトに属している必要があります。コンソールでバインディングを設定すると、ESA はバインドされたドメイン名の DNS レコードをサイトに自動的に追加します。

1. ESA コンソールにログインします。左側のナビゲーションウィンドウで、エッジコンピューティング > Functions and Pages を選択します。設定する Functions and Pages サービスをクリックします。

2. [ドメイン] タブをクリックします。ドメイン名の関連付け セクションで、ドメイン名を追加 をクリックします。

3. Functions and Pages サービスにバインドするドメイン名 (例: pages.example.com) を入力します。ドメイン名が追加されると、対応するサイトに新しい DNS レコードが作成されます。

   説明

   新しいドメイン名は、そのサイトの設定を継承します。サイトに SSL/TLS 証明書がない場合、バインドされたドメイン名は HTTPS 経由でアクセスできません。サイトで SSL/TLS を有効にする方法の詳細については、「SSL/TLS」をご参照ください。

   

4. ご利用サイトの接続タイプに対応する手順に従います：

   NS 設定を使用して接続されたサイト

   ご利用のサイトが NS レコードを使用して接続されている場合は、DNS レコードが有効になるまで待ちます。このプロセスには約 1 分かかります。その後、新しくバインドされたカスタムドメイン名 (例: pages.example.com) にブラウザでアクセスして結果を表示します。

   CNAME 設定を使用して接続されたサイト

   ご利用のサイトが CNAME レコードを使用して接続されている場合は、バインディングを有効にするために、DNS プロバイダーで CNAME レコードを設定する必要があります。

   1. 新しく追加したカスタムドメイン名の右側にある DNS レコードの表示 をクリックします。

      

   2. ESA が新しい DNS レコード用に生成した CNAME 値をコピーします。

      

   3. DNS プロバイダーに移動し、ドメイン名の DNS 設定に CNAME レコードを追加します：

      • ホストレコード：カスタムドメイン名のプレフィックスを入力します。この例では、pages と入力します。

      • レコードタイプ：CNAME を選択します。

      • レコード値：前のステップでコピーした CNAME 値を貼り付けます。

      

   4. ESA コンソールに戻ります。CNAME のステータス が 設定済み に変わるまで待ちます。その後、新しくバインドされたカスタムドメイン名 (例: pages.example.com) にブラウザでアクセスして結果を表示します。

ルーティング設定の使用

ルーティングを使用して、特定の URL パスへのリクエストを Functions and Pages サービスに転送できます。このメソッドは、詳細なトラフィックシェーピングを提供します。リクエストが設定された URL パターンに一致する場合、Functions and Pages サービスがそれを処理します。それ以外の場合、リクエストは ESA の高速化された back-to-origin プロセスを続行します。たとえば、example.com サイトにルーティングルール example.com/a* を設定した場合、/a、/a1、/a2 などの一致するパスへのすべてのリクエストは、Functions and Pages サービスによって処理されます。/b、/c、/d などの一致しないパスへのリクエストは、標準の back-to-origin またはキャッシュプロセスに従います。

1. ESA コンソールにログインします。左側のナビゲーションウィンドウで、エッジコンピューティング > Functions and Pages を選択します。設定する Functions and Pages サービスをクリックします。

2. [ドメイン] タブをクリックします。ルート セクションで、ルートを追加 をクリックします。

3. [ルーティング名] を入力します。[サイトの選択] リストで、ターゲットサイト (例: example.com) を選択します。

4. 選択する[ルーティングパターン]：

   1. [基本モード]：このパターンは、ホスト名とパスを含む URL のみに基づいてリクエストを照合します。たとえば、URL プレフィックスが pages.example.com のすべてのリクエストを Functions and Pages サービスにルーティングするように設定できます：

   2. カスタムパターン: このパターンは、リクエストヘッダー、Cookie、リクエストメソッドなど、複数の条件に基づく複雑な論理マッチングを必要とするシナリオに適しています。複数のマッチング条件を追加し、それらの間の論理関係を「すべての条件を満たす」または「いずれかの条件を満たす」として指定することができます。たとえば、hostname が www.example.com と等しく、かつ User-Agent リクエストヘッダーに Mobile が含まれる場合にのみ、リクエストを 関数とページ サービスに転送するルールを設定できます:

5. ブラウザで一致するルーティングパスにアクセスして、結果を表示します。

   

バイパスモード

ルーティングルールのバイパスモードを有効にすると、リクエストがルーティングポリシーに一致したときに、リクエストはサブリクエストとして Functions and Pages サービスに送信されます。バイパスモードの全体的なプロセスは次のとおりです：

1. クライアントが ESA の POP (Point of Presence) にリクエストを送信します。

2. リクエストはルーティングポリシーに一致し、処理のために Functions and Pages サービスに転送されます。Functions and Pages サービスでは、リクエストの内容に基づいてログ記録や認証などの操作を実行できます。バイパスモードが有効な場合、リクエストボディは Functions and Pages サービスに転送されないことに注意してください。

3. Functions and Pages サービスからのレスポンスのステータスコードが 200 の場合、リクエストは次の処理ステップに進みます。ステータスコードが 200 でない場合、ESA はリクエストを中止し、クライアントに 403 ステータスコードを返します。

4. その後、リクエストは後続のポリシーと照合され、ESA のキャッシュマッチングまたは高速化された back-to-origin ロジックを経て処理されます。

5. キャッシュヒットまたはオリジンサーバーからのレスポンスが ESA の POP に返されます。この時点で、レスポンスは Functions and Pages サービスによって処理されなくなります。

6. レスポンスはクライアントに転送されます。

一般的な利用シーン

• ログ記録：一部のリクエストのログを生成したい場合、リクエストをバイパスモードで Functions and Pages サービスに転送し、関数内でカスタムのログ記録ロジックを定義できます。

• 大容量ファイルのダウンロード認証：エッジ関数がクライアントにレスポンスを転送する際、CPU 時間を消費します。レスポンスが大きすぎると、CPU タイムスライスの上限を超え、追加コストが発生する可能性があります。バイパスモードを使用して Functions and Pages サービスで認証を行うことで、これらの問題を回避できます。

よくある質問

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get('auth_key');

  const privateKey = 'your_secret_key'
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // 認証失敗。エッジはデフォルトでクライアントに 403 ステータスコードを返します。
    return new Response('Unauthorized', { 
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split('-');

  if (currentTimestamp > parseInt(timestamp)+ delta) {
    // 認証失敗。エッジはデフォルトでクライアントに 403 ステータスコードを返します。
    return new Response('Link expired', {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join('-');

  const md5 = createHash('md5').update(signString).digest('hex');

  if (md5 !== signature) {
  
    return new Response('Unauthorized', {
      status: 401
    });
  }

  // リソースが別のドメイン名にある場合は、リクエストを送信してレスポンスを返します。
  // const yourUrl = `https://your-dcdn-domain.com${path}${url.search}`
  // const cdnResponse = await fetch(yourUrl, request)
  // return new Response(cdnResponse.body, cdnResponse)

  // ほとんどの場合、オリジンからフェッチするだけで十分です。
  return fetch(request.url)
}

export default {
  async fetch(request) {
    return handleRequest(request)
  }
}

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get("auth_key");

  const privateKey = "your_secret_key";
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // 認証失敗。false を渡します。エッジはデフォルトでクライアントに 403 ステータスコードを返します。
    return new ResponseBypass(false, {
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split("-");

  if (currentTimestamp > parseInt(timestamp) + delta) {
    // 認証失敗。false を渡します。エッジはデフォルトでクライアントに 403 ステータスコードを返します。
    return new ResponseBypass(false, {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join("-");

  const md5 = createHash("md5").update(signString).digest("hex");

  if (md5 !== signature) {
    // 認証失敗。false を渡します。エッジはデフォルトでクライアントに 403 ステータスコードを返します。
    return new ResponseBypass(false, {
      status: 401,
    });
  }

  // 認証成功。true を渡します。リクエストはオリジンに続行され、レスポンスは関数によって処理されなくなります。
  const resSuccess = new ResponseBypass(true);
  return resSuccess;
}

export default {
  async bypass(request) {
    return handleRequest(request);
  },
};