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

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

デフォルトでは、​ カタログビューはパブリックです。 カタログビューへのアクセスを制限して、有効な署名済みトークンを持つリクエストのみがデータを取得できるようにします。

カタログビューは、次の2つの方法のいずれかで非公開になります。

  • [Private Beta]{class="badge yellow" title="現在プライベートベータ版のAdobe Commerce Optimizer Connector B2B拡張機能が必要です。"} 自動的に、B2B共有カタログ​の場合 – Adobe Commerce Optimizer Connector統合とB2B拡張機能を使用するCommerce デプロイメントの場合、Adobe Commerceの共有カタログ設定に基づいて、プライベートカタログビューが自動的に作成および設定されます。 B2B共有カタログの自動プライベートカタログビューを参照してください。

  • 手動で、任意のカタログ ビュー—B2C カタログ ビューを含め、パブリックになるカタログ ビューへのアクセスを制限するには、​ カタログ ビューを保護の手順に従います。 パートナーポータルやプレリリースプレビューなどの例については、​ アクセス制限キーのユースケース ​を参照してください。

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

保護範囲の理解

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

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

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

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

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

​ プライベートカタログビューの価格表制限

  • 複数の価格表が割り当てられているカタログ ビューでCatalog Protectionを有効にする場合、1つの価格表を除くすべての価格表を削除するまで、ビューを保存できません。
  • この制限が存在する前に、複数の価格表の割り当てがあるプライベートカタログビューを以前に保存した場合、カタログビューの設定は自動的には変更されません。 ただし、次回ビューを編集する際は、更新を保存する前に、1つを除くすべての価格表を削除する必要があります。

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

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

B2B共有カタログの自動プライベートカタログビュー

[Private Beta]{class="badge yellow" title="現在プライベートベータ版のAdobe Commerce Optimizer Connector B2B拡張機能が必要です。"}

共有カタログをサポートするためにAdobe Commerce Optimizer Connector for B2Bと統合されたデプロイメントの場合、拡張機能は、Adobe Commerceの共有カタログ設定に基づいて、プライベートカタログビューを自動的に作成および設定します。 この設定には、カタログビュー、ポリシー、初期アクセス制限キー、価格表の参照が含まれます。 この設定では、制限付きアクセスキーをCommerce管理者​制限付きアクセスキー ページ (システム > データ転送)から管理します。 詳しくは、Adobe Commerce Optimizer Connector統合ガイド​のB2B共有カタログの変更を参照してください。

B2B共有カタログを使用していない場合(例えば、パートナーポータルやプレリリースプレビューのカタログビューを保護する場合など)、​ カタログビューを保護の手順を使用して手動で設定します。

カタログビューの保護

NOTE
Adobe Commerce Optimizer Connector for B2Bによって管理されるB2B共有カタログに関連付けられているカタログ ビューについては、この手順をスキップしてください。 B2B共有カタログの自動プライベートカタログビューを参照してください。

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

  1. カタログビューのフォームの作成または編集で、Catalog Protection​を​ Enabled ​に切り替えます。

  2. Restricted Access Keys​で、このカタログ ビューに割り当てるアクセス キー🔗を3つまで選択してください。

    ​ カタログ保護がカタログビュー編集フォームで有効になっており、アクセス制限キーが割り当てられている {width="70%" modal="regular"}

  3. Save catalog view​をクリックします。

    これで、カタログ ビューが保護されました。 割り当てられたキーから有効な署名されたトークンを持つリクエストのみが、そのデータを取得できます。

    note
    NOTE
    カタログ保護の設定変更を有効にするには、最大5分かかります。

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

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

ヘッダー
目的
AC-View-ID
クエリするカタログビュー。
AC-Price-Book-ID
適用する価格表。
AC-Catalog-View-Access-Token
カタログビューの認証を証明する署名済みJWT。

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

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

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

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

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

NOTE
Adobe Commerce Optimizer Connector for B2B拡張機能と統合されたデプロイメントの場合、Commerce管理者​制限付きアクセスキー ページ (システム > データ転送)からアクセスキーを管理します。 詳しくは、Adobe Commerce Optimizer Connector統合ガイド​の「制限付きアクセスキー管理」を参照してください。

その他

  • ​ カタログビュー - カタログビューが、ビジネス構造、ポリシー、価格によって商品カタログをどのように整理するかを説明します。
  • 制限付きアクセス キー - カタログ保護のトークンの署名に使用するキーを作成、割り当て、回転します。
recommendation-more-help
commerce-help-optimizer