第2章 リリース固有の変更

このリリース以降、Red Hat build of Keycloak では、レルムの SMTP 設定に新しいオプション allowutf8 が追加されます (管理コンソールの Realm settings セクションの Email タブ内の Allow UTF-8 フィールド)。メールの設定の詳細は、「サーバー管理ガイド」の レルムのメールの設定 の章を参照してください。

このオプションを有効にすると、メールアドレスが送信時に UTF-8 でエンコードされます。ただし、SMTP サーバーも SMTPUTF8 拡張を介して UTF-8 をサポートしている必要があります。Allow UTF-8 が無効な場合、Red Hat build of Keycloak は、非 ASCII 文字が使用されている場合に、メールアドレスのドメイン部分 (@ の後に続く 2 番目の部分) を punycode を使用してエンコードし、ローカル部分に非 ASCII 文字が使用されているメールアドレスを拒否します。

レルムに SMTP サーバーが設定されている場合は、アップグレード後に次の移行を実行してください。