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

> Auth0のリフレッシュトークンのメタデータについて説明します

# リフレッシュトークンのメタデータ

<Warning>
  リフレッシュトークンのメタデータは現在、Enterpriseのお客様のみを対象とした早期アクセス機能です。この機能を使用すると、Oktaの[Master Subscription Agreement](https://www.okta.com/legal)に定められた該当するFree Trial条件に同意したものとみなされます。Auth0の製品リリースサイクルの詳細については、[Product Release Stages](https://auth0.com/docs/troubleshoot/product-lifecycle/product-release-stages)を参照してください。
</Warning>

リフレッシュトークンのメタデータを使用すると、Auth0の[リフレッシュトークン](/ja/docs/secure/tokens/refresh-tokens)に、カスタマイズ可能なキーと値 (各最大255文字) を保存できます。

リフレッシュトークンのメタデータのユースケースには、次のようなものがあります。

* デバイス名やログイン場所などのデバイス情報を追跡する
* たとえば `user_accepted_terms` や `session_type` などのトークンレベルのフラグを保存する
* 同じフロー内の複数のActions間で状態を共有する
* トークンの発行または失効に条件付きロジックを適用する
* ユーザーコンテキストデータを認識する必要がある監査および分析パイプラインで使用する

Auth0の[Actions](/ja/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)と[Management API](https://auth0.com/docs/api/management/v2)を使用すると、リフレッシュトークンのライフサイクル全体を通じて、リフレッシュトークンのメタデータにアクセスして変更できます。

詳細については、[Configure Refresh Token Metadata](/ja/docs/secure/tokens/refresh-tokens/refresh-token-metadata/configure-refresh-token-metadata)を参照してください。

<div id="supported-flows">
  ## サポートされているフロー
</div>

次の OAuth 2.0 フローでは、Post-Login Actions を使用してリフレッシュトークンのメタデータを設定できます。

* Authorization Code Flow
* リソースオーナーパスワードグラント
* デバイス認可グラント
* フェデレーテッド接続フロー
* クライアント起点バックチャネル認証 (CIBA)
* ネイティブパスキー
* リフレッシュトークン交換

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  上記のサポート対象フローでは、いずれもリフレッシュトークンのメタデータを**設定**できます。ただし、既存のメタデータを **読み取れる** のは、`event.refresh_token` が存在する [リフレッシュトークン交換](/ja/docs/secure/tokens/refresh-tokens/use-refresh-tokens) のシナリオで、`event.refresh_token.metadata` オブジェクトを介する場合に限られます。初回ログイン時には `event.refresh_token` は存在しないため、メタデータは設定のみ可能で、読み取ることはできません。リフレッシュトークン交換中は、既存のメタデータの読み取りと新しい値の設定の両方が可能です。
</Callout>

リフレッシュトークン交換の実行時に Actions で設定したメタデータが適用されるのは、MFA チャレンジなどの中間ステップではなく、リフレッシュトークンの発行時です。

<div id="limitations">
  ## 制限事項
</div>

* リフレッシュトークンのメタデータは最大 25 件までです
* 各キーと値は 255 文字以下である必要があります
* メタデータのキーに使用できるのは、英字、数字、アンダースコア、ハイフンのみです

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

* [リフレッシュトークンのメタデータを設定する](/ja/docs/secure/tokens/refresh-tokens/refresh-token-metadata/configure-refresh-token-metadata)
* [Actions でリフレッシュトークンを使用する](/ja/docs/secure/tokens/refresh-tokens/manage-refresh-tokens-actions)
* [リフレッシュトークン](/ja/docs/secure/tokens/refresh-tokens)