Keycloak: 打开主题编辑器

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

👋 欢迎查阅 Stackhero 文档!

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

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

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

Stackhero 控制台 的服务页面,您会在管理控制台旁边看到一个 Themes editor 链接:

https://your-domain.com:4443/stackhero_themes/

请使用您的 Keycloak 管理员凭据 登录(与管理控制台相同的账号密码)。

请注意以下两点:

  • 编辑器运行在管理端口,而不是您的应用程序所用的端口。如果您在 Stackhero 防火墙中关闭了该端口,管理控制台和编辑器都将无法访问,但您的应用程序仍可正常进行身份验证。
  • 您在此处的所有更改都保存在服务磁盘上,包含在备份中,并在重启或升级后依然有效。

您会看到两个目录:

目录用途
themes/登录页面、账户控制台和邮件的外观定制。
providers/用于高级 Keycloak 定制的 Java 扩展(.jar 文件)。

每个目录下都包含一个 README.md 文件,内容与您的服务版本保持同步。