菜单
Sa-Token SSO 单点登录专项技能。覆盖三种SSO模式完整方案：模式一(同域+同Redis/Cookie共享)、模式二(跨域+同Redis/URL重定向)、模式三(跨域+跨Redis/Http ticket)。 SSO-Server认证中心搭建、SSO-Client接入、单点注销、自定义登录页面、前后端分离SSO(H5方案)、消息推送、匿名Client、域名校验、NoSdk非Java接入、自定义API路由、平台中心跳转。 当用户需要多系统统一登录/注销、搭建单点登录认证中心、跨域SSO集成时使用。 基础登录认证请先使用 sa-token 技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
基于 Alibaba EasyExcel（com.alibaba:easyexcel:4.0.3）的 Excel 模板填充技能。覆盖简单对象填充、列表填充（{.}+forceNewRow）、横向多列组合填充（FillWrapper+WriteDirectionEnum.HORIZONTAL）、复杂填充（含合计行/统计行/先 fill 后 write）、Spring Boot 集成、模板设计规范、转义字符、03版/07版差异、性能优化（分次 fill、文件缓存）。当用户需要把 Java 对象或 Map 数据按预制 .xlsx 模板（变量语法 {var}、{.}、{prefix.}）填充生成报表（工资条/合同/对账单/发票/财务报表/统计表/汇总表）时使用此技能，不适用于不基于模板的"程序生成 Excel"场景（改用 easyexcel-write）。
基于 Alibaba EasyExcel（com.alibaba:easyexcel:4.0.3）的 Excel 数据读取技能。覆盖监听器模式（ReadListener/AnalysisEventListener/PageReadListener）、同步读取（doReadSync）、多 Sheet 读取、@ExcelProperty(index/name)匹配、多行表头（headRowNumber）、日期数字自定义转换器（@DateTimeFormat/@NumberFormat/Converter）、监听器异常处理（onException + ExcelDataConvertException）、额外信息读取（批注/超链接/合并单元格，extraRead + CellExtra）、公式和单元格类型（CellData<T>）、不创建对象的读（ReadListener<Map<Integer,String>>）、Web 上传读取（MultipartFile→InputStream）。当用户需要解析 Excel（导入数据/批量入库/对账文件/用户上传/Excel 转对象/Excel 转 Map）时使用此技能，不适用于按预制模板填充（改用 easyexcel-fill）、不适用于程序化生成 Excel（改用 easyexcel-write）。
基于 Alibaba EasyExcel（com.alibaba:easyexcel:4.0.3）的 Excel 数据写入技能。覆盖最简写入（3 种写法）、复杂表头（多级）、@ExcelProperty/@ExcelIgnore/@DateTimeFormat/@NumberFormat 注解、includeColumn/excludeColumn 选择列、@ColumnWidth/@ContentRowHeight 样式注解、@HeadStyle/@ContentStyle 自定义样式、合并单元格（@ContentLoopMerge/LoopMergeStrategy）、图片导出（File/InputStream/URL/byte[]）、超链接/批注/公式/富文本（WriteCellData）、动态表头、自动列宽、自定义拦截器（CellWriteHandler/SheetWriteHandler/RowWriteHandler）、分页分批写入、Web 下载直接写 OutputStream、03/07 版兼容。当用户需要程序化生成 Excel（无预制模板）导出订单/用户/财务/库存/报表/对账单/审批单等结构化数据时使用此技能，不适用于按预制模板填充（改用 easyexcel-fill）、不适用于读取 Excel（改用 easyexcel-read）。
Provides comprehensive guidance for searching and retrieving Maven components from Maven Central Repository (https://repo1.maven.org/maven2/). This skill enables searching by groupId, artifactId, version, and other coordinates, retrieving component metadata (POM files, JARs, sources, Javadoc), querying version history, and analyzing dependencies. Use when the user needs to find, verify, or retrieve Maven dependencies, check component versions, analyze dependency trees, or work with Maven coordinates.
Provides comprehensive guidance for generating MyBatis-Plus code including Entity, Mapper, Service, ServiceImpl, Controller, DTO, VO, BO and other related objects from database tables. Use ONLY when the user explicitly mentions MyBatis-Plus, mybatis-plus-generator, or wants to generate code using MyBatis-Plus framework. This skill automatically generates standard CRUD methods and custom methods based on user requirements for MyBatis-Plus projects. Supports MVC and DDD architectures, Java and Kotlin languages. Do NOT trigger for generic code generation, JPA/Hibernate, or other ORM frameworks.
Sa-Token 高级安全特性技能。覆盖二级认证(safe-auth二次验证)、账号封禁(全封禁/分类封禁/阶梯封禁)、模拟他人与身份切换、多账号认证(StpUserUtil/StpKit)、全局侦听器(登录/注销/踢人/封禁/续签事件)、全局过滤器(SaServletFilter/SaReactorFilter)、密码加密(MD5/SHA1/SHA256/AES/RSA/BCrypt/TOTP)、会话查询(终端列表/全局搜索Token)、Http Basic/Digest认证、防火墙(IP黑白名单/频率限制)、自定义鉴权注解、路由鉴权动态化、反向代理URI修复、异步Mock上下文、数据架构Redis键值设计。 当用户需要实现敏感操作二次验证、账号分级封禁、模拟用户操作、多套账号体系(User/Admin分离)、全局事件监听、密码加密工具时使用。 基础登录认证请使用 sa-token 技能。
| name | sa-token-sso |
| description | Sa-Token SSO 单点登录专项技能。覆盖三种SSO模式完整方案：模式一(同域+同Redis/Cookie共享)、模式二(跨域+同Redis/URL重定向)、模式三(跨域+跨Redis/Http ticket)。 SSO-Server认证中心搭建、SSO-Client接入、单点注销、自定义登录页面、前后端分离SSO(H5方案)、消息推送、匿名Client、域名校验、NoSdk非Java接入、自定义API路由、平台中心跳转。 当用户需要多系统统一登录/注销、搭建单点登录认证中心、跨域SSO集成时使用。 基础登录认证请先使用 sa-token 技能。 |
| license | Apache-2.0 |
基于 sa-token-doc/sso/ 全部 18 个文档。基础认证使用 sa-token 技能。
secret-key 加密通信| 模式 | 场景 | 共享Redis | 认证机制 | 适用 |
|---|---|---|---|---|
| 类型1 | 同域名 | ✅ | Cookie共享 | 同父域下的子系统 |
| 类型2 | 不同域名 | ✅ | URL重定向 | 不同域名但共享Redis |
| 类型3 | 完全隔离 | ❌ | HTTP ticket | 不同Redis、不同网络 |
admin.example.com、shop.example.com）→ 模式一，最简单Step 1. 确认环境 — 引入 sa-token-sso 依赖，确认Redis连接
Step 2. 选择模式 — 根据系统架构选择模式一/二/三
Step 3. 搭建SSO-Server — 配置认证中心 /sso/auth 等端点
Step 4. 接入SSO-Client — 各应用系统配置认证地址
Step 5. 配置域名校验 — 设置允许的域名白名单
Step 6. 开启单点注销 — 配置 is-slo: true
Step 7. 测试验证 — 验证跨系统登录/注销流程
| 主题 | 文件 | 来源 |
|---|---|---|
| SSO-Server搭建+三种模式 | references/sso-server.md | sso-server、sso-type1、sso-type2、sso-type3 |
| SSO-Client接入+注销+FAQ | references/sso-client.md | readme、signout、sso-questions |
| 前后端分离SSO(H5) | references/sso-h5.md | sso-h5 |
Q: SSO和OAuth2.0的区别是什么？ A: SSO解决多系统统一登录问题（一个账号登录所有系统）。OAuth2.0解决第三方授权问题（允许第三方应用访问用户数据）。简单场景选SSO，开放平台场景选OAuth2.0。
Q: 三种SSO模式如何选择？ A: 同域名用模式一（最简单），跨域但共享Redis用模式二，完全隔离的环境用模式三。不确定时选模式三。
Q: SSO-Server和SSO-Client必须用同一语言吗？ A: 模式一和模式二需要（依赖共享Redis的Java SDK），模式三不限语言（通过HTTP交互）。
Q: 如何保证ticket的安全性？
A: 1) 配置 secret-key 加密通信；2) ticket有效期默认5分钟，较短；3) 配置 is-check-sign: true 校验签名。
Q: SSO支持前后端分离项目吗？ A: 支持。有专门的H5方案，前端SPA应用通过URL参数传递ticket，后端提供接口换取登录态。
Q: 单点注销是怎么工作的？ A: 用户在SSO-Server注销时，Server会向所有已注册的Client发送注销通知，各Client清除本地会话。
ticket-url 配置，否则Client无法向Server校验ticketis-check-sign: false，生产务必开启allow-domains 时所有域名均可接入，生产环境需限制is-slo: true + Client端 reg-logout-call: true.example.com）本技能不收集、存储或传输任何用户数据。所有代码示例仅供本地开发参考。