リファラーフィルター referrer-filter

Adobe Experience Manager のリファラーフィルターを使用すると、サードパーティのホストからアクセスできます。

HTTP POST 経由でヘッドレスアプリケーションの GraphQL エンドポイントにアクセスできるようにするには、リファラーフィルターの OSGi 設定が必要です。 HTTP GET 経由で AEM にアクセスする AEM ヘッドレス永続クエリを使用する場合、リファラーフィルターの設定は必要ありません。

WARNING
AEM のリファラーフィルターは OSGi 設定ファクトリではありません。つまり、AEM サービスで一度にアクティブになる設定は 1 つだけです。 可能であれば、カスタムリファラーフィルター設定を追加しないでください。これにより、AEM のネイティブ設定が上書きされ、製品の機能が損なわれる可能性があります。

これを行うには、リファラーフィルターに次の適切な OSGi 設定を追加します。

  • 信頼できる web サイトのホスト名(allow.hosts または allow.hosts.regexp)を指定する。
  • この名前のホストに対するアクセスを許可する。

ファイル名は、org.apache.sling.security.impl.ReferrerFilter.cfg.json.のように指定する必要があります。

設定例 example-configuration

例えば、リファラーが my.domain のリクエストにアクセスを許可するには、次の操作を行います。

CAUTION
これは、標準設定を上書きする基本的な例です。 製品のアップデートが常にカスタマイズに適用されるようにする必要があります。
{
    "allow.empty": false,
    "allow.hosts": [
      "my.domain"
    ],
    "allow.hosts.regexp": [
      ""
    ],
    "filter.methods": [
      "POST",
      "PUT",
      "DELETE",
      "COPY",
      "MOVE"
    ],
    "exclude.agents.regexp": [
      ""
    ]
}

データのセキュリティ data-security

CAUTION
ユーザーは、次の点に完全に対処する必要があります。

データのセキュリティを確保するには、次の点を確認する必要があります。

  • アクセスは信頼されたドメインに​ のみ ​許可する

  • ワイルドカード [*] 構文は使用​しない。ワイルドカードを使用すると、GraphQL エンドポイントへの認証済みアクセスが無効になり、エンドポイントが世界中に公開されることになります。

  • 直接的にも間接的にも、決して​機密情報を公開しない。

    • 例えば、すべての GraphQL スキーマを次のようにします。

      • 有効」になっているコンテンツフラグメントモデルから派生

      および

      • GraphQL エンドポイントを介して読み取り可能

      つまり、モデル定義のフィールド名として存在する情報を使用できるようになります。

機密データをどの手段でも利用できないことを確認する必要があるので、そのような詳細については慎重に検討する必要があります。

recommendation-more-help
experience-manager-cloud-service-help-main-toc