Since: Version 2023.11.28-b5252a41
The functionality described in this section requires version 2023.11.28-b5252a41 of KumoMTA, or a more recent version.
This method will verify each DKIM signature that is present at the top level of the message, up to a limit of 10 signatures. The limit is in place to limit the scope of a DoS attack being carried out through maliciously constructed messages.
For each signature, an authenticationresult object will be constructed and an array of those results will be returned to the caller.
Example: obtaining DKIM authentication results
kumo.on('smtp_server_message_received', function(msg) -- Verify the dkim signature and return the results. -- Note that this example isn't making any policy decisions; -- it is only annotating the message with the results and -- allowing it to be relayed local verify = msg:dkim_verify() print('dkim', kumo.json_encode_pretty(verify)) -- Add the results to the message msg:add_authentication_results(msg:get_meta 'hostname', verify) end)
might print something like this to the diagnostic log:
and produce an