Keycloak :自定义执行操作邮件，是否可以获取用户自定义属性?

Question

我试图通过覆盖keycloak的executeAction邮件模板来向我的Keycloak用户发送自定义邮件。

我创建了：

../myProject/email/text/executeAction.ftl
../myProject/email/messages/messages_fr.properties
../myProject/email/html/executeAction.ftl

我已经收到一封使用这个html/executeAction.ftl的邮件：

${msg("executeActionsBody",link, linkExpiration, realmName, requiredActionsText, linkExpirationFormatter(linkExpiration),user.getFirstName(),user.getLastName(),user.getUsername(),user.getAttributes())}

所以我知道我的配置很好。 上面示例的问题在于，当我只想获取一个用户自定义属性时，我会显示一个用户自定义属性列表：

性别=先生或性别=太太

我尝试使用我在那里看到的功能： https://github.com/keycloak/keycloak/blob/4.5.0.Final/server-spi/src/main/java/org/keycloak/models/UserModel.java

给出以下内容：

<#assign gender= user.getAttributes(gender)/>
${msg("executeActionsBody",link, linkExpiration, realmName, requiredActionsText, linkExpirationFormatter(linkExpiration),user.getFirstName(),user.getLastName(),user.getUsername(),gender)}

我预计会收到一封包含用户性别的邮件，但没有发送邮件：

我有以下错误：

ERROR [org.keycloak.services] (default task-1) KC-SERVICES0029: Failed to send email: javax.mail.MessagingException: IOException while sending message;
nested exception is:
java.io.IOException: Exception writing Multipart
at com.sun.mail.smtp.SMTPTransport.sendMessage(SMTPTransport.java:1308)
at org.keycloak.email.DefaultEmailSenderProvider.send(DefaultEmailSenderProvider.java:142)
at org.keycloak.email.freemarker.FreeMarkerEmailTemplateProvider.send(FreeMarkerEmailTemplateProvider.java:251)
.......
Caused by: java.io.IOException: Exception writing Multipart
at com.sun.mail.handlers.multipart_mixed.writeTo(multipart_mixed.java:83)
at javax.activation.ObjectDataContentHandler.writeTo(DataHandler.java:897)
at javax.activation.DataHandler.writeTo(DataHandler.java:330)
at javax.mail.internet.MimeBodyPart.writeTo(MimeBodyPart.java:1652)
at javax.mail.internet.MimeMessage.writeTo(MimeMessage.java:1850)
at com.sun.mail.smtp.SMTPTransport.sendMessage(SMTPTransport.java:1259)
... 84 more
Caused by: javax.mail.MessagingException: Empty multipart: multipart/alternative; 
boundary="----=_Part_0_165447285.1560929205027"
at javax.mail.internet.MimeMultipart.writeTo(MimeMultipart.java:548)
at com.sun.mail.handlers.multipart_mixed.writeTo(multipart_mixed.java:81)
... 89 more

我不明白到底出了什么问题： 我的 ftl 不好吗？我不是专家，但从我所看到的情况来看，应该没问题。 看起来 keycloak 正在尝试发送邮件，那么当我尝试使用单个属性而不是完整列表时，为什么突然失败了？

另一种选择可能是在 .ftl 中使用某种正则表达式来提取性别，但我不知道这是否可能？

编辑：好的，经过多次试验和错误，我发现该怎么做：

我想我对 FTL 缺乏了解是问题所在。我通过这样做让它工作：

<#assign attributes = user.getAttributes()>
<#assign civilite = attributes.civilite?capitalize>
${msg("executeActionsBody",link, linkExpiration, realmName, requiredActionsText, linkExpirationFormatter(linkExpiration),user.getFirstName(),user.getLastName(),user.getUsername(),civilite)}

我不知道为什么我需要删除 ${} 部分，或者为什么你会通过执行 attributes.key 而不是使用 getter 来获取 HashMap 中的值>但它工作得很好......

Answer 1

好的，经过多次试验和错误，我发现了如何做到这一点：

我想我对 FTL 缺乏了解是问题所在。我通过这样做让它工作：

<#assign attributes = user.getAttributes()>
<#assign civilite = attributes.civilite?capitalize>
${msg("executeActionsBody",link, linkExpiration, realmName, requiredActionsText, linkExpirationFormatter(linkExpiration),user.getFirstName(),user.getLastName(),user.getUsername(),civilite)}

我不知道为什么我需要删除 ${} 部分，或者为什么你会通过执行 attributes.key 而不是使用 getter 来获取 HashMap 中的值>但它工作得很好......