net-receiver 1.2.1 → 1.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c70623651d874318484c5abb5b914d30bd7d2c72
-  data.tar.gz: 123896fdb625e12835ae32bcfb809c98503a54c4
+  metadata.gz: 4d5eea2e6448830a5f0eab76eec380fd40da0f8a
+  data.tar.gz: 9b5373996ea3bc356c5d41f979cd35bdd49fa5ce
 SHA512:
-  metadata.gz: d9c70d0c461a3726ccc165506fa40e68defd385745cc5aae6f8def402e1511f245f9b135754d900fa90280788bacc0eacf089140eb970d69e18f2af00d4ef0f3
-  data.tar.gz: 4296f6d5f98ba5a161f0ad52178608441c07c65f6d07a6b04ac852cb785dee78f80a74fcd687025d88606b355a524d091a7dfc4510234e168ac0d5e29ea3deb7
+  metadata.gz: 71299d172ed45dd97cfcf98e13dc19bf48d7fe02dca670e382d1df0a3e53e7b4198f94713c2cefa30b27b7562a8385c56290583d37a848ab83ebb2b68a469582
+  data.tar.gz: bb0f889c65ec8c97ae6e00714efb642fdd51ea7a139440454f5199cc38588df22ad4c327f6e871946dcf445956b5d369f7e2391b0bcc7a4cba1b1aecf9d7363e

data/README.md

@@ -8,6 +8,8 @@ Currently, I'm using this as the base for an MTA written in Ruby. There's no int
 
 That being said, If you use this for anything, and want me to make special changes that don't interfere with my purpose, email me at mjwelchphd@gmail.com, and I'll work with you as best I can.
 
+The source code for this project is located at https://github.com/mjwelchphd/net-receiver
+
 # General
 
 This gem sits on top of my net-server gem, and receives standard emails. It has only a few checks that it makes on the incoming email, leaving the specialized checks up to you. You can change it's behavior by overriding base methods, and adding your own programming; don't worry, I'll show you how. Your Ruby overrides are the same as witing a configuration file for a standard MTA.
@@ -113,6 +115,7 @@ The method `psych_value` is used with MAIL FROM and RCPT TO commands to validate
     - characters ! # $ % & ' * + - / = ? ^ _ ` { | } ~
     - dots, which must not be first or last character, and must not appear two or more times consecutively
   4. If the option is selected, it does a Dig MX lookup, followed by a Dig A (IP) lookup if the MX was successful. This is helpful to determine if the sender's domain is legitimate.
+  5. `psych_value` also checks for an empty address ("<>") which means it's a bounced message.
 
 The main method is the `receive` method (which is called by net-server when a connection is requested). Receive uses the aforementioned table to read the commands and process them. It also allocates an 'item of mail' structure to put it's findings in.
 
