> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# APIの設定

> Auth0 Dashboardで使用できるAPIの設定をご説明します。

<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=auth0-dashboard" tip="Auth0 Dashboard: サービスを構成するためのAuth0の主製品。" cta="用語集の表示">Auth0 Dashboard</Tooltip>の **［Settings（設定）］** タブ（[［Dashboard］>［Applications（アプリケーション）］>［API］](https://manage.auth0.com/#/apis)）を使って、認可されたアプリケーションから使用可能な登録済みのAPIを構成します。APIを構成するには、リストのAPIの横にある **［...］** をクリックして **［Settings（設定）］** を選択するか、API名をクリックします。APIの作成および登録方法については、「[APIを登録する](/docs/ja-jp/get-started/auth0-overview/set-up-apis)」をお読みください。

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/f9tcsxrYvRYBs4lY/docs/images/ja-jp/cdy7uua7fh8z/3rhmhghYZDSi6YWHRA5yMQ/2bafc57d32df6eb415b9e59b62f41531/API_List.png?fit=max&auto=format&n=f9tcsxrYvRYBs4lY&q=85&s=e6cd5927001a9a2ddb655c2a0fb37cdc" alt="Dashboard - アプリケーション - APIリスト" width="1402" height="511" data-path="docs/images/ja-jp/cdy7uua7fh8z/3rhmhghYZDSi6YWHRA5yMQ/2bafc57d32df6eb415b9e59b62f41531/API_List.png" />
</Frame>

## 設定

このタブでは、トークンの有効期間、ロールベースのアクセス制御（RBAC）、その他のアクセス設定を構成できます。タブの下にある **［Save（保存）］** をクリックして変更内容を保存します。

### 一般設定

これらのフィールドは、最初にAPIを登録したときに設定されますが、Auth0 <Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=management-api" tip="Management API: 顧客が管理タスクを実行できるようにするための製品。" cta="用語集の表示">Management API</Tooltip>の場合は例外です。変更可能なのは **［Name（名前）］** のみです。

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/9Vac8_IYDB9MGlmx/docs/images/ja-jp/cdy7uua7fh8z/QCaXd3FSeP6SYqLfEJWBr/f33c6d4d2852c04b65257b5804a6814b/API_general_settings.png?fit=max&auto=format&n=9Vac8_IYDB9MGlmx&q=85&s=d180c3d2253f1e5c06c7d519043ee088" alt="Dashboard - アプリケーション - APIの設定タブ - 一般設定" width="700" height="314" data-path="docs/images/ja-jp/cdy7uua7fh8z/QCaXd3FSeP6SYqLfEJWBr/f33c6d4d2852c04b65257b5804a6814b/API_general_settings.png" />
</Frame>

