Laravel CAS Server

一个功能完整的 Laravel CAS (Central Authentication Service) 服务器扩展包,实现 SSO 单点登录 与 SLO 单点登出,支持 CAS 1.0 / 2.0 / 3.0 协议。

✨ 功能特性

• 🔐 SSO 单点登录 — 一次登录,多个应用共享会话
• 🔄 SLO 单点登出 — 一处登出,处处登出(自动通知所有客户端)
• 🎫 完整票据体系 — TGT / ST / PGT / PT,一次性防重放
• 📦 协议支持 — CAS 1.0 / 2.0 / 3.0,JSON + XML 双响应格式
• 🎨 高度可定制 — 自定义用户模型、页面模板、属性释放、交互接口
• 🛡️ 安全内置 — service 白名单、SSRF 防御、登出跳转白名单、SLO 死信

📋 环境要求

⚡ 快速安装

# 1. 安装
composer require lyn-huang/laravel-cas-server

# 2. 发布配置与视图
php artisan vendor:publish --provider="LynHuang\LaravelCasServer\CasServerServiceProvider"

# 3. 建表
php artisan migrate

# 4. 创建客户端应用
php artisan cas:create-client

MySQL 5.7 + utf8mb4 用户,请先在 AppServiceProvider::boot() 加 Schema::defaultStringLength(191);

安装完成后访问 /cas/health 验证是否正常。

🚀 快速开始

1. 在 cas_clients 表注册你的应用(client_redirect = 登录回调地址)
2. 应用检测未登录 → 跳转 GET /cas/login?service={回调地址}
3. 用户登录 → CAS 带 ticket 重定向回回调地址
4. 应用调用 GET /cas/serviceValidate?service=&ticket= 验证并获取用户

详细流程见下方文档。

定位:本包是独立的"统一用户中心",通过 CAS 协议为多个已有系统提供 SSO/SLO。
任何 Web 应用(SPA / SSR / 移动端 webview)都可接入,只要能整页跳转。
接入方应用保持自己的用户体系,本包只做"认证网关",不替换用户表/Token。
详情看 08 · 接入方式与适用场景。

📚 使用文档

📦 包结构

laravel-cas-server/
├── config/            # 配置文件
├── database/migrations/  # 数据表迁移
├── resources/views/   # Blade 模板
├── routes/            # 路由定义
├── src/               # 核心 PHP 代码
└── docs/              # 使用文档

📄 License

MIT