> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

# アクションのトリガー：ログイン後 - APIオブジェクト

> Post-Loginアクショントリガー のAPIオブジェクトについて説明します。

Post-Login アクショントリガーの API オブジェクトには以下が含まれます。

<div id="apiaccess">
  ## `api.access`
</div>

ログイン試行の拒否などでユーザーのログインアクセスを修正します。

<div id="apiaccessdenyreason">
  ### `api.access.deny(reason)`
</div>

現在のログイン試行を「拒否」としてマークします。これによりエンドユーザーがログインフローを完了できなくなります。ただし、このアクションから要求されたユーザー関連の他の副次的な影響（メタデータの変更など）はキャンセル*しません*。 このアクションの完了後、ログインフローはすぐに停止し、以降のアクションは実行されません。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`reason`</td>

      <td>
        <p>
          <em>文字列</em>
          。ログインを拒否するための、人間が理解できる説明。これは`error_description`として要求を開始したアプリケーションに送信されます。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiaccesstoken">
  ## `api.accessToken`
</div>

発行されたアクセストークンを変更する要求。

<div id="apiaccesstokensetcustomclaimname-value">
  ### `api.accessToken.setCustomClaim(name, value)`
</div>

ログインフローの完了に発行されるアクセストークンへのカスタムクレームを設定します。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`name`</td>

      <td>
        <p>
          <em>文字列</em>
          。クレームの名前（これは完全修飾URLが必要な場合があります）。
        </p>
      </td>
    </tr>

    <tr>
      <td>`value`</td>

      <td>
        <p>
          <em>すべての値</em>。クレームの値。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiaccesstokenaddscopescope">
  ### `api.accessToken.addScope(scope)`
</div>

ログインフローの完了に発行されるアクセストークンへのスコープを追加します。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`scope`</td>

      <td>
        <p>
          <em>文字列</em> 追加するスコープ。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiaccesstokenremovescopescope">
  ### `api.accessToken.removeScope(scope)`
</div>

ログインフローの完了に発行されるアクセストークンへのスコープを削除します。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`scope`</td>

      <td>
        <p>
          <em>文字列</em> 削除するスコープ。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiauthentication">
  ## `api.authentication`
</div>

現在のユーザーセッションの認証状態の変更を要求します。

<div id="apiauthenticationrecordmethodprovider_url">
  ### `api.authentication.recordMethod(provider_url)`
</div>

現在のセッションで完了したカスタム認証メソッドを示します。このメソッドは、後続のログインの`event.authentication.methods`配列で可能になります。

**重要** ：この API は`PostLogin`Actions の`onContinuePostLogin` 機能でのみ可能です。言い換えると、これは`api.redirect.sendUserTo()`を介してユーザーをリダイレクトした後、カスタム認証メソッドの完了を記録するために使用できます。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`provider_url`</td>

      <td>
        <p>
          <em>文字列</em>。完了したカスタム認証方法の IDを示すURL。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiauthenticationchallengewithfactor-options">
  ### `api.authentication.challengeWith(factor, options)`
</div>

1 つ以上の指定された多要素認証の要素でユーザーチャレンジを行います。このメソッドは、まずデフォルトのオプションでチャレンジし、追加の要素が提供された場合にはユーザーが異なるオプションを選択できるようにします。ユーザーが、提供されたどの要素でも登録していない場合（デフォルトと追加要素の両方を含む）、コマンドは失敗します。

**注意** ：このメソッドは、テナント内で MFA を有効または無効にする既存のポリシーやルールを上書きします。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`factor`</td>

      <td>
        <p><em>オブジェクト</em>。`type`フィールドを含むオブジェクト。`type`は、デフォルトのMFA要素またはユーザーチャレンジに使用される要素を指定するために使用される文字列です。</p>
        <p>対応する値には次のものが含まれます：</p>

        <ul>
          <li>`otp`</li>
          <li>`recovery-code`</li>
          <li>`email`</li>
          <li>`push-notification`</li>

          <ul>
            <li>`otpFallback``false`に設定されている場合、ユーザーはプッシュ通知ファクターのOTPフォールバックオプションを使用できません。</li>
          </ul>

          <li>`phone`</li>

          <ul>
            <li>`preferredMethod: voice`</li>
            <li>`preferredMethod: sms`</li>
            <li>`preferredMethod: both`</li>
          </ul>

          <li>`webauthn-platform`</li>
          <li>`webauthn-roaming`</li>
        </ul>

        <p>例</p>

        <p>
          ```
          api.authentication.challengeWith({ 
              type: 'phone', 
              options: { preferredMethod: 'both'} 
            });`
          ```
        </p>
      </td>
    </tr>

    <tr>
      <td>`options`</td>

      <td>
        <p><em>任意のオブジェクト</em>。任意の`additionalFactors`フィールドを含むオブジェクト。</p>
        <p>`additionalFactors` は、MFAチャレンジを完了する際にユーザーが選択できる他のファクターを指定するために使用される配列です。`type`フィールドと同じ値をサポートします。</p>
        <p>例</p>

        <p />

        ```
        api.authentication.challengeWith({
            type: 'otp'
          }, {  
            additionalFactors: [{
              type: 'push-notification'
            }, {
              type: 'phone'
            }]
          })`
        ```

        <p />
      </td>
    </tr>
  </tbody>
