This presentation is Part 32 of the EWD 3 Training Course. It explains how to configure QEWD to work securely over SSL / HTTPS

1. Copyright © 2016 M/Gateway Developments Ltd
EWD 3 Training Course
Part 32
Configuring QEWD to use
SSL/HTTPS
Rob Tweed
Director, M/Gateway Developments Ltd
Twitter: @rtweed

2. Copyright © 2016 M/Gateway Developments Ltd
QEWD Uses Express
• The outward-facing HTTP(S) interface of QEWD
is provided by Express
• By default, QEWD starts up Express in non-
secure HTTP mode
• Although you could manually configure Express
to use SSL/HTTPS, QEWD automates the
process:
– Simply a configuration property in your QEWD startup
file

3. Copyright © 2016 M/Gateway Developments Ltd
Step 1: Get an SSL Certificate
• For testing, you can create a self-signed
one
• For production, purchase a commercial
one
• Your SSL certificate consists of 2 files:
– The certificate file
– The key file

4. Copyright © 2016 M/Gateway Developments Ltd
Step 2: Save the SSL Certificate Files
• Save the 2 files somewhere that is
accessible from your QEWD working
directory, eg:
– ~/qewd/ssl/ssl.key
– ~/qewd/ssl/ssl.crt

5. Copyright © 2016 M/Gateway Developments Ltd
Edit your QEWD Startup File
var config = {
managementPassword: 'keepThisSecret!',
serverName: 'My QEWD Server',
port: 8080,
poolSize: 2,
database: {
type: 'cache',
params: {
path: 'c:InterSystemsCache2015-2mgr’
},
ssl: {
keyFilePath: 'ssl/ssl.key',
certFilePath: 'ssl/ssl.crt'
}
}};
var qewd = require('qewd').master;
qewd.start(config);
Use a relative or
absolute path, as
required

6. Copyright © 2016 M/Gateway Developments Ltd
Step 4: Restart QEWD
• Provided your SSL certificate is valid,
QEWD will start up Express in SSL mode
• You must now access your QEWD
applications using HTTPS URLs
• eg:
https://192.168.1.185:8080/qewd-monitor/index.html