keycloak - Keycloak 中的 "Welcome"字母的 "Finish registration"

Question

当通过 Keycloak 管理控制台创建用户时，是否可以通过电子邮件通知用户已创建配置文件并且用户可以通过链接完成注册？
目前，只有在创建后为用户设置了密码，用户才能收到有关正在创建配置文件的电子邮件。并且仅在初始登录尝试之后。但是对于这次登录尝试，用户应该知道设置的密码。

Answer 1

我通过为发送的电子邮件和登录页面自定义 keycloak 主题模板来完成同样的事情。这是Keycloak docs关于如何自定义主题。

这是我如何做到的具体细节:

首先，我自定义了executeActions.ftl 电子邮件模板漂亮地说“欢迎使用我们的应用程序，单击下面的链接以完成您的帐户设置”。我继续使用默认基本模板中的链接和链接到期说明。您可以在 https://github.com/keycloak/keycloak/blob/master/themes/src/main/resources/theme/base/email/html/executeActions.ftl 看到默认的基本模板。

其次，我们决定了新用户“需要”哪些标准的 keycloak 操作 .我们决定要完成注册，用户需要执行以下操作:

接受条款和条件

输入他们的全名(更新他们的个人资料)

设置新密码

第三，我们设置 Keycloak 领域以要求所有用户完成 3 个步骤。
在 Keycloak 管理控制台中，我们将这些设置为“必需”操作(在配置-->身份验证-->必需操作下)，将“条款和条件”、“更新配置文件”和“更新密码”操作标记为“已启用” ”和“默认操作”。我们还按照我们希望它们在“帐户设置”过程中出现的确切顺序放置这些操作，用户将逐屏浏览。对于其他操作，我们取消选中默认操作。


第四，我自定义了以下呈现帐户设置页面的 keycloak 登录模板。 嵌入在 executeActions 电子邮件中的 keycloak 生成的链接(来自第 1 步)会将用户带到这些“帐户设置”网页:

info.ftl - 默认为 here .单击欢迎电子邮件中的链接后，用户最终会进入由该模板生成的页面。此页面通常呈现显示各种通用信息消息的网页，
但它也会呈现帐户设置过程的第一个和最后一个页面。所以我修改了它以检查 message.summary 是否与帐户设置过程的第一步或最后一步匹配。如果这是第一步，我会在页面上呈现“欢迎”文本。如果这是最后一步，我会呈现诸如“您的帐户已设置”之类的内容。点击此处登录'。请参阅下文了解我如何修改 info.ftl。

<!-- info.ftl -->
<#import "template.ftl" as layout>
<@layout.registrationLayout displayMessage=false; section>

  <#if section = "header">
    <#if messageHeader??>
      ${messageHeader}
    <#else>
      <#if message.summary == msg('confirmExecutionOfActions')>
        ${kcSanitize(msg('welcomeToOurApplication'))?no_esc}
      <#elseif message.summary == msg('accountUpdatedMessage')>
        ${kcSanitize(msg('accountSuccessfullySetup'))?no_esc}
      <#else>
        ${message.summary}
      </#if>
    </#if>

  <#elseif section = "form">
    <div id="kc-info-message">
      <div class="kc-info-wrapper">
        <#if message.summary == msg('confirmExecutionOfActions')>
          ${kcSanitize(msg('startSettingUpAccount'))?no_esc}
        <#elseif message.summary == msg('accountUpdatedMessage')>
          ${kcSanitize(msg('accountIsReadyPleaseLogin'))?no_esc}
        <#else>
          ${message.summary}
        </#if>
      </div>

      <#if pageRedirectUri??>

       ... <!-- Omitted the rest because it's the same as the base template -->

我还自定义了以下模板，它们对应于帐户设置过程中的步骤。

条款.ftl - 显示条款和条件步骤

登录更新配置文件.ftl - 显示用户需要输入/更新他/她的全名的步骤

登录更新密码.ftl - 提示用户更改密码。

第五，当管理员创建一个新用户时，他/她触发发送给用户的欢迎邮件:
- 在 Keycloak 管理控制台中，“添加”新用户后，转到该用户的“凭据”选项卡，然后在凭据重置下选择“重置操作”下所需的帐户设置操作，然后单击“发送电子邮件”按钮。



无论如何，我希望这会有所帮助。我记得我花了一点时间才弄明白，因为它不是 keycloak 中的标准流程。