ドキュメントExperience Cloud KCS

AEMaaCSでX-AEM-Edge-Keyを生成してデプロイする

最終更新日： 2026年9月3日

この記事では、Adobe Experience Manager as a Cloud Service環境用にX-AEM-Edge-Keyを生成、設定、デプロイする手順を説明します。 また、複数のドメインをまたいでキーを使用し、Cloud Managerを通じてデプロイする方法についても説明します。

説明 description

環境

Adobe Experience Manager as a Cloud Service（AEMaaCS）（すべてのバージョン）

問題/症状

  • 新しいステージング環境または実稼動以外の環境に対してX-AEM-Edge-Keyを設定する必要があります。
  • 同じ環境内の複数のドメインに対して同じエッジキーを使用する際の不確実性。
  • Cloud Managerで実稼動以外のパイプラインを作成する場合、Configのデプロイメントオプションが表示されず、必要なCDN設定のデプロイメントが妨げられます。

原因

お客様はX-AEM-Edge-Keyを管理し、Cloud ManagerのConfig パイプラインを通じて設定およびデプロイする必要があります。 環境ごとに1つのConfig パイプラインのみが許可され、キーは個々のドメインではなく環境に適用されます。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. X-AEM-Edge-Keyを生成します。

    1. 安全なランダムジェネレーターを使用して、32 バイトの16進数文字列を作成します。 例：openssl rand -hex 32
    2. 生成された値をX-AEM-Edge-Keyとして使用します。

  2. Cloud Managerでシークレット環境変数を作成します。

    1. Cloud Managerで、CDN_EDGEKEY_<date>などのシークレット環境変数をターゲット環境に追加します。
    2. 生成されたエッジキーにその値を設定します。

  3. CDN設定でシークレットを参照します。

    1. リポジトリで、config/staging/cdn.yamlなどの適切な設定パスにCDN設定ファイルを追加または更新します。
    2. YAML ファイル内の秘密変数を参照します。 例：edgeKey1: ${{CDN_EDGEKEY_<date>}}

  4. 設定パイプラインを使用してCDN設定をデプロイします。 メモ：環境ごとに存在できる構成パイプラインは1つだけです。 Config オプションが表示されない場合は、Config パイプラインが既に環境をターゲットにしているかどうかを確認します。 設定パイプラインが存在しない場合は、Adobe サポートに連絡してオプションを有効にします。

    1. Cloud Managerで、Config パイプラインが環境をターゲットにしていることを確認します。

    2. 設定パイプラインが既に存在する場合は、次の設定を使用するように編集します。

      • リポジトリ：お使いのAEM リポジトリ
      • 分岐：開発ブランチ（devなど）
      • コードの場所： configまたは適切なサブフォルダー

    3. ​​​​​パイプラインを実行して、cdn.yaml設定をAdobe CDNにデプロイします

  5. 外部CDNを設定します。

    • パブリッシュインスタンスにトラフィックを転送する場合は、次のヘッダーを設定します。

      • Host：公開インスタンスのホスト名
      • X-Forwarded-Host：あなたのドメイン
      • X-AEM-Edge-Key：生成されたエッジ キー

  6. 設定を確認します。

    1. デプロイメント後、外部CDNからAEMに転送されるリクエストに正しいX-AEM-Edge-Keyが含まれていることを確認します。
    2. Adobe CDNがリクエストを受け入れることを確認します。
recommendation-more-help
experience-cloud-kcs-help-kbarticles