IMS 資格情報を使用した web API トークンの生成
Commerce インスタンスでAdobe IMSによる管理者認証が有効になっている場合、Commerce管理 API は影響を受けます。 管理者ユーザーは、Commerce インスタンスが発行した資格情報を使用できなくなります。 これらは、管理者にログインし、サービスが管理者の REST API およびSOAP API にリクエストを行うために使用できるアクセストークンを取得するために必要な資格情報です。
Adobe IMS統合が有効になると、管理者ユーザーは、認証を必要とするAdobe Commerce API エンドポイントに対して 🔗0}Adobe IMS OAuth トークン } を使用する必要があります。 クライアントソリューションは、web API で使用するためにトークンを動的に取得します。 この認証メカニズムは、この統合の設定の一環として、REST およびSOAP web API 領域に対して有効になっています。
Web API でのCommerce アクセストークンの使用方法(IMS アクセストークンを含む)の概要については、 トークンベースの認証を参照してください。
Commerce セッション管理およびAdobe IMSアクセストークン
アクセストークンには、ユーザー資格情報とログインセッション情報の両方が格納されます。 ユーザーが認証され、セッションが開始されると、次の 2 つの変数がユーザーのセッションに追加されます。
token_last_check_time
。 現在の時刻を識別し、\Magento\AdminAdobeIms\Plugin\BackendAuthSessionPlugin
プラグインで使用されます。
adobe_access_token
– 認証中に受け取った ACCESS_TOKEN
値を識別します。
\Magento\AdminAdobeIms\Plugin\BackendAuthSessionPlugin
プラグインは、token_last_check_time
が 10 分前に更新されたかどうかを確認します。 10 分前に token_last_check_time
がチェックされた場合、認証ワークフローは IMS への API 呼び出しを行い、アクセストークンを検証して、セッションを続行します。 アクセストークンが有効な場合、token_last_check_time
値は現在の時刻に更新されます。 トークンが無効な場合、セッションは終了します。
重要なファイル
adminAdobeIms
- AdobeImsApi
モジュールに基づく Admin ログインの実装を提供します。
admin_adobe_ims_webapi
– 検証済みのすべてのアクセストークンの記録を保持します。 トークンが検証または無効化されると、そのステータスの記録がこの表に保持されます。
adobeIms
- Adobe IMSとの統合に関連するすべてのビジネスロジックを実装します(後方非互換性を防ぐために保持されます)。
adobeImsApi
- Adobe IMSとの統合をサポートするインターフェイスを宣言します。
adminadobe-ims.log
- エラーログファイル。
統合の有効化
Adobe IMSメタパッケージは、Adobe Commerce 2.4.5 以降でインストールされますが、使用するように設定する必要があります。 AdobeIms
モジュールを拡張して、認証ロジック(AdminAdobeIms
)を有効にするモジュールをサポートします。
Adobe IMSの有効化について詳しくは、 統合を使用したCommerce Admin 統合の設定を参照してください。