@@ -179,23 +182,23 @@ Here is a sample structure for an authenticated email.
 {
   :local_port=>"2001",
   :local_hostname=>"mail.example.com",
-  :remote_port=>"38436",
-  :remote_hostname=>"cpe-107-185-187-182.socal.res.rr.com",
-  :remote_ip=>"::ffff:107.185.187.182",
-  :id=>"ODZM0W-PRPAYD-49",
-  :time=>"2016-09-24 02:38:56 +0000",
+  :remote_port=>"54278",
+  :remote_hostname=>"example.com",
+  :remote_ip=>"::ffff:107.105.187.182",
+  :id=>"OELGQA-A58QI3-AA",
+  :time=>"2016-10-05 21:51:46 +0000",
   :accepted=>true,
   :prohibited=>false,
   :encrypted=>true,
-  :authenticated=>"admin@example.com",
+  :authenticated=>false,
   :connect=>{
-    :value=>"::ffff:107.185.187.182",
+    :value=>"::ffff:107.105.187.182",
     :domain=>nil
   },
   :ehlo=>{
-    :value=>"mail.example.com",
-    :rip=>"23.253.107.107",
-    :fip=>"23.253.107.107",
+    :value=>"example.com",
+    :rip=>"93.184.216.34",
+    :fip=>"93.184.216.34",
     :domain=>"mail.example.com"
   },
   :mailfrom=>{
@@ -207,45 +210,48 @@ Here is a sample structure for an authenticated email.
     :domain=>"example.com",
     :bad_characters=>false,
     :wrong_dot_usage=>false,
-    :ip=>"23.253.107.107",
+    :ip=>"93.184.216.34",
     :mxs=>[
       "mail.example.com"
     ],
     :ips=>[
-      "23.253.107.107"
-    ]
+      "93.184.216.34"
+    ],
+    :spf=>:pass
   },
   :rcptto=>[
     {
       :accepted=>true,
-      :value=>"<coco@example.com>",
+      :value=>"<abuse@example.com>",
       :name=>"",
-      :url=>"coco@example.com",
-      :local_part=>"coco",
-      :domain=>"example.com"
+      :url=>"abuse@example.com",
+      :local_part=>"abuse",
+      :domain=>"example.com",
+      :bad_characters=>false,
+      :wrong_dot_usage=>false,
+      :ip=>"93.184.216.34",
+      :mxs=>[
+        "mail.example.com"
+      ],
+      :ips=>[
+        "93.184.216.34"
+      ]
     }
   ],
   :data=>{
     :accepted=>true,
     :value=>"",
+    :headers=>{
+      :date=>"Date: Wed, 05 Oct 2016 14:51:46 -0700",
+      :to=>"To: abuse@example.com",
+      :from=>"From: admin@example.com",
+      :subject=>"Subject: test Wed, 05 Oct 2016 14:51:46 -0700",
+      :x_mailer=>"X-Mailer: swaks v20130209.0 jetmore.org/john/code/swaks/"
+    },
     :text=>[
-      "Date: Fri, 23 Sep 2016 19:38:55 -0700",
-      "To: coco@example.com",
-      "From: admin@example.com",
-      "Subject: test Fri, 23 Sep 2016 19:38:55 -0700",
-      "X-Mailer: swaks v20130209.0 jetmore.org/john/code/swaks/",
-      "",
       "This is a test mailing",
-      "",
-      "."
-    ],
-    :headers=>{
-      :date=>"Fri, 23 Sep 2016 19:38:55 -0700",
-      :to=>"coco@example.com",
-      :from=>"admin@example.com",
-      :subject=>"test Fri, 23 Sep 2016 19:38:55 -0700",
-      :x_mailer=>"swaks v20130209.0 jetmore.org/john/code/swaks/"
-    }
+      ""
+    ]
   }
 }
 ```
@@ -299,6 +305,7 @@ Here is a sample structure for an authenticated email.
 | :ip | This is the IP from looking up the domain. |
 | :mxs | This is a list of one or more mail servers for this domain. |
 | :ips | This is a list of IPs obtained by looking up the MXs above. |
+| :spf | This is the SPF check on the sender. It will normally be :pass or :fail. To learn more about SPF, go to `http://www.openspf.org/`. |
 
 ### RCPT TO Values (a list)
 
@@ -327,14 +334,13 @@ Here's an example:
 
 |Key |Value |
 |:--- |:--- |
-| :date | "Fri, 23 Sep 2016 19:38:55 -0700", |
-| :to | "coco@example.com", |
-| :from | "admin@example.com", |
-| :subject | "test Fri, 23 Sep 2016 19:38:55 -0700", |
-| :x_mailer | "swaks v20130209.0 jetmore.org/john/code/swaks/" |
-
+| :date | "Date: Wed, 05 Oct 2016 14:51:46 -0700" |
+| :to | "To: abuse@example.com" |
+| :from | "From: admin@example.com" |
+| :subject | "Subject: test Wed, 05 Oct 2016 14:51:46 -0700" |
+| :x_mailer | "X-Mailer: swaks v20130209.0 jetmore.org/john/code/swaks/" |
 
-The headers are put into a hash like this so that you may easily locate them, or test to see if they exist or not. Modifying this Hash *does not* modify the actual email.
+The headers are put into a hash like this so that you may easily locate them, or test to see if they exist or not.
 
 
 FIN

data/lib/net/version.rb

@@ -1,4 +1,4 @@
 module Net
-  BUILD_VERSION = "1.2.1"
+  BUILD_VERSION = "1.2.2"
   BUILD_DATE = "2016-10-05"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: net-receiver
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.2
 platform: ruby
 authors:
 - Michael J. Welch, Ph.D.