zammad/app/models/channel/driver/smtp.rb

# Copyright (C) 2012-2025 Zammad Foundation, https://zammad-foundation.org/

class Channel::Driver::Smtp < Channel::Driver::BaseEmailOutbound
=begin

  instance = Channel::Driver::Smtp.new
  instance.send(
    {
      host:                 'some.host',
      port:                 25,
      enable_starttls_auto: true, # optional
      openssl_verify_mode:  'none', # optional
      user:                 'someuser',
      password:             'somepass'
      authentication:       nil, # nil, autodetection - to use certain schema use 'plain', 'login', 'xoauth2' or 'cram_md5'
    },
    mail_attributes,
    notification
  )

=end

  def deliver(options, attr, notification = false)
    # return if we run import mode
    return if Setting.get('import_mode')

    options = prepare_options(options, attr)

    attr = prepare_message_attrs(attr)

    smtp_params = build_smtp_params(options)

    Certificate::ApplySSLCertificates.ensure_fresh_ssl_context if options[:ssl] || options[:enable_starttls_auto]

    deliver_mail(attr, notification, :smtp, smtp_params)
  end

  def prepare_options(options, attr)
    # set smtp defaults
    if !options.key?(:port) || options[:port].blank?
      options[:port] = 25
    end

    if !options.key?(:ssl) && options[:port].to_i == 465
      options[:ssl] = true
    end

    if !options.key?(:domain)
      # set fqdn, if local fqdn - use domain of sender
      fqdn = Setting.get('fqdn')
      if fqdn =~ %r{(localhost|\.local^|\.loc^)}i && (attr['from'] || attr[:from])
        domain = Mail::Address.new(attr['from'] || attr[:from]).domain
        if domain
          fqdn = domain
        end
      end
      options[:domain] = fqdn
    end

    if !options.key?(:enable_starttls_auto)
      options[:enable_starttls_auto] = true
    end

    options
  end

  def build_smtp_params(options)
    ssl_verify_mode = if options[:openssl_verify_mode].present?
                        options[:openssl_verify_mode]
                      else
                        options.fetch(:ssl_verify, true) ? 'peer' : 'none'
                      end

    smtp_params = {
      openssl_verify_mode:  ssl_verify_mode,
      address:              options[:host],
      port:                 options[:port],
      domain:               options[:domain],
      enable_starttls_auto: options[:enable_starttls_auto],
      open_timeout:         DEFAULT_OPEN_TIMEOUT,
      read_timeout:         DEFAULT_READ_TIMEOUT,
    }

    # set ssl if needed
    if options[:ssl].present?
      smtp_params[:ssl] = options[:ssl]
    end

    # add authentication only if needed
    if options[:user].present?
      smtp_params[:user_name] = options[:user]
      smtp_params[:password] = options[:password]
      smtp_params[:authentication] = options[:authentication]
    end

    smtp_params
  end
end