Skip to content

kumo.spf.check_msg

kumo.spf.check_msg(MESSAGE)
Since: Dev Builds Only

The functionality described in this section requires a dev build of KumoMTA. You can obtain a dev build by following the instructions in the Installation section.

This function will check SPF records from DNS for the provided message. It will extract the appropriate domain and sender information from the metadata and message.

It will return an object containing the SPF disposition string and a result of type authenticationresult for use with msg:add_authentication_results().

Example: checking the SPF policy

kumo.on('smtp_server_message_received', function(msg, conn_meta)
  -- Check the SPF policy for the domain and return the results.
  local result = kumo.spf.check_msg(msg)
  print('spf', kumo.json_encode_pretty(result))
  if result.disposition ~= 'pass' then
    kumo.reject(420, 'go away')
  end
end)

might print something like this to the diagnostic log:

spf    [
  "disposition": "pass",
  {
    "result": "pass",
    "method": "spf",
    "reason": "matched 'all' directive",
    "method_version": null,
    "props": {
        "smtp.mailfrom": "sender@example.com"
    }
  }
]

See Also: