Land rapid7#8102, Add a plugin to notify new sessions via SMS

Author: dmohanty-r7

documentation/modules/auxiliary/client/sms/send_text.md

@@ -23,6 +23,10 @@ Remember that these phone numbers must be the same carrier.
 The carrier that the targeted numbers use. See **Supported Carrier Gateways** to learn more about
 supported carriers.
 
+**SMSSUBJECT**
+
+The text subject.
+
 **SMSMESSAGE**
 
 The text message you want to send. For example, this will send a text with a link to google:

lib/msf/core/auxiliary/sms.rb

@@ -22,7 +22,8 @@ def initialize(info={})
           OptString.new('SMTPPASSWORD', [true, 'The SMTP password to use to send the text messages']),
           OptEnum.new('SMSCARRIER', [true, 'The targeted SMS service provider', nil,Rex::Proto::Sms::Model::GATEWAYS.keys.collect { |k| k.to_s }]),
           OptString.new('CELLNUMBERS', [true, 'The phone numbers to send to']),
-          OptString.new('SMSMESSAGE', [true, 'The text message to send'])
+          OptString.new('SMSMESSAGE', [true, 'The text message to send']),
+          OptString.new('SMSSUBJECT', [false, 'The text subject', ''])
         ], Auxiliary::Sms)
 
       register_advanced_options(
@@ -42,10 +43,11 @@ def initialize(info={})
     #   sms.send_text_to_phones(numbers, 'Hello from Gmail')
     #
     # @param phone_numbers [<String>Array] An array of numbers of try (of the same carrier)
+    # @param subject [String] The text subject
     # @param message [String] The text to send.
     #
     # @return [void]
-    def send_text(phone_numbers, message)
+    def send_text(phone_numbers, subject, message)
       smtp = Rex::Proto::Sms::Model::Smtp.new(
         address: datastore['SMTPADDRESS'],
         port: datastore['SMTPPORT'],
@@ -57,7 +59,7 @@ def send_text(phone_numbers, message)
 
       carrier = datastore['SMSCARRIER'].to_sym
       sms = Rex::Proto::Sms::Client.new(carrier: carrier, smtp_server: smtp)
-      sms.send_text_to_phones(phone_numbers, message)
+      sms.send_text_to_phones(phone_numbers, subject, message)
     end
 
   end

lib/rex/proto/sms/client.rb

@@ -32,10 +32,11 @@ def initialize(opts={})
         # Sends a text to multiple recipients.
         #
         # @param phone_numbers [<String>Array] An array of phone numbers.
+        # @param subject [String] Subject of the message
         # @param message [String] The text message to send.
         #
         # @return [void]
-        def send_text_to_phones(phone_numbers, message)
+        def send_text_to_phones(phone_numbers, subject, message)
           carrier     = Rex::Proto::Sms::Model::GATEWAYS[self.carrier]
           recipients  = phone_numbers.collect { |p| "#{p}@#{carrier}" }
           address     = self.smtp_server.address
@@ -52,7 +53,13 @@ def send_text_to_phones(phone_numbers, message)
             smtp.enable_starttls_auto
             smtp.start(helo_domain, username, password, login_type) do
               recipients.each do |r|
-                smtp.send_message(message, from, r)
+                sms_message = Rex::Proto::Sms::Model::Message.new(
+                  from: from,
+                  to: r,
+                  subject: subject,
+                  message: message
+                )
+                smtp.send_message(sms_message.to_s, from, r)
               end
             end
           rescue Net::SMTPAuthenticationError => e

lib/rex/proto/sms/model.rb

@@ -28,4 +28,5 @@ module Model
 
 require 'net/smtp'
 require 'rex/proto/sms/model/smtp'
+require 'rex/proto/sms/model/message'
 require 'rex/proto/sms/client'

lib/rex/proto/sms/model/message.rb

@@ -0,0 +1,65 @@
+# -*- coding: binary -*-
+
+module Rex
+  module Proto
+    module Sms
+      module Model
+        class Message
+
+          # @!attribute message
+          #   @return [String] The text message
+          attr_accessor :message
+
+
+          # @!attribute from
+          #   @return [String] The from field in the email
+          attr_accessor :from
+
+          # @!attribute to
+          #   @return [String] The to field in the email
+          attr_accessor :to
+
+          # @!attribute subject
+          #   @return [String] The subject of the email
+          attr_accessor :subject
+
+
+          # Initializes the SMTP object.
+          #
+          # @param [Hash] opts
+          # @option opts [String] :from
+          # @option opts [String] :to
+          # @option opts [String] :message
+          #
+          # @return [Rex::Proto::Sms::Model::Message]
+          def initialize(opts={})
+            self.from = opts[:from]
+            self.to = opts[:to]
+            self.message = opts[:message]
+            self.subject = opts[:subject]
+          end
+
+
+          # Returns the raw SMS message
+          #
+          # @return [String]
+          def to_s
+            body = Rex::MIME::Message.new
+            body.add_part(self.message, 'text/plain; charset=UTF-8', nil)
+
+            sms = "MIME-Version: 1.0\n"
+            sms << "From: #{self.from}\n"
+            sms << "To: #{self.to}\n"
+            sms << "Subject: #{self.subject}\n"
+            sms << "Content-Type: multipart/alternative; boundary=#{body.bound}\n"
+            sms << "\n"
+            sms << body.to_s
+
+            sms
+          end
+
+        end
+      end
+    end
+  end
+end

modules/auxiliary/client/sms/send_text.rb

@@ -28,7 +28,7 @@ def run
     phone_numbers = datastore['CELLNUMBERS'].split
     print_status("Sending text (#{datastore['SMSMESSAGE'].length} bytes) to #{phone_numbers.length} number(s)...")
     begin
-      res = send_text(phone_numbers, datastore['SMSMESSAGE'])
+      res = send_text(phone_numbers, datastore['SMSSUBJECT'], datastore['SMSMESSAGE'])
       print_status("Done.")
     rescue Rex::Proto::Sms::Exception => e
       print_error(e.message)