能否将Azure Email Communication Service作为KeyCloak邮件提供商？SMTP参数疑问

1. 获取Azure Email Communication Service（AECS）的SMTP参数 #

Azure门户默认页面不会直接展示SMTP信息，需进入指定路径获取：

• 登录Azure门户，打开你的AECS资源
• 在左侧导航栏「设置」分组下，找到**「SMTP设置」**（若未显示，刷新页面或确认资源类型为Email Communication Service）
• 此处可查看SMTP服务器地址（格式示例：smtp.azurecomm.net）、端口（固定为587，需用TLS加密）

认证信息说明 #

AECS的SMTP认证需使用以下信息：

• 用户名：你的AECS资源名称（创建资源时自定义的名称，不是验证的域名）
• 密码：在AECS资源的**「密钥和终结点」**页面复制任意一个「访问密钥」（Key1或Key2）

2. 为Docker部署的KeyCloak配置SMTP #

有两种配置方式，按需选择：

方式一：通过环境变量配置（推荐，适配Docker容器） #

启动KeyCloak容器时添加以下环境变量：

-e KC_MAIL_SMTP_SERVER=smtp.azurecomm.net \
-e KC_MAIL_SMTP_PORT=587 \
-e KC_MAIL_SMTP_USERNAME=<你的AECS资源名称> \
-e KC_MAIL_SMTP_PASSWORD=<你的AECS访问密钥> \
-e KC_MAIL_SMTP_STARTTLS=true \
-e KC_MAIL_FROM=<已验证域名下的发件邮箱，如no-reply@yourdomain.com>

方式二：通过KeyCloak管理后台配置 #

• 登录KeyCloak管理控制台，进入目标Realm
• 左侧导航栏选择**「Realm设置」** → 「邮件」
• 填写SMTP服务器、端口，开启「启用STARTTLS」，输入用户名（AECS资源名）和密码（访问密钥），设置发件邮箱为已验证域名下的地址
• 点击「测试连接」验证配置有效性

3. 关键注意事项 #

• 发件邮箱的后缀必须是已在AECS中完成验证的域名，否则邮件会被拒收
• AECS访问密钥权限极高，请勿泄露，建议通过Azure Key Vault管理后注入容器
• 若测试邮件失败，检查AECS的发送配额是否充足，以及防火墙是否允许KeyCloak容器访问587端口

内容的提问来源于stack exchange，提问作者Ali Radan