Struct SaTokenConfig 

pub struct SaTokenConfig {

    pub token_name: String,
    pub timeout: i64,
    pub active_timeout: i64,
    pub auto_renew: bool,
    pub is_concurrent: bool,
    pub is_share: bool,
    pub token_style: TokenStyle,
    pub is_log: bool,
    pub is_read_cookie: bool,
    pub is_read_header: bool,
    pub is_read_body: bool,
    pub token_prefix: Option<String>,
    pub jwt_secret_key: Option<String>,
    pub jwt_algorithm: Option<String>,
    pub jwt_issuer: Option<String>,
    pub jwt_audience: Option<String>,
    pub enable_nonce: bool,
    pub nonce_timeout: i64,
    pub enable_refresh_token: bool,
    pub refresh_token_timeout: i64,
}

sa-token 配置

Fields

token_name: String

Token 名称（例如在 header 或 cookie 中的键名）

timeout: i64

Token 有效期（秒），-1 表示永久有效

active_timeout: i64

Token 最低活跃频率（秒），-1 表示不限制

配合 auto_renew 使用时，表示自动续签的时长

auto_renew: bool

是否开启自动续签（默认 false）

如果设置为 true，在以下场景会自动续签 token：

• 调用 get_token_info() 时
• 中间件验证 token 时
• 调用无参数的 StpUtil 方法时

续签时长由 active_timeout 决定：

• 如果 active_timeout > 0，则续签 active_timeout 秒
• 如果 active_timeout <= 0，则续签 timeout 秒

is_concurrent: bool

是否允许同一账号并发登录

is_share: bool

在多人登录同一账号时，是否共享一个 token

token_style: TokenStyle

Token 风格（uuid、simple-uuid、random-32、random-64、random-128）

is_log: bool

是否输出操作日志

is_read_cookie: bool

是否从 cookie 中读取 token

is_read_header: bool

是否从 header 中读取 token

is_read_body: bool

是否从请求体中读取 token

token_prefix: Option<String>

token 前缀（例如 “Bearer “）

jwt_secret_key: Option<String>

JWT 密钥（如果使用 JWT）

jwt_algorithm: Option<String>

JWT 算法（默认 HS256）

jwt_issuer: Option<String>

JWT 签发者

jwt_audience: Option<String>

JWT 受众

enable_nonce: bool

是否启用防重放攻击（nonce 机制）

nonce_timeout: i64

Nonce 有效期（秒），-1 表示使用 token timeout

enable_refresh_token: bool

是否启用 Refresh Token

refresh_token_timeout: i64

Refresh Token 有效期（秒），默认 7 天

Implementations

impl SaTokenConfig

pub fn builder() -> SaTokenConfigBuilder

pub fn timeout_duration(&self) -> Option<Duration>

Trait Implementations

impl Clone for SaTokenConfig

fn clone(&self) -> SaTokenConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SaTokenConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for SaTokenConfig

fn default() -> SaTokenConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SaTokenConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<SaTokenConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SaTokenConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.