1. 项目背景 在数字化转型浪潮中企业系统越来越多——OA、ERP、CRM、HR、财务……员工每天要记住十几套账号密码IT 部门被忘记密码的工单淹没。据 Forrester 研究企业因密码重置每年平均损失每位员工 70 小时。单点登录SSO已成为企业 IT 基础设施的刚需。MaxKey 应运而生由国内 Dromara 开源社区开发维护是国内领先的 IAM-IDaaS 身份管理平台。项目是什么DromaraMaxKey单点登录认证系统是业界领先的IAM-IDaas身份管理和认证产品谐音为马克思的钥匙寓意它能够像一把万能钥匙(最大钥匙)一样解锁复杂的企业安全需求提供简洁而高效的解决方案。产品支持OAuth 2.x/OpenID Connect、SAML 2.0、JWT、CAS、SCIM等标准协议提供安全、标准和开放的用户身份管理(IDM)、身份认证(AM)、单点登录(SSO)、RBAC权限管理和资源管理等。2. 目标用户 企业 IT 管理员需要统一认证平台管理多系统登录和权限安全合规负责人需要符合等保 2.0 要求的身份认证方案Java 后端开发者需要在项目中集成 SSO/OAuth2/SAML 等认证协议中大型企业架构师规划统一身份管理基础设施替代分散的认证方案政企单位对数据合规、自主可控有严格要求的组织3. 平台定位 MaxKey 定位为业界领先的开源 IAM-IDaaS 身份管理和认证产品。与商业方案如 Okta、Azure AD相比MaxKey 的核心优势在于开源免费、安全合规、自主可控完全适配国内政企信创环境。它覆盖了身份管理的完整生命周期——从用户注册、认证、授权到注销、审计提供一站式解决方案。基于 RBAC 统一权限模型实现一个身份通行所有系统。4. 平台技术 ️核心框架Java Spring Boot成熟的微服务架构数据库支持 MySQL、PostgreSQL、Oracle、达梦、人大金仓认证协议全面支持 OAuth2.x、OpenID Connect、SAML 2.0、CAS、JWT、SCIM权限模型基于 RBAC 的统一权限控制支持数据权限和 API 权限部署方式支持 Docker 容器化部署适配 Kubernetes 集群信创适配支持国产操作系统麒麟、统信和国产数据库密码策略支持国密算法SM2/SM3/SM4满足密评要求5. 核心功能 ① 多协议单点登录MaxKey 支持几乎所有主流 SSO 协议企业无需改造现有系统即可接入支持的认证协议 ├── OAuth2.x —— 授权码模式、密码模式、客户端模式 ├── OpenID Connect —— 基于 OAuth2 的身份层扩展 ├── SAML 2.0 —— 企业级联邦认证适合大型组织 ├── CAS —— 经典中央认证服务协议 ├── JWT —— 无状态 Token 认证 └── SCIM —— 用户信息同步标准协议② 统一身份管理用户生命周期管理入职→在职→调岗→离职全流程自动化组织架构管理部门、岗位、角色灵活定义支持多级树形结构多租户支持一套系统服务多个业务单元数据完全隔离③ 细粒度权限控制基于 RBAC 模型实现三级权限控制// MaxKey RBAC 权限模型 用户(User) ──关联──▶ 角色(Role) ──关联──▶ 权限(Permission) ├── 菜单权限 ├── 数据权限 └── API 权限④ 安全审计全链路日志记录登录、授权、变更等所有操作异常检测异地登录、暴力破解、异常时间段访问告警密码策略复杂度检查、有效期管理、历史密码复用限制6. 独特优势 协议覆盖最全同时支持 OAuth2/OIDC/SAML/CAS/JWT/SCIM市面开源项目中协议最全国密算法支持内置 SM2/SM3/SM4 国密算法满足政企等保和密评要求信创生态适配适配麒麟、统信操作系统达梦、人大金仓数据库Apache-2.0 开源协议商业项目可自由使用无 GPL 传染性风险Dromara 社区加持Dromara 是国内最活跃的开源社区之一社区响应及时6 年持续维护2019 年至今持续迭代版本稳定可靠7. 安装使用 Docker 快速部署推荐# 1. 克隆项目 git clone https://gitee.com/dromara/MaxKey.git cd MaxKey # 2. 使用 Docker Compose 启动 docker-compose up -d # 3. 访问管理后台 # 浏览器打开http://localhost:9527 # 默认账号admin / 123456Spring Boot 应用集成 MaxKey 认证// 在你的 Spring Boot 项目中集成 MaxKey OAuth2 登录 Configuration publicclass SecurityConfig { Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { return http .oauth2Login(oauth2 - oauth2 .loginPage(/login) .defaultSuccessUrl(/dashboard) ) .authorizeHttpRequests(auth - auth .requestMatchers(/public/**).permitAll() .anyRequest().authenticated() ) .build(); } } // application.yml 配置 MaxKey 为认证服务器 spring: security: oauth2: client: registration: maxkey: client-id: your-client-id client-secret: your-client-secret authorization-grant-type: authorization_code redirect-uri: {baseUrl}/login/oauth2/code/maxkey provider: maxkey: authorization-uri: http://maxkey-server.com/authz/oauth/v20/authorize token-uri: http://maxkey-server.com/authz/oauth/v20/token user-info-uri: http://maxkey-server.com/authz/oauth/v20/userinfo接入第三方应用以 WordPress 为例在 MaxKey 管理后台创建应用选择 OAuth2 协议配置回调地址获取 Client ID 和 Client Secret在 WordPress 安装 OAuth 插件填入配置用户即可通过 MaxKey 统一登录 WordPress8. 应用场景 集团企业统一认证多子公司、多系统统一身份管理员工一套账号通行全集团政务云平台对接政务各委办局系统实现跨部门统一认证满足等保 2.0 要求高校数字化校园教务、学工、图书馆、宿舍等多系统统一登录入口医院信息系统集成HIS、EMR、LIS、PACS 等系统统一认证医生一次登录即可SaaS 多租户平台为不同客户提供独立身份域数据隔离支持客户自定义认证策略信创替代项目替代 Okta/Azure AD 等国外产品实现身份管理自主可控总结MaxKey 用6 年深耕 13,000 Star证明了它在身份认证领域的实力。对于需要统一认证平台、追求安全合规、同时不想被商业授权绑定的团队来说MaxKey 是国内开源 IAM 方案中的首选。特别是在信创大背景下支持国密算法和国产软硬件生态的 MaxKey为政企客户提供了真正自主可控的选择。项目地址https://gitee.com/dromara/MaxKey