Configurer la durée de vie d’une session

Décrit comment configurer la durée de vie d’une session pour un tenant à l’aide de l’Auth0 Dashboard, de la Management API et des Actions.

Pour configurer la durée de vie d’une session, vous pouvez utiliser l’Auth0 Dashboard, la Management API ou une Action Post Login.

​

Auth0 Dashboard

Pour configurer la durée de vie de la session dans Auth0 Dashboard :

1. Accédez à Dashboard > Tenant Settings et sélectionnez la vue Advanced.

2. Sous Session Expiration, vous pouvez configurer les éléments suivants :

Politique de session	Description
Idle Session Lifetime (Persistent)	Durée maximale (en minutes) d’inactivité avant l’expiration d’une session persistante.
Idle Session Lifetime (Non-Persistent)	Durée maximale (en minutes) d’inactivité avant l’expiration d’une session non persistante.
Maximum Session Lifetime (Persistent)	Durée maximale (en minutes) pendant laquelle une session persistante peut rester active, même si l’utilisateur est actif.
Maximum Session Lifetime (Non-Persistent)	Durée maximale (en minutes) pendant laquelle une session non persistante peut rester active, même si l’utilisateur est actif.

​

Management API Auth0

Pour configurer la durée de vie de la session à l’aide de la Management API Auth0 :

Les appels au point de terminaison /api/v2/tenants/settings nécessitent un jeton d’accès à la Management API avec la portée update:tenant_settings.

Effectuez une requête PATCH au point de terminaison /api/v2/tenants/settings :

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

Paramètre	Description
session_lifetime	Durée maximale (en heures) avant l’expiration absolue.
idle_session_lifetime	Durée maximale (en heures) avant qu’une session expire en raison de l’inactivité.
ephemeral_session_lifetime	Durée maximale (en heures) avant l’expiration absolue.
idle_ephemeral_session_lifetime	Durée maximale (en heures) avant qu’une session expire en raison de l’inactivité.

​

Actions Post Login d’Auth0

Vous pouvez configurer dynamiquement le comportement de la session à l’aide des méthodes api.session dans une Action Post Login. Cela vous permet de remplacer les paramètres de session par défaut du tenant pour chaque connexion, selon une logique propre à l’utilisateur ou au contexte.

Les cas d’utilisation comprennent :

• Raccourcir les délais d’expiration pour les connexions à risque élevé

• Prolonger les délais d’expiration pour les utilisateurs ou organisations de confiance

• Ajuster la persistance des cookies selon le type d’application

Les méthodes api.session offertes pour configurer la durée de vie des sessions sont :

• api.session.setExpiresAt

• api.session.setIdleExpiresAt

• api.session.setCookieMode

Les méthodes api.session s’appliquent uniquement à la session en cours et doivent être appelées pendant la transaction de connexion. Ces méthodes exigent que la propriété d’événement event.session.id soit disponible.

Pour en savoir plus, consultez Sessions avec Actions.