> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Authorization Extension への API アクセスを有効にする方法について説明します。

# Authorization Extension への API アクセスを有効にする

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0 では、ロールベースアクセス制御 (RBAC) を実装する方法として 2 つの選択肢を提供しています。これらは、API 独自の内部アクセス制御システムの代わりに使用することも、組み合わせて使用することもできます。

  * [Authorization Core](/ja/docs/manage-users/access-control/rbac)
  * [Authorization Extension](/ja/docs/customize/extensions/authorization-extension)

  Authorization Core の機能セットは Authorization Extension と同等の機能を備えており、パフォーマンスとスケーラビリティを向上させるとともに、Authorization Extension よりも柔軟な RBAC システムを提供します。

  現在、どちらも RBAC の主要な機能を実装しており、API に定義されたカスタムスコープを、権限としてユーザーに割り当てられたものだけに制限できます。
</Callout>

設定とセットアップが完了すると、拡張機能にはユーザーに加えて、グループ、ロール、権限が含まれるようになります。拡張機能への API アクセスを有効にすると、プロビジョニングを自動化し、ユーザーの認可コンテキストをリアルタイムで照会できます。

<div id="enable-api-access">
  ## API アクセスを有効にする
</div>

1. [Auth0 Dashboard > Extensions > Auth0 Authorization](https://manage.auth0.com/#/extensions) に移動します。
2. **API** セクションを開くには、**Authorization Dashboard** の右上にある Auth0 テナント名を選択し、**API** を選択します。

   <Frame>
     <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/6cF78dwvbK7Sc0JbuxJF85/fbd895fb6f7338559628ea71b3003f52/click-configuration_select-api.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=e9c4f668e1c377ea2e09ec940736c477" alt="ダッシュボード - 拡張機能 - Authorization Extensions ダッシュボード - API を選択" width="814" height="462" data-path="docs/images/cdy7uua7fh8z/6cF78dwvbK7Sc0JbuxJF85/fbd895fb6f7338559628ea71b3003f52/click-configuration_select-api.png" />
   </Frame>
3. **Settings** ページで、**API Access** スイッチを有効にします。

   <Frame>
     <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5toxhsSik9EWMnQoK5wTjH/fc40d80a32461e9216f5c69a89e031ec/enable-api-access.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=96c49df4d14d2376bc78695b9796e973" alt="ダッシュボード - 拡張機能 - Authorization Extensions ダッシュボード - API Access を有効にする" width="681" height="341" data-path="docs/images/cdy7uua7fh8z/5toxhsSik9EWMnQoK5wTjH/fc40d80a32461e9216f5c69a89e031ec/enable-api-access.png" />
   </Frame>
4. API Access を有効にすると、API が発行するトークンの一部のパラメーターを、拡張機能内で表示または制御できるようになります。トークンの**有効期限**を制御できるほか、API にアクセスするためのトークンの**オーディエンス**、**発行者**、**URL**を確認できます。

   <Frame>
     <img src="https://mintcdn.com/translations/3nS3prIggmJG9TUI/docs/images/cdy7uua7fh8z/3WfHXaEyi8FvD8pTDlYQpt/cbe92c5b5f4baf9c35a8c686ff4f511d/api-access-enabled.png?fit=max&auto=format&n=3nS3prIggmJG9TUI&q=85&s=0bce7dcd4af828802954d470ad8f01df" alt="ダッシュボード - 拡張機能 - Authorization Extensions ダッシュボード - API Access が有効" width="683" height="455" data-path="docs/images/cdy7uua7fh8z/3WfHXaEyi8FvD8pTDlYQpt/cbe92c5b5f4baf9c35a8c686ff4f511d/api-access-enabled.png" />
   </Frame>

<div id="access-extension-api">
  ## 拡張機能の API にアクセスする
</div>

拡張機能への API アクセスを有効にすると、Auth0 は [Auth0 Dashboard](https://manage.auth0.com/#/apis) に、利用可能な API を自動的に作成します。API にアクセスするには、API 自体とやり取りするエンティティである Machine to Machine Application を作成する必要があります。

<div id="create-applications">
  ### アプリケーションを作成する
</div>

1. [Auth0 Dashboard > Applications > Applications](https://manage.auth0.com/#/applications) に移動し、**Create Application** を選択します。新しいアプリケーションに名前を付け、タイプとして **Machine to Machine Application** を選択します。続行するには **Create** を選択します。
   アプリケーションの **Quick Start** ページにリダイレクトされます。このページでは、アプリケーションで使用する API に応じてライブドキュメントをカスタマイズできます。Auth0 が拡張機能用に作成した API (**auth0-authorization-extension-api** などの名前) を選択します。
   API とアプリケーションを一緒に使用するのは今回が初めてなので、「This application is not authorized for this API.」というメッセージが表示されます。API でアプリケーションを使用できるように認可するには、**Navigate to the API and Authorize** を選択します。

   <Frame>
     <img src="https://mintcdn.com/translations/mMSz-RNYLuOm2GmQ/docs/images/cdy7uua7fh8z/UbMM1C6a1GjMIhNlk8cCD/462b9dcd29e5d7f5bbd261490e6a46b0/Dashboard_-_Authorization_Extensions_-_Client_Quick_Start.png?fit=max&auto=format&n=mMSz-RNYLuOm2GmQ&q=85&s=600800eb98c9edf001bd8d936a687eb0" alt="Dashboard - Authorization Extensions - Client Quick Start" width="1202" height="456" data-path="docs/images/cdy7uua7fh8z/UbMM1C6a1GjMIhNlk8cCD/462b9dcd29e5d7f5bbd261490e6a46b0/Dashboard_-_Authorization_Extensions_-_Client_Quick_Start.png" />
   </Frame>
2. API で使用できる Machine to Machine Applications の一覧が表示されます。作成したばかりのアプリケーションの横にあるスイッチを有効にして認可します。

   <Frame>
     <img src="https://mintcdn.com/translations/pvjQqAy3EB2TK6NP/docs/images/cdy7uua7fh8z/4WFJ3BhCf2kZjbRWhQ0sCp/38aeb0ca9360fd75bd7d54f897ac1735/Dashboard_-_Authorization_Extension_-_Clients_for_API.png?fit=max&auto=format&n=pvjQqAy3EB2TK6NP&q=85&s=b9496a9d1f0a2f92a51f992a163a5402" alt="Dashboard - Authorization Extension - Clients for API" width="1140" height="600" data-path="docs/images/cdy7uua7fh8z/4WFJ3BhCf2kZjbRWhQ0sCp/38aeb0ca9360fd75bd7d54f897ac1735/Dashboard_-_Authorization_Extension_-_Clients_for_API.png" />
   </Frame>

   アプリケーションを認可すると、**Grant ID** が表示されます。アプリケーションに付与する **Scopes** を選択することもできます。付与するスコープは、アクセスするエンドポイントによって異なります。
3. スコープを変更した場合は、**Update** を選択して保存します。

   <Frame>
     <img src="https://mintcdn.com/translations/Dcx0M11uuptU53TX/docs/images/cdy7uua7fh8z/2RvMFmLusnUOmBp1uXPh1/a78add868b094d37cec63365f745f196/extensions-auth-api-scopes.png?fit=max&auto=format&n=Dcx0M11uuptU53TX&q=85&s=a26a630a359ed080481f604ef3cd1a26" alt="Dashboard - Authorization Extension Dashboard - Client Scopes" width="1504" height="856" data-path="docs/images/cdy7uua7fh8z/2RvMFmLusnUOmBp1uXPh1/a78add868b094d37cec63365f745f196/extensions-auth-api-scopes.png" />
   </Frame>

<div id="get-access-token">
  ### アクセストークンを取得する
</div>

API にアクセスするには、[適切なアクセストークンをリクエストして取得する](/ja/docs/get-started/authentication-and-authorization-flow/client-credentials-flow/call-your-api-using-the-client-credentials-flow)必要があります。

<div id="call-the-api">
  ### API を呼び出す
</div>

API は次の方法で呼び出せます。

* HTML リクエスト
* cURL コマンド

エンドポイントの詳細情報に加え、上記 3 つの方法を使用して各エンドポイントを呼び出す方法のサンプルは、[Authorization Extension API Explorer](https://auth0.com/docs/api/authorization-extension)でも確認できます。

API 経由で拡張機能へのアクセスを有効にすると、コマンドラインから実行できるすべての操作が記載された **API Explorer** も参照できます。

API ドキュメントを表示するには、**Explorer** ページを選択します。

<Frame>
  <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5mwKE5muQHYbXKqYZvWOwR/aa0ecec3e5cb803a105d857f24c8b6b7/api-explorer.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=1b08bef6bb161fbe400a23135dd77da5" alt="Authorization Extension API Explorer" width="812" height="467" data-path="docs/images/cdy7uua7fh8z/5mwKE5muQHYbXKqYZvWOwR/aa0ecec3e5cb803a105d857f24c8b6b7/api-explorer.png" />
</Frame>

<div id="learn-more">
  ## 詳しくはこちら
</div>

* [Authorization Extension で Rules を使用する](/ja/docs/customize/extensions/authorization-extension/use-rules-with-the-authorization-extension)
* [Authorization Extension のデータをインポートおよびエクスポートする](/ja/docs/customize/extensions/authorization-extension/import-and-export-authorization-extension-data)