</table>

<div id="apiauthenticationchallengewithanyfactors">
  ### `api.authentication.challengeWithAny(factors)`
</div>

MFA チャレンジをトリガーし、ユーザーに提供されたリストから好みのファクターを選択させます。このメソッドは、次の条件に従って、ユーザーに特定のチャレンジではなく、ファクターピッカーを提示します：

* 複数のファクターが指定された場合、ファクターピッカーはユーザーに表示されます。
* ユーザーが指定ファクターの 1 つでのみに登録されている場合（またはファクターが 1 つだけ指定されている場合）、ファクターピッカーはスキップされます。
* ユーザーがどの指定ファクターでも登録していない場合、チャレンジコマンドは失敗します。

**注意** ：このメソッドは、テナント内で MFA を有効または無効にする既存のポリシーやルールを上書きします。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`factors`</td>

      <td>
        <p>
          <em>配列</em>
          。`type`フィールドを含むオブジェクトの配列。`type`はチャレンジされた際、MFAファクターを指定するために使用される文字列です。
        </p>

        <p>対応する値には次のものが含まれます：</p>

        <ul>
          <li>`otp`</li>
          <li>`recovery-code`</li>
          <li>`email`</li>
          <li>`push-notification`</li>

          <ul>
            <li>
              `otpFallback``true`に設定されている場合、ユーザーはプッシュ通知ファクターのOTPフォールバックオプションを使用できません。
            </li>
          </ul>

          <li>`phone`</li>

          <ul>
            <li>`preferredMethod: voice`</li>
            <li>`preferredMethod: sms`</li>
            <li>`preferredMethod: both`</li>
          </ul>

          <li>`webauthn-platform`</li>
          <li>`webauthn-roaming`</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiauthenticationenrollwithfactor-options">
  ### `api.authentication.enrollWith(factor, options)`
</div>

ユーザーが特定の MFA ファクターで登録するようにします。このメソッドは、ユーザーがデフォルトのファクターで登録するように最初は促しますが、追加の要素が提供された場合にはユーザーが異なるオプションを任意で選択できるようにします。ユーザーが提供されたすべてのファクター（デフォルトの値と追加要素の両方を含む）で登録済みの場合には、コマンドは失敗します。

**注意** ：このメソッドは、テナント内で MFA を有効または無効にする既存のポリシーやルールを上書きします。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`factor`</td>

      <td>
        <p><em>オブジェクト</em>。`type`フィールドを含むオブジェクト。`type`は、ユーザーが登録の際に指示されるデフォルトのMFA要素を指定するために使用される文字列です。</p>
        <p>対応する値には次のものが含まれます：</p>

        <ul>
          <li>`otp`</li>
          <li>`recovery-code`</li>
          <li>`push-notification`</li>
          <li>`phone`</li>

          <ul>
            <li>`preferredMethod: voice`</li>
            <li>`preferredMethod: sms`</li>
            <li>`preferredMethod: both`</li>
          </ul>

          <li>`webauthn-platform`</li>
          <li>`webauthn-roaming`</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>`options`</td>

      <td>
        <p><em>任意のオブジェクト</em>。任意の`additionalFactors`フィールドを含むオブジェクト。</p>
        <p>`additionalFactors`は、ユーザーが登録の際に選択できる他のファクターを指定するために使用される配列です。`type`フィールドと同じ値をサポートします。</p>
        <p>例</p>

        <p />

        ```
        api.authentication.enrollWith({
            type: 'otp'
          }, {
            additionalFactors: [{
              type: 'push-notification'
            }, {
              type: 'phone'
            }]
          })`
        ```

        <p />

        <p />

        <p>例</p>

        <p />

        ```
        api.authentication.enrollWith({
            type: 'otp'
          }, {
            additionalFactors: [{
              type: 'push-notification'
            }, {
              type: 'phone'
            }]
          })`
        ```

        <p />
      </td>
    </tr>
  </tbody>
</table>

<div id="apiauthenticationenrollwithanyfactors">
  ### `api.authentication.enrollWithAny(factors)`
</div>

ユーザーに提示リストから登録に使う MFA ファクターを選択させます。このメソッドは、次の条件に従って、ユーザーにデフォルトのファクタープロンプトではなく、ファクターピッカーを提示します：

