logologo
Get Started
Guide
Development
Plugins
API
English
简体中文
Get Started
Guide
Development
Plugins
API
English
简体中文
logologo
Security guide
Token policy

Password policy

Password policy
User lockout
IP restriction
Audit logger
Two factor authentication (2FA)
Previous PageSecurity guide
Next PagePassword policy

#Token Security Policy

#Introduction

The Token Security Policy is a functional configuration designed to protect system security and enhance user experience. It includes three main configuration items: "Session Validity Period", "Token Validity Period", and "Expired Token Refresh Time Limit".

#Configuration Entry

The configuration entry is located under Plugin Settings - Security - Token Policy:

20250105111821-2025-01-05-11-18-24

#Session Validity Period

Definition:

The Session Validity Period refers to the maximum duration that the system allows a user to maintain an active session after logging in.

Function:

Once the Session Validity Period is exceeded, the user will receive a 401 error response upon subsequent access to the system, and will then be redirected to the login page for re-authentication. Example: If the Session Validity Period is set to 8 hours, the session will expire 8 hours after the user logs in, assuming no additional interactions.

Recommended Settings:

  • Short-term operation scenarios: Recommended 1-2 hours to enhance security.
  • Long-term work scenarios: Can be set to 8 hours to accommodate business needs.

#Token Validity Period

Definition:

The Token Validity Period refers to the lifecycle of each Token issued by the system during the user's active session.

Function:

When a Token expires, the system will automatically issue a new Token to maintain the session activity. Each expired Token is only allowed to be refreshed once.

Recommended Settings:

For security reasons, it is recommended to set it between 15 to 30 minutes. Adjustments can be made based on scenario requirements. For example: High-security scenarios: The Token Validity Period can be shortened to 10 minutes or less. Low-risk scenarios: The Token Validity Period can be appropriately extended to 1 hour.

#Expired Token Refresh Time Limit

Definition:

The Expired Token Refresh Time Limit refers to the maximum time window allowed for a user to obtain a new Token through a refresh operation after the Token has expired.

Characteristics:

If the refresh time limit is exceeded, the user must log in again to obtain a new Token. The refresh operation does not extend the Session Validity Period, it only regenerates the Token.

Recommended Settings:

For security reasons, it is recommended to set it between 5 to 10 minutes.