SendEmailWebApp

SendEmailWebApp is a web application with a formulary to send emails to a specified destinatary.
This page is designed to be added at other page and the people can send emails at specified email adress.

Pre-requisites

• Maven 3.0 or later.
• Java 1.7 or later.
• Tomcat 1.7 or later.

Compile

Type in a cmd or console:

mvn clean install

Usage

1. Configure webapp.
2. (Optional) add your own language pack.
3. (Optional) add banned ips.
4. Deploy the webapp in a tomcat server.

1) Configure Webapp.

Go to target/SendEmailWebApp/WEB-INF folder.
Edit configuration.properties and change the properties.
Example of configuration.properties:

mail.destinatary=TO_CHANGE
mail.host.url=TO_CHANGE
mail.host.port=TO_CHANGE
mail.host.user=TO_CHANGE
mail.host.password=TO_CHANGE
mail.ttls.enable=false
mail.message.header=%FULLNAME% sent you, from Web=TO_CHANGE and IP=%IP%, the next message: %MESSAGE%
server.mail.limit=5
server.mail.limit.interval.hours=24
server.mail.trys.limit=5
server.mail.trys.interval.hours=1

Properties description:

• mail.destinatary: Is the destinatary of email formulary.
• mail.host.url: Is the URL of smtp server.
• mail.host.port: Is the port of smtp server.
• mail.host.user: Is the user of smtp server.
• mail.host.password: Is the user of smtp server.
• mail.ttls.enable: If smtp server have TTLs then this parameter is "true". Values "false", "true".
• mail.message.header: Is the header added to message for more info to destinatary. This param have reserved words (Replaced by webapp data):
  -- %FULLNAME%: Fullname specified in formulary.
  -- %IP%: The client ip that send the email.
  -- %MESSAGE%: The specified message in formulary.
• server.mail.limit: Limit of messages sent by same ip in a interval.
• server.mail.limit.interval.hours: Time interval that clear count of emails sent.
• server.mail.trys.limit: Limit of captcha trys by same ip in a interval.
• server.mail.trys.interval.hours: Time interval that clear count of captcha trys.

2) (Optional) add your own language pack.

Go to target/SendEmailWebApp/WEB-INF/classes/resources/messages folder.
Copy ui.properties and rename it to ui_LANGUAGE-CODE_COUNTRY-CODE.properties
--Language-code is your language code, see the next list for search your code (ISO_639-1): https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
--Country-code is your country code, see the next list for search your code: https://es.wikipedia.org/wiki/ISO_3166-1
Edit your new file and translate it (Not translate the keys).
Example lines of languaje file:

key=value to translate
not.change=This is a example

3) (Optional) add banned ips.

Go to target/SendEmailWebApp/WEB-INF/bannedIPs.txt
Each line is a banned ip. If you want to add comments put "#" character and line start.
Example file:

#This is a comment.
#Each line is a banned IP.
#Ip hacker attacks:
1.12.123.123

4) Deploy the webapp in a tomcat server.

Copy the target/SendEmailWebApp folder to a tomcat webapps folder.
Or compress it on a war file and deploy it by tomcat manager.

Version

0.0.1