Commerce Services Connector
Adobe CommerceとMagento Open Sourceの一部の機能は Commerce Services を利用し、SaaS （software as a service）としてデプロイされます。 これらのサービスを使用するには、実稼動およびサンドボックス API キーを使用して Commerce インスタンスを接続し、configuration でデータ領域を指定する必要があります。 接続はインスタンスごとに 1 回だけ設定する必要があります。
これらの API キーを生成できるのは Commerce ライセンス所有者のみです。 ライセンス所有者でない場合は、ストアのCommerce ライセンスを所有するユーザーまたはチームにキーをリクエストしてください。
利用可能なサービス availableservices
Commerce からアクセスできる Commerce Services Connector の機能は次のとおりです。
アーキテクチャ
大まかに言えば、Commerce Services Connector は次のコア要素で構成されています。
次のセクションでは、これらの各要素について詳しく説明します。
資格情報 apikey
実稼働およびサンドボックスの API キーは、Commerce ライセンス所有者 の アカウントから生成されます。 Commerce アカウントは、一意の Commerce ID （MageID）で識別されます。 加盟店の組織のライセンス所有者は、アカウントが正常に動作している限り、製品レコメンデーションやライブ検索などのサービスの API キーを生成できます。
キーは、ライセンス所有者の代わりにプロジェクトや環境を管理するシステムインテグレーターまたは開発チームと、「必要な情報」ベースで共有できます。 ライセンス所有者から Shared Access を付与された開発者は、マーチャントの組織がアカウントの Switch Accounts ドロップダウンに存在する場合でも、ライセンス所有者に代わってキーを生成することはできません。
さらに、ソリューションインテグレーターは Commerce Services を使用する資格があります。 ソリューションインテグレーターの場合は、Commerce パートナー契約の署名者が API キーを生成する必要があります。
キー ID 実稼動環境 および サンドボックス とは、（Adobe Commerce環境ではなく）データを保存 Commerce Services る SaaS データスペース環境を指します。 ローカル、開発、ステージング、実稼動のAdobe Commerce環境で同じ API キーセットを使用できます。重要なのは、設定するデータ領域に正しいキーペアを貼り付けることです。
ライセンスオーナーは通常、Adobe Commerce アカウントのプライマリ連絡先であり、クラウドインフラストラクチャプロジェクトにおけるAdobe Commerceのプロジェクトオーナーと同じでないことがあります。
実稼動およびサンドボックス API キーの生成 genapikey
-
Commerce アカウント（https://account.magento.com）にログインします。
-
「Magento」タブで、サイドバーの API ポータル を選択します。
-
環境 メニューから、「実稼動」または「サンドボックス」を選択します。
-
API キー セクションに名前を入力し、新規追加 をクリックして、新しいキーをダウンロードするためのダイアログを開きます。
note warning WARNING 秘密鍵は 1 回だけコピーまたはダウンロードできます。 安全に保存します。 -
「ダウンロード」をクリックして秘密鍵を保存し、ダイアログを閉じます。
-
各環境（実稼動環境とサンドボックス）で上記の手順を繰り返します。
API キー セクションに API （公開）キーが表示されるようになりました。 ライセンスに関連付けられたいずれかの環境またはインストールで SaaS プロジェクトを選択または作成 する場合、4 つのキー（実稼動鍵とサンドボックス鍵の両方、公開鍵と秘密鍵）がすべて必要です。
SaaS 設定 saasenv
Commerce インスタンスは、データを適切な場所に送信できるように、SaaS プロジェクトと SaaS データ領域を使用して設定する必要が Commerce Services ります。 SaaS プロジェクトは、すべての SaaS データ スペースをグループ化します。 SaaS データ スペースは、Commerce Services ーザーが作業できるようにするデータの収集および保存に使用されます。 このデータの一部は Commerce インスタンスから書き出され、一部はストアフロントの買い物客の行動から収集される場合があります。 そのデータは、セキュリティで保護されたクラウドストレージに保持されます。
Product Recommendations および Live Search の場合、SaaS データ スペースには、カタログおよび行動データが含まれています。 Commerce 設定で 選択 することにより、Commerce インスタンスを SaaS データ空間にポイントできます。
管理者に Live Search 設定フィールドが見つからない場合は、選択したデータスペースに対して正しい API キーペアを入力したことを確認します（実稼動データスペースは実稼動キーを使用し、テスト データスペースはサンドボックスキーを使用します）。 誤ったキーを設定した場合、そのAdobe Commerceでは Live Search などの SaaS サービスを利用できません。
API キーの削除 delapikey
API キーを削除する前に、置き換えキーを生成して安全に保存します。 すべての統合を更新して新しいキーを使用し、依存するサービスが期待どおりに動作していることを確認します。
管理パネルに設定フィールド Live Search 表示されない場合は、その環境の正しい SaaS API キーを入力したことを確認してください。 実稼動データ領域には実稼動 SaaS キーを使用し、ステージングデータ領域にはステージングキーを使用します。 間違ったキーが設定されている場合、SaaS サービス（Live Search を含む）はAdobe Commerce環境で使用できません。
削除する API キーで、「削 Delete」をクリックします。 プロンプトが表示されたら、キーを完全に削除する操作を確認します。
SaaS データ領域のプロビジョニング
すべてのAdobe Commerce マーチャントは、SaaS プロジェクトごとに 1 つの実稼動データスペースと 2 つのテストデータスペースにアクセスできます。
非実稼動環境でテスト用データスペースを使用できますが、複数の環境で同じデータスペースを同時に使用しないでください。 テスト用のデータ領域を別の環境に移動する場合は、新しい環境で選択して設定する前に、データのクリーンアップを実行します。
複数のステージング環境を使用する Adobe Commerce Cloud Pro プロジェクトの場合は、 サポートリクエストを送信 することで、ステージング環境ごとに追加のテストデータスペースをリクエストできます。 ただし、ステージング環境が 1 つのみで、追加のテストデータスペースが必要な場合は、次のオプションがあります。
-
追加のステージング環境をリクエストする場合は、カスタマーサクセスチームまたは担当のカスタマーサクセスマネージャーにお問い合わせください。
-
サポートリクエストを送信 して、追加のテストデータスペースをリクエストし、その追加データスペースのビジネス上の正当性を示します。 このリクエストは承認される場合があります。
Adobe支払いサービスを利用しているMagento Open Sourceのお客様は、追加のデータスペースをリクエストする場合もあります。 テストデータスペースをリクエストするには、 サポートリクエスト を送信する前に、支払いチームに追加のデータスペースに関する事前承認を問い合わせてください。
複数のクラウドプロジェクトまたはオンプレミス（実稼働/実稼働）インストールを所有しているお客様は、 サポートリクエストを送信 することで、各プロジェクトまたはインスタンスに対して追加の実稼働およびテスト用データスペースをリクエストすることもできます。
SaaS プロジェクトの選択または作成 createsaasenv
SaaS プロジェクトを選択または作成するには、ストアの Commerce ライセンス所有者に Commerce API キーをリクエストします。
-
管理者 サイドバーで、システム/サービス/Commerce サービスコネクタ に移動します。
Commerce Services Connector のセクションが表示されない場合は、目的の Commerce サービス Commerce の モジュールをインストールし、
magento/module-services-idパッケージがインストールされていることを確認します。 -
Sandbox API KeysセクションとProduction API Keys セクションに、キー値を貼り付けます。
- 秘密鍵は、鍵の先頭に
-----BEGIN PRIVATE KEY-----、鍵の末尾に-----END PRIVATE KEY-----を含める必要があります。 - 実際のキーのコピーがない場合は、ライセンス所有者に問い合わせて、値を設定にプラグインします。
データベースのバックアップまたはスナップショットからコピーしたキー値を貼り付けないでください。 設定を保存すると、追加の暗号化レイヤーが適用され、キーは機能しません。
- 秘密鍵は、鍵の先頭に
-
保存 をクリックします。
キーに関連付けられている SaaS プロジェクトは、[SaaS Identifier] セクションの [プロジェクト] フィールドに表示されます。
-
SaaS プロジェクトが存在しない場合は、[プロジェクトの作成] をクリックします。 次に、プロジェクト フィールドに、SaaS プロジェクトの名前を入力します。
混乱を避けるために、特定のCommerce サービスをプロジェクトの名前として使用しないでください（例：Live Search、Product Recommendations、Data Connection）。 ライセンスが複数の SaaS プロジェクト用にプロビジョニングされていない限り、複数のサービスに同じ SaaS プロジェクトを使用できます。
-
ストアの現在の設定に使用する データスペース Commerce を選択します。
Commerce サービスと統合するための個別のインスタンスがある場合は、 サポートチケットを送信 して、追加のインスタンスごとに新しい SaaS プロジェクトをリクエストします。 サポートが SaaS プロジェクトを作成したら、同じ API キーを使用してインスタンスの統合を設定し、データ空間用の新しい SaaS プロジェクトを選択します。
SaaS プロジェクトまたはデータ領域の名前を変更するには、どちらかの横にある 名前の変更 をクリックします。 名前を変更しても、サービスには影響しません。名前は、プロジェクトとデータ スペースを識別および区別するのに役立つラベルにすぎないからです。
IMS 組織（オプション） organizationid
Adobe Commerce インスタンスをAdobe Experience Platformに接続するには、Adobe IDを使用してAdobe アカウントにログインします。 ログインすると、Adobe アカウントに関連付けられた IMS 組織がこのセクションに表示されます。
SaaS データのエクスポート
Commerce インスタンスが Commerce Services に正常に接続されると、SaaS データ書き出しプロセスによって、Commerce データが Commerce サーバーから Commerce SaaS Services に書き出され、接続されたCommerce Services に同期できるようになります。 管理者では、 データ管理ダッシュボード を使用して、同期ステータスを確認できます。 詳細については、「SaaS データ書き出しガイド 」を参照してください。