第 2 章 特定于发行版本的更改

从这个版本起，红帽构建的 Keycloak 增加了一个新的选项 allowutf8 以用于域 SMTP 配置（允许管理控制台的 Realm settings 部分中的 Email 选项卡中的Allow UTF-8 字段）。有关电子邮件配置的更多信息，请参阅服务器管理指南中的 为域配置电子邮件 章节。

在发送时，启用 UTF-8 中的选项对电子邮件地址进行编码，但它依赖于 SMTP 服务器，通过 SMTPUTF8 扩展支持 UTF-8。如果禁用 Allow UTF-8，红帽构建的 Keycloak 将对电子邮件地址的域部分进行编码（如果使用了非 ASCIII 字符），并使用 punycode 对电子邮件地址进行编码，并将拒绝在本地部分中使用非 ASCIII 字符的电子邮件地址。

如果您为域配置了 SMTP 服务器，请升级后执行以下迁移：