UCPリソースサーバーを構成する

Auth for UCP機能は早期アクセス段階にあります。この機能を使用することで、OktaのMaster Subscription Agreementに定める該当の無料トライアル条件に同意したものとみなされます。参加をご希望の場合は、Limited Early Access Partnership Programフォームにご記入のうえ、ご関心をお知らせください。

Geminiなどのエージェントプラットフォームは、認可サーバーが公開するスコープをもとに同意画面を構築します。UCPスコープを検出できるようにするには、APIをUCPリソースサーバーとして設定してください。これにより、Auth0がそのスコープをテナントの検出メタデータで公開します。

前提条件

UCPサーバーを表すAPI。
Resource Parameter Compatibility Profile (任意) ：MCPクライアントを使用する場合は、テナント設定でこのプロファイルを有効にすることをお勧めします。これを有効にすると、オーディエンスが指定されていない場合に認可サーバーがresourceパラメーターを確認し、リソース固有のリクエスト (RFC 8707) を処理できるようになります。

UCPリソースサーバーを構成する

UCPリソースサーバーとして構成できるAPIは、1つのテナントにつき1つだけです。

Auth0 Dashboard
Management API

［ダッシュボード］>［Applications］>［APIs］に移動して、対象のAPIを選択します。
［Settings (設定) ］タブで、［Universal Commerce Protocol］セクションを探します。
［UCP Resource Server (UCPリソースサーバー) ］を有効にします。
［Save (保存) ］を選択します。

テナント内の別のAPIでこの設定がすでに有効になっている場合は、保存時にエラーが発生し、競合しているAPIの名前が表示されます。APIにUCPを構成したら、UCPスコープを追加します。

［Permissions (権限) ］タブを選択します。
UCPサーバーがサポートするスコープをそれぞれ追加します。UCPスコープはdev.ucpで始まります (例：dev.ucp.shopping.order:read、dev.ucp.shopping.cart:manage、dev.ucp.shopping.checkout:manage) 。各スコープには説明を入力してください。

Management APIのアクセストークンにcreate:resource_serversまたはupdate:resource_servers権限が付与されていることを確認してください。新しいUCPリソースサーバーを作成するには、/api/v2/resource-serversにPOSTリクエストを送信します。

curl --request POST \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/resource-servers' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "name": "Acme UCP Server",
    "identifier": "https://ucp.acme.example.com",
    "type": "universal_commerce_protocol_server",
    "scopes": [
      { "value": "dev.ucp.shopping.order:read", "description": "Read orders" },
      { "value": "dev.ucp.shopping.cart:manage", "description": "Manage carts" },
      { "value": "dev.ucp.shopping.checkout:manage", "description": "Manage checkout" }
    ]
  }'

既存のAPIをUCPサーバーとして構成するには、"type": "universal_commerce_protocol_server"を指定して/api/v2/resource-servers/{id}にPATCHリクエストを送信します。typeは、dev.ucp.*スコープを追加する前に設定するか、スコープの追加と同じリクエスト内で設定してください。標準のAPIにUCPスコープを追加しようとするリクエストは拒否されます。

デフォルトのオーディエンスを設定する

Geminiなどのエージェントプラットフォームは、scopeパラメーターを送信しますが、audienceパラメーターは送信しません。オーディエンスが指定されていないと、Auth0はどのAPI向けにトークンを発行すればよいかを判断できません。早期アクセス期間中、Auth0はテナントのデフォルトのオーディエンスを使ってこれを解決します。 UCPリソースサーバーの識別子を、テナントのデフォルトのオーディエンスとして設定します。

［ダッシュボード］>［Settings (設定) ］>［General (一般) ］に移動します。
［API Authorization Settings (API認可設定) ］で、［Default Audience (デフォルトのオーディエンス) ］にUCPリソースサーバーの識別子を設定します。
［保存］を選択します。

アプリケーションごとにデフォルトのオーディエンスを設定する機能は、今後のリリースで提供される予定です。

次のステップ

標準アカウントリンクをセットアップする

はじめに

リファレンス

UCPリソースサーバーを構成する

前提条件

UCPリソースサーバーを構成する

デフォルトのオーディエンスを設定する

次のステップ

​前提条件

​UCPリソースサーバーを構成する

​デフォルトのオーディエンスを設定する

​次のステップ

前提条件

UCPリソースサーバーを構成する

デフォルトのオーディエンスを設定する

次のステップ