Apache HTTP サーバー

この設定は、Apache HTTP サーバーがオリジンの前段でリバースプロキシとして機能する場合(AEM Dispatcher を​ 使用しない ​セルフホスト型の構成)に適用されます。 エージェントトラフィック(AI ボットや LLM ユーザーエージェントからのリクエスト)を Edge での最適化バックエンドサービス(live.edgeoptimize.net)にルーティングします。 人間の訪問者と SEO ボットは、通常どおりオリジンから引き続き提供されます。 設定をテストするには、設定が完了したら、応答のヘッダー x-edgeoptimize-request-id を探します。

この統合は、Apache のネイティブな Include ファイルのセットであり、デプロイするコードやワーカーはありません。 3 つのファイルをダウンロードし、API キーを設定して、仮想ホストに 2 Include 行を追加します。

前提条件

Apache のルーティングルールを設定する前に、次のものがあることを確認します。

  • これらのモジュールが有効になっている Apache HTTP サーバー 2.4 以降:proxyproxy_httpsslrewriteheadersenvsetenvif
  • Apache 設定(サイトの <VirtualHost>)へのアクセス権と、Apache を再読み込みできる権限。
  • Adobe Brand Visibility UI から取得された Edge Optimize API キー。 手順について詳しくは、API キーの取得を参照してください。
  • (オプション)ステージングルーティングをテストするには、Staging API キーを参照してください。

設定

1. 設定ファイルをダウンロード

Edge での最適化コードサンプルリポジトリから 3 つの Edge での最適化インクルードファイルをダウンロードし、Apache サーバー上のディレクトリ(例:conf/oae/)に配置します。

ファイル
目的
oae-routing.conf
AI ボットを検出し、Edge での最適化ヘッダーを挿入して、HTML ページのリクエストをバックエンドにルーティングし、キャッシュの分離とフェイルオーバーを設定します。
oae-failover.conf
Edge での最適化がエラーを返した場合に、元のリクエストをオリジンに対して再実行します。
domains.conf
ドメインごとに Edge での最適化を有効にし、API キーを保持します。

oae-routing.confoae-failover.conf を変更する必要はありません。そのまま使用します。

2. ドメインを有効にして API キー(domains.conf)を設定

domains.conf を編集し、有効にするドメインごとに 1 行を追加します。 ホストを自分のドメインに置き換え、YOUR_API_KEY を Adobe Brand Visibility UI から取得したキーに置き換えます。 リストに含まれていないドメインは変更されずにオリジンにルーティングされるので、一度に 1 つのドメインを有効にできます。

SetEnvIfExpr "%{HTTP_HOST} =~ m#(?i)^(www\.)?example\.com(:\d+)?$#" OAE_DOMAIN_ENABLED=1 OAE_API_KEY=YOUR_API_KEY

3. 仮想ホストにファイルを組み込む

既存の <VirtualHost *:443> に 2 行の Include を追加します。 ルーティングファイルは、既存の書き換えおよび ProxyPass ルールよりも​ ​に配置し、フェイルオーバーファイルはそれらの​ ​に配置します。 以下の例では、#NEWLINE のマークが付いた行だけが Edge での最適化に追加する行です。それ以外(ServerNameProxyPass、その他)はすべて既存の変更されていない設定です。

Define OAE_CONF_DIR conf/oae                       #NEWLINE  directory holding the OAE include files

<VirtualHost *:443>
    ServerName www.example.com

    Include "${OAE_CONF_DIR}/oae-routing.conf"     #NEWLINE  OAE routing — BEFORE your Rewrite & ProxyPass rules

    # --- your existing rewrite rules and ProxyPass to origin ---
    ProxyPass        "/" "https://www.example.com/"
    ProxyPassReverse "/" "https://www.example.com/"

    Include "${OAE_CONF_DIR}/oae-failover.conf"    #NEWLINE  OAE failover — AFTER your ProxyPass rules
</VirtualHost>

4. Apache をリロード

設定を検証し、Apache をリロードして、変更を適用します。

NOTE
ボット向けに最適化された応答と人間向けの応答は、自動的に別々のキャッシュエントリとして保持されます(ルーティングファイルによって Vary: x-edgeoptimize-config が設定されます)。 Apache ですでに mod_cache を使用している場合は、Edge での最適化ヘッダーの設定後にキャッシュ検索が実行されるよう、CacheQuickHandler Off が設定されていることを確認します。

ファイアウォールルールで 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 での最適化は、このヘッダーをそのまま転送するため、お客様が鍵のライフサイクル全体を管理することになります。

設定の検証

設定が完了したら、ボットトラフィックが 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
フェイルオーバーが発生した場合のみ存在(値:1
不在

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

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

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

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