* 複数のファクターが指定された場合、ファクターピッカーがユーザーに表示されます。
* ユーザーが 1 つを除く他のすべての提示ファクターで登録済みの場合は、ファクターピッカーはスキップされ、ユーザーは残りのファクターで登録するように促されます。
* ユーザーが提供されたすべてのファクターで登録済みの場合には、コマンドは失敗します。

**注意** ：このメソッドは、テナント内で MFA を有効または無効にする既存のポリシーやルールを上書きします。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`factors`</td>

      <td>
        <p>
          <em>配列</em>
          。`type`フィールドを含むオブジェクトの配列。`type`は、ユーザーが登録の際に指示されるデフォルトのMFA要素を指定するために使用される文字列です。
        </p>

        <p>対応する値には次のものが含まれます：</p>

        <ul>
          <li>`otp`</li>
          <li>`recovery-code`</li>
          <li>`push-notification`</li>
          <li>`phone`</li>

          <ul>
            <li>`preferredMethod: voice`</li>
            <li>`preferredMethod: sms`</li>
            <li>`preferredMethod: both`</li>
          </ul>

          <li>`webauthn-platform`</li>
          <li>`webauthn-roaming`</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiauthenticationsetprimaryuserprimary_user_id">
  ### `api.authentication.setPrimaryUser(primary_user_id)`
</div>

ログイントランザクションのプライマリユーザーを変更します。ユーザー連携を必要とするシナリオでは、ログインを始めるために使用するユーザー ID は、もはや個別のユーザーとして存在しないことがあります。そのような ID は既存ユーザーのセカンダリアイデンティティーになります。そのような状況では、`setPrimaryUser()`関数を使用して、ログインの対象を変更することができます。

重要：

* セキュリティの脆弱性をもたらすことなくアカウントをリンクすることで、悪意のあるアクターが正当なユーザーアカウントにアクセスできるようになる可能性があります。したがって、テナントはリンクが行われる前に両方のアカウントの認証を要求すべきです。
* ログインの認証に使用される ID は、`primary_user_id`で参照されるユーザーのセカンダリ ID の中に含まれている必要があります。ログインは失敗し、その結果トークンは発行されません。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`primary_user_id`</td>

      <td>
        <p>
          <em>文字列</em>
          。トークンが発行される（`sub`クレーム）べきユーザーのユーザーID。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apicache">
  ## `api.cache`
</div>

実行間で維持されるデータの保管と取得を行います。

<div id="apicachedeletekey">
  ### `api.cache.delete(key)`
</div>

提供された key にキャッシュ済みの値が存在する場合は、それを記述したレコードを削除します。

値がキャッシュから削除されると、`CacheWriteResult`オブジェクトに`type: "success"`を含めて返します。操作に失敗すると、`type: "error"`を返します。エラーの場合には、返すオブジェクトに`code`プロパティを含めて、失敗の詳細を示します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`key`</td>

      <td>
        <p>
          <em>文字列</em>。キャッシュに保管されているレコードのキー。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apicachegetkey">
  ### `api.cache.get(key)`
</div>

提供された`key`にキャッシュ済みの値が存在する場合は、それを記述したレコードを取得します。レコードが見つかった場合には、返されたオブジェクトの`value`プロパティにキャッシュ済みの値があります。

提供された`key`にキャッシュ済みの項目が存在する場合は、それを記述したレコードを返します。キャッシュレコードは、キャッシュされた値のある`value`プロパティと、レコードの最大有効期限を UNIX エポックからのミリ秒単位で示す`expires_at`プロパティを含むオブジェクトです。

**重要：** このキャッシュは、短命で一時的なデータ向けに設計されています。項目が所定のライフタイム内であったとしても、後のトランザクションでは利用できないかもしれません。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`key`</td>

      <td>
        <p>
          <em>文字列</em>。キャッシュに保管されているレコードのキー。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apicachesetkey-value-options">
  ### `api.cache.set(key, value, [options])`
</div>

指定された key のキャッシュに文字列値を保管または更新します。

このキャッシュに保管された値は、それを設定するトリガーにスコープが限定されます。これは[アクションのキャッシュ制限](/docs/ja-JP/ja-jp/customize/actions/limitations)の対象になります。

このように保管された値には、指定された`ttl`または`expires_at`値までのライフタイムがあります。ライフタイムが指定されない場合には、デフォルトのライフタイムである 15 分が使用されます。ライフタイムは[アクションのキャッシュ制限](/docs/ja-JP/ja-jp/customize/actions/limitations)が定める最大値を超過してはいけません。

