Crate sa_token_plugin_actix_web

Expand description

§sa-token-plugin-actix-web

Actix-web框架集成插件 - 一站式认证授权解决方案

§快速开始

只需要导入这一个包，即可使用所有功能：

[dependencies]
sa-token-plugin-actix-web = "0.1.3"  # 默认使用内存存储
# 或者使用 Redis 存储
sa-token-plugin-actix-web = { version = "0.1.3", features = ["redis"] }

§使用示例

use sa_token_plugin_actix_web::*;
 
// 1. 初始化（使用内存存储）
let state = SaTokenState::builder()
    .storage(Arc::new(MemoryStorage::new()))  // 已重新导出
    .timeout(7200)
    .build();
 
// 2. 登录
let token = state.manager().login("user123").await?;
 
// 3. 使用宏检查权限
#[sa_check_login]
async fn user_info() -> impl Responder {
    "User info"
}
 
#[sa_check_permission("admin")]
async fn admin_panel() -> impl Responder {
    "Admin panel"
}

Re-exports§

pub use middleware::SaCheckLoginMiddleware;
pub use middleware::SaTokenMiddleware;
pub use layer::SaTokenLayer;
pub use extractor::SaTokenExtractor;
pub use extractor::OptionalSaTokenExtractor;
pub use extractor::LoginIdExtractor;
pub use adapter::ActixRequestAdapter;
pub use adapter::ActixResponseAdapter;
pub use sa_token_core;
pub use sa_token_adapter;

Modules§

adapter: Actix-web请求/响应适配器
error: Error type definitions | 错误类型定义
extractor: Actix-web提取器
layer
middleware: Actix-web中间件
token: Token 管理模块

Structs§

AccessToken: Access Token Response | 访问令牌响应
AuthResult: Authentication result after processing 处理后的鉴权结果
AuthorizationCode: Authorization Code | 授权码
DefaultWsTokenExtractor: Default token extractor implementation 默认的 Token 提取器实现
DistributedSession: Distributed session data structure 分布式 Session 数据结构
DistributedSessionManager: Distributed session manager 分布式 Session 管理器
InMemoryDistributedStorage: In-memory distributed session storage implementation 内存分布式 Session 存储实现
InMemoryPusher: In-memory message pusher implementation 内存消息推送器实现
JwtClaims: JWT Claims | JWT 声明
JwtManager: JWT Manager | JWT 管理器
LoggingListener: 简单的日志监听器示例
MemoryStorage: 内存存储（默认启用）内存存储实现
NonceManager: Nonce Manager | Nonce 管理器
OAuth2Client: OAuth2 Client Information | OAuth2 客户端信息
OAuth2Manager: OAuth2 Manager | OAuth2 管理器
OAuth2TokenInfo: OAuth2 Token Information (for storage) | OAuth2 令牌信息（用于存储）
OnlineManager: Online user manager 在线用户管理器
OnlineUser: Online user information 在线用户信息
PathAuthConfig: Path-based authentication configuration 基于路径的鉴权配置
PushMessage: Push message structure 推送消息结构
RefreshTokenManager: Refresh Token Manager | Refresh Token 管理器
SaSession: Session 对象 | Session Object
SaTokenConfig: sa-token 配置
SaTokenContext: sa-token 上下文 | sa-token Context
SaTokenEvent: 事件数据
SaTokenEventBus: 事件总线 - 管理所有监听器并分发事件
SaTokenManager: sa-token 管理器
SaTokenState: 应用状态
SaTokenStateBuilder: 状态构建器
ServiceCredential: Service credential for inter-service authentication 服务间认证的服务凭证
SsoClient: SSO 客户端 | SSO Client
SsoConfig
SsoManager
SsoServer: SSO 服务端 | SSO Server
SsoSession: SSO 全局会话 | SSO Global Session
SsoTicket: SSO 票据结构 | SSO Ticket Structure
StpUtil: StpUtil - 权限认证工具类
TokenInfo: Token 信息 | Token Information
TokenValue: Token 值
WsAuthInfo: WebSocket authentication information WebSocket 认证信息
WsAuthManager: WebSocket authentication manager WebSocket 认证管理器

Enums§

JwtAlgorithm: JWT Algorithm | JWT 算法
MessageType: Message type enumeration 消息类型枚举
SaTokenError
SaTokenEventType: 事件类型
TokenStyle: Token 风格 | Token Style

Traits§

DistributedSessionStorage: Distributed session storage trait 分布式 Session 存储 trait
FrameworkAdapter: 框架适配器trait
LoginId: LoginId trait - 支持任何可以转换为字符串的类型作为登录 ID
MessagePusher: Message pusher trait 消息推送器 trait
PermissionChecker: 权限检查器 | Permission Checker
SaStorage: 存储适配器trait
SaTokenListener: 事件监听器 trait | Event Listener Trait
WsTokenExtractor: Token extractor trait for WebSocket connections WebSocket 连接的 Token 提取器 trait

Functions§

create_context: Create SaTokenContext from authentication result 从鉴权结果创建SaTokenContext
match_any: Check if path matches any pattern in the list 检查路径是否匹配列表中的任意模式
match_path: Match a path against a pattern (Ant-style wildcard) 匹配路径与模式（Ant 风格通配符）
need_auth: Determine if authentication is needed for a path 判断路径是否需要鉴权
process_auth: Process authentication for a request path 处理请求路径的鉴权

Type Aliases§

SaTokenData: Actix-web应用数据
SaTokenResult

Attribute Macros§

sa_check_login: 检查登录状态的宏
sa_check_permission: 检查权限的宏
sa_check_permissions_and: 同时检查多个权限（AND逻辑）
sa_check_permissions_or: 同时检查多个权限（OR逻辑）
sa_check_role: 检查角色的宏
sa_check_roles_and: 同时检查多个角色（AND逻辑）
sa_check_roles_or: 同时检查多个角色（OR逻辑）
sa_ignore: 忽略认证检查的宏

Crate sa_token_plugin_actix_web

Crate sa_token_plugin_actix_web Copy item path

§sa-token-plugin-actix-web

§快速开始

§使用示例

Re-exports§

Modules§

Structs§

Enums§

Traits§

Functions§

Type Aliases§

Attribute Macros§

Crate sa_token_plugin_actix_web