Module: Sisimai::Rhost::Cox

Defined in:
lib/sisimai/rhost/cox.rb

Overview

Sisimai::Rhost detects the bounce reason from the content of Sisimai::Fact object as an argument of find() method when the value of “destination” of the object is “charter.net”. This class is called only Sisimai::Fact class.

Constant Summary collapse

ErrorCodes = 
{
  # CXBL
  # - The sending IP address has been blocked by Cox due to exhibiting spam-like behavior.
  # - Send an email request to Cox to ask for a sending IP address be unblocked.
  #   Note: Cox has sole discretion whether to unblock the sending IP address.
  'CXBL' => 'blocked',

  # CXDNS
  # - There was an issue with the connecting IP address Domain Name System (DNS).
  # - The Reverse DNS (rDNS) lookup for your IP address is failing. 
  #   - Confirm the IP address that sends your email.
  #   - Check the rDNS of that IP address. If it passes, then wait 24 hours and try resending
  #     your email.
  'CXDNS' => 'requireptr',

  # CXSNDR
  # - There was a problem with the sender's domain.
  # - Your email failed authentication checks against your sending domain's SPF, DomainKeys,
  #   or DKIM policy.
  'CXSNDR' => 'authfailure',

  # CXSMTP
  # - There was a violation of SMTP protocol.
  # - Your email wasn't delivered because Cox was unable to verify that it came from a
  #   legitimate email sender.
  'CXSMTP' => 'rejected',

  # CXCNCT
  # - There was a connection issue from the IP address.
  # - There is a limit to the number of concurrent SMTP connections per IP address to
  #   protect the systems against attack. Ensure that the sending email server is not
  #   opening more than 10 concurrent connections to avoid reaching this limit.
  'CXCNCT' => 'ratelimited',

  # CXMXRT
  #   - The sender has sent email to too many recipients and needs to wait before sending
  #     more email.
  #   - The email sender has exceeded the maximum number of sent email allowed.
  'CXMXRT' => 'ratelimited', 

  # CDRBL
  # - The sending IP address has been temporarily blocked by Cox due to exhibiting spam-like
  #   behavior.
  # - The block duration varies depending on reputation and other factors, but will not exceed
  #   24 hours. Inspect email traffic for potential spam, and retry email delivery.
  'CDRBL' => 'blocked',

  'CXTHRT'    => 'securityerror', # Email sending limited due to suspicious account activity.
  'CXMJ'      => 'securityerror', # Email sending blocked due to suspicious account activity on primary Cox account.
  'IPBL0001'  => 'blocked',       # The sending IP address is listed in the Spamhaus Zen DNSBL.
  'IPBL0010'  => 'blocked',       # The sending IP is listed in the Return Path DNSBL.
  'IPBL0100'  => 'blocked',       # The sending IP is listed in the Invaluement ivmSIP DNSBL.
  'IPBL0011'  => 'blocked',       # The sending IP is in the Spamhaus Zen and Return Path DNSBLs.
  'IPBL0101'  => 'blocked',       # The sending IP is in the Spamhaus Zen and Invaluement ivmSIP DNSBLs.
  'IPBL0110'  => 'blocked',       # The sending IP is in the Return Path and Invaluement ivmSIP DNSBLs.
  'IPBL0111'  => 'blocked',       # The sending IP is in the Spamhaus Zen, Return Path and Invaluement ivmSIP DNSBLs.
  'IPBL1000'  => 'blocked',       # The sending IP address is listed on a CSI blacklist.
  'IPBL1001'  => 'blocked',       # The sending IP is listed in the Cloudmark CSI and Spamhaus Zen DNSBLs.
  'IPBL1010'  => 'blocked',       # The sending IP is listed in the Cloudmark CSI and Return Path DNSBLs.
  'IPBL1011'  => 'blocked',       # The sending IP is in the Cloudmark CSI, Spamhaus Zen and Return Path DNSBLs.
  'IPBL1100'  => 'blocked',       # The sending IP is listed in the Cloudmark CSI and Invaluement ivmSIP DNSBLs.
  'IPBL1101'  => 'blocked',       # The sending IP is in the Cloudmark CSI, Spamhaus Zen and Invaluement IVMsip DNSBLs.
  'IPBL1110'  => 'blocked',       # The sending IP is in the Cloudmark CSI, Return Path and Invaluement ivmSIP DNSBLs.
  'IPBL1111'  => 'blocked',       # The sending IP is in the Cloudmark CSI, Spamhaus Zen, Return Path and Invaluement ivmSIP DNSBLs.
  'IPBL00001' => 'blocked',       # The sending IP address is listed on a Spamhaus blacklist.

  'URLBL011'  => 'spamdetected',  # A URL within the body of the message was found on blocklists SURBL and Spamhaus DBL.
  'URLBL101'  => 'spamdetected',  # A URL within the body of the message was found on blocklists SURBL and ivmURI.
  'URLBL110'  => 'spamdetected',  # A URL within the body of the message was found on blocklists Spamhaus DBL and ivmURI.
  'URLBL1001' => 'spamdetected',  # The URL is listed on a Spamhaus blacklist.
}.freeze
MessagesOf =