* **Id** ：Auth0によって生成された一意のアルファベット文字列です。この情報は、読み取り専用で、[Auth0 Management APIのリソースサーバーエンドポイント](https://auth0.com/docs/api/management/v2#!/Resource_Servers/get_resource_servers_by_id)を直接使用する場合にのみ必要です。
* **Name（名前）** ：APIのフレンドリー名です。いずれの機能にも影響しません。次の文字は使用できません：`<>`。
* **Identifier（識別子）** ：APIの一意の識別子です。この値は、APIの作成時に設定され、以降変更することはできません。URLの使用を推奨していますが、公開されたURLである必要はありません。Auth0がAPIを呼び出すことはありません。

### トークンの設定

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/5l8GTXHD40NsjgmL/docs/images/ja-jp/cdy7uua7fh8z/2FFfqqmntXL9CnGrSxea9M/99e770190f064a72b4bc18c8cd867ce9/API_-_Access_Token_Settings.png?fit=max&auto=format&n=5l8GTXHD40NsjgmL&q=85&s=57695b6eeff23267b39eca1cab1ae29e" alt="Dashboard - API - トークンの設定 - 有効期限" width="1238" height="962" data-path="docs/images/ja-jp/cdy7uua7fh8z/2FFfqqmntXL9CnGrSxea9M/99e770190f064a72b4bc18c8cd867ce9/API_-_Access_Token_Settings.png" />
</Frame>

* **Maximum <Tooltip data-tooltip-id="react-containers-DefinitionTooltip-3" href="/docs/ja-jp/glossary?term=access-token" tip="アクセストークン: APIへのアクセスに使用される、不透明な文字列またはJWT形式の認可資格情報。" cta="用語集の表示">Access Token</Tooltip> Lifetime (Seconds)（アクセストークンの最大ライフタイム（秒単位））** ：アクセストークンの有効期限が切れるまでの時間（秒単位）です。デフォルトの値は、86,400秒（24時間）です。設定できる最大値は、2,592,000秒（30日間）です。

* **Implicit / Hybrid Flow Access Token Lifetime (Seconds)（暗黙/ハイブリッドフローを使用したアクセストークンのライフタイム（秒単位））** ：暗黙/ハイブリッドフローを使用して発行されたアクセストークンの有効期限が切れるまでの時間（秒単位）です。デフォルトの値は、86,400秒（24時間）です。値はアクセストークンの最大ライフタイムよりも長くできません。

* **<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-2" href="/docs/ja-jp/glossary?term=json-web-token" tip="JSON Web Token（JWT）: 二者間のクレームを安全に表現するために使用される標準IDトークン形式（および多くの場合、アクセストークン形式）。" cta="用語集の表示">JSON Web Token</Tooltip> (JWT) Profile（JSON Web Token（JWT）プロファイル）** ：プロファイルは、APIに発行されるアクセストークンの形式を決定します。使用可能な値は`Auth0`と`RFC 9068`です。詳細については、「[アクセストークンのプロファイル](/docs/ja-jp/secure/tokens/access-tokens/access-token-profiles)」をお読みください。

* **JSON Web Token (JWT) <Tooltip data-tooltip-id="react-containers-DefinitionTooltip-4" href="/docs/ja-jp/glossary?term=signing-algorithm" tip="署名アルゴリズム: トークンが改ざんされないように、トークンにデジタル署名するためのアルゴリズム。" cta="用語集の表示">Signing Algorithm</Tooltip>（JSON Web Token （JWT）の署名アルゴリズム）** ：トークンの署名に使用するアルゴリズムです。署名は、JWTの送信者が自称のとおりであることを検証し、メッセージが途中で変更されていないことを保証するために使用されます。使用可能な値は[`HS256`](https://en.wikipedia.org/wiki/Symmetric-key_algorithm)と[`RS256`](https://en.wikipedia.org/wiki/Public-key_cryptography)です。`RS256`（推奨）を選択すると、トークンがテナントの秘密鍵で署名されます。この値は、APIの作成時に設定され、以降変更することはできません。署名アルゴリズムとAuth0での役割については、「[署名アルゴリズム](/docs/ja-jp/get-started/applications/signing-algorithms)」をお読みください。

  <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
    署名はJWTの一部です。JWTの構造に慣れていない場合は、「[JSON Web Tokenの構造](/docs/ja-jp/secure/tokens/json-web-tokens/json-web-token-structure)」を参照してください。
  </Callout>

* **JSON Web Encryption（JWE）** ：有効な場合、発行されたアクセストークンは、JSON Web Encryption（JWE）形式で暗号化されます。詳細については、「[JSON Web Encryption](/docs/ja-jp/secure/tokens/access-tokens/json-web-encryption)」をお読みください。

### RBACの設定

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/V-g8sIA_dMysRiDH/docs/images/ja-jp/cdy7uua7fh8z/65tKb6aj0ktc2qXLUVlV3e/ee1e226b004fb56f88143ead67750fbf/API_-_RBAC_Settings.png?fit=max&auto=format&n=V-g8sIA_dMysRiDH&q=85&s=459dad7e531581e4ac99b6d31e8c4241" alt="Auth0 Dashboard - APIの設定 - RBACトグル" width="1200" height="408" data-path="docs/images/ja-jp/cdy7uua7fh8z/65tKb6aj0ktc2qXLUVlV3e/ee1e226b004fb56f88143ead67750fbf/API_-_RBAC_Settings.png" />
</Frame>

* **Enable RBAC（RBACを有効にする）**：有効にすると、APIにRBACポリシーが適用されます。詳細については、「[ロールベースのアクセス制御](/docs/ja-jp/manage-users/access-control/rbac)」と「[APIにロールベースのアクセス制御を有効にする](/docs/ja-jp/get-started/apis/enable-role-based-access-control-for-apis)」をお読みください。トラブルシューティングのヘルプについては、「[ロールベースのアクセス制御と認可のトラブルシューティングを実行する](/docs/ja-jp/troubleshoot/authentication-issues/troubleshoot-rbac-authorization)」を参照してください。
* **Add Permissions in the Access Token（アクセストークンに権限を追加する）**：有効にすると、アクセストークンに権限クレームを追加できます。この設定は、RBACを有効にしている場合のみ利用できます。権限は **［Permissions（権限）］** タブで構成することができます。

### アクセス設定

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/9Vac8_IYDB9MGlmx/docs/images/ja-jp/cdy7uua7fh8z/JNlWACqoyfmpE89JwWLKy/c1e88ad09e1d33d5689eb426d96bbe43/2025-02-25_14-53-56.png?fit=max&auto=format&n=9Vac8_IYDB9MGlmx&q=85&s=f41ed8c0f814a1a5dd2a6c23c05804cd" alt="Dashboard - アプリケーション - APIの設定タブ - アクセスの設定" width="702" height="395" data-path="docs/images/ja-jp/cdy7uua7fh8z/JNlWACqoyfmpE89JwWLKy/c1e88ad09e1d33d5689eb426d96bbe43/2025-02-25_14-53-56.png" />
</Frame>

* **Allow Skipping User Consent（ユーザー同意のスキップを許可）** ：有効にすると、「ファーストパーティ」のフラグが付いたアプリケーションついて、APIがユーザー同意をスキップします。
* **Allow Offline Access（オフラインアクセスの許可）** ：有効にすると、アプリケーションがAPIにリフレッシュトークンを要求できます。

## 権限

**［Permissions（権限）］** タブの設定を使って、APIが使用する権限（スコープ）を定義します。詳細については、「[APIに権限を追加する](/docs/ja-jp/get-started/apis/add-api-permissions)」と「[APIの権限を削除する](/docs/ja-jp/get-started/apis/delete-api-permissions)」をお読みください。

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/itywf6vBRFUC2Nea/docs/images/ja-jp/cdy7uua7fh8z/32Pb185OFs2mC6z2fmunEw/6b337d23304ea568dfcf8d9156b859b8/2025-02-27_10-17-20.png?fit=max&auto=format&n=itywf6vBRFUC2Nea&q=85&s=aece2f64afedf3fec593efcbbdf2519a" alt="Dashboard - APIの権限を追加する - APIの権限の定義画面" width="1598" height="1322" data-path="docs/images/ja-jp/cdy7uua7fh8z/32Pb185OFs2mC6z2fmunEw/6b337d23304ea568dfcf8d9156b859b8/2025-02-27_10-17-20.png" />
</Frame>

## M2Mアプリケーション

M2Mアプリケーションがある場合は、このタブのリストに表示されます。リストにあるアプリケーションは、トグルを使って認可します。詳細については、「[マシンツーマシンアプリケーションを登録する](/docs/ja-jp/get-started/auth0-overview/create-applications/machine-to-machine-apps)」をお読みください。

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/9Vac8_IYDB9MGlmx/docs/images/ja-jp/cdy7uua7fh8z/7lIxRDYBUf0CxzZkXFZFyI/2db7526b16cb6c427057e8cdd6ea1ba1/Travel0_API_m2m_tab.png?fit=max&auto=format&n=9Vac8_IYDB9MGlmx&q=85&s=7533a003e9adcb04143f2dee47d2ef98" alt="Dashboard - アプリケーション - API - マシンツーマシンアプリケーション" width="1282" height="1228" data-path="docs/images/ja-jp/cdy7uua7fh8z/7lIxRDYBUf0CxzZkXFZFyI/2db7526b16cb6c427057e8cdd6ea1ba1/Travel0_API_m2m_tab.png" />
</Frame>

## テスト

APIでテストを行うためのテストアプリケーションが自動的に作成されます。Management APIテスト用にマシンツーマシンアプリケーションを作成する方法については、「[テスト用にマシンツーマシンアプリケーションを作成する](/docs/ja-jp/get-started/apis/create-m2m-app-test)」をお読みください。

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/9Vac8_IYDB9MGlmx/docs/images/ja-jp/cdy7uua7fh8z/iVNH8BQ3GBp90CSJTbArs/53bc8f41e828a4d27bfd792bb1f21454/Travel0_API_-_Mgmt_API_Tab.png?fit=max&auto=format&n=9Vac8_IYDB9MGlmx&q=85&s=910fdb09d2517c52a7a232d0fe6c03c0" alt="Dashboard - アプリケーション - APIのテストタブ" width="1139" height="1313" data-path="docs/images/ja-jp/cdy7uua7fh8z/iVNH8BQ3GBp90CSJTbArs/53bc8f41e828a4d27bfd792bb1f21454/Travel0_API_-_Mgmt_API_Tab.png" />
</Frame>

## Management API Explorer

Auth0 Management APIの **［Settings（設定）］** を表示すると、**［API Explorer］** と呼ばれる追加のタブが表示されます。

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/1FU_hDyg-ytA7ilg/docs/images/ja-jp/cdy7uua7fh8z/1OSC4OQZkMBQOq9D0PFuHv/82b4600bc5a72b96627e471cb1613c53/Auth0_Management_API_settings.png?fit=max&auto=format&n=1FU_hDyg-ytA7ilg&q=85&s=3b6f0327b6c377e90f76d6bfb8a4e664" alt="Dashboard - アプリケーション - API - Management API Explorer" width="1135" height="1230" data-path="docs/images/ja-jp/cdy7uua7fh8z/1OSC4OQZkMBQOq9D0PFuHv/82b4600bc5a72b96627e471cb1613c53/Auth0_Management_API_settings.png" />
</Frame>

トラブルシューティングのヘルプについては、「[API呼び出しを確認する](/docs/ja-jp/troubleshoot/authentication-issues/check-api-calls)」をお読みください。

## もっと詳しく

* [APIを登録する](/docs/ja-jp/get-started/auth0-overview/set-up-apis)
* [トークン](/docs/ja-jp/secure/tokens)
* [署名アルゴリズム](/docs/ja-jp/get-started/applications/signing-algorithms)
* [APIスコープ](/docs/ja-jp/get-started/apis/scopes/api-scopes)
* [複数のAPIの論理APIを構成する](/docs/ja-jp/get-started/apis/set-logical-api)
* [テスト用にM2Mアプリケーションを作成する](/docs/ja-jp/get-started/apis/create-m2m-app-test)
