SSL Configuration

Back to Installation and Configuration

IFS Workflow Apache Configuration

VirtualHost in Apache with SSL

Use the following VirtualHost configuration. In the pmos.conf file, replace your_ip_address and your_processmaker_domain with the IP address or domain name used by your ProcessMaker server:

#Force HTTPS redirection
<VirtualHost *:80>
    ServerName your_ip_address
    Redirect / http://your_ip_address
</VirtualHost>
 
#processmaker virtual host
<VirtualHost *:443 >
    ServerName "your_IFSworkflow_domain"

 SSLEngine on
    SSLCertificateFile "/opt/httpd/conf/localhost.crt"
    SSLCertificateKeyFile "/opt/httpd/conf/keystore.key"
 
    DocumentRoot /opt/processmaker/workflow/public_html
    DirectoryIndex index.html index.php
 
    <Directory /opt/processmaker/workflow/public_html>
        Options Indexes FollowSymLinks MultiViews
        AddDefaultCharset UTF-8
        AllowOverride All
        Require all granted
        ExpiresActive On
 
        <IfModule mod_rewrite.c>
            RewriteEngine On
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^.*/(.*)$ app.php [QSA,L,NC]
        </IfModule>
 
        #Deflate filter is optional. It reduces download size, but adds slightly more CPU processing:
        AddOutputFilterByType DEFLATE text/html
 
    </Directory>
</VirtualHost>

The port 443 is for HTTPS exclusive use

Replace your_ip_address with the IP number or domain name of the server running IFS Workflow. If you only planning on running and accessing IFS Workflow on your local machine, then use the IP address "127.0.0.1". If using IFS Workflow on a machine whose IP address might change (such as a machine whose IP address is assigned with DHCP), then use *, which represents any IP address. To use a port other than port 80, then it is also necessary to specify the port number.

If your DNS or /etc/hosts has a defined domain for IFS Workflow, then use that domain for your_ifsworkflow_domain. Otherwise, use the same IP address for your_ifsworkflow_domain as was used for your_ip_address. For more information, see the Apache Virtual Hosts Documentation.

Example 1

IFSWorkflow is installed in the /opt/processmaker directory and is running on a server at the address 192.168.1.100:

#processmaker virtual host
<VirtualHost 192.168.1.100>
    ServerName "192.168.1.100"
    DocumentRoot /opt/processmaker/workflow/public_html
    ...

Example 2

IFS Workflow is installed in the /home/fred directory on your local machine at port 8080 with a dynamic IP assigned by DHCP:

Listen 8080
#processmaker virtual host
<VirtualHost *:8080 >
    #don't include ServerName
    DocumentRoot /home/fred/processmaker/workflow/public_html
    ...

Example 3

IFS Workflow is installed in the /opt/pm3.2.3 directory at the IP address 123.45.67.89 and the domains www.example.com and any variant of X.example.com:

#processmaker virtual host
<VirtualHost 123.45.67.89 >
    ServerName "www.example.com"
    ServerAlias "*.example.com"
    DocumentRoot /opt/pm3.2.3/processmaker/workflow/public_html
    ...