Akamai(BYOCDN)

この設定では、エージェントトラフィック(AI ボットおよび LLM ユーザーエージェントからのリクエスト)を Edge での最適化バックエンドサービス(live.edgeoptimize.net)にルーティングします。 人間の訪問者と SEO ボットは、通常どおりオリジンから引き続き提供されます。 設定をテストするには、設定が完了したら、応答のヘッダー x-edgeoptimize-request-id を探します。

前提条件

Akamai Property Manager ルールを設定する前に、次の内容を確認します。

  • ドメインの Akamai Property Manager へのアクセス権。
  • Adobe Brand Visibility UI から取得された Edge Optimize API キー。 手順について詳しくは、API キーの取得を参照してください。
  • (オプション)ステージングルーティングをテストするには、Staging API キーを参照してください。

設定オプション

Akamai を Edge での最適化用に設定するには、2 つの方法があります。

オプション 1:Adobe Brand Visibility でのガイド付き設定

ガイド付き設定には、お客様の Akamai アカウントに EdgeGrid API クライアントが必要です。また、対象プロパティのグループと契約に対する Property Manager(PAPI)- 読み取り/書き込み​アクセス権、および Akamai のステージング環境と本番環境でプロパティのバージョンをアクティベートする権限が必要です。 Adobe Brand Visibility は、これらの認証情報を設定時にのみ使用し、保存しません。

Akamai EdgeGrid API クライアントを準備

適切な API クライアントをまだお持ちでない場合は、Akamai Control Center で作成します。

  1. Administration/Identity & access を開きます。
  2. Users and API Clients」で、「Create API client」を選択します。
  3. Myself」を選択し、次に「Advanced」を選択します。 クライアントの権限を Property Manager(PAPI)- 読み取り/書き込み​に制限し、対象のグループと契約のみを残して、ステージング環境と本番環境でアクティベートする権限があることを確認します。
  4. クライアントを作成したら、すぐに認証情報ファイルをダウンロードするか、コピーします。 クライアントシークレット、API ホスト、アクセストークン、クライアントトークンが必要です。 クライアントシークレットは 1 回だけ表示されます。

Akamai Identity and Access Management で API クライアントを作成

API クライアントを Property Manager(PAPI)の読み取り/書き込み権限に制限

NOTE
組織で承認されているシークレットマネージャーに資格情報ファイルを保管します。 Adobe Brand Visibility はこれらの資格情報を保存しません。資格情報はブラウザーセッションに保持され、デプロイメントダッシュボードを閉じると消去されます。

ルーティング設定をデプロイ

  1. 設定する URL の CDN 設定​を開きます。
  2. AI エージェントに最適化をデプロイ​で、必要に応じて「有効化」を選択します。
  3. Akamai(Beta)にルーティングをデプロイ」を選択します。
  4. EdgeGrid 認証情報ファイルを貼り付けるか、クライアントシークレット、API ホスト、アクセストークン、クライアントトークンを個別に入力して、接続します。
  5. Akamai プロパティを選択し、提案された変更を確認して、ガイド付きの手順に従ってデプロイします。 新しいプロパティバージョンをアクティベートする前に、承認を得ます。

Adobe Brand Visibility から Akamai にルーティングをデプロイ

NOTE
ガイド付き設定は、対象アカウントの早期アクセス機能として利用できます。 オンボーディングに関するサポートについて詳しくは、アドビのアカウントチームにお問い合わせいただくか、abv-at-edge@adobe.com までメールでお問い合わせください。

オプション 2:手動設定

次の手順に従って、Akamai Property Manager のルールを手動で設定します。

設定

次の Akamai Property Manager ルールでは、エージェント型 HTML ページトラフィックを Edge での最適化にルーティングします。 設定には、次の手順が含まれます。

​1. ルーティング条件を設定(User-Agent と HTML トラフィックのマッチング)

次のユーザーエージェントのルーティングを設定します。

 *AdobeEdgeOptimize-AI*
 *ChatGPT-User*
 *GPTBot*
 *OAI-SearchBot*
 *PerplexityBot*
 *Perplexity-User*
 *ClaudeBot*
 *Claude-User*
 *Claude-SearchBot*
