AEM CloudおよびAMS環境でのCDN ドメインリダイレクトとルーティングの問題
Adobe Experience Manager(AEM)では、ドメインが正しくマッピングされない、またはサポートされていない設定や前提条件が欠落しているためリダイレクトが失敗した場合、ドメインリダイレクトとルーティングの問題が発生します。 これは、リダイレクト動作がCDN、Dispatcher、AEMなどの実行レイヤーに依存し、ワイルドカードドメインのサポートの欠如や必要なSSL設定などの制限が原因で発生します。 この問題を解決するには、適切なリダイレクトメカニズムを特定し、AEM ランタイムに基づいてドメイン登録、SSLおよびリダイレクトルールを設定します。
説明 description
環境
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- Adobe Managed Services(AMS)
- Adobe Experience Manager(AEM)オンプレミス
問題/症状
- ドメインは常に、意図したページではなくサイトルートに解決されます。
- リダイレクトは、ホストヘッダーの動作が正しくないため、無限ループになります。
- ドメインがCloud Managerに登録されていないため、リダイレクトはトリガーしません。
- ワイルドカードサブドメイン (
*.example.com)を追加できず、トラフィックが失敗します。 - 設定の構文が無効なため、CDN パイプラインのデプロイメントに失敗します。
根本原因
リダイレクトの動作は、リダイレクトの実行場所(CDN、Dispatcher、AEMなど)によって異なります。 AEM as a Cloud Serviceでは、CDN処理に明示的なドメイン登録と有効なSSL証明書が必要です。 ワイルドカードドメインマッピングはサポートされておらず、リダイレクトルールまたはホストヘッダーの設定が正しくないと、エラーまたはループが発生します。
解決策 resolution
ドメインベースのリダイレクトとルーティング動作を正しく設定するには、次の手順に従います。
- AEMがリクエストを処理する前にリダイレクトを実行する必要があるか、AEMに到達した後にリダイレクトを実行して正しい実行レイヤーを決定する必要があるかを特定します。
- AEM as a Cloud Serviceのドメイン間ルーティングには、CDN リダイレクトを使用します。
- Adobe Managed Servicesまたはオンプレミス環境では、DispatcherまたはApacheの書き換えルールを使用します。
- AEMがサポートしていない動的ワイルドカードサブドメインが要件に含まれる場合は、外部リダイレクトサービスを使用します。
- Edge Delivery Servicesを使用する場合、アプリケーションレイヤーでは正確なパスの一致のみがサポートされるため、ホストレベルのルーティングにCDN ベースのリダイレクトを使用します。
AEM as a Cloud Service (AEMaaCS)の場合
- Cloud Managerを開き、Environmentsに移動し、Domain Managementにアクセスして、リダイレクトに必要なすべてのドメインを追加します。
- 非www ドメインを含む各ドメインの有効なSSL証明書をアップロードして設定します。
- 各ドメインに有効な証明書を含むアクティブなステータスが表示されていることを確認します。
- リポジトリルートで
cdn.yamlファイルを作成または更新して、リダイレクトルールを定義します。 - 必要なステータスコードと宛先パスまたはURLを含むホストベースの条件を使用して、リダイレクトルールを定義します。
- Cloud Manager設定パイプラインを実行してCDN ルールをデプロイし、デプロイメントが正常に完了したことを検証します。
- パイプラインログを確認し、ルール構造を修正することで、設定ファイル内の構文エラーを修正します。
- 該当する場合、サポートされている一致条件を使用して、パターンベースのリダイレクトを設定します。
- ワイルドカードホスト名はサポートされていないため、CDN ルールで使用しないでください。
Adobe Managed Services (AMS)またはオンプレミス の場合
- DispatcherまたはApache設定ファイルに書き換えルールを追加して、ドメインレベルのリダイレクトを実装します。
- 適切なルーティングを有効にするために、各ドメインまたはサブドメインの仮想ホストエントリを設定します。
- 各ドメインまたはサブドメインを適切なAEM サイトルートにマッピングします。
- 仮想ホストの設定により、ドメインの解決と優先順位付けが正しく行われることを検証します。
Edge Delivery Services (EDS)の場合
アプリケーションレベルで一致する正確なパスに対してのみリダイレクトを設定し、CDN レイヤーでホストベースのリダイレクトを処理します。
検証:
- curlなどのツールを使用してHTTP リクエストを実行し、応答に正しいリダイレクトステータスとロケーションヘッダーが含まれていることを確認します。
- CDN ログまたはデプロイメントの結果を確認して、リダイレクトルールが正しく実行されていることを確認します。
- リクエスト間で一貫したホストと転送ホストの動作を確保することで、リダイレクトループが発生しないことを確認します。
エスカレーションするタイミング:
- リダイレクト動作は、正しいリダイレクトメカニズムを実装した後に、想定されるロジックと一致しません。
- 未解決の検証または構文エラーにより、CDN設定のデプロイメントが失敗します。
- 適切な登録と有効なSSL証明書にもかかわらず、ドメインがルーティングされない。
- ホストヘッダーの不整合により、リダイレクトループが保持されます。
- ワイルドカードまたはダイナミックドメインルーティングの要件は、サポートされているAEM機能を使用して実装することはできません。
関連トピックス
- AEMaaCS CDN設定
- AEM ドメイン マッピング
- Dispatcher Configuration
- AEM as a Cloud ServiceのCDN
- AEM as a Cloud Service リリースノート (2023.11.0)
recommendation-more-help
experience-cloud-kcs-help-kbarticles