値の保存に成功すると、`CacheWriteSuccess`を返します。成功しなかった場合は`CacheWriteError`を受け取ります。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`key`</td>

      <td>
        <p>
          <em>文字列</em>。キャッシュに保管されているレコードのキー。
        </p>
      </td>
    </tr>

    <tr>
      <td>`value`</td>

      <td>
        <p>
          <em>文字列</em>。保管するレコードの値。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options`</td>

      <td>
        <p>
          <em>任意のオブジェクト</em>
          。キャッシュの動作を調整するためのオプション。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.expires_at`</td>

      <td>
        <p>
          <em>任意の数値</em>
          。UNIXエポックからのミリ秒単位で指定した絶対有効期限です。キャッシュ済みのレコードは早期に削除されることはあっても、`expires_at`で指定された時点を過ぎて存続することはありません。
        </p>

        <p>
          <em>注意：</em>
          この値が`ttl`で指定されている場合は指定するべきではありません。両方で指定された場合、2つの中で早い方の有効期限が適用されます。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.ttl`</td>

      <td>
        <p>
          <em>任意の数値</em>
          。このキャッシュエントリーのミリ秒単位で指定した存続時間。キャッシュ済みのレコードは早期に削除されることはあっても、`ttl`で指定された時点を過ぎて存続することはありません。
        </p>

        <p>
          <em>注意：</em>
          この値が`expires_at`で指定されている場合は指定するべきではありません。両方で指定された場合、2つの中で早い方の有効期限が適用されます。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiidtoken">
  ## `api.idToken`
</div>

発行された ID トークンを変更する要求。

<div id="apiidtokensetcustomclaimname-value">
  ### `api.idToken.setCustomClaim(name, value)`
</div>

ログインフローの完了時に発行される ID トークンへのカスタムクレームを設定します。

`api`オブジェクトへの参照を返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`name`</td>

      <td>
        <p>
          <em>文字列</em>
          。クレームの名前（これは完全修飾URLが必要な場合があります）。
        </p>
      </td>
    </tr>

    <tr>
      <td>`value`</td>

      <td>
        <p>
          <em>任意の値</em>。クレームの値。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apimultifactor">
  ## `api.multifactor`
</div>

ログイン試行でも多要素認証のための要件を設定します。

<div id="apimultifactorenableprovider-options">
  ### `api.multifactor.enable(provider, options)`
</div>

このログインフローの多要素認証を有効にします。有効にした場合、ユーザーは設定された多要素認証チャレンジを完了する必要があります。実際の多要素認証チャレンジは、ログインフローの終了時に延期されます。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`provider`</td>

      <td>
        <p>
          <em>文字列</em>
          。使用する多要素認証プロバイダーの名前、または`any`の値を使用して、構成されたプロバイダーのいずれかを使用します。
        </p>

        <p>次の値に対応しています。</p>

        <ul>
          <li>`any`任意の設定されたチャレンジを使用します。</li>
          <li>`duo`Duo多要素認証プロバイダーを使用します。</li>

          <li>
            `google-authenticator`Google Authenticatorプロバイダーを使用します。
          </li>

          <li>`guardian`Guardianプロバイダーを使用します。</li>

          <li>
            `none`MFAフローのトリガーを防ぐために設定されたチャレンジを使用しません。
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>`options`</td>

      <td>
        <p>
          <em>任意のオブジェクト</em>
          。多要素認証チャレンジを有効にする追加のオプション。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.allowRememberBrowser`</td>

      <td>
        <p>
          <em>任意のブール値</em>
          。プロバイダーが`google-authenticator`または`duo`に設定されている場合、ユーザーは30日ごとにMFAを促されます。プロバイダーが`guardian`に設定されている場合、MFAプロンプトが登録チェックボックスを表示して、
          ユーザーに登録するかしないかを選択させます。デフォルトは`false`です。詳細はこちらをご覧ください：

          <a href="https://auth0.com/docs/secure/multi-factor-authentication/customize-mfa ">
            多要素認証ページをカスタマイズする
          </a>
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.providerOptions`</td>

      <td>
        <p>
          <em>任意のオブジェクト</em>
          。チャレンジを設定する追加オプションで、`duo`プロバイダーに使用可能です。
        </p>

        <p>対応オプションは次の通りです：</p>

        <ul>
          <li>
            `host` <em>文字列</em>。これはDuoアカウントのAPIホスト名の値です。
          </li>

          <li>
            `ikey` <em>文字列</em>
            。これはDuoアカウントからのクライアントID（旧Integration key（統合キー））値です。
          </li>

          <li>
            `skey` <em>文字列</em>
            。これはDuoアカウントからのクライアントID（旧Secret key（シークレットキー））です。
          </li>

          <li>
            `username` <em>任意の文字列</em>
            。DuoSecurityのユーザー名として、いくつかのプロファイル属性を使用します。またこれは、Duoに登録されたユーザーを持っている場合に便利です。
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiredirect">
  ## `api.user`
</div>

ログインしているユーザーのメタデータに対してアプリケーション固有の変更を行います。

*注意： **これらのメソッドを呼び出しても、即座にメタデータのアップデートは行われません** 。同じフローの複数アクションから複数回呼び出すことができます。またエンジンは変更を集約し、 **フローが完了する前にメタデータを一度に更新します** 。*

<div id="apiredirectencodetokenoptions">
  ### `api.user.setAppMetadata(name, value)`
</div>

ログインしているユーザーに対してアプリケーションメタデータを設定します。app\_metadata に保存されたデータは、ユーザーが編集することはできません。

注意：このトリガーは Management API を呼び出し、Management API レート制限を消費します。この要求がレート制限に達し、タイムアウト制限時間内に再試行できなかった場合は、`Deadline Exceeded`エラーを受け取ります。

`api`オブジェクトへの参照を返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`name`</td>

      <td>
        <p>
          <em>文字列</em>。メタデータプロパティの名前。
        </p>
      </td>
    </tr>

    <tr>
      <td>`value`</td>

      <td>
        <p>
          <em>任意の値</em>。メタデータプロパティの値。メタデータプロパティを
          削除するために`null`に設定されていることがあります。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apiredirectsendusertourl-options">
  ### `api.user.setUserMetadata(name, value)`
</div>

ログインしているユーザーの一般メタデータを設定します。

注意：このトリガーは Management API を呼び出し、Management API レート制限を消費します。この要求がレート制限に達し、タイムアウト制限時間内に再試行できなかった場合は、`Deadline Exceeded`エラーを受け取ります。

`api`オブジェクトへの参照を返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`name`</td>

      <td>
        <p>
          <em>文字列</em>。メタデータプロパティの名前。
        </p>
      </td>
    </tr>

    <tr>
      <td>`value`</td>

      <td>
        <p>
          <em>任意の値</em>
          。メタデータプロパティの値。メタデータプロパティを削除するために`null`に設定されていることがあります。
        </p>
      </td>
    </tr>
  </tbody>
</table>

## `api.redirect`

### `api.redirect.encodeToken(options)`

リダイレクト先（`sendUserTo`経由）のクエリ文字列パラメーターとして使用可能で、信頼性を対象のエンドポイントで証明可能なデータを含むセッショントークンを作成します。対象のエンドポイントは共有シークレットで JWT の署名を確認して、信頼性とデータの整合性を検証できます。

JWT 文字列を返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`options`</td>

      <td>
        <p>
          <em>オプション</em>
          。結果のURLのクエリパラメーターに機密データをどのように暗号化するのかを構成します。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.expiresInSeconds`</td>

      <td>
        <p>
          <em>数値</em>。トークンが期限切れになるまでの秒数（デフォルトは900）。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.payload`</td>

      <td>
        <p>
          <em>オプション</em>
          。リダイレクト先に渡され、信頼性と整合性が証明可能であるべきデータ。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.secret`</td>

      <td>
        <p>
          <em>文字列</em>
          。リダイレクト先と共有され、JWTの署名に使用されるシークレット。シークレット値はシークレットとして保管され、`event.secrets['SECRET_NAME']`を使用して取得されなければなりません。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apirefreshtokenrevokereason">
  ### `api.redirect.sendUserTo(url, options)`
