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

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

セッションの有効期間を設定するには、Auth0 の Dashboard、Management API、または Post-Login Action を使用できます。

​

Auth0 Dashboard

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)	ユーザーがアクティブであっても、非永続セッションを維持できる最大時間 (分) 。

​

Auth0 Management API

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

/api/v2/tenants/settings エンドポイントを呼び出すには、update:tenant_settings スコープを持つ Management API access token が必要です。

/api/v2/tenants/settings エンドポイントに PATCH リクエストを送信します。

cURL

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\
  }'

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

​

Auth0 Post-Login Actions

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

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

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

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

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

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

• api.session.setExpiresAt

• api.session.setIdleExpiresAt

• api.session.setCookieMode

api.session メソッドは現在のセッションにのみ適用され、ログイントランザクション中に呼び出す必要があります。これらのメソッドを使用するには、イベントプロパティ event.session.id を利用できる必要があります。

詳しくは、Sessions with Actions を参照してください。