In this article you will learn
- how to access the Workflow encrypted via
https
and - which requirements are needed.
1. Encrypted Access
Encrypted communication or addressing the Workflow via https
is possible by setting up a Reverse Proxy Server that forwards requests from "clients" (web browsers). This server can be installed and configured on a workstation using the PPDTC Tool.
1.1. Requirements
Note: Workflow version > 1.16.2 must be installed for https
access to the Workflow!
The configuration can be carried out if the Nginx Reverse Proxy is installed via the PPD Tools Collection (PPDTC). Find out how to do this in section 1.2.
A valid SSL certificate must also be available.
1.2. Configuration
Proceed as follows to configure the Reverse Proxy and make the Workflow accessible via https
:
- Navigate to ppdtc via the command line or press "
Windows
+R
" to access PPDTC. -
ppdtc is located in
C:\program files\ppd\install
. - Open the Ngnix Configuration dialog via Applications > Local Workflow > Ngnix > Configuration.
- In the text field Server Name [1] enter the server name with which the Workflow should be accessible e.g.: "workflow.mycompany.com".
- In this case, workflow.mycompany.com has to point to the IP address of the Workflow (DNS configuration).
- With the Install [2] button Ngnix is installed and configured.
- The SSL certificate and the key of "mycompany.com" must be saved in "c:\Program Files\PPD\NGinx\conf\certificate\" after the installation. Note that in the Ngnix Configuration dialog the path
C:\Program Files\PPD\NGinx\conf\certificate\
is shown. - Exchange the files Certificate.txt and Key.txt in
C:\Program Files\PPD\NGinx\conf\certificate\
. - With Remove [3] the Ngnix can be removed again.
- After the installation, the computer has to be restarted.
Accessing the Workflow
After access has been set up via https
, navigate to the Workflow via e.g. the address workflow.mycompany.com without a port number!
Figure 1: The dialog Nginx Configuration to access the Workflow via https
Article update: Workflow version 1.17.0 - 03/2024