User Tools

Site Tools


reference:lua_smtp_mx_control

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
reference:lua_smtp_mx_control [2016/02/16 15:40] paulreference:lua_smtp_mx_control [2023/07/28 16:41] (current) paul
Line 1: Line 1:
 ======Lua SMTP MX Control====== ======Lua SMTP MX Control======
  
-Every time VPOP3 is going to send messages using direct MX sending, it runs a script called **mxout.lua** in the VPOP3 directory.+Every time VPOP3 is going to send messages using direct MX sending, it runs a script called **mxout.lua** which can be created/edited in Settings -> Scripts (or in the VPOP3 directory in VPOP3 v6.6 or earlier).
  
 =====Messages to be sent===== =====Messages to be sent=====
Line 30: Line 30:
 =====Remote Server Settings===== =====Remote Server Settings=====
 If you need to tweak how VPOP3 connects to remote servers you can write a **ServerDetails** function. VPOP3 calls this function before sending each message. If you need to tweak how VPOP3 connects to remote servers you can write a **ServerDetails** function. VPOP3 calls this function before sending each message.
 +
 +(This function was [[https://bugtracker.pscs.co.uk/view.php?id=968|added in VPOP3 v6.5]])
  
 The function signature is: The function signature is:
 **ServerDetails(Parameters, HeaderLines, Actions)** **ServerDetails(Parameters, HeaderLines, Actions)**
 +
 +The Parameters object contains details of the message being sent:
 +  * authsender - the authenticated sender (if any) that sent the message to VPOP3
 +  * originator - the email address that sent the message to VPOP3
 +  * server - the mail server being connected to
 +  * domain - the domain the message is being sent to
 +  * length - the size of the message being sent
 +  * connnid - the VPOP3 Connection/Sender ID
 +  * connection - the VPOP3 Connection/Sender name
  
 The function returns an Actions object saying what to do with the message. If nothing else, the function should return the Actions parameter. The function returns an Actions object saying what to do with the message. If nothing else, the function should return the Actions parameter.
Line 53: Line 64:
   * checkCertThumbprint - string to check against the TLS certificate SHA-1 thumbprint. The connection will fail if the thumbprint doesn't match (case insensitive)   * checkCertThumbprint - string to check against the TLS certificate SHA-1 thumbprint. The connection will fail if the thumbprint doesn't match (case insensitive)
  
 +Example - don't use SSL when connecting to 'mail.broken.com'
 +
 +  function ServerDetails(params, headers, actions)
 +    if params["server"] == "mail.broken.com" then
 +      actions["tryTLS"] = 0
 +    end
 +    return actions
 +  end
 +  
  
 +=====ParseURL=====
 +(VPOP3 8.0 and later)
reference/lua_smtp_mx_control.1455637238.txt.gz · Last modified: 2018/11/14 10:44 (external edit)