</div>

アクションが完了した直後に、ブラウザーを目的の`url`にリダイレクトさせます。

`api`オブジェクトへの参照を返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`url`</td>

      <td>
        <p>
          <em>文字列</em>。リダイレクト先のURL。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options`</td>

      <td>
        <p>
          <em>オプション</em>
          。リダイレクトURLに追加される任意のクエリ文字列パラメーターを表すオブジェクト。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.query`</td>

      <td>
        <p>
          <em>オプション</em>
          。リダイレクトURLに追加する追加のクエリ文字列パラメーター。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apirefreshtokensetexpiresatabsolute">
  ### `api.redirect.validateToken(options)`
</div>

JWT トークンに含めて`/continue`エンドポイントに渡された暗号化済みのデータを取得すると同時に、そのデータの信頼性と整合性を検証します。

JWT トークンのペイロードを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`options`</td>

      <td>
        <p>
          <em>オプション</em>
          。リダイレクト後に、JWTトークンに含めて`/continue`エンドポイントに渡された暗号化済みのデータを取得するためのオプション。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.secret`</td>

      <td>
        <p>
          <em>文字列</em>。トークンの暗号化に使用されたシークレット。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options.tokenParameterName`</td>

      <td>
        <p>
          <em>文字列</em>
          。`/continue`エンドポイントに送信されたクエリまたは本文のパラメーターの名前。デフォルト：`session_token`
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apirefreshtokensetidleexpiresatidle">
  ### `api.rules`
</div>

現在のトランザクション中に実行したルールについての情報を取得します。

<div id="apirules">
  ### `api.rules.wasExecuted(ruleId)`
