mailshield 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b14ffd727fa0a54fbce427772f17317f28743bdcd87ec2f204bf89fc25530f3e
+  data.tar.gz: 6e593d1bac55e212d43d875692a2ae9d6ae10a451409e779f188531849bdac78
+SHA512:
+  metadata.gz: 7bff616725f5ee9c1ea1d8cf49777ad6a0e83915bf1e48639e771785b84df7e0cd3db9f55aa7093477cee93fdaf93c241c3b475d3c159f1dd31cfb95afbf7ce4
+  data.tar.gz: acd38d78a78e94edf2df0e8f17b5debe32aca7ce17d2657df69323ff9909fa4c72f2f9d3023c3a937f535a12242525fc9ebf54209159fcacf5790b9ccb5e3fc7

data/lib/mailshield/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Mailshield
+  VERSION = "0.1.0"
+end

data/lib/mailshield.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative "mailshield/version"
+require 'resolv'
+
+module MailShield
+  class DomainChecker
+    TEMP_DOMAINS = %w[mailinator.com tempmail.com guerrillamail.com].freeze # If any one want to contribute, please add the known more domains here.
+
+    def self.temporary_email?(email)
+      domain = extract_domain(email)
+      return true if known_temp_domain?(domain)
+
+      mx_records = fetch_mx_records(domain)
+      return true if suspicious_mx_records?(mx_records)
+
+      return true unless spf_record?(domain)
+      return true unless dmarc_record?(domain)
+
+      false
+    end
+
+    def self.extract_domain(email)
+      email.split('@').last.downcase
+    end
+
+    def self.known_temp_domain?(domain)
+      TEMP_DOMAINS.include?(domain)
+    end
+
+    def self.fetch_mx_records(domain)
+      Resolv::DNS.open do |dns|
+        mx_records = dns.getresources(domain, Resolv::DNS::Resource::IN::MX)
+        mx_records.map(&:exchange).map(&:to_s)
+      end
+    rescue Resolv::ResolvError
+      []
+    end
+
+    def self.suspicious_mx_records?(mx_records)
+      suspicious_patterns = [/mailinator/, /tempmail/, /guerrillamail/]
+      mx_records.any? { |mx| suspicious_patterns.any? { |pattern| mx.match?(pattern) } }
+    end
+
+    def self.spf_record?(domain)
+      spf_records = fetch_txt_records(domain)
+      spf_records.any? { |record| record.include?('v=spf1') }
+    end
+
+    def self.dmarc_record?(domain)
+      dmarc_records = fetch_txt_records("_dmarc.#{domain}")
+      dmarc_records.any? { |record| record.include?('v=DMARC1') }
+    end
+
+    def self.fetch_txt_records(domain)
+      Resolv::DNS.open do |dns|
+        records = dns.getresources(domain, Resolv::DNS::Resource::IN::TXT)
+        records.map(&:data)
+      end
+    rescue Resolv::ResolvError
+      []
+    end
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: mailshield
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- jana
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2024-08-25 00:00:00.000000000 Z
+dependencies: []
+description: MailShield helps secure your application by identifying temporary or
+  disposable email domains.
+email:
+- shanmugamjanarthan24@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mailshield.rb
+- lib/mailshield/version.rb
+homepage: https://github.com/janarthanan-shanmugam/mailshield
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/janarthanan-shanmugam/mailshield
+  source_code_uri: https://github.com/janarthanan-shanmugam/mailshield
+  changelog_uri: https://github.com/janarthanan-shanmugam/mailshield
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key: 
+specification_version: 4
+summary: A gem to detect temporary or disposable email domains.
+test_files: []