[SaaSのみ]{class="badge positive" title="Adobe Commerce as a Cloud Serviceおよび Adobe Commerce Optimizer プロジェクトにのみ適用されます（Adobeで管理されるSaaS インフラストラクチャ）。"}

プライベートカタログビュー

デフォルトでは、​ カタログビューはパブリックです。 カタログビューでカタログ保護を有効にして、有効な署名済みトークンを含むリクエストへのアクセスを制限します。

カタログ保護は、選択したカタログビューにのみ適用されます。 ビューのポリシー、レイヤー、価格表は変更されません。

カタログビューを保護するタイミングの例については、​ アクセス制限キーの使用例を参照してください。

保護範囲の理解

カタログ保護は、有効になっているカタログビューにのみ適用されます。 カタログと検索リクエストを保護しますが、ビューのポリシーや価格表の変更、他のカタログビューの保護、カート、チェックアウト、注文操作の保護は行いません。

連続性のあるコマースのバックエンドでは、独自に購入資格を適用する必要があります。

カタログビューの保護

開始する前に、クライアントアプリケーションが生成する公開鍵から制限付きアクセスキーを作成します。

アクセスが強制されていることを確認する

プライベートカタログビューが不正なリクエストを拒否することを確認するには、次のヘッダーを使用して、署名されたトークンの有無にかかわらずGraphQL エンドポイント ​を呼び出します。

有効なトークンのないリクエストは、カタログデータではなくGraphQL エラーを返します。例：

{
  "errors": [
    {
      "message": "Access key validation failed: Missing token",
      "extensions": { "x-commerce-exception": "access-key-invalid" }
    }
  ]
}

割り当てられた、期限切れでないキーによって署名されたトークンを含むリクエストは、期待どおりにカタログデータを返します。 JWTへの署名とマーチャンダイジング APIの呼び出しについて詳しくは、開発者ドキュメント ​を参照してください。

制限付きアクセスキーの管理

Catalog Protectionが有効になっていて、割り当てられたすべてのキーの有効期限が切れると、カタログビューにアクセスできなくなります。このカタログビューに依存するストアフロントは、そのカタログビューからデータを提供できません。 新しい期限切れでないキーを割り当てて、アクセスを復元します。 手順については、​ キーの回転を参照してください。

その他