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

> 登録済みおよびカスタムの JSON Web Token (JWT) クレーム、Auth0 トークンでの構造、namespaced クレームで名前の衝突を回避する方法について説明します。

# JSON Web Token クレーム

[JSON Web Token (JWT)](/docs/ja-jp/secure/tokens/json-web-tokens) のクレームは、対象に関して表明される情報です。たとえば、[ID トークン](/docs/ja-jp/secure/tokens/id-tokens) (これは常に <Tooltip tip="JSON Web Token (JWT): 2 者間でクレームを安全にやり取りするために使用される標準の ID トークン形式（多くの場合、アクセストークンの形式でもあります）。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=JWT">JWT</Tooltip> です) には、認証しているユーザーの名前が "John Doe" であることを示す `name` というクレームを含めることができます。JWT では、クレームは名前と値のペアとして表され、名前は常に文字列で、値には任意の JSON 値を指定できます。一般に、JWT の文脈でクレームについて言う場合は、名前 (またはキー) を指します。たとえば、次の JSON オブジェクトには 3 つのクレーム (`sub`、`name`、`admin`) が含まれています。

```json lines theme={null}
{
      "sub": "1234567890",
      "name": "John Doe",
      "admin": true
    }
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  OpenID Connect (OIDC) の標準クレームについては、[OpenID Connect Scopes](/docs/ja-jp/get-started/apis/scopes/openid-connect-scopes) と [OpenID Connect Standard Claims](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims) を参照してください。
</Callout>

JWT クレームには 2 種類あります。

* **Registered**: [Internet Assigned Numbers Authority (IANA) ](https://www.iana.org/assignments/jwt/jwt.xhtml) に登録され、[JWT の仕様](https://tools.ietf.org/html/rfc7519) で定義されている標準クレームです。これは、サードパーティ、つまり外部のアプリケーションとの相互運用性を確保するためのものです。OIDC の標準クレームは予約クレームです。
* **Custom**:  登録されていないパブリッククレームまたはプライベートクレームで構成されます。パブリッククレームは名前の衝突が起こりにくい一方、プライベートクレームは衝突が発生する可能性があります。

<div id="registered-claims">
  ## 登録済みクレーム
</div>

JWT の仕様では、必須ではないものの、[サードパーティアプリケーション](/docs/ja-jp/get-started/applications/third-party-applications/configure-third-party-applications)との相互運用性を確保するために推奨される予約済みクレームが 7 つ定義されています。以下のとおりです。

* `iss` (issuer): JWT の発行者
* `sub` (subject): JWT の主体 (ユーザー)
* `aud` (<Tooltip tip="Audience: 発行されたトークンの audience を表す一意の識別子です。トークン内では aud という名前で表され、その値には、ID トークンの場合はアプリケーション（Client ID）の ID、アクセストークンの場合は API（API Identifier）の ID が含まれます。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=audience">audience</Tooltip>): JWT の想定される受信者
* `exp` (expiration time): JWT の有効期限が切れる時刻
* `nbf` (not before time): JWT を処理のために受け入れてはならない時刻
* `iat` (issued at time): JWT が発行された時刻。JWT の経過時間の判断に使用できます
* `jti` (JWT ID): 一意の識別子。JWT の再利用を防ぐために使用できます (トークンを 1 回だけ使用可能にします)

登録済みクレームの完全な一覧は、[IANA JSON Web Token Claims Registry](https://www.iana.org/assignments/jwt/jwt.xhtml#claims) で確認できます。

<div id="custom-claims">
  ## カスタムクレーム
</div>

独自に管理するカスタムクレームを定義し、Actions を使ってそれらをトークンに追加できます。以下にいくつか例を示します。

* ユーザーのメールアドレスを <Tooltip tip="アクセストークン: API へのアクセスに使用される、非透過文字列または JWT の形式の認可資格情報です。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=access+token">アクセストークン</Tooltip> に追加し、それを使ってユーザーを一意に識別できます。
* Auth0 のユーザープロファイルに保存されているカスタム情報を <Tooltip tip="ID トークン: リソースへのアクセスではなく、クライアント自体を対象とした資格情報です。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=ID+token">ID トークン</Tooltip> に追加できます。

Action が設定されていれば、それによって追加されたカスタムクレームは、[リフレッシュトークン](/docs/ja-jp/secure/tokens/refresh-tokens) を使って新たに発行されるトークンにも含まれます。

トークンにカスタムクレームを追加する例については、[スコープとクレームのユースケース例](/docs/ja-jp/get-started/apis/scopes/sample-use-cases-scopes-and-claims) を参照してください。

<div id="public-claims">
  ### 公開クレーム
</div>

一般公開向けのカスタムクレームを作成できます。これには、氏名やメールアドレスなどの一般的な情報を含めることができます。公開クレームを作成する場合は、それらを登録するか、名前空間を使って衝突しにくい名前を使用する必要があります。また、使用する名前空間を自分で管理していることを確実にするために、適切な予防策を講じてください。

[IANA JSON Web Token Claims Registry](https://www.iana.org/assignments/jwt/jwt.xhtml#claims) では、<Tooltip tip="OpenID: アプリケーションがログイン情報を収集および保存することなく、ユーザーの本人確認を行えるようにする認証のためのオープン標準です。" cta="用語集を表示" href="/docs/ja-jp/glossary?term=OpenID">OpenID</Tooltip> Connect (OIDC) によって登録された公開クレームの例をいくつか確認できます。

* `auth_time`
* `acr`
* `nonce`

<div id="private-claims">
  ### プライベートクレーム
</div>

アプリケーション固有の情報を共有するためのプライベートなカスタムクレームを作成できます。たとえば、パブリッククレームには名前やメールアドレスといった一般的な情報が含まれるのに対し、プライベートクレームには社員IDや部署名のような、より具体的な情報が含まれます。

<div id="auth0-restrictions">
  ## Auth0 の制限事項
</div>

Auth0 では、カスタムクレームに関して以下の一般的な制限が適用されます。

* カスタムクレームのペイロードの最大サイズは 100KB です
* OIDC の標準クレームやその他の登録済み標準クレームの一部、および Auth0 が内部で使用するクレームは、カスタマイズまたは変更できません
* `/userinfo` エンドポイントを除き、Auth0 API のオーディエンスを持つアクセストークンに、名前空間のないプライベートなカスタムクレームを含めることはできません
* アクセストークンに追加できるのは、指定された OIDC のユーザープロファイルクレームのみです

カスタムクレームの詳細については、[Create Custom Claims](/docs/ja-jp/secure/tokens/json-web-tokens/create-custom-claims) を参照してください。

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

* [JSON Web Token の検証](/docs/ja-jp/secure/tokens/json-web-tokens/validate-json-web-tokens)
* [JSON Web Token の構造](/docs/ja-jp/secure/tokens/json-web-tokens/json-web-token-structure)
* [JSON Web Key Sets](/docs/ja-jp/secure/tokens/json-web-tokens/json-web-key-sets)
* [JSON Web Key Set のプロパティ](/docs/ja-jp/secure/tokens/json-web-tokens/json-web-key-set-properties)