javydreamercsw/origamismtp

A TLS Enabled Fake SMTP Server for Development

Origami SMTP

Origami SMTP is a fake SMTP server with SSL (STARTTLS) support. The reason it was developed was so that developers could test their applications that require a secure SMTP server without having to change more than just a couple settings.

This project is the runnable jar file but you can download a easier to use application (also know as Origami SMTP) from the official website

Requirements

This server requires:

• Java 1.8 or higher
• Java JCE

Starting the Server

To start the server run the following from the terminal or command line.

java -jar origami.jar 2525

You may replace 2525 with the port you would like to use.

Working with STARTLS

Since this service requires some custom configuration, you will have to load the Origami CA Certificate into your Trusted Root Store. If you are unsure how to do this on Windows follow this guide. You will have to do this on other operating systems too but at this time we have no guides provided.

Next make sure your SMTP settings set the host to localhost and not the IP address 127.0.0.1 or the validation may fail, notably in C#.

You may have to download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8. This extension may be restricted in some countries and may have export controls enforced by the United State Government. Since we do not have the funds for legal council this file must be downloaded from the link provided. Follow the instructions in README.txt to install.

Debugging

Using Swaks

To use Swaks to debug you will need Perl installed. To do this on Windows we suggest the use of ActivePerl as we could not get it to work with Strawberry Perl. After that is installed you can use the following command to help with debugging.

swaks.pl -t [email protected] -f [email protected] -s localhost -p 2525 -tls --tls-verify --tls-ca-path /path/to/origami/ca.crt

Using OpenSSL

To use OpenSSL s_client to try and debug use the following command

openssl s_client -connect localhost:2525 -starttls smtp

Previously 127.0.0.1 was used in place of localhost so it may validate correctly now but has not been tested.

Helpful Tips

• When working in Eclipse it is recommended to set the VM arguments to -Djavax.net.debug=ssl,handshake
• You can use openssl to help you debug
• You can use Swaks to help debug

Contributing

Contributing is simple just fork this on GitHub and then send a pull request.

License

MIT License