Readme.md

Contact Form Backend for Karmakurier

Microservice for Contact Form used at karmakurier website.

Local Development

You can start the solution locally by executing the following commands. First, make sure to set the environment variables needed to run the application.

export smtp_host=your.host
export smtp_port=465
export smtp_user=your.user
export smtp_password=your.pw
export target_mail=receiverOfContactMails
export session_secret=verysecretsessionkey
export allowedOrigin=http://localhost:3000 # this is the cors origin, typically the website of karmakurier frontend

Next, configure cors. To allow multiple domains to be configured, an cors.json files has to be created at the project root. It should look something like this:

{
    "allowed":["http://localhost:3000"]
}

When this is done, you can run the application like so:

npm install 
npm start

Usage

To use the contact form, the frontend page has to implement the following.

• import a svg-captcha at the contact-form. Use the /contactapi-captcha endpoint to get a generated svg and embed it in the form.
• the enpoint /contactapi-contact expects the following json payload:

{
    "name":"Username",
    "email":"Email address of the user sending the mail",
    "message":"The body of the contact message",
    "captcha":"solved captcha, to be checked by the backend"
}

• after submission, the server will check the provided captcha for validity. If the captcha is wrong, the frontend must receive a new image as the session will be destroyed!