Keycloak - 如何在使用 Keycloak 的 Admin REST API 发送电子邮件时选择电子邮件验证模板?

Pee*_*eka 3 keycloak

我正在使用 Keycloak 的 Admin REST API 向用户发送验证电子邮件。具体来说,使用端点:

admin/realms/{realmName}/users/{userId}/execute-actions-email?redirect_uri={redirectURI}&client_id={clientId}
Run Code Online (Sandbox Code Playgroud)

邮件发送成功,但是keycloak选择的邮件模板是“Update Your Account”模板而不是“Verify email”模板。

有没有办法让 Keycloak 使用正确的模板?

更新:也 尝试使用send-verify-email端点.. 存在同样的问题。

小智 9

我扩展了 Barnys 的回答并最终得到了这个模板。不知道为什么他们不称其为“错误”而是限制https://issues.redhat.com/browse/KEYCLOAK-5034

用于 HTML

<#outputformat "plainText">
<#assign requiredActionsText><#if requiredActions??><#list requiredActions><#items as reqActionItem>${msg("requiredAction.${reqActionItem}")}<#sep>, </#sep></#items></#list></#if></#assign>
<#assign requiredActionsValues><#if requiredActions??><#list requiredActions><#items as reqActionItem>${reqActionItem}<#sep>, </#sep></#items></#list></#if></#assign>
</#outputformat>


<html>
<body>
<#if requiredActionsValues == "VERIFY_EMAIL">
${kcSanitize(msg("emailVerificationBodyHtml",link, linkExpiration, realmName, linkExpirationFormatter(linkExpiration)))?no_esc}
<#elseif requiredActionsValues == "UPDATE_PASSWORD">
${kcSanitize(msg("passwordResetBodyHtml",link, linkExpiration, realmName, linkExpirationFormatter(linkExpiration)))?no_esc}
<#else>
${kcSanitize(msg("executeActionsBodyHtml",link, linkExpiration, realmName, requiredActionsText, linkExpirationFormatter(linkExpiration)))?no_esc}
</#if>
</body>
</html>
Run Code Online (Sandbox Code Playgroud)

对于纯文本

<#ftl output_format="plainText">
<#assign requiredActionsText><#if requiredActions??><#list requiredActions><#items as reqActionItem>${msg("requiredAction.${reqActionItem}")}<#sep>, </#sep></#items></#list><#else></#if></#assign>
<#assign requiredActionsValues><#if requiredActions??><#list requiredActions><#items as reqActionItem>${reqActionItem}<#sep>, </#sep></#items></#list></#if></#assign>


<#if requiredActionsValues == "VERIFY_EMAIL">
${msg("emailVerificationBody",link, linkExpiration, realmName, linkExpirationFormatter(linkExpiration))}
<#elseif requiredActionsValues == "UPDATE_PASSWORD">
${msg("passwordResetBody",link, linkExpiration, realmName, linkExpirationFormatter(linkExpiration))}
<#else>
${msg("executeActionsBody",link, linkExpiration, realmName, requiredActionsText, linkExpirationFormatter(linkExpiration))}
</#if>
Run Code Online (Sandbox Code Playgroud)

不要忘记将模板更改放在集群的所有实例中并重新启动每个集群实例

sudo systemctl restart keycloak.service
Run Code Online (Sandbox Code Playgroud)

  • 在上面如何使用不同的邮件主题来执行不同的所需操作。 (4认同)