AEMaaCSでのCDN ルーティングとヘッダーの問題の修正
AEMaaCSのカスタム CDN設定は、オリジン設定が正しくないか、必要なヘッダーが欠落しているか、ルーティングルールが正しく設定されていないため、失敗します。 AEMでは、常にAdobeが管理するFastlyを通じてトラフィックがルーティングされるため、リクエストを受け付けるには正しいホスト名のターゲティングと特定のヘッダーが必要です。 設定が正しくないと、ルーティング エラー、SSLの不一致、および 421 や 不明なドメイン などのエラーが発生します。 オリジン設定、ヘッダー転送、およびcdn.yaml ルーティングを修正して、問題を解決し、適切なリクエストフローを復元します。
説明 description
環境
- Adobe Experience Manager as a Cloud Service （AEMaaCS）
- AEM Managed Services
- Adobe Developer App Builder
問題/症状
- Fastly 421または 不明なドメイン のエラーが発生し、AEMへのリクエストが失敗します。
- お客様のCDNは公開エンドポイントに到達できません。
- ルーティングの失敗またはSSLの不一致が発生する。
- キャッシュの不整合が表示されます。
- 必要なヘッダーが削除または上書きされると、ヘッダーベースの認証が失敗します。
根本原因
AEM as a Cloud Serviceは、パブリッシュ層に到達する前に、Fastlyを通じてすべてのトラフィックをルーティングします。 お客様のCDNからのリクエストには、適切なパブリッシュホスト名をターゲティングする際に、ホスト、SNI、X-AEM-Edge-Keyなどの必須ヘッダーを含める必要があります。 設定が見つからないか正しくない場合は、Fastlyがリクエストを拒否するか、ルーティングが失敗します。
解決策 resolution
この問題を解決するには、次の手順に従います。
- Cloud Manager環境から公開ホスト名を特定し、URLをブラウザーに直接読み込んで、403または同様の応答を返すことで検証します。 CDNまたはWAF オリジンを設定して、正確なパブリッシュホスト名を指し、SSL ハンドシェイクが成功するように、Host ヘッダー、SNI、プロトコル HTTPS、およびポート 443を設定します。
X-AEM-Edge-Key、X-Forwarded-Host、X-Forwarded-Proto、およびオプションでX-Forwarded-Forを設定して、必要なヘッダーをCDNからFastlyに転送します。これにより、Fastlyはリクエストを信頼できると認識し、ログとcurl テストを使用してヘッダー転送を検証します。- カスタムルーティングが必要な場合は、/configの下のCloud Manager Git リポジトリで
cdn.yamlファイルをコミットし、オリジン選択ルールを追加してから、Config パイプラインを実行してデプロイメントを成功させます。 - cdn.yaml request-transformation ルールを使用してgeo header injectionを設定し、
x-aem-client-countryやx-aem-client-continentなどの既存のAdobe geo ヘッダーをX-Forwarded-CountryやX-Forwarded-Regionなどのカスタムヘッダーにマッピングし、ヘッダーインスペクションを通じて変換を検証します。 - パブリックドメインをお客様のCDNに指定し、CDNがFastlyとAEMをターゲットにすることで、DNS フローを検証します。これにより、カスタムドメインのFastlyへの直接DNS マッピングを回避できます。
- Fastlyが常にお客様のCDNとAEMの間に存在し、削除またはバイパスできないことを確認してから、パブリックドメインを介してサイトにアクセスし、ブラウザー開発者ツールを使用してルーティング、ヘッダー、キャッシュ動作を検証することで、エンドツーエンドの検証を実行します。
experience-cloud-kcs-help-kbarticles