> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-feat-init-gt-translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Auth0 Dashboard、Management API、Actions を使用して、テナントのセッションの有効期間を設定する方法を説明します。

# セッションの有効期間を設定する

セッションの有効期間を設定するには、Auth0 の [Dashboard](/docs/ja-jp/get-started/auth0-overview/dashboard)、[Management API](https://auth0.com/docs/api/management/v2)、または [Post-Login Action](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger) を使用できます。

<div id="auth0-dashboard">
  ## Auth0 Dashboard
</div>

Auth0 Dashboard を使用してセッションの有効期間を設定するには、次の手順に従います。

1. **Dashboard > Tenant Settings** に移動し、**Advanced** ビューを選択します。

2. **Session Expiration** では、次の項目を設定できます。

| Session Policy                                | Description                              |
| --------------------------------------------- | ---------------------------------------- |
| **Idle Session Lifetime (Persistent)**        | 永続セッションが期限切れになるまでの、非アクティブ状態の最大時間 (分) 。   |
| **Idle Session Lifetime (Non-Persistent)**    | 非永続セッションが期限切れになるまでの、非アクティブ状態の最大時間 (分) 。  |
| **Maximum Session Lifetime (Persistent)**     | ユーザーがアクティブであっても、永続セッションを維持できる最大時間 (分) 。  |
| **Maximum Session Lifetime (Non-Persistent)** | ユーザーがアクティブであっても、非永続セッションを維持できる最大時間 (分) 。 |

<Frame>
  <img src="https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=afc90a5696d96ed89c804db0ec8aea76" alt="Dashboard > Tenant > Settings > Advanced > Session Expiration" data-og-width="1404" width="1404" data-og-height="995" height="995" data-path="docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?w=280&fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=9faa940db1c874bf31a53a3d6f0ea4c5 280w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?w=560&fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=cd10fb9616dd86b21b9041a30a86ee00 560w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?w=840&fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=5f3d8a6dafad783a86866846e6c9d7ba 840w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?w=1100&fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=926e452ecab65b48ed916da7604fc98c 1100w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?w=1650&fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=8c0d555749a5a8c1875b26edbbdcdbde 1650w, https://mintcdn.com/docs-dev-feat-init-gt-translations/2eg7X7TgyYFJUdNP/docs/images/cdy7uua7fh8z/session-lifetime/Dashboard-Tenant-Settings-Advanced-Session-expiration.png?w=2500&fit=max&auto=format&n=2eg7X7TgyYFJUdNP&q=85&s=79747a2595b692d8576221beb44dd044 2500w" />
</Frame>

<div id="auth0-management-api">
  ## Auth0 Management API
</div>

Auth0 Management API を使用してセッションの有効期間を設定するには、次のようにします。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  `/api/v2/tenants/settings` エンドポイントを呼び出すには、`update:tenant_settings` スコープを持つ [Management API access token](/docs/ja-jp/secure/tokens/access-tokens) が必要です。
</Callout>

[/api/v2/tenants/settings](/docs/ja-jp/api/management/v2/tenants/patch-settings) エンドポイントに `PATCH` リクエストを送信します。

<Tabs>
  <Tab title="Auth0 CLI">
    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">Auth0 CLI をお使いですか？まだの場合は、このコマンドを実行する前に [CLI セッションのセットアップと認証](/docs/ja-jp/deploy-monitor/auth0-cli)を行ってください。</Callout>

    ```bash theme={null}
    auth0 api patch "tenants/settings" \
      --data '{     "session_lifetime": SESSION_LIFETIME_VALUE,     "idle_session_lifetime": IDLE_SESSION_LIFETIME_VALUE,     "ephemeral_session_lifetime": EPHEMERAL_SESSION_LIFETIME_VALUE,     "idle_ephemeral_session_lifetime": EPHEMERAL_IDLE_SESSION_LIFETIME_VALUE   }'
    ```
  </Tab>

  <Tab title="cURL">
    ```bash cURL theme={null}
    curl --request PATCH \
      --url 'https://<your-domain>/api/v2/tenants/settings' \
      --header 'Authorization: Bearer MGMT_API_ACCESS_TOKEN' \
      --header 'Content-Type: application/json' \
      --data '{\
        "session_lifetime": SESSION_LIFETIME_VALUE,\
        "idle_session_lifetime": IDLE_SESSION_LIFETIME_VALUE,\
        "ephemeral_session_lifetime": EPHEMERAL_SESSION_LIFETIME_VALUE,\
        "idle_ephemeral_session_lifetime": EPHEMERAL_IDLE_SESSION_LIFETIME_VALUE\
      }'
    ```
  </Tab>
</Tabs>

| パラメータ                             | 説明                                           |
| --------------------------------- | -------------------------------------------- |
| `session_lifetime`                | 絶対タイムアウトまでの最大時間 (時間単位) 。                     |
| `idle_session_lifetime`           | 非アクティブ状態が続いた場合にセッションが期限切れになるまでの最大時間 (時間単位) 。 |
| `ephemeral_session_lifetime`      | 絶対タイムアウトまでの最大時間 (時間単位) 。                     |
| `idle_ephemeral_session_lifetime` | 非アクティブ状態が続いた場合にセッションが期限切れになるまでの最大時間 (時間単位) 。 |

<div id="auth0-post-login-actions">
  ## Auth0 Post-Login Actions
</div>

[post-login Action](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger) で `api.session` メソッドを使用すると、セッションの動作を動的に構成できます。これにより、ユーザーごと、またはコンテキストに応じたロジックに基づいて、ログインのたびにテナントのデフォルトのセッション設定を上書きできます。

主なユースケースは次のとおりです。

* リスクの高いログインではタイムアウトを短くする

* 信頼できるユーザーや組織ではタイムアウトを延長する

* アプリケーションの種類に応じて Cookie の永続性を調整する

セッションの有効期間の設定に使用できる `api.session` メソッドは次のとおりです。

* `api.session.setExpiresAt`

* `api.session.setIdleExpiresAt`

* `api.session.setCookieMode`

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  `api.session` メソッドは現在のセッションにのみ適用され、ログイントランザクション中に呼び出す必要があります。これらのメソッドを使用するには、イベントプロパティ `event.session.id` を利用できる必要があります。
</Callout>

詳しくは、[Sessions with Actions](/docs/ja-jp/manage-users/sessions/manage-sessions-actions) を参照してください。
