# Copyright (C) 2012-2016 Zammad Foundation, http://zammad-foundation.org/ # encoding: utf-8 require 'mail' require 'encode' class Channel::EmailParser =begin parser = Channel::EmailParser.new mail = parser.parse(msg_as_string) mail = { from: 'Some Name ', from_email: 'some@example.com', from_local: 'some', from_domain: 'example.com', from_display_name: 'Some Name', message_id: 'some_message_id@example.com', to: 'Some System ', cc: 'Somebody ', subject: 'some message subject', body: 'some message body', content_type: 'text/html', # text/plain date: Time.zone.now, attachments: [ { data: 'binary of attachment', filename: 'file_name_of_attachment.txt', preferences: { 'content-alternative' => true, 'Mime-Type' => 'text/plain', 'Charset: => 'iso-8859-1', }, }, ], # ignore email header x-zammad-ignore: 'false', # customer headers x-zammad-customer-login: '', x-zammad-customer-email: '', x-zammad-customer-firstname: '', x-zammad-customer-lastname: '', # ticket headers (for new tickets) x-zammad-ticket-group: 'some_group', x-zammad-ticket-state: 'some_state', x-zammad-ticket-priority: 'some_priority', x-zammad-ticket-owner: 'some_owner_login', # ticket headers (for existing tickets) x-zammad-ticket-followup-group: 'some_group', x-zammad-ticket-followup-state: 'some_state', x-zammad-ticket-followup-priority: 'some_priority', x-zammad-ticket-followup-owner: 'some_owner_login', # article headers x-zammad-article-internal: false, x-zammad-article-type: 'agent', x-zammad-article-sender: 'customer', # all other email headers some-header: 'some_value', } =end def parse(msg) data = {} mail = Mail.new(msg) # set all headers mail.header.fields.each { |field| # full line, encode, ready for storage begin value = Encode.conv('utf8', field.to_s) if value.blank? value = field.raw_value end data[field.name.to_s.downcase.to_sym] = value rescue => e data[field.name.to_s.downcase.to_sym] = field.raw_value end # if we need to access the lines by objects later again data["raw-#{field.name.downcase}".to_sym] = field } # verify content, ignore recipients with non email address ['to', 'cc', 'delivered-to', 'x-original-to', 'envelope-to'].each { |field| next if data[field.to_sym].blank? next if data[field.to_sym] =~ /@/ data[field.to_sym] = '' } # get sender from = nil ['from', 'reply-to', 'return-path'].each { |item| next if data[item.to_sym].blank? from = data[item.to_sym] break if from } # set x-any-recipient data['x-any-recipient'.to_sym] = '' ['to', 'cc', 'delivered-to', 'x-original-to', 'envelope-to'].each { |item| next if data[item.to_sym].blank? if data['x-any-recipient'.to_sym] != '' data['x-any-recipient'.to_sym] += ', ' end data['x-any-recipient'.to_sym] += mail[item.to_sym].to_s } # set extra headers begin data[:from_email] = Mail::Address.new(from).address data[:from_local] = Mail::Address.new(from).local data[:from_domain] = Mail::Address.new(from).domain data[:from_display_name] = Mail::Address.new(from).display_name || (Mail::Address.new(from).comments && Mail::Address.new(from).comments[0]) rescue from.strip! if from =~ /^(.+?)<(.+?)@(.+?)>$/ data[:from_email] = "#{$2}@#{$3}" data[:from_local] = $2 data[:from_domain] = $3 data[:from_display_name] = $1 else data[:from_email] = from data[:from_local] = from data[:from_domain] = from end end # do extra decoding because we needed to use field.value data[:from_display_name] = Mail::Field.new('X-From', data[:from_display_name]).to_s data[:from_display_name].delete!('"') data[:from_display_name].strip! data[:from_display_name].gsub!(/^'/, '') data[:from_display_name].gsub!(/'$/, '') # compat headers data[:message_id] = data['message-id'.to_sym] # body # plain_part = mail.multipart? ? (mail.text_part ? mail.text_part.body.decoded : nil) : mail.body.decoded # html_part = message.html_part ? message.html_part.body.decoded : nil data[:attachments] = [] # multi part email if mail.multipart? # html attachment/body may exists and will be converted to strict html if mail.html_part && mail.html_part.body data[:body] = mail.html_part.body.to_s data[:body] = Encode.conv(mail.html_part.charset.to_s, data[:body]) data[:body] = data[:body].html2html_strict.to_s.force_encoding('utf-8') if !data[:body].force_encoding('UTF-8').valid_encoding? data[:body] = data[:body].encode('utf-8', 'binary', invalid: :replace, undef: :replace, replace: '?') end data[:content_type] = 'text/html' end # text attachment/body exists if data[:body].empty? && mail.text_part data[:body] = mail.text_part.body.decoded data[:body] = Encode.conv(mail.text_part.charset, data[:body]) if !data[:body].valid_encoding? data[:body] = data[:body].encode('utf-8', 'binary', invalid: :replace, undef: :replace, replace: '?') end data[:content_type] = 'text/plain' end # any other attachments if data[:body].empty? data[:body] = 'no visible content' data[:content_type] = 'text/plain' end # add html attachment/body as real attachment if mail.html_part filename = 'message.html' headers_store = { 'content-alternative' => true, } if mail.mime_type headers_store['Mime-Type'] = mail.html_part.mime_type end if mail.charset headers_store['Charset'] = mail.html_part.charset end attachment = { data: mail.html_part.body.to_s, filename: mail.html_part.filename || filename, preferences: headers_store } data[:attachments].push attachment end # get attachments if mail.parts mail.parts.each { |part| # protect process to work fine with spam emails, see test/fixtures/mail15.box begin attachs = _get_attachment(part, data[:attachments], mail) data[:attachments].concat(attachs) rescue attachs = _get_attachment(part, data[:attachments], mail) data[:attachments].concat(attachs) end } end # not multipart email # html part only, convert to text and add it as attachment elsif mail.mime_type && mail.mime_type.to_s.casecmp('text/html').zero? filename = 'message.html' data[:body] = mail.body.decoded data[:body] = Encode.conv(mail.charset, data[:body]) data[:body] = data[:body].html2html_strict.to_s.force_encoding('utf-8') if !data[:body].valid_encoding? data[:body] = data[:body].encode('utf-8', 'binary', invalid: :replace, undef: :replace, replace: '?') end data[:content_type] = 'text/html' # add body as attachment headers_store = { 'content-alternative' => true, } if mail.mime_type headers_store['Mime-Type'] = mail.mime_type end if mail.charset headers_store['Charset'] = mail.charset end attachment = { data: mail.body.decoded, filename: mail.filename || filename, preferences: headers_store } data[:attachments].push attachment # text part only elsif !mail.mime_type || mail.mime_type.to_s == '' || mail.mime_type.to_s.casecmp('text/plain').zero? data[:body] = mail.body.decoded data[:body] = Encode.conv(mail.charset, data[:body]) if !data[:body].force_encoding('UTF-8').valid_encoding? data[:body] = data[:body].encode('utf-8', 'binary', invalid: :replace, undef: :replace, replace: '?') end data[:content_type] = 'text/plain' else filename = '-no name-' data[:body] = 'no visible content' data[:content_type] = 'text/plain' # add body as attachment headers_store = { 'content-alternative' => true, } if mail.mime_type headers_store['Mime-Type'] = mail.mime_type end if mail.charset headers_store['Charset'] = mail.charset end attachment = { data: mail.body.decoded, filename: mail.filename || filename, preferences: headers_store } data[:attachments].push attachment end # strip not wanted chars data[:body].gsub!(/\n\r/, "\n") data[:body].gsub!(/\r\n/, "\n") data[:body].tr!("\r", "\n") # get mail date begin if mail.date data[:date] = Time.zone.parse(mail.date.to_s) end rescue data[:date] = nil end # remember original mail instance data[:mail_instance] = mail data end def _get_attachment(file, attachments, mail) # check if sub parts are available if !file.parts.empty? a = [] file.parts.each { |p| attachment = _get_attachment(p, attachments, mail) a.concat(attachment) } return a end # ignore text/plain attachments - already shown in view return [] if mail.text_part && mail.text_part.body.to_s == file.body.to_s # ignore text/html - html part, already shown in view return [] if mail.html_part && mail.html_part.body.to_s == file.body.to_s # get file preferences headers_store = {} file.header.fields.each { |field| headers_store[field.name.to_s] = field.value.to_s } # get filename from content-disposition filename = nil # workaround for: NoMethodError: undefined method `filename' for # begin filename = file.header[:content_disposition].filename rescue begin result = file.header[:content_disposition].to_s.scan( /filename=("|)(.+?)("|);/i ) if result && result[0] && result[0][1] filename = result[0][1] end rescue Rails.logger.debug 'Unable to get filename' end end # for some broken sm mail clients (X-MimeOLE: Produced By Microsoft Exchange V6.5) filename ||= file.header[:content_location].to_s # generate file name if filename.blank? attachment_count = 0 (1..1000).each { |count| filename_exists = false filename = 'file-' + count.to_s attachments.each { |attachment| if attachment[:filename] == filename filename_exists = true end } break if filename_exists == false } end # get mime type if file.header[:content_type] && file.header[:content_type].string headers_store['Mime-Type'] = file.header[:content_type].string end # get charset if file.header && file.header.charset headers_store['Charset'] = file.header.charset end # remove not needed header headers_store.delete('Content-Transfer-Encoding') headers_store.delete('Content-Disposition') # cleanup content id, <> will be added automatically later if headers_store['Content-ID'] headers_store['Content-ID'].gsub!(/^$/, '') end attach = { data: file.body.to_s, filename: filename, preferences: headers_store, } [attach] end =begin parser = Channel::EmailParser.new ticket, article, user = parser.process(channel, email_raw_string) returns [ticket, article, user] do not raise an exception - e. g. if used by scheduler parser = Channel::EmailParser.new ticket, article, user = parser.process(channel, email_raw_string, false) returns [ticket, article, user] || false =end def process(channel, msg, exception = true) _process(channel, msg) rescue => e # store unprocessable email for bug reporting path = "#{Rails.root}/tmp/unprocessable_mail/" FileUtils.mkpath path md5 = Digest::MD5.hexdigest(msg) filename = "#{path}/#{md5}.eml" message = "ERROR: Can't process email, you will find it for bug reporting under #{filename}, please create an issue at https://github.com/zammad/zammad/issues" p message # rubocop:disable Rails/Output p 'ERROR: ' + e.inspect # rubocop:disable Rails/Output Rails.logger.error message Rails.logger.error 'ERROR: ' + e.inspect Rails.logger.error 'ERROR: ' + e.backtrace.inspect File.open(filename, 'wb') { |file| file.write msg } return false if exception == false raise e.inspect + e.backtrace.inspect end def _process(channel, msg) # parse email mail = parse(msg) # run postmaster pre filter UserInfo.current_user_id = 1 filters = {} Setting.where(area: 'Postmaster::PreFilter').order(:name).each { |setting| filters[setting.name] = Kernel.const_get(Setting.get(setting.name)) } filters.each { |_prio, backend| Rails.logger.debug "run postmaster pre filter #{backend}" begin backend.run(channel, mail) rescue => e Rails.logger.error "can't run postmaster pre filter #{backend}" Rails.logger.error e.inspect raise e end } # check ignore header if mail['x-zammad-ignore'.to_sym] == 'true' || mail['x-zammad-ignore'.to_sym] == true Rails.logger.info "ignored email with msgid '#{mail[:message_id]}' from '#{mail[:from]}' because of x-zammad-ignore header" return true end # set interface handle original_interface_handle = ApplicationHandleInfo.current ticket = nil article = nil session_user = nil # use transaction Transaction.execute(interface_handle: "#{original_interface_handle}.postmaster") do # get sender user session_user_id = mail['x-zammad-session-user-id'.to_sym] if !session_user_id raise 'No x-zammad-session-user-id, no sender set!' end session_user = User.lookup(id: session_user_id) if !session_user raise "No user found for x-zammad-session-user-id: #{session_user_id}!" end # set current user UserInfo.current_user_id = session_user.id # get ticket# based on email headers if mail['x-zammad-ticket-id'.to_sym] ticket = Ticket.find_by(id: mail['x-zammad-ticket-id'.to_sym]) end if mail['x-zammad-ticket-number'.to_sym] ticket = Ticket.find_by(number: mail['x-zammad-ticket-number'.to_sym]) end # set ticket state to open if not new if ticket set_attributes_by_x_headers(ticket, 'ticket', mail, 'followup') # save changes set by x-zammad-ticket-followup-* headers ticket.save if ticket.changed? state = Ticket::State.find(ticket.state_id) state_type = Ticket::StateType.find(state.state_type_id) # if tickte is merged, find linked ticket if state_type.name == 'merged' end # set ticket to open again or keep create state if !mail['x-zammad-ticket-followup-state'.to_sym] && !mail['x-zammad-ticket-followup-state_id'.to_sym] new_state = Ticket::State.find_by(default_create: true) if ticket.state_id != new_state.id && !mail['x-zammad-out-of-office'.to_sym] ticket.state = Ticket::State.find_by(default_follow_up: true) ticket.save! end end end # create new ticket if !ticket preferences = {} if channel[:id] preferences = { channel_id: channel[:id] } end # get default group where ticket is created group = nil if channel[:group_id] group = Group.lookup(id: channel[:group_id]) end if !group || group && !group.active group = Group.where(active: true).order('id ASC').first end if !group group = Group.first end title = mail[:subject] if title.blank? title = '-' end ticket = Ticket.new( group_id: group.id, title: title, preferences: preferences, ) set_attributes_by_x_headers(ticket, 'ticket', mail) # create ticket ticket.save! end # set attributes ticket.with_lock do article = Ticket::Article.new( ticket_id: ticket.id, type_id: Ticket::Article::Type.find_by(name: 'email').id, sender_id: Ticket::Article::Sender.find_by(name: 'Customer').id, content_type: mail[:content_type], body: mail[:body], from: mail[:from], to: mail[:to], cc: mail[:cc], subject: mail[:subject], message_id: mail[:message_id], internal: false, ) # x-headers lookup set_attributes_by_x_headers(article, 'article', mail) # create article article.save! # store mail plain article.save_as_raw(msg) # store attachments if mail[:attachments] mail[:attachments].each do |attachment| Store.add( object: 'Ticket::Article', o_id: article.id, data: attachment[:data], filename: attachment[:filename], preferences: attachment[:preferences] ) end end end end # run postmaster post filter filters = {} Setting.where(area: 'Postmaster::PostFilter').order(:name).each { |setting| filters[setting.name] = Kernel.const_get(Setting.get(setting.name)) } filters.each { |_prio, backend| Rails.logger.debug "run postmaster post filter #{backend}" begin backend.run(channel, mail, ticket, article, session_user) rescue => e Rails.logger.error "can't run postmaster post filter #{backend}" Rails.logger.error e.inspect end } # return new objects [ticket, article, session_user, mail] end def self.check_attributes_by_x_headers(header_name, value) class_name = nil attribute = nil if header_name =~ /^x-zammad-(.+?)-(followup-|)(.*)$/i class_name = $1 attribute = $3 end return true if !class_name if class_name.downcase == 'article' class_name = 'Ticket::Article' end return true if !attribute key_short = attribute[ attribute.length - 3, attribute.length ] return true if key_short != '_id' class_object = Object.const_get(class_name.to_classname) return if !class_object class_instance = class_object.new return false if !class_instance.association_id_validation(attribute, value) true end def set_attributes_by_x_headers(item_object, header_name, mail, suffix = false) # loop all x-zammad-hedaer-* headers item_object.attributes.each { |key, _value| # ignore read only attributes next if key == 'updated_by_id' next if key == 'created_by_id' # check if id exists key_short = key[ key.length - 3, key.length ] if key_short == '_id' key_short = key[ 0, key.length - 3 ] header = "x-zammad-#{header_name}-#{key_short}" if suffix header = "x-zammad-#{header_name}-#{suffix}-#{key_short}" end # only set value on _id if value/reference lookup exists if mail[ header.to_sym ] Rails.logger.info "header #{header} found #{mail[header.to_sym]}" item_object.class.reflect_on_all_associations.map { |assoc| next if assoc.name.to_s != key_short Rails.logger.info "ASSOC found #{assoc.class_name} lookup #{mail[header.to_sym]}" item = assoc.class_name.constantize assoc_object = nil assoc_has_object = false if item.respond_to?(:name) assoc_has_object = true if item.lookup(name: mail[header.to_sym]) assoc_object = item.lookup(name: mail[header.to_sym]) end elsif item.respond_to?(:login) assoc_has_object = true if item.lookup(login: mail[header.to_sym]) assoc_object = item.lookup(login: mail[header.to_sym]) end end next if assoc_has_object == false if assoc_object item_object[key] = assoc_object.id next end # no assoc exists, remove header mail.delete(header.to_sym) } end end # check if attribute exists header = "x-zammad-#{header_name}-#{key}" if suffix header = "x-zammad-#{header_name}-#{suffix}-#{key}" end if mail[header.to_sym] Rails.logger.info "header #{header} found #{mail[header.to_sym]}" item_object[key] = mail[header.to_sym] end } end end module Mail # workaround to get content of no parseable headers - in most cases with non 7 bit ascii signs class Field def raw_value value = Encode.conv('utf8', @raw_value) value.sub(/^.+?:(\s|)/, '') end end # workaround to parse subjects with 2 different encodings correctly (e. g. quoted-printable see test/fixtures/mail9.box) module Encodings def self.value_decode(str) # Optimization: If there's no encoded-words in the string, just return it return str unless str.index('=?') str = str.gsub(/\?=(\s*)=\?/, '?==?') # Remove whitespaces between 'encoded-word's # Split on white-space boundaries with capture, so we capture the white-space as well str.split(/([ \t])/).map do |text| if text.index('=?') .nil? text else # Join QP encoded-words that are adjacent to avoid decoding partial chars # text.gsub!(/\?\=\=\?.+?\?[Qq]\?/m, '') if text =~ /\?==\?/ # Search for occurences of quoted strings or plain strings text.scan(/( # Group around entire regex to include it in matches \=\?[^?]+\?([QB])\?[^?]+?\?\= # Quoted String with subgroup for encoding method | # or .+?(?=\=\?|$) # Plain String )/xmi).map do |matches| string, method = *matches if method == 'b' || method == 'B' b_value_decode(string) elsif method == 'q' || method == 'Q' q_value_decode(string) else string end end end end.join('') end end # issue#348 - IMAP mail fetching stops because of broken spam email (e. g. broken Content-Transfer-Encoding value see test/fixtures/mail43.box) # https://github.com/zammad/zammad/issues/348 class Body def decoded if !Encodings.defined?(encoding) #raise UnknownEncodingType, "Don't know how to decode #{encoding}, please call #encoded and decode it yourself." Rails.logger.info "UnknownEncodingType: Don't know how to decode #{encoding}!" raw_source else Encodings.get_encoding(encoding).decode(raw_source) end end end end