B2B共有カタログの制限付きアクセスキーの管理
[Private Beta]{class="badge yellow" title="現在プライベートベータ版のAdobe Commerce Optimizer Connector B2B拡張機能が必要です。"}
Adobe Commerce個のB2B共有カタログをAdobe Commerce Optimizer Connector B2B extensionと共に使用する場合、カタログ ビューの作成時に、拡張機能が自動的に最初の制限付きアクセス キーを生成して割り当てます。 Commerce管理者のRestricted Access Keys ページを使用して、そのキーを表示し、追加のキーを作成、割り当て、または削除します。
ページへのアクセス access-the-page
Commerce管理者から、System > Data Transfer > Restricted Access Keysに移動します。
共有カタロググリッドまたは会社グリッドからカタログビューにキーを割り当てることができます。 「B2B共有カタログビューにキーを割り当てる」を参照してください。
自動キー以上のものが必要な場合 when-you-need-more-than-the-automatic-key
Adobe Commerce Optimizer Connector B2B extensionによって生成された自動キーは、ユーザーの操作を必要とせずに、ほとんどのB2B共有カタログをカバーします。 以下の場合は、自分でキーを管理します。
- キーの回転 – 新しいキーを作成し、既存のキーと並行してカタログビューに割り当て、機能していることを確認してから、古いキーを削除します。 自動回転はまだ利用できません。
- キーがリンクに失敗しました- カタログ ビュー同期ステータス にキー関連のドリフトが表示される場合は、カタログ ビューの割り当てを再度保存して、失敗したリンクを再試行してください。 それでもキーが失敗する場合は、Reconcile & Repairを実行してキーまたはステータスを回復してから、置換を作成します。 キーの有効期限が切れているか、障害が永続的に回復不能な場合にのみ、置換キーを作成します。
- 公開鍵を検索 – 制限付きアクセスキーのページで、View Public Keyを選択して、キーの公開鍵を表示およびコピーします。
カタログビューには、一度に最大3つのキーを割り当てることができます。 キーのローテーション中、Adobe Commerce Optimizerは、割り当てられた、期限切れでないキーによって署名されたトークンを受け入れます。「アクティブ」キーを設定する手作業はありません。
キーを作成
Restricted Access Keys ページで、Create Keyを選択してキーを作成します。
Commerceは新しいキーペアを生成し、秘密鍵を保持します。 制限付きアクセスキーのテーブルは、一意のキーIDを示す新しいキーのエントリで更新されます。 このKey IDは、カタログ ビューにキーを割り当てる場合に使用します。
カタログ ビューにキーを割り当てるまで、公開鍵はAdobe Commerce Optimizerに登録されません。 登録後、アクセス制限キーのテーブルエントリが更新され、カタログの割り当てと有効期限が表示されます。
B2B共有カタログから投影されたカタログビューにキーを割り当てる assign-keys-to-a-shared-catalog-view
メインのRestricted Access Keys グリッドからではなく、会社アカウントまたは共有カタログページからカタログビューにキーを割り当てるか、割り当て解除します。
カタログビューには、少なくとも1つのキーを持ち、最大3つのキーを持つことができます。
- 4つ目のキーを割り当てようとすると、値
A Catalog View can have at most 3 access keys.を保存しようとするとエラーメッセージが表示されます - カタログビューにキーが1つしかない場合、そのキーを削除したり、割り当てを解除したりすることはできません。
カタログビューキー設定を更新するには、会社アカウントページまたは共有カタログページからアクセスできます。
-
Commerce管理者から、会社ページ （Customers > Companies）を開きます。
-
会社のAction列で、Editを選択します。
-
会社に割り当てられた共有カタログから予測されるカタログビューのリストを表示するには、Catalog Viewsセクションを展開します。
このタブには、割り当てられたキーを含め、共有カタログから投影されたカタログビューが一覧表示されます。
-
更新するカタログ ビューのActions列で、Edit Restricted Access Keysを選択します。
-
キーを割り当てるには、Access Keys ドロップダウンリストを選択します。 次に、key IDによって割り当てられていないキー（例：
#42）を選択します。 次に、Doneをクリックして、カタログ ビューに割り当てます。別のカタログビューに既に割り当てられているキーには、それに応じてラベルが付けられます。
-
アクセストークンを削除するには、キーラベルの
xコントロールを選択して、Access Tokens フィールドからアクセストークンを削除します。 -
構成更新を保存して適用するには、Saveを選択します。
-
Commerce管理者から、共有カタログページ（Catalog > Shared catalogs）を開きます。
-
共有のAction列で、Select メニューから General Settings を選択します。
-
共有カタログから投影されたカタログビューのリストを表示するには、Shared Catalog Information メニューから Catalog Views を選択します。
Catalog Views ページには、各カタログビューのカタログビューID、関連付けられたストアビュー、およびアクセスキーが一覧表示されます。
-
更新するカタログ ビューのActions列で、Edit Restricted Access Keysを選択します。
-
キーを割り当てるには、Access Keys ドロップダウンリストを選択します。 次に、デフォルトのキータイトル（例：
#42）で未割り当てのキーを選択します。 次に、Doneをクリックして、カタログ ビューに割り当てます。別のカタログビューに既に割り当てられているキーには、それに応じてラベルが付けられます。
-
アクセストークンを削除するには、キーラベルの
xコントロールを選択して、Access Tokens フィールドからアクセストークンを削除します。 -
構成更新を保存して適用するには、Saveを選択します。
キーの有効期限と更新を管理
制限付きアクセスキーのデフォルトのキーの有効期間を設定できます。 値は、Adobe Commerce Optimizer Connector B2B拡張機能が初期キーを生成する場合、または新しいキーを手動で作成する場合に、有効期限セットを決定します。
有効期限は、Restricted Access Keys ページのExpires At列に表示されます。
期間を変更するには、Stores > Settings > Configuration > Services > ACO Restricted Access Keysに移動します。 Provisioning ページで、Default Key Expiry (days) フィールドを更新します。 デフォルトのシステムキーの有効期間は、最初は長期（約100年）に設定されます。 セキュリティポリシーに一致する値に更新してください。
キーの更新
キーの有効期限が10日以内の場合、Restricted Access Keys ページには、そのエントリの横に警告アイコンが表示されます。 有効期限が切れる前にキーを更新しないと、新しいキーを割り当てるまでカタログビューにアクセスできなくなります。
新しいキーはいつでも作成して割り当てることができ、新しいキーが機能していることを確認した後に古いキーを削除できます。
既知の制限事項
自動キーローテーションはまだ利用できません。