Keycloak: Java 扩展（providers）

本文档属于自定义外观指南的一部分。您可以在此处查看完整指南：在 Stackhero 上轻松为您的 Keycloak 登录页面、账户控制台和邮件进行品牌定制：设置您的配色、Logo、文本，甚至可通过内置在线编辑器创建完整的自定义主题。。

👋 欢迎查阅 Stackhero 文档！

Stackhero 提供 Keycloak 云服务，让您仅需 2 分钟即可轻松部署一套可用于生产环境的身份认证服务：

• 无限量用户、realm 和 client
• 支持 OpenID Connect、OAuth 2.0、SAML 2.0、社交登录、LDAP 及 Active Directory 联邦
• 自定义域名，内置 HTTPS，保障安全访问（例如，https://login.your-company.com）
• 自定义主题：通过内置在线编辑器，轻松定制登录页面、账户控制台和邮件的品牌风格
• 专属 邮件服务器，支持 SPF、DKIM 和 DMARC，自动处理账户确认和密码重置
• 内置 PostgreSQL 数据库，管理控制台可通过独立端口访问并支持关闭
• 一键升级，系统自动保持最新，无需手动干预

专注于开发，而非配置：您可以在 5 分钟内体验 Stackhero 的 Keycloak 云解决方案。

providers/ 目录用于主题无法实现的功能：自定义认证器、用户存储、事件监听器或协议映射器等。

将您的 .jar 文件放入该目录并重启服务。此类重启会稍慢（约一分钟），因为 Keycloak 需重构以加载新扩展。若要移除扩展，删除文件并再次重启即可。

主题的 .jar 文件也可放在此目录，但建议优先使用 themes/，这样无需重构且便于后续文件编辑。