Struct SsoServer 

pub struct SsoServer { /* private fields */ }

SSO 服务端 | SSO Server

中央认证服务，负责票据生成、验证和会话管理 Central authentication service responsible for ticket generation, validation, and session management

Implementations

impl SsoServer

pub fn new(manager: Arc<SaTokenManager>) -> Self

创建新的 SSO 服务端 | Create a new SSO Server

参数 | Parameters

• manager - SaTokenManager 实例 | SaTokenManager instance

pub fn with_ticket_timeout(self, timeout: i64) -> Self

设置票据超时时间 | Set ticket timeout

参数 | Parameters

• timeout - 超时时间（秒）| Timeout in seconds

pub async fn is_logged_in(&self, login_id: &str) -> bool

检查用户是否已登录 | Check if user is logged in

通过检查 SSO 会话是否存在来判断 Determined by checking if SSO session exists

pub async fn create_ticket( &self, login_id: String, service: String, ) -> SaTokenResult<SsoTicket>

创建票据 | Create ticket

为已登录用户创建访问特定服务的票据 Creates a ticket for logged-in user to access specific service

参数 | Parameters

• login_id - 用户登录 ID | User login ID
• service - 目标服务 URL | Target service URL

返回 | Returns

新创建的票据 | Newly created ticket

pub async fn validate_ticket( &self, ticket_id: &str, service: &str, ) -> SaTokenResult<String>

验证票据 | Validate ticket

验证票据的有效性并将其标记为已使用（一次性使用） Validates ticket and marks it as used (one-time use)

参数 | Parameters

• ticket_id - 票据 ID | Ticket ID
• service - 请求的服务 URL | Requested service URL

返回 | Returns

用户登录 ID | User login ID

错误 | Errors

• InvalidTicket - 票据不存在 | Ticket not found
• TicketExpired - 票据已过期或已使用 | Ticket expired or used
• ServiceMismatch - 服务 URL 不匹配 | Service URL mismatch

pub async fn login( &self, login_id: String, service: String, ) -> SaTokenResult<SsoTicket>

用户登录 | User login

完整的登录流程：创建 Token、会话和票据 Complete login flow: create Token, session, and ticket

参数 | Parameters

• login_id - 用户登录 ID | User login ID
• service - 目标服务 URL | Target service URL

返回 | Returns

生成的票据 | Generated ticket

pub async fn logout(&self, login_id: &str) -> SaTokenResult<Vec<String>>

统一登出 | Unified logout

从 SSO 服务端登出，并返回需要通知的客户端列表 Logout from SSO Server and return list of clients to notify

参数 | Parameters

• login_id - 用户登录 ID | User login ID

返回 | Returns

需要清除会话的客户端 URL 列表 | List of client URLs to clear sessions

pub async fn get_session(&self, login_id: &str) -> Option<SsoSession>

获取 SSO 会话 | Get SSO session

参数 | Parameters

• login_id - 用户登录 ID | User login ID

返回 | Returns

SSO 会话信息（如果存在）| SSO session info (if exists)

pub async fn check_session(&self, login_id: &str) -> bool

检查会话是否存在 | Check if session exists

参数 | Parameters

• login_id - 用户登录 ID | User login ID

返回 | Returns

会话是否存在 | Whether session exists

pub async fn cleanup_expired_tickets(&self)

清理过期票据 | Cleanup expired tickets

删除所有过期或已使用的票据 Removes all expired or used tickets

pub async fn get_active_clients(&self, login_id: &str) -> Vec<String>

获取活跃客户端列表 | Get active clients list

参数 | Parameters

• login_id - 用户登录 ID | User login ID

返回 | Returns

客户端 URL 列表 | List of client URLs