[僅限SaaS]{class="badge positive" title="僅適用於Adobe Commerce as a Cloud Service和 Adobe Commerce Optimizer 專案（Adobe管理的SaaS基礎結構）。"}

受限制的存取金鑰

最後更新： 2026年8月10日

建立對象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

受限制的存取金鑰可讓授權的使用者端應用程式存取私人目錄檢視 — 只有從指派的金鑰中攜帶有效已簽署權杖的請求才能擷取目錄資料。所有其他請求都遭到拒絕，包括來自匿名購物者、未明確獲得此目錄檢視存取權的購物者，以及探索API的指令碼。

限制存取的關鍵使用案例

在Adobe Commerce Optimizer中，Price Book ID會決定要求可以看到的價格 — 其範圍是定價，而非誰可以提出要求。任何知道目錄檢視ID和價格簿ID的使用者端都可透過Merchandising API擷取該資料。限制存取金鑰可新增個別的補充控制：限制存取金鑰可限定存取目錄檢視的使用者範圍，且不受價格簿所套用。

受限制的存取金鑰通常用於：

合約式B2B定價 — 限制連結至議價價格簿的目錄檢視，以便只有適用它的買方可以查詢它。其他購買機構和公眾則不能。
合作夥伴與經銷商入口網站 — 將目錄的子集限製為直接與銷售API整合的已核准合作夥伴。
發行前預覽 — 讓受信任的內部或合作夥伴系統先預覽即將推出的產品，然後再公開顯示。

IMPORTANT

金鑰產生、權杖簽署和輪換目前完全由驗證購物者的後端使用者端應用程式管理。 Adobe Commerce Optimizer不會代表您產生或旋轉這些金鑰。

受限制的存取金鑰如何運作

受限制的存取金鑰是RSA金鑰組的公開元件。您的使用者端應用程式會產生並使用此金鑰來證明其已獲得讀取私人目錄檢視的授權。在此內容中，「使用者端應用程式」是指可驗證購物者的後端系統（例如，Adobe Commerce上的自訂邏輯或第三方後端），而不是店面前端本身。

下列步驟說明金鑰組與簽署的權杖如何從建立移至驗證：

您的使用者端應用程式會產生RSA金鑰組並保留私密金鑰。
您在Commerce Optimizer中將公用金鑰註冊為受限制的存取金鑰。
您的使用者端應用程式會使用私密金鑰簽署JSON Web權杖(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。

{width="70%" modal="regular"}
按一下Add Restricted Access Key。
輸入金鑰詳細資料：

{width="70%" modal="regular"}
- Title — 識別索引鍵的標籤，顯示在索引鍵清單和目錄檢視索引鍵選擇器中，例如ACME Corp wholesale portal — Tier 1 pricing。
- Expiration date — 停止接受金鑰的日期和時間(UTC)，即使對於尚未過期的權杖亦然。
- Public key — 主體公開金鑰資訊(SPKI)格式的PEM編碼RSA公開金鑰，包括-----BEGIN PUBLIC KEY-----和-----END PUBLIC KEY-----標籤。在整個環境中必須是唯一的。
按一下Save。