The URL is listed on a Spamhaus blacklist.

{
  'blocked' => [
    # - An email client has repeatedly sent bad commands or invalid passwords resulting in
    #   a three-hour block of the client's IP address.
    # - The sending IP address has exceeded the threshold of invalid recipients and has
    #   been blocked.
    # - Cox enforces various rate limits to protect our platform. The sending IP address
    #   has exceeded one of these rate limits and has been temporarily blocked.
    'cox too many bad commands from',
    'too many invalid recipients',
  ],
  'contenterror' => [
    # - The message has been rejected because it contains an attachment with one of the
    #   following prohibited file types, which commonly contain viruses: .shb, .shs, .vbe,
    #   .vbs, .wsc, .wsf, .wsh, .pif, .msc, .msi, .msp, .reg, .sct, .bat, .chm, .isp, .cpl,
    #   .js, .jse, .scr, .exe.
    'attachment extension is forbidden',
  ],
  'policyviolation' => [
    # - The sending server has attempted to communicate too soon within the SMTP transaction
    'esmtp no data before greeting',
  ],
  'ratelimited' => [
    # - The sending IP address has exceeded the five maximum concurrent connection limit.
    # - The SMTP connection has exceeded the 100 email message threshold and was disconnected.
    # - The sending IP address has exceeded one of these rate limits and has been temporarily
    #   blocked.
    'too many sessions from',
    'requested action aborted: try again later',
    'message threshold exceeded',
  ],
  'rejected' => [
    # Cox requires that all sender domains resolve to a valid MX or A-record within DNS.
    'sender rejected',
  ],
  'requireptr' => [
    # - The reverse DNS check of the sending server IP address has failed.
    # - Cox requires that all connecting email servers contain valid reverse DNS PTR records.
    'dns check failure - try again later',
    'rejected - no rdns',
  ],
  'systemerror' => [
    # - Our systems are experiencing an issue which is causing a temporary inability to
    #   accept new email.
    'esmtp server temporarily not available',
  ],
  'userunknown' => [
    # - The intended recipient is not a valid Cox Email account.
    'recipient rejected',
  ],
}.freeze

Class Method Summary collapse

Class Method Details

.find(argvs) ⇒ String, Nil

Detect bounce reason from cox.com/

Parameters:

Returns:

  • (String, Nil) —

    The bounce reason at Cox

See Also:

Since:

  • v4.25.8



138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
 
# File 'lib/sisimai/rhost/cox.rb', line 138

def find(argvs)
  return "" if argvs["diagnosticcode"].empty?
  issuedcode = argvs['diagnosticcode']
  codenumber = 0

  if cv = issuedcode.match(/AUP#([0-9A-Z]+)/)
    # Capture the numeric part of the error code
    codenumber = cv[1]
  end
  reasontext = ErrorCodes[codenumber] || ''

  issuedcode = argvs['diagnosticcode'].downcase
  if reasontext.empty?
    # The error code was not found in ErrorCodes
    MessagesOf.each_key do |e|
      # Try to find with each error message defined in MessagesOf
      next if MessagesOf[e].none? { |a| issuedcode.include?(a) }
      reasontext = e
      break
    end
  end

  return reasontext
end