</div>

現在のトランザクションにおけるこのアクションの前に特定のルールが実行されたかを確認します。アクションへの移行中に「そのルールからこのアクションに移行する」ロジックが重複して実行されることを防ぐために使用できます。このメソッドでは、指定した ID のルールがこのトランザクションで実行されたことがある場合には`true`が返され、 そうでなかった場合は`false`が返されます。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`ruleId`</td>

      <td>
        <p>文字列。確認するルールID。</p>
      </td>
    </tr>
  </tbody>
</table>

## `api.samlResponse`

ログインしているユーザーの SAML 応答を修正します。

### `api.samlResponse.setAttribute(attribute, value)`

カスタムの SAML 属性を設定します。

失敗した操作は、`Error`をスローします。エラーについて、返されたオブジェクトは、失敗の性質を示すメッセージを持ちます。

値は、`SAMLValue`タイプでなければならず、次のものが可能です。
`string | number | boolean | null | Array`

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`attribute`</td>

      <td>
        <p>
          <em>文字列</em>。設定されるSAML属性。
        </p>
      </td>
    </tr>

    <tr>
      <td>`value`</td>

      <td>
        <p>
          <em>SAMLValue</em>
          。SAMLアサーションの値。属性プロパティを削除するために`null`に設定されていることがあります。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetattributeattribute-value">
  ### `api.samlResponse.setAudience(audience)`
</div>

SAML 応答のオーディエンスを変更します。デフォルトは、SAMLRequest の発行者です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`audience`</td>

      <td>
        <p>
          <em>文字列</em>。設定されるSAMLオーディエンス。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetaudienceaudience">
  ### `api.samlResponse.setEncryptionPublicKey(publicKey)`
</div>

SAML アサーションの暗号化に使用される公開鍵を任意に指定します。公開鍵はサービスプロバイダーから取得されるべきです。公開鍵と証明書の両方が指定される必要があります。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`publicKey`</td>

      <td>
        <p>
          <em>文字列</em>。設定される公開鍵です。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetissuerissuer">
  ### `api.samlResponse.setRecipient(recipient)`
</div>

SAML アサーションの受信者を変更します（SubjectConfirmationData）。デフォルトは、`SAMLRequest`の`AssertionConsumerUrl`または SAMLRequest が送られなかった場合は Callback URL です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`recipient`</td>

      <td>
        <p>
          <em>文字列</em>。設定されるSAML受信者です。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetencryptionpublickeypublickey">
  ### `api.samlResponse.setCreateUpnClaim(createUpnClaim)`
</div>

UPN クレームが作成されるべきかどうかを指示します。デフォルトは`true`です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`createUpnClaim`</td>

      <td>
        <p>
          <em>ブール値</em>切り替えて、UPNクレームを作成します。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetrecipientrecipient">
  ### `api.samlResponse.setPassthroughClaimsWithNoMapping(passthroughClaimsWithNoMapping)`
</div>

`true`の場合（デフォルト）、共通プロファイルにマッピングされていない各クレームは、Auth0 がそれらを通じて出力アサーションに渡します。`false`の場合、それらのクレームはマップされません。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`passthroughClaimsWithNoMapping`</td>

      <td>
        <p>
          <em>ブール値</em>{" "}
          クレームを出力アサーションにマッピングするかどうかを指定します。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetcreateupnclaimcreateupnclaim">
  ### `api.samlResponse.setMapUnknownClaimsAsIs(mapUnknownClaimsAsIs)`
</div>

