Iris框架不内置SSO协议实现,其MVC结构仅组织代码,SSO需主动集成OAuth2/OIDC或对接CAS等认证中心;Controller层须显式调用外部服务、校验票据、管理会话并注入用户上下文,无法自动完成。

Iris 框架本身不内置 SSO 协议实现,它是一个轻量、高性能的 Go Web 框架,MVC 结构只是组织方式;SSO 必须由你主动集成标准协议(如 OAuth2、OIDC)或对接认证中心(如 CAS、Azure AD),不能靠 Iris 自动完成。
为什么 Iris 的 MVC 不能“直接支持”SSO
Iris 的 Controller 和路由层只负责处理 HTTP 请求与响应,不包含身份协议逻辑。所谓“MVC 中实现 SSO”,本质是:在 Controller 层调用外部认证服务、解析返回票据、管理会话/Token,并把用户上下文注入到视图或后续业务逻辑中。
常见误区是以为给 BaseController 加个 BeforeActivation 就能自动登录 —— 实际上,那只是拦截请求,真正认证动作必须显式发起 HTTP 调用(比如向 https://auth.example.com/oauth/authorize 重定向)或验证 JWT。
- 没有内置
OAuth2Config或OIDCProvider类型 - Session 管理需手动配
iris.Sessions,且默认不加密跨域共享 - 模板渲染(
ctx.View)拿不到远程用户信息,得靠 Controller 显式传参
用 OAuth2/OIDC 在 Iris Controller 中做登录跳转
这是最通用、跨域安全的方案。你需要在某个 Controller 方法里生成授权 URL 并 302 重定向,而不是试图在中间件里“静默登录”。
关键点:
- 使用
golang.org/x/oauth2构建oauth2.Config,配置RedirectURL必须和 Iris 启动地址一致(如http://localhost:8080/callback) - Controller 中调用
config.AuthCodeURL(state)获取跳转地址,state要存入 session 防 CSRF - 回调接口(
/callback)必须是公开路由,不能被iris.BasicAuth或登录拦截器挡住 - 拿到
code后,用config.Exchange(ctx, code)换取token,再用 token 请求用户信息(如https://openid.net/userinfo)
示例片段(非完整):
func (c *AuthController) GetLogin(ctx iris.Context) {
state := uuid.NewString()
ctx.Session().Set("oauth_state", state)
url := oauthConf.AuthCodeURL(state, oauth2.AccessTypeOnline)
ctx.Redirect(url, 302)
}
<p>func (c *AuthController) GetCallback(ctx iris.Context) {
state := ctx.URLParam("state")
if state != ctx.Session().GetString("oauth_state") {
ctx.StatusCode(400)
return
}
code := ctx.URLParam("code")
token, err := oauthConf.Exchange(ctx.Request().Context(), code)
// ... 解析 ID Token,存用户到 session 或发 JWT 给前端
}CAS 集成时 Controller 怎么验证 Service Ticket
CAS 流程依赖后端校验 ST(Service Ticket),不能只靠前端跳转。Iris Controller 必须主动向 CAS Server 的 /p3/serviceValidate 接口发起 GET 请求,带 ticket 和 service 参数。
注意细节:
-
service参数值必须和最初跳转到 CAS 时传的一致,且需 URL 编码(url.QueryEscape) - CAS 返回 XML 响应,需解析
<authenticationsuccess></authenticationsuccess>节点提取用户名 - 不要信任前端传来的
ticket,必须服务端直连 CAS 校验(防止伪造) - 校验成功后,建议用
ctx.Session().Set("user", username)记录会话,而非返回明文 Token 给前端
典型错误:ctx.Request().URL.Query().Get("ticket") 直接拼进 CAS 请求却没校验 referer 或 service 匹配性,导致中间人可复用 ticket。
JWT 登录态如何在 Iris MVC 中安全透传
如果认证中心发的是 JWT(如 OIDC ID Token),别在 Controller 里用 ctx.PostValue 解析 —— 应该统一用中间件验证签名并注入 ctx.Values().Set("user", claims),再由各 Controller 取用。
关键约束:
- 密钥(
publicKey)不能硬编码,应从环境变量或文件加载 - 验证时必须检查
iss、aud、exp,尤其aud要匹配当前 Iris 应用的 client_id - 不要把完整 JWT 存 localStorage,前端应仅存
access_token并通过Authorization: Bearer xxx发送 - Controller 返回 JSON 时,敏感字段(如邮箱)要按角色过滤,不能无条件
ctx.JSON(user)
复杂点在于:Iris 默认不区分“登录态”和“授权态”,而 SSO 往往需要同时管理用户身份(ID Token)和资源访问权限(Access Token)。这两个 Token 生命周期不同,必须分开存储和刷新。


















