制限付きアクセスキー
制限付きアクセスキーを使用すると、許可されたクライアントアプリケーションは プライベートカタログビューにアクセスできます。割り当てられたキーから有効な署名済みトークンを含むリクエストのみが、カタログデータを取得できます。 匿名の買い物客、このカタログビューへのアクセスが明示的に許可されていない買い物客、APIを調査するスクリプトなど、その他のすべてのリクエストは拒否されます。
制限付きアクセスキーのユースケース
Adobe Commerce Optimizerでは、Price Book IDはリクエストに表示される価格を決定します。これは、リクエストを実行できる担当者ではなく、価格をスコープ化します。 カタログビューのIDと価格表のIDを知っているクライアントであれば誰でも、Merchandising APIを通じてそのデータを取得できます。 制限付きアクセスキーは、別個の補完的なコントロールを追加します。各アクセスキーは、どの価格表が適用されるかにかかわらず、カタログビューにまったくアクセスできる範囲を指定します。
制限付きアクセスキーは、一般的に次の目的で使用されます。
- 契約ベースのB2B価格設定 – 交渉済み価格表にリンクされたカタログ ビューを制限して、適用される購入者のみがクエリを実行できるようにします。 その他の購買組織や一般の人は利用できません。
- パートナーおよびリセラーポータル：カタログのサブセットを、マーチャンダイジング APIと直接統合する承認済みパートナーに制限します。
- プレリリースプレビュー：信頼できる内部またはパートナーのシステムが公開される前に、今後の製品をプレビューします。
制限付きアクセスキーの仕組み
制限付きアクセスキーは、RSA キーペアの公開コンポーネントです。 クライアントアプリケーションは、このキーを生成して使用し、プライベートカタログビューの読み取りが許可されていることを証明します。 このコンテキストでは、「クライアントアプリケーション」とは、買い物客を認証するバックエンドシステム（例えば、Adobe Commerceやサードパーティバックエンドのカスタムロジック）を意味します。ストアフロントフロントエンド自体は決してありません。
次の手順では、キーペアと署名済みトークンが作成から検証に移動する方法について説明します。
- クライアントアプリケーションはRSA鍵ペアを生成し、秘密鍵を保持します。
- public キーをCommerce Optimizerに制限付きアクセス キーとして登録します。
- クライアントアプリケーションは、秘密鍵を使用してJSON Web Token （JWT）に署名し、秘密鍵を使用してプライベートカタログビューへの各リクエストに含めます。
- Commerce Optimizerは、登録された公開鍵に対してトークンの署名を検証し、有効な場合は、要求されたカタログデータを返します。
制限付きアクセスキーの作成
プライベートカタログビューの最初のテストでは、OpenSSLなどのツールを使用してキーペアを生成します。 秘密鍵を秘密にしてください。公開鍵のみがCommerce Optimizerにアップロードされます。
openssl genrsa -out private-key.pem 2048
openssl rsa -in private-key.pem -pubout -out public-key.pem
キーサイズは、2048 ビットから8192 ビットの間である必要があります。 public-key.pemには、下のPublic key フィールドに貼り付けた値が含まれています。
制限付きアクセスキーをCommerce Optimizerに追加
-
Adobe Commerce Optimizer Studioの左側のメニューから、Store setupに移動し、Restricted access keysをクリックします。
-
Add Restricted Access Keyをクリックします。
-
キーの詳細を入力します。
- Title - キーを識別するためのラベル。キーリストおよびカタログ表示のキーピッカー（例：
ACME Corp wholesale portal — Tier 1 pricing）に表示されます。 - Expiration date – 有効期限がまだ切れていないトークンの場合でも、キーの処理が停止する日時（UTC）。
- Public key -
-----BEGIN PUBLIC KEY-----および-----END PUBLIC KEY-----マーカーを含む、PEMでエンコードされたRSA公開鍵をSubject Public Key Info （SPKI）形式で指定します。 環境全体で一意である必要があります。
- Title - キーを識別するためのラベル。キーリストおよびカタログ表示のキーピッカー（例：
-
Saveをクリックします。
キーは作成後に不変になります。 値を変更するには、キーを削除して新しいキーを作成します。 アクセスの中断なしでキー🔗を回転する方法については、を参照してください。
カタログビューへのキーの割り当て
制限付きアクセスキーは、Catalog Protectionが有効になっているカタログビューに割り当てられた後にのみアクセスを制限します。 設定手順については、 カタログビューの保護を参照してください。
キーの削除
-
Restricted access keys ページで、削除するキーを見つけて、Deleteをクリックします。
キーが1つ以上のカタログビューに割り当てられている場合、警告は、そのキーに依存しているクライアントアプリケーションがアクセス権を失うことを説明します。 カタログビュー自体は保護されており、一般に公開されることはありません。
-
削除を確認します。
キーの回転
アクセスを中断せずにキーを回転させるには、カタログビューに一度に最大3つのキーを割り当てることができます。
- 新しいキーペアを生成し、新しい公開鍵を新しい制限付きアクセス鍵として追加します。
- 既存のキーと並行して、新しいキーをカタログビューに割り当てます。
- 新しい秘密鍵で新しいトークンへの署名を開始して、キーロールオーバーを完了します。
- 新しいキーですべてのクライアントアプリケーションが確認されたら、古いキーを削除して削除します。
制限
カタログビューとポリシー制限を参照してください。
その他
- プライベートカタログビュー – アクセスキーが制限されたカタログビューを保護する方法について説明します。