开源项目推荐｜Keycloak：给企业 AI 门户接入 SSO、角色与会话治理

开源项目推荐｜Keycloak：给企业 AI 门户接入 SSO、角色与会话治理

企业内部 AI 门户经常从一组共享账号开始：大家使用同一密钥，离职员工是否还能访问无人确认，管理员也分不清谁调用了高成本模型。API Key 适合识别应用或调用入口，却不能完整替代员工登录、组织关系、多因素认证和会话撤销。Keycloak 是开源身份与访问管理项目，支持保护应用与服务、管理用户会话，并可通过角色、组和身份提供商连接企业现有身份体系。

人的身份与服务密钥要分层

员工通过 OIDC 或 SAML 登录，获得本人和组织会话；后端服务使用独立服务账户或受控凭据调用 AnyAIS。浏览器不应直接持有平台主密钥，也不应把员工访问令牌当作模型供应商密钥传递。

典型链路是：Keycloak 完成认证，后端验证令牌与受众，按租户和角色授权，再用服务端 AnyAIS Key 调用模型。日志记录员工、应用和模型请求，异常时能定位到人和服务。

Realm、组织、组和角色如何映射

身份结构不要照搬部门通讯录。Realm 通常代表独立安全边界，组适合表达组织层级，角色表达可执行能力，例如使用高成本模型、管理知识库、发布内容或调用写操作工具。业务系统还要检查资源所属租户和项目，不能只凭一个全局 admin 角色访问所有数据。

令牌中的角色应保持精简，不要塞入完整权限表。权限变化后，短期令牌与会话撤销要尽快生效。具体文章、模型、MCP 工具和 DASP 会话能否访问，仍由业务服务按资源上下文判断。

SSO 不等于一次登录永久有效

高风险动作应要求更强认证或重新认证，例如创建平台密钥、修改结算、导出敏感会话和启用写操作工具。普通浏览与高风险管理可以使用不同认证强度，避免所有用户每次操作都被打断，也避免登录一次后无限执行敏感动作。

会话超时、离职停用、设备丢失和降权都需要演练。退出应用与撤销所有会话的效果不同，后端不能只依赖前端清除 Cookie。服务账户也应有独立生命周期。

对接企业目录与外部身份

Keycloak 可连接 LDAP、Active Directory，并作为身份代理对接外部 OIDC 或 SAML 提供商。接入时要明确用户唯一标识、邮箱变更、同名账号合并和首次登录流程，避免员工换邮箱后生成两个业务身份。

组和角色同步默认最小权限。目录里的部门组不应自动获得所有 AI 数据；同步失败且无法确认权限时，应拒绝高风险操作。

多租户 AI 平台的边界

企业客户可使用自己的身份提供商，平台把外部组织映射到内部租户。映射须受控配置，不能按用户提交的邮箱域名自动授权。租户管理员只能管理本组织资源，平台管理员操作需严格审计。

AnyAIS 统一模型、MCP、DASP、API Key 与用量数据，Keycloak 可作为员工和企业用户的登录入口。两者结合后，人的登录会话、业务资源权限和模型调用凭据彼此分离，既支持 SSO 体验，也保留准确的成本与审计归属。

上线前测试清单

至少覆盖首次登录、重复登录、令牌过期、刷新失败、退出、管理员撤权、离职停用、角色变更、跨租户访问、服务账户和高风险重新认证。可以让另一套独立模型审阅角色矩阵是否有遗漏，但必须通过自动化授权测试和安全人员复核确认。

身份系统的价值不只是少输一次密码，而是让每次 AI 使用都能回答：谁、以哪个组织身份、通过哪个应用、被允许执行什么。先把这些边界建立起来，企业 AI 才能从共享体验走向可治理服务。

参考资料

• [Keycloak 官方文档](https://www.keycloak.org/documentation)
• [Keycloak Server Administration Guide](https://www.keycloak.org/docs/latest/server_admin/)
• [Keycloak Securing Applications Guide](https://www.keycloak.org/guides#securing-apps)

如果你正在为企业团队开放 AnyAIS，可以先用 Keycloak 建立 SSO 与角色映射，再为模型、MCP 工具和会话配置资源级权限。