Example Programs
================

hello_world.cpp	- a very simple example of using libhttpserver to
		  create a Rest server capable of receiving and processing
		  HTTP requests.  The server will be listening on port
		  8080.


service.cpp	- an example using more of the libhttpserver API.
		  This creates a Rest server capable of running with
		  HTTP or HTTPS (provided that libhttpserver and
		  libmicrohttpd have been compiled with SSL support.

		  The server can be configured via command line
		  arguments:

		  -p <port>  - port number to listen on (default 8080)
		  -s         - enable HTTPS
		  -k         - server key filename (default "key.pem")
		  -c         - server certificate filename (default "cert.pem")

Creating Certificates
=====================
Self-signed certificates can be created using OpenSSL using the
following steps:

	  $ openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
	  $ openssl rsa -passin pass:x -in server.pass.key -out server.key
	  $ openssl req -new -key server.key -out server.csr
	  $ openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt

On the last step when prompted for a challenge password it can be left
empty.

Thanks to https://devcenter.heroku.com/articles/ssl-certificate-self
for these instructions.

Keystore configuration
======================
If using a local client such as RestClient
(https://github.com/wiztools/rest-client) for testing the Rest server
then a keystore needs to be established.  These commands should be
bundled with your Java installation.

$ keytool -noprompt -import -keystore /path/to/restclient.store -alias
restclient -file /path/to/server.crt

The keys in the store can be listed as follows:

$ keytool -list -v -keystore /path/to/restclient.store

The client can then be configured to use this keystore.  Thanks to
http://rubensgomes.blogspot.com/2012/01/how-to-set-up-restclient-for-ssl.html
for instructions on configuring RestClient.