信頼できる代理エージェント (Trusted Agent On Behalf (TAOB)) 認可では、エージェントが登録済みの買い物客またはゲスト買い物客に代わってアクションを実行できます。
デフォルトでは、買い物客の追跡環境設定はすべての TAOB フローで無効になっています。つまり、dnt は true に設定されています。これは、dnt が false に設定されている他の SLAS トークンリクエストとは異なります。
Note
Login_On_Behalf および Create_Order_On_Behalf の機能の許可を構成します。auth_code PKCE フローで使用する専用のパブリッククライアント ID を作成します。詳細については、パブリック SLAS クライアントのユースケースを参照してください。sfcc.ta_ext_on_behalf_of スコープを SLAS クライアントに追加します。SLAS の構成時に作成したパブリッククライアント ID を必ず使用してください。
Note
login_id を guest に設定します。idp_origin を slas に設定します。これは、SLAS ゲストリクエストの標準です。別の idp_origin 値が使用されている場合、SLAS は不正なリクエストを返します。state パラメーターを渡して、認可呼び出しからトークン呼び出しに状態を転送するための TAOB access_token を取得する必要があります。state パラメーター値は、TAOB ゲスト認可呼び出しからのレスポンス URL の認可コードとともに返されます。例:
.../taob/callback?code=HETXpvg5LKBNIHjDTWkRrf2MLVU&state=taob.gst.7bc7fb7f-e646-44fd-bc73-dfd5c3c9019b
1curl 'https://$CODE.api.commercecloud.salesforce.com/shopper/auth/v1/organization/$ORG/oauth2/trusted-agent/authorize'
2\--get
3\--data "client_id=$CLIENT"
4\--data "channel_id=$SITE"
5\--data "redirect_uri=$REDIRECT"
6\--data 'response_type=code'
7\--data 'idp_origin=slas'
8\--data-urlencode "login_id=guest"
9\--data "code_challenge=$CHALLENGE'Authorization ヘッダーで、エージェントが Account Manager で認証されたときに返された code クエリパラメーターの値を使用します。
1curl 'https://$CODE.api.commercecloud.salesforce.com/shopper/auth/v1/organization/$ORG/oauth2/trusted-agent/token' \
2--header 'Authorization: Bearer jpsM6DNwzFtrUIZJDwyRihkRX1g' \
3--data "client_id=$CLIENT" \
4--data "channel_id=$SITE" \
5--data 'grant_type=client_credentials' \
6--data 'idp_origin=slas' \
7--data-urlencode 'login_id=guest' \
8--data-urlencode 'agent_id=example@yourdomain.com' \
9--data-urlencode 'channel_id=SiteGenesis' \
10--data 'code_verifier=`$VERIFIER' \
11--data 'state=taobgst.3ebdcbb6-ef87-4f41-8173-67728636e513'SLAS の構成時に作成したパブリッククライアント ID を必ず使用してください。
Note
login_id を買い物客の認証情報に設定します。idp_origin を ecom に設定します。次のシナリオでは、信頼できるエージェントの認可を使用して登録済みの買い物客をサポートします。
このフローは、エージェントの IDP として機能する Account Manager 専用です。別の IDP を使用するエージェントの場合は、信頼できる代理システム (Trusted System On Behalf (TSOB)) の呼び出しフローを使用して、カスタムエージェントソリューションで SLAS 買い物客の JSON Web Token (JWT) を提供することを検討してください。
Note
以下の図は、登録済み買い物客用の信頼できるエージェントの認可フローで使用される一般的な API リクエストとレスポンスを示しています。
次のコマンドは、パブリッククライアントを使用して信頼できるエージェントを認可する方法を示しています。
用意されているサンプルコードを実行する際には、プレースホルダーの値を必ず実際の値に置き換えてください。
Important
まず、信頼できるエージェントのための認可コードを getTrustedAgentAuthorizationToken を使ってリクエストします。
1curl "https://$CODE.api.commercecloud.salesforce.com/shopper/auth/v1/organization/$ORG/oauth2/trusted-agent/authorize" \
2--get \
3--data "client_id=$CLIENT" \
4--data "channel_id=$SITE" \
5--data "redirect_uri=$REDIRECT" \
6--data 'response_type=code' \
7--data 'idp_origin=ecom' \
8--data-urlencode "login_id=jack.shopper" \
9--data-urlencode 'agent_id=example@yourdomain.com' \
10--data-urlencode 'channel_id=SiteGenesis' \
11--data "code_challenge=$CHALLENGE"リクエストにより、Account Manager にリダイレクトされ、認証するよう求められます。正常にログインすると、前回のリクエストの redirect_uri パラメーターで渡されたアドレスにリダイレクトされます。リダイレクトする場合、認可コードは code クエリパラメーターに含まれます。
次に、getTrustedAgentAccessToken を使用して信頼できるエージェントトークンをリクエストします。Authorization ヘッダーで、エージェントが Account Manager で認証されたときに返された code クエリパラメーターの値を使用します。
1curl "https://$CODE.api.commercecloud.salesforce.com/shopper/auth/v1/organization/$ORG/oauth2/trusted-agent/token" \
2--header 'Authorization: Bearer jpsM6DNwzFtrUIZJDwyRihkRX1g' \
3--data "client_id=$CLIENT" \
4--data "channel_id=$SITE" \
5--data 'grant_type=client_credentials' \
6--data 'idp_origin=ecom' \
7--data-urlencode 'login_id=jack.shopper' \
8--data "code_verifier=$VERIFIER"信頼できるエージェントトークンは 15 分後に期限切れになり、更新できません。新しいトークンを取得するには、認可フローを再開します。
Note
1{
2"status_code": "403 FORBIDDEN",
3"message": "AM SSO Unauthorized!"
4}agent_id と login_id が同じであることを示していますが、これは許可されていません。
1{
2 "status_code": "403 FORBIDDEN",
3 "message": "Agent Id - AM SSO Unauthorized!"
4}
j