NOTE
Edge での最適化ルーティングルールは、エージェント型 HTML ページトラフィックにのみ適用します。 一般的な設定としては、リクエスト側の条件として、html に一致する​ ファイル拡張子 ​や、拡張子のないページ URL に一致する EMPTY_STRING などを使用することがあります。 サイトが他の URL パターンから HTML を配信する場合や、API エンドポイントなどの拡張子のない非ページルートが含まれる場合は、パスベースの追加条件でルールを絞り込みます。

ルーティング条件を設定

​2. オリジンと SSL の動作を設定

オリジンを live.edgeoptimize.net として設定し、SAN を *.edgeoptimize.net に一致させます。

NOTE
Edge での最適化ルールを追加した後にプロパティのアクティブ化が失敗する場合は、そのルールがデフォルトのルールとは異なるオリジンサーバーの SSL 検証モードを使用しているかどうかを確認します。 異なるモードを使用している場合は、Edge での最適化ルールをデフォルトのルールと一致するように更新します。 例えば、デフォルトのルールで​ プラットフォーム設定 ​を使用している場合は、ここでも​ プラットフォーム設定 ​を使用します。 必要な設定を使用できない場合は、Akamai サポートにお問い合わせください。

オリジンと SSL の動作を設定

​3. キャッシュキー変数を設定

キャッシュキー変数 PMUSER_EDGE_OPTIMIZE_CACHE_KEYLLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}} に設定します。

キャッシュキー変数を設定

​4. キャッシュルール

キャッシュルール

​5. 受信リクエストヘッダーを変更

次の受信リクエストヘッダーを設定します。
x-edgeoptimize-api-key を Adobe Brand Visibility から取得した API キーに
x-edgeoptimize-config コピー先: LLMCLIENT=TRUE;
x-edgeoptimize-url{{builtin.AK_URL}}

受信リクエストヘッダーを変更

ファイアウォールルールで Edge での最適化を許可(任意)

CDN で WAF または Bot Manager を使用している場合:

  • Optimize at Edge サービスがオリジンコンテンツを取得できるよう、WAF または Bot Manager で *AdobeEdgeOptimize/1.0* ユーザーエージェントを許可リストに追加します。

  • ファイアウォールでユーザーエージェント以外の追加の検証が必要な場合は、シークレット(例:openssl rand -hex 32)を生成し、次の操作を行ってください。

    • 他の x-edgeoptimize-* ヘッダーとともに、ルーティングルールにシークレットを含む x-edgeoptimize-fetcher-key を追加します。
    • x-edgeoptimize-fetcher-key が同じシークレットと一致するリクエストを許可するよう、WAF または Bot Manager のルールを追加します。
  • Edge での最適化は、このヘッダーをそのまま転送するため、お客様が鍵のライフサイクル全体を管理することになります。

プロパティマネージャーで x-edgeoptimize-fetcher-key ヘッダーを設定

NOTE
また、Akamai Bot Manager で *AdobeEdgeOptimize/1.0* ユーザーエージェントと x-edgeoptimize-fetcher-key ヘッダーを許可リストに追加します。

​6. 受信応答ヘッダーを変更

受信応答ヘッダーを変更

​7. キャッシュ ID を変更

キャッシュ ID を変更

​8. 送信リクエストヘッダーを変更

x-forwarded-host ヘッダーを {{builtin.AK_HOST}} に設定します。

送信リクエストヘッダーを変更

​9. サイトフェイルオーバー

サイトフェイルオーバー設定には、フェイルオーバー動作(メインの optimize-at-edge ルーティングルール内で設定)と、個別のフェイルオーバーテストヘッダールールの 2 つの部分かがあります。

9a. サイトフェイルオーバー動作(メインの optimize-at-edge ルーティングルール内)

メインの Optimize-at-Edge ルーティングルール内に、サイトフェイルオーバー動作​という名の子ルールを作成します。 Match Any に設定し、次の条件を追加します。

  • 応答ステータスコード​は 400599 の範囲にあります。
  • オリジンタイムアウト​は Yes です。

