如何在Ruby on Rails中为ActionMailer配置mTLS连接？

1. 准备mTLS证书文件 #

首先你需要拿到三组关键文件：

• CA根证书（比如ca.pem）：用来验证邮件服务器的证书合法性
• 客户端证书（比如client_cert.pem）：邮件服务器用来确认你的客户端身份
• 客户端私钥（比如client_key.pem）：和客户端证书配对的加密密钥

把这些文件放到Rails项目的config/certs/目录下，务必严格设置文件权限，避免敏感信息泄露：

chmod 600 config/certs/client_key.pem
chmod 644 config/certs/*.pem

2. 配置ActionMailer的SMTP参数 #

打开对应运行环境的配置文件（比如生产环境用config/environments/production.rb），找到ActionMailer的SMTP配置块，添加mTLS相关参数：

config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address: '你的SMTP服务器地址',
  port: 587, # 也可能是465，取决于邮件服务器的配置
  domain: '你的业务域名',
  user_name: '可选：SMTP认证用户名（如果服务器需要）',
  password: '可选：SMTP认证密码（如果服务器需要）',
  authentication: :plain, # 或其他认证方式，比如:login
  enable_starttls_auto: true,
  # mTLS核心配置项
  openssl_verify_mode: OpenSSL::SSL::VERIFY_PEER,
  cert: File.read(Rails.root.join('config/certs/client_cert.pem')),
  key: File.read(Rails.root.join('config/certs/client_key.pem')),
  ca_file: Rails.root.join('config/certs/ca.pem').to_s,
  # 如果客户端私钥设置了密码，取消注释下面这行
  # key_passphrase: '你的私钥密码'
}

3. 验证配置是否生效 #

通过Rails控制台发送测试邮件，确认mTLS连接正常：

# 启动Rails控制台
rails c

# 发送测试邮件
ActionMailer::Base.mail(
  from: 'sender@yourdomain.com',
  to: 'test@example.com',
  subject: 'mTLS连接测试',
  body: '检查mTLS配置是否生效'
).deliver_now

查看项目日志（比如log/production.log），如果出现TLS connection established类的日志，且无证书验证错误，说明配置成功。

注意事项 #

• 确保证书文件路径正确，Rails.root能准确指向项目根目录
• 客户端私钥的权限必须设为600，禁止其他用户读取
• 提前确认邮件服务器已将你的客户端证书加入信任列表
• 定期检查证书有效期，避免过期导致邮件发送失败

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