> ## 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.

> OpenID Connect (OIDC) プロトコルで使用されるスコープとクレームについて説明します。

# OpenID Connect スコープ

このドキュメントでは、<Tooltip tip="OpenID: アプリケーションがログイン情報を収集・保存することなくユーザーの本人確認を行えるようにする、認証のオープン標準です。" cta="用語集を見る" href="/ja/docs/glossary?term=OpenID">OpenID</Tooltip> Connect (OIDC) 認証プロトコルで使用されるスコープについて説明します。OIDC 自体の詳細については、[OpenID Connect プロトコル](/ja/docs/authenticate/protocols/openid-connect-protocol)を参照してください。

OpenID Connect (OIDC) のスコープは、認証時にアプリケーションがユーザーの名前やプロフィール画像などの情報へのアクセスを要求するために使用されます。各スコープは、クレームと呼ばれる一連のユーザー属性を返します。アプリケーションが要求すべきスコープは、そのアプリケーションに必要なユーザー属性によって異なります。ユーザーが要求されたスコープを認可すると、クレームは<Tooltip tip="ID Token: リソースへのアクセスではなく、クライアント自体を対象としたクレデンシャルです。" cta="用語集を見る" href="/ja/docs/glossary?term=ID+Token">IDトークン</Tooltip>で返され、[`/userinfo` エンドポイント](/ja/docs/api/authentication/user-profile/get-user-info)からも利用できます。

たとえば、通常の Web アプリケーションを構築して Auth0 に登録し、ユーザーが username とパスワードでログインできるように設定したとします。ユーザーがアプリにログインした後、そのユーザーの名前を含むパーソナライズされたウェルカムメールを自動生成して送信したいとします。

1. ユーザーがアプリ内の **Login** をクリックします。
2. アプリは、次のスコープを含めてユーザーを Auth0 認可サーバー (`/authorize` エンドポイント) にリダイレクトします。

   * `openid` (必須。アプリケーションがユーザーの本人確認に OIDC を使用することを示すため)
   * `profile` (ユーザーの名前を使ってメールをパーソナライズするため)
   * `email` (ウェルカムメールの送信先を把握するため)
3. Auth0 認可サーバーがユーザーをログインプロンプトにリダイレクトします。
4. ユーザーは認証を行い、Auth0 がアプリに付与するスコープ (プロフィール情報やメールアドレスへのアクセスを含む) が一覧表示された同意ページを確認します。
5. ユーザーはこれを承諾し、Auth0 に保存されている自分の情報に対して、アプリにこのレベルのアクセスを許可します。
6. これで、アプリはユーザーのプロフィール情報とメールアドレスにアクセスできるようになります。

<div id="standard-claims">
  ## 標準クレーム
</div>

標準クレームは、名前、メールアドレス、画像などのユーザー情報をアプリケーションに提供するためのもので、OIDC プロトコルであらかじめ定義されています。これらのクレームは IDトークン で返され、[`/userinfo` エンドポイント](/ja/docs/api/authentication/user-profile/get-user-info)からも取得できます。

また、カスタムクレームを作成することもできます。カスタムクレームは、[Auth0 Actions](/ja/docs/customize/actions/actions-overview)を使用して定義、制御し、トークンに追加するクレームです。詳しくは、[JSON Web Token Claims](/ja/docs/secure/tokens/json-web-tokens/json-web-token-claims)を参照してください。

OIDC の基本的な (かつ必須の) スコープは `openid` です。これは、アプリケーションが OIDC プロトコルを使用してユーザーの本人確認を行うことを示します。これに加えて、アプリケーションは `scope` パラメーターに要求するスコープ名をスペース区切りで指定することで、追加のスコープを要求できます。

最も一般的に使用されるスコープに含まれる標準クレームを以下に示します。利用可能な標準クレームの完全な一覧については、[OIDC specification: Standard Claims on openid.net](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims)を参照してください。スコープの完全な一覧については、[OIDC specification: Requesting Claims Using Scope Values on openid.net](https://openid.net/specs/openid-connect-core-1_0.html#ScopeClaims)を参照してください。

| スコープ      | クレーム                                                                                                                                                                                              |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `openid`  | (必須) ユーザーを一意に識別する `sub` クレームを返します。IDトークン には、`iss`、`aud`、`exp`、`iat`、`at_hash` クレームも含まれます。IDトークン のクレームの詳細については、[ID Token Structure](/ja/docs/secure/tokens/id-tokens/id-token-structure)を参照してください。 |
| `profile` | `name`、`family_name`、`given_name`、`middle_name`、`nickname`、`picture`、`updated_at` など、基本的なプロフィール情報を表すクレームを返します。                                                                                    |
| `email`   | ユーザーのメールアドレスを含む `email` クレームと、メールアドレスがユーザーによって確認済みかどうかを示すブール値の `email_verified` を返します。                                                                                                            |

アプリケーションで標準クレームを要求する方法の例については、[Sample Use Cases: Scopes and Claims](/ja/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims)を参照してください。

<div id="learn-more">
  ## 詳細情報
</div>

* [スコープとクレームのユースケース例](/ja/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims)
* [スコープ](/ja/docs/get-started/apis/scopes)
* [カスタムクレームの作成](/ja/docs/secure/tokens/json-web-tokens/create-custom-claims)