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

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

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

カタログ保護は、選択したカタログビューにのみ適用されます。 ビューのポリシーやレイヤーは変更されません。 ビューを単一の価格表に制限します。​ プライベートカタログビューの価格表制限を参照してください。

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

保護範囲の理解

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

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

プライベートカタログビューに対する価格表の制限

プライベートカタログビューでは、1つの価格表のみを参照できます。 これは、複数の価格表を使用できるパブリックカタログビューとは異なります。

Catalog Protectionが有効になっている場合、カタログビューフォームの価格表セレクターは、複数選択コントロールから単一選択（ラジオボタン）コントロールに切り替わります。

これらのケースのそれぞれで、Adobe Commerce Optimizerは次の検証メッセージを表示します：A protected catalog view can use only one price book. Select 'Single price book only' to continue.

パブリックカタログビューは、この制限の影響を受けず、複数の価格表を引き続き参照できます。

カタログビューの保護

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

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

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

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

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

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

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

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

その他