> ## 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="/docs/ja-jp/glossary?term=OpenID">OpenID</Tooltip> Connect (OIDC) 認証プロトコルで使用されるスコープについて説明します。OIDC 自体の詳細については、[OpenID Connect プロトコル](/docs/ja-jp/authenticate/protocols/openid-connect-protocol)を参照してください。

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

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

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

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

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

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

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

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

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

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  スコープベースのフィルタリングは、クレームをトークンに追加する方法にかかわらず適用されます。対応するスコープ (たとえば`email`) がリクエストに含まれていない場合、`setCustomClaim()`を介してpostLogin Actionsから明示的に追加していても、発行されるトークンからクレームは削除されます。これはID Tokens、`/userinfo`レスポンス、アクセストークンにも同様に適用されます。
</Callout>

アプリケーションで標準クレームを要求する方法の例については、[スコープとクレームのユースケース例](/docs/ja-jp/get-started/apis/scopes/sample-use-cases-scopes-and-claims)をお読みください。

<div id="learn-more">
  ## さらに詳しく
</div>

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