HEX
Server: Apache/2
System: Linux nexus-01 4.18.0-553.120.1.el8_10.x86_64 #1 SMP Mon Apr 20 18:04:27 EDT 2026 x86_64
User: aglcoke (1118)
PHP: 8.2.31
Disabled: mail,exec,system,passthru,shell_exec,proc_close,proc_open,dl,popen,show_source,posix_kill,posix_mkfifo,posix_getpwuid,posix_setpgid,posix_setsid,posix_setuid,posix_setgid,posix_seteuid,posix_setegid,posix_uname
Upload Files
File: //usr/share/rspamd/lualib/lua_scanners/dcc.lua
--[[
Copyright (c) 2022, Vsevolod Stakhov <vsevolod@rspamd.com>
Copyright (c) 2018, Carsten Rosenberg <c.rosenberg@heinlein-support.de>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
]]--

--[[[
-- @module dcc
-- This module contains dcc access functions
--]]

local lua_util = require "lua_util"
local tcp = require "rspamd_tcp"
local upstream_list = require "rspamd_upstream_list"
local rspamd_logger = require "rspamd_logger"
local common = require "lua_scanners/common"
local fun = require "fun"

local N = 'dcc'

local function dcc_config(opts)

  local dcc_conf = {
    name = N,
    default_port = 10045,
    timeout = 5.0,
    log_clean = false,
    retransmits = 2,
    cache_expire = 7200, -- expire redis in 2h
    message = '${SCANNER}: bulk message found: "${VIRUS}"',
    detection_category = "hash",
    default_score = 1,
    client = '0.0.0.0',
    symbol_fail = 'DCC_FAIL',
    symbol = 'DCC_REJECT',
    symbol_bulk = 'DCC_BULK',
    body_max = 999999,
    fuz1_max = 999999,
    fuz2_max = 999999,
  }

  dcc_conf = lua_util.override_defaults(dcc_conf, opts)

  if not dcc_conf.prefix then
    dcc_conf.prefix = 'rs_' .. dcc_conf.name .. '_'
  end

  if not dcc_conf.log_prefix then
    dcc_conf.log_prefix = dcc_conf.name
  end

  if not dcc_conf.servers and dcc_conf.socket then
    dcc_conf.servers = dcc_conf.socket
  end

  if not dcc_conf.servers then
    rspamd_logger.errx(rspamd_config, 'no servers defined')

    return nil
  end

  dcc_conf.upstreams = upstream_list.create(rspamd_config,
      dcc_conf.servers,
      dcc_conf.default_port)

  if dcc_conf.upstreams then
    lua_util.add_debug_alias('external_services', dcc_conf.name)
    return dcc_conf
  end

  rspamd_logger.errx(rspamd_config, 'cannot parse servers %s',
      dcc_conf['servers'])
  return nil
end

local function dcc_check(task, content, digest, rule)
  local upstream = common.get_upstream_or_fail(task, rule, nil)
  if not upstream then
    return
  end
  local addr = upstream:get_addr()
  local retransmits = rule.retransmits
  local client = rule.client

  local client_ip = task:get_from_ip()
  if client_ip and client_ip:is_valid() then
    client = client_ip:to_string()
  end
  local client_host = task:get_hostname()
  if client_host then
    client = client .. "\r" .. client_host
  end

  -- HELO
  local helo = task:get_helo() or ''

  -- Envelope From
  local ef = task:get_from()
  local envfrom = 'test@example.com'
  if ef and ef[1] then
    envfrom = ef[1]['addr']
  end

  -- Envelope To
  local envrcpt = 'test@example.com'
  local rcpts = task:get_recipients();
  if rcpts then
    local dcc_recipients = table.concat(fun.totable(fun.map(function(rcpt)
      return rcpt['addr']
    end,
        rcpts)), '\n')
    if dcc_recipients then
      envrcpt = dcc_recipients
    end
  end

  -- Build the DCC query
  -- https://www.dcc-servers.net/dcc/dcc-tree/dccifd.html#Protocol
  local request_data = {
    "header grey-off\n",
    client .. "\n",
    helo .. "\n",
    envfrom .. "\n",
    envrcpt .. "\n",
    "\n",
    content
  }

  local function dcc_callback(err, data, conn)

    local function dcc_requery()
      -- retry with another upstream until retransmits exceeds
      if retransmits > 0 then

        retransmits = retransmits - 1

        -- Select a different upstream!
        upstream = rule.upstreams:get_upstream_round_robin()
        if not upstream then
          common.yield_result(task, rule,
              'no upstream available for retry', 0.0, 'fail')
          return
        end
        addr = upstream:get_addr()

        lua_util.debugm(rule.name, task, '%s: error: %s; retry IP: %s; retries left: %s',
            rule.log_prefix, err, addr, retransmits)

        tcp.request({
          task = task,
          host = addr:to_string(),
          port = addr:get_port(),
          timeout = rule.timeout or 2.0,
          upstream = upstream,
          shutdown = true,
          data = request_data,
          callback = dcc_callback,
        })
      else
        rspamd_logger.errx(task, '%s: failed to scan, maximum retransmits ' ..
            'exceed', rule.log_prefix)
        common.yield_result(task, rule, 'failed to scan and retransmits exceed', 0.0, 'fail')
      end
    end

    if err then

      dcc_requery()

    else
      -- Parse the response
      local _, _, result, disposition, header = tostring(data):find("(.-)\n(.-)\n(.-)$")
      lua_util.debugm(rule.name, task, 'DCC result=%1 disposition=%2 header="%3"',
          result, disposition, header)

      if header then
        -- Unfold header
        header = header:gsub('\r?\n%s*', ' ')
        local _, _, info = header:find("; (.-)$")
        if (result == 'R') then
          -- Reject
          common.yield_result(task, rule, info, rule.default_score)
        elseif (result == 'T') then
          -- Temporary failure
          rspamd_logger.warnx(task, 'DCC returned a temporary failure result: %s', result)
          dcc_requery()
        elseif result == 'A' or result == 'S' then
          -- Accept for all or some recipients, return a dynamic score
          local opts = {}
          local score = 0.0
          local rep_orig = nil
          if info then
            info = info:lower()
            local rep = info:match('rep=(%d+)')
            rep_orig = rep

            -- Adjust reputation if available
            if rep then
              rep = (tonumber(rep) or 100.0) / 100.0

              if rep > 1.0 then
                rep = 1.0
              elseif rep < 0.0 then
                rep = 0.0
              end
            else
              rep = 1.0
            end

            local function check_threshold(what, num, lim)
              local rnum
              if num == 'many' then
                rnum = lim
              else
                rnum = tonumber(num) or lim
              end

              if rnum and rnum >= lim then
                opts[#opts + 1] = string.format('%s=%s', what, num)
                score = score + (rule.default_score * rep / 3.0)
              end
            end

            local body = info:match('body=([^=%s]+)')

            if body then
              check_threshold('body', body, rule.body_max)
            end

            local fuz1 = info:match('fuz1=([^=%s]+)')

            if fuz1 then
              check_threshold('fuz1', fuz1, rule.fuz1_max)
            end

            local fuz2 = info:match('fuz2=([^=%s]+)')

            if fuz2 then
              check_threshold('fuz2', fuz2, rule.fuz2_max)
            end
          end

          if #opts > 0 and score > 0 then
            if rep_orig then
              opts[#opts + 1] = string.format('%s=%s', "rep", rep_orig .. "%")
            end
            task:insert_result(rule.symbol_bulk,
                score,
                opts)
          else
            if rule.log_clean then
              rspamd_logger.infox(task, '%s: clean, returned result A - info: %s',
                  rule.log_prefix, info)
            else
              lua_util.debugm(rule.name, task, '%s: returned result A - info: %s',
                  rule.log_prefix, info)
            end
          end
        else
          -- Unexpected result
          rspamd_logger.warnx(task, '%1: Unexpected result. Result: %2, info: %3', rule.log_prefix, result, info);
          common.yield_result(task, rule, 'error: ' .. result, 0.0, 'fail')
        end
      end
    end
  end

  tcp.request({
    task = task,
    host = addr:to_string(),
    port = addr:get_port(),
    timeout = rule.timeout or 2.0,
    shutdown = true,
    upstream = upstream,
    data = request_data,
    callback = dcc_callback,
  })
end

return {
  type = { 'dcc', 'bulk', 'hash', 'scanner' },
  description = 'dcc bulk scanner',
  configure = dcc_config,
  check = dcc_check,
  name = N
}