サイトフェイルオーバー動作と詳細な XML スニペットを子ルールに追加します。

IMPORTANT
この手順で使用する XML スニペットには、詳細​な動作が必要です。 Akamai の一部の環境では、セルフサービス編集に対してこの機能を使用できません。 「詳細」オプションが表示されない場合は、Akamai アカウントチームまたは Akamai サポートに連絡して、必要な設定を有効にしてください。

サイトフェイルオーバー

高度な XML を通じて、リクエストヘッダー x-edgeoptimize-request に値 fo を追加します。

<forward:availability.fail-action2>
<add-header>
<status>on</status>
<name>x-edgeoptimize-request</name>
<value>fo</value>
</add-header>
</forward:availability.fail-action2>

フェイルオーバー動作

9b. フェイルオーバーテストヘッダールール(兄弟ルール)

IMPORTANT
EdgeOptimize フェイルオーバー - テストヘッダー​ルールを、ルーティングルールの​ 兄弟 ​として(同じレベルで)作成します。ルーティングルールの内部にネスト​ しない ​でください。 Akamai Property Manager のルールツリーでは、階層は次のようになります。
code language-none
▼ Optimize at Edge                          ← parent rule
      ▼ Optimize at Edge Routing                ← routing rule
              Site Failover Behavior                ← child of the routing rule
      EdgeOptimize Failover - Test Header       ← sibling of the routing rule
これにより、フェイルオーバーテストヘッダールールが、1 つだけでなく、すべて​のルーティングルールに対して評価されることが確保されます。
また、Edge での最適化ルーティング​ルールが、同じリクエストのオリジン、キャッシュ動作、キャッシュ ID を変更する後続の一致ルールにより上書きされないことも確保されます。 別の一致ルールにより、これらの動作がリセットされた場合、Edge での最適化ルーティングまたはキャッシュが期待どおりに機能しないことがあります。

リクエストヘッダーの x-edgeoptimize-request の値が fo の場合、送信応答ヘッダーの x-edgeoptimize-fotrue に設定します。

フェイルオーバールール

サイトフェイルオーバーにより、Edge での最適化が 4XX または 5XX エラーを返した場合、リクエストは自動的にデフォルトのオリジンにルーティングされるので、エンドユーザーは応答を引き続き受信できます。

シナリオ
動作
Edge での最適化で 2XX が返される
最適化された応答がクライアントに提供されます。
Edge での最適化で 4XX または 5XX が返される
リクエストがデフォルトのオリジンにルーティングされます。

設定の検証

設定が完了したら、ボットトラフィックが Edge での最適化にルーティングされていることと、人間のトラフィックに影響がないことを確認します。

1. ボットトラフィックをテスト(最適化する必要があります)

エージェント型ユーザーエージェントを使用して、AI ボットリクエストをシミュレートします。

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: chatgpt-user"

正常な応答には、リクエストが Edge での最適化を経由してルーティングされたことを確認する x-edgeoptimize-request-id ヘッダーが含まれます。

< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85

2. 人間のトラフィックをテスト(影響を受けません)

通常の人間によるブラウザーリクエストをシミュレートします。

curl -svo /dev/null https://www.example.com/page.html \
  --header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

応答には、x-edgeoptimize-request-id ヘッダーを含め​ ない ​でください。 ページのコンテンツと応答時間は、Edge での最適化を有効にする前と同じ状態を維持する必要があります。

3. 2 つのシナリオを区別する方法

ヘッダー
ボットトラフィック(最適化)
人間のトラフィック(影響を受けない)
x-edgeoptimize-request-id
存在 - 一意のリクエスト ID が含まれます
不在
x-edgeoptimize-fo
フェイルオーバーが発生した場合のみ存在(値:true
不在

トラフィックルーティングのステータスは、Adobe Brand Visibility UI でも確認できます。 顧客設定​に移動し、「CDN 設定」タブを選択します。

AI エージェントへ最適化をデプロイ - 完了

利用可能な機会、自動最適化ワークフロー、FAQ など、Optimize at Edge について詳しくは、Optimize at Edge の概要に戻ってご確認ください。

recommendation-more-help
brand-visibility-help-main-toc