`passthroughClaimsWithNoMapping`が`true`で、これが`false`の場合（デフォルト）、共通プロファイルにマッピングされていない各クレームは、Auth0 がプレフィックス（[http://schema.auth0.com）を追加します。\`true\`の場合、クレームをそのままパススルーします。](http://schema.auth0.com）を追加します。`true`の場合、クレームをそのままパススルーします。)

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`mapUnknownClaimsAsIs`</td>

      <td>
        <p>
          <em>ブール値</em>クレームをそのままマッピングするかどうか。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetpassthroughclaimswithnomappingpassthroughclaimswithnomapping">
  ### `api.samlResponse.setMapIdentities(mapIdentities)`
</div>

`true`の場合（デフォルト）、これによりプロバイダー（Google、ADFS、AD など）や、利用可能な場合アクセストークンなどの追加情報がトークンに付け足されます

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`mapIdentities`</td>

      <td>
        <p>
          <em>ブール値</em>IDをマッピングするかどうか。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetmapunknownclaimsasismapunknownclaimsasis">
  ### `api.samlResponse.setDestination(destination)`
</div>

SAML 応答の宛先。指定されていない場合、SAMLRequest の AsserionConsumerUrl になり、SAMLRequest がない場合は、Callback URL になります。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`destination`</td>

      <td>
        <p>
          <em>文字列</em>SAML応答の宛先。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetmapidentitiesmapidentities">
  ### `api.samlResponse.setLifetimeInSeconds(lifetimeInSeconds)`
</div>

トークンの有効期限（秒）。デフォルトでは`3600`秒（1 時間）です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`lifetimeInSeconds`</td>

      <td>
        <p>
          <em>数字</em>トークンの有効期限（秒）。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetdestinationdestination">
  ### `api.samlResponse.setSignResponse(signResponse)`
</div>

SAML 応答が署名されるべきかどうか。デフォルトでは、SAML アサーションは署名されますが、SAML 応答は署名されません。`true`の場合、SAML アサーションではなく SAML 応答が署名されます。デフォルトは`false`です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`signResponse`</td>

      <td>
        <p>
          <em>ブール値</em>SAML応答が署名されるべきかどうか。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetrelaystaterelaystate">
  ### `api.samlResponse.setNameIdentifierFormat(nameIdentifierFormat)`
</div>

名前 ID 形式を設定します。デフォルトは`urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified`です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`nameIdentifierFormat`</td>

      <td>
        <p>
          <em>文字列</em>名前IDの形式
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetlifetimeinsecondslifetimeinseconds">
  ### `api.samlResponse.setNameIdentifierProbes(nameIdentifierProbes)`
</div>

Auth0 はこの配列の各属性に順番に名前を付けようとします。その一つが 値を持つ場合は、それを件名/名前 ID に使用します。順序：

1. [http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier)
   （`user_id`からマッピング）
2. [http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress（](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress（)
   `email`からマッピング）
3. [http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name](http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name) （
   `name`からマッピング）

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`nameIdentifierProbes`</td>

      <td>
        <p>
          <em>文字の配列</em>名前識別子を取得するために試す属性の配列。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetsignresponsesignresponse">
  ### `api.samlResponse.setAuthnContextClassRef(authnContextClassRef)`
</div>

デフォルトは`urn:oasis:names:tc:SAML:2.0:ac:classes:unspecified`です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`authnContextClassRef`</td>

      <td>
        <p>
          <em>文字列</em>AuthnContextClassRef。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetnameidentifierformatnameidentifierformat">
  ### `api.samlResponse.setSigningCert(signingCert)`
</div>

SAML 要求の検証に使用される公開鍵証明書を任意に示します。設定された場合、SAML 要求の署名が必要になります。サンプル値は次のようになります：
`"-----BEGIN
CERTIFICATE-----\nMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV\n[..all
the other lines..]-----END CERTIFICATE-----\n"`.

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`signingCert`</td>

      <td>
        <p>
          <em>文字列</em>SAML要求の検証に使用される任意の公開鍵証明書。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetnameidentifierprobesnameidentifierprobes">
  ### `api.samlResponse.setIncludeAttributeNameFormat(includeAttributeNameFormat)`
</div>

`true`に設定された場合、属性名に基づいた NameFormat を推測します。NameFormat 値は次の通りです：
`urn:oasis:names:tc:SAML:2.0:attrname-format:uri`、
`urn:oasis:names:tc:SAML:2.0:attrname-format:basic`、
`urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified`。

`false`に設定された場合、属性 NameFormat はアサーションに設定されません。デフォルトは`true`です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`includeAttributeNameFormat`</td>

      <td>
        <p>
          <em>ブール値</em>NameFormatは属性名に基づいて推測するべきかどうか。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetauthncontextclassrefauthncontextclassref">
  ### `api.samlResponse.setTypedAttributes(typedAttributes)`
</div>

`true`に設定された場合、要素の`xs:type`を推測します。型は、`xs:string`、`xs:boolean`、`xs:double`、`xs:anyType`です。`false`に設定された場合、すべての`xs:type`は`xs:anyType`になります。デフォルトは`true`です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`typedAttributes`</td>

      <td>
        <p>
          <em>ブール値</em>`xs:type`が推測されるべきかどうか。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetsigningcertsigningcert">
  ### `api.samlResponse.setEncryptionCert(encryptionCert)`
</div>

SAML アサーションの暗号化に使用される証明書を任意に指定します。証明書はサービスプロバイダーから取得されるべきです。証明書と公開鍵の両方が指定される必要があります。サンプル値は次のようになります：
`"-----BEGIN
CERTIFICATE-----\nMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV\n[..all
the other lines..]-----END CERTIFICATE-----\n"`.

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`encryptionCert`</td>

      <td>
        <p>
          <em>文字列</em>SAMLアサーションの暗号化に使用される任意の証明書。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetincludeattributenameformatincludeattributenameformat">
  ### `api.samlResponse.setCert(cert)`
</div>

デフォルトでは、Auth0 は SAML 応答やアサーションに署名するためのテナントに割り当てられた秘密鍵/公開鍵のペアを使用します。非常に特殊な場合、独自の証明書と秘密鍵を提供することが望ましいかもしれません。

証明書と秘密鍵の両方が指定される必要があります。

サンプル値は次のようになります：
`"-----BEGIN
CERTIFICATE-----\nMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV\n[..all
the other lines..]-----END CERTIFICATE-----\n"`.

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`cert`</td>

      <td>
        <p>
          <em>文字列</em>SAML応答またはアサーションに署名する任意の証明書。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesettypedattributestypedattributes">
  ### `api.samlResponse.setKey(key)`
</div>

デフォルトでは、Auth0 は SAML 応答やアサーションに署名するためのテナントに割り当てられた秘密鍵/公開鍵のペアを使用します。非常に特殊な場合、独自の証明書と秘密鍵を提供することが望ましいかもしれません。

この秘密鍵は機密であるため、
**［Actions のシークレット機能を追加する］** を使用することをおすすめします。詳細はこちらから：
最初のアクションを書く

証明書と秘密鍵の両方が指定される必要があります。

サンプル値は次のようになります：
`"-----BEGIN PRIVATE
KEY-----\nnMIIC8jCCAdqgAwIBAgIJObB6jmhG0QIEMA0GCSqGSIb3DQEBBQUAMCAxHjAcBgNV\n[..all
the other lines..]-----END PRIVATE KEY-----\n"`.

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`key`</td>

      <td>
        <p>
          <em>文字列</em>SAML応答またはアサーションに署名する任意の秘密鍵。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetencryptioncertencryptioncert">
  ### `api.samlResponse.setSignatureAlgorithm(signatureAlgorithm)`
</div>

**廃止** ：デフォルトは`rsa-sha256`

<table class="table">
  <thead>
    <tr>
      <th>ですパラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`signatureAlgorithm`</td>

      <td>
        <p>
          `rsa-sha256` | `rsa-sha1`。
          `rsa-sha1`は使用すべきではありません。安全性に問題があります。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<div id="apisamlresponsesetcertcert">
  ### `api.samlResponse.setDigestAlgorithm(digestAlgorithm)`
</div>

**廃止** ：デフォルトは`sha256`

です。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`digestAlgorithm`</td>

      <td>
        <p>
          `sha256` | `sha1`。
          `rsa-sha1`は使用すべきではありません。安全性に問題があります。
        </p>
      </td>
    </tr>
  </tbody>
</table>

## `api.session`

ユーザーセッションの取り消しなどでセッションを管理します。

<div id="apisamlresponsesetsignaturealgorithmsignaturealgorithm">
  ### `api.session.revoke(reason, options)`
</div>

現在のトランザクションを拒否し、セッションを取り消し、関連するリフレッシュトークンを削除します。ユーザーはフローを完了できなくなり、それ以降のアクションは実行されません。

**注意** この方法はセッション取り消しの[OIDC Back-Channel Logout Initiator（OIDC バックチャネルログアウトイニシエーター）](https://auth0.com/docs/authenticate/login/logout/back-channel-logout/oidc-back-channel-logout-initiators)を開始し、現在のセッションと関係するすべてのアプリケーションからユーザーをログアウトさせます。リフレッシュトークンに関連するセッションの削除は非同期の処理です。

`api`オブジェクトにリファレンスを返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`reason`</td>

      <td>
        <p>
          <em>文字列</em>。ログインを拒否するための、人間が理解できる説明。これはerror\_descriptionとして要求を開始したアプリケーションに送信されます。
        </p>
      </td>
    </tr>

    <tr>
      <td>`options`</td>

      <td>
        <p><em>preserveRefreshTokens</em>。ブール値で、取り消し後も同じsession\_idのセッションに結びついたリフレッシュトークンが保存されるかを特定するために使われます。デフォルトはfalseです。</p>
        <p>例</p>

        ```
          api.session.revoke('reason', 
                     {'preserveRefreshTokens':true} );`
        ```
      </td>
    </tr>
  </tbody>
</table>

## `api.refreshToken`

リフレッシュトークンの取り消しなどによってリフレッシュトークンを管理します。

### `api.refreshToken.revoke(reason)`

現在のトークン交換を拒否し、リフレッシュトークンを取り消します。これによりユーザーはフローを完了できなくなり、それ以降のアクションは実行されません。

`api`オブジェクトに参照を返します。

<table class="table">
  <thead>
    <tr>
      <th>パラメーター</th>
      <th>説明</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`reason`</td>

      <td>
        <p>
          <em>文字列</em>
          。リフレッシュトークンを拒否するための、人間が理解できる説明。これはerror\_descriptionとして要求を開始したアプリケーションに送信されます。
        </p>
      </td>
    </tr>
  </tbody>
</table>