SMTPValve

Valve to send a mail using a SMTP server .

Note: This valve is commonly used when sending notifications to users and administrators. NOT for sending one-time passwords.

Properties

Name Description Default value Mandatory Supports property expansion
generated_otp_name Item property containing the generated otp. generated_otp No No
mail_param_name Property containing the recipient mail address. mail No Yes
recipients Static comma separated list of recipients. No No
userid_param_name Property containing the username. User-Name No Yes
mail_template The file path to the mail message template. resources/otp_mail_template.mustache No No
smtp_settings SMTP server Settings. Yes No
smtp_host SMTP host address. Overrides SMTP server Settings. No No
smtp_port SMTP port number. Overrides SMTP server Settings. 587 No No
smtp_from_address The from mail address. Overrides SMTP server Settings. No No
smtp_username Username for the smtp account. Overrides SMTP server Settings. No No
smtp_password Password for the smtp account. Overrides SMTP server Settings. No No
start_tls_enabled true No No
ssl_on_connect false No No
ssl_check_server_identity false No No
socket_connection_timeout 15 No No
removal_prefixes Prefixes to be removed as a comma separated list. smtp:,SMTP:,sip: No No
attachment_param_name Parameter containing the attachement data. Looks at request parameters first and item parameters secondly. No No
attachment_name_param_name Parameter containing the atachement name. Looks at request parameters first and item parameters secondly. No No
message_subject_key Locale key for the mail message subject. Found in lang/*/strings.xml valves.delivery.smtp.message.subject No No
message_body_key Locale key for the mail message body. Found in lang/*/strings.xml valves.delivery.smtp.message.body No No
message_subject Static, non localizeable message. Overrides message_subject_key parameter. No No
message_body Static, non localizeable message. Overrides message_body_key parameter. No No

Example Configuration

{
        "name": "SMTPValve",
        "config": { 
              "smtp_settings":"7dfddb47-c742-494e-a176-b67bde973f63",
              "userid_param_name":"{{request.username}}",
              "mail_param_name":"{{request.mail}}"
        }
}

Requirements

Item set must have at least one entry.