Class: Rex::MIME::Message

Inherits:
Object
  • Object
show all
Includes:
Encoding
Defined in:
lib/rex/mime/message.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Encoding

#force_crlf

Constructor Details

#initialize(data = nil) ⇒ Message

Returns a new instance of Message.



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
 
# File 'lib/rex/mime/message.rb', line 16

def initialize(data=nil)
  self.header = Rex::MIME::Header.new
  self.parts  = []
  self.bound  = "_Part_#{rand(1024)}_#{rand(0xffffffff)}_#{rand(0xffffffff)}"
  self.content = ''
  if data
    head,body = data.split(/\r?\n\r?\n/, 2)

    self.header.parse(head)
    ctype = self.header.find('Content-Type')

    if ctype and ctype[1] and ctype[1] =~ /multipart\/mixed;\s*boundary=([^\s]+)/
      self.bound = $1

      chunks = body.to_s.split(/--#{self.bound}(--)?\r?\n/)
      self.content = chunks.shift.to_s.gsub(/\s+$/, '')
      self.content << "\r\n" if not self.content.empty?

      chunks.each do |chunk|
        break if chunk == "--"
        head,body = chunk.split(/\r?\n\r?\n/, 2)
        part = Rex::MIME::Part.new
        part.header.parse(head)
        part.content = body.gsub(/\s+$/, '')
        self.parts << part
      end
    else
      self.content = body.to_s.gsub(/\s+$/, '') + "\r\n"
    end
  end
end

Instance Attribute Details

#bound ⇒ Object

Returns the value of attribute bound.



13
14
15
 
# File 'lib/rex/mime/message.rb', line 13

def bound
  @bound
end

#content ⇒ Object

Returns the value of attribute content.



13
14
15
 
# File 'lib/rex/mime/message.rb', line 13

def content
  @content
end

#header ⇒ Object

Returns the value of attribute header.



13
14
15
 
# File 'lib/rex/mime/message.rb', line 13

def header
  @header
end

#parts ⇒ Object

Returns the value of attribute parts.



13
14
15
 
# File 'lib/rex/mime/message.rb', line 13

def parts
  @parts
end

Instance Method Details

#add_part(data = '', content_type = 'text/plain', transfer_encoding = "8bit", content_disposition = nil) ⇒ Object 



89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/rex/mime/message.rb', line 89

def add_part(data='', content_type='text/plain', transfer_encoding="8bit", content_disposition=nil)
  part = Rex::MIME::Part.new

  if (content_disposition)
    part.header.set("Content-Disposition", content_disposition)
  end

  if (content_type)
    part.header.set("Content-Type", content_type)
  end

  if (transfer_encoding)
    part.header.set("Content-Transfer-Encoding", transfer_encoding)
  end

  part.content = data
  self.parts << part
  part
end

#add_part_attachment(data, name) ⇒ Object 



109
110
111
112
113
114
115
116
 
# File 'lib/rex/mime/message.rb', line 109

def add_part_attachment(data, name)
  self.add_part(
    Rex::Text.encode_base64(data, "\r\n"),
    "application/octet-stream; name=\"#{name}\"",
    "base64",
    "attachment; filename=\"#{name}\""
  )
end

#add_part_inline_attachment(data, name) ⇒ Object 



119
120
121
122
123
124
125
126
 
# File 'lib/rex/mime/message.rb', line 119

def add_part_inline_attachment(data, name)
  self.add_part(
    Rex::Text.encode_base64(data, "\r\n"),
    "application/octet-stream; name=\"#{name}\"",
    "base64",
    "inline; filename=\"#{name}\""
  )
end

#from ⇒ Object 



60
61
62
 
# File 'lib/rex/mime/message.rb', line 60

def from
  (self.header.find('From') || [nil, nil])[1]
end

#from=(val) ⇒ Object 



56
57
58
 
# File 'lib/rex/mime/message.rb', line 56

def from=(val)
  self.header.set("From", val)
end

#mime_defaults ⇒ Object 



72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/rex/mime/message.rb', line 72

def mime_defaults
  self.header.set("MIME-Version", "1.0")
  self.header.set("Content-Type", "multipart/mixed; boundary=\"#{self.bound}\"")
  self.header.set("Subject", '') # placeholder
  self.header.set("Date", Time.now.strftime("%a,%e %b %Y %H:%M:%S %z"))
  self.header.set("Message-ID",
    "<"+
    Rex::Text.rand_text_alphanumeric(rand(20)+40)+
    "@"+
    Rex::Text.rand_text_alpha(rand(20)+3)+
    ">"
  )
  self.header.set("From", '')    # placeholder
  self.header.set("To", '')      # placeholder
end

#subject ⇒ Object 



68
69
70
 
# File 'lib/rex/mime/message.rb', line 68

def subject
  (self.header.find('Subject') || [nil, nil])[1]
end

#subject=(val) ⇒ Object 



64
65
66
 
# File 'lib/rex/mime/message.rb', line 64

def subject=(val)
  self.header.set("Subject", val)
end

#to ⇒ Object 



48
49
50
 
# File 'lib/rex/mime/message.rb', line 48

def to
  (self.header.find('To') || [nil, nil])[1]
end

#to=(val) ⇒ Object 



52
53
54
 
# File 'lib/rex/mime/message.rb', line 52

def to=(val)
  self.header.set("To", val)
end

#to_s ⇒ Object 



128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
 
# File 'lib/rex/mime/message.rb', line 128

def to_s
  msg = force_crlf(self.header.to_s + "\r\n")

  unless self.content.blank?
    msg << force_crlf(self.content + "\r\n")
  end

  self.parts.each do |part|
    msg << force_crlf("--" + self.bound + "\r\n")
    msg << part.to_s
  end

  if self.parts.length > 0
    msg << force_crlf("--" + self.bound + "--\r\n")
  end

  msg
end