認可スコープカタログ

スコープは、トークンがアクセスできる B2C Commerce エンドポイントを制御し、トークンが実行できる許可とアクションを定義して、承認された操作のみが許可されるようにします。

スコープの形式は sfcc.{{family}}[.rw] です。オプションの .rw 接尾辞は、読み取りと書き込みの許可を示します。

スコープをトークンに割り当て、ストアフロントのニーズに基づいて構成するには、以下を行います。

1. ストアフロントの機能と、買い物客が実行できる操作を理解します。
2. ストアフロントが連携する必要のある API ファミリーと、必要な特定のアクションを決定します。これには、Shopper API、SCAPI Admin API、および SLAS Admin API が含まれます。
3. 以下の表を使用して、必要なスコープを特定します。
   • セキュリティ上の理由から、スコープは必要最小限に制限します。
   • JWT のサイズを最適化します。スコープは SLAS JWT の大部分を占めており、多くの場合、この SLAS トークンは Cookie として格納され、リクエストとレスポンスの両方でやり取りされます。
     • 選択したスコープごとに、冗長性を回避するために特定のアクセス許可を構成します。スコープに -rw バージョンを含める場合は、読み取り専用のバージョンは使用しないでください。読み取り専用のバージョンは冗長性が高く、トークンが不必要に大きくなる可能性があります。
     • 該当する API ファミリーのスコープのみを含めるようにしてください。たとえば、SCAPI Admin API スコープを SLAS JWT に含めないでください。
4. トークンを正しいスコープで構成します。
   • トークンを Shopper API に渡すことができるように構成するには、Shopper API の認可を参照してください。
   • トークンを SCAPI Admin API に渡すことができるように構成するには、Admin API の認可を参照してください。
   • カスタム API でスコープを使用するには、カスタム API の認証と認可を参照してください。
5. 保存してテストします。トークン構成を保存してテストし、期待どおりに動作することを確認します。トークンを API 呼び出しで使用して、トークンに適切な許可があり、必要なアクションを実行できることを確認します。

デフォルトでは、次の SLAS スコープが割り当てられます。

これらのスコープは、SLAS JWT の内部でのみ役立ちます。

トークンを Shopper API に渡すことができるように、正しいスコープでトークンを構成するには、Shopper API の認可を参照してください。

これらのスコープは、Account Manager JWT の内部でのみ役立ちます。

トークンを SCAPI Admin API に渡すことができるように、正しいスコープでトークンを構成するには、Admin API の認可を参照してください。

ショッピングアプリケーション (PWA Kit ストアフロントなど) に必要なスコープセットの例を次に示します。