Configuring Apache http

This chapter describes how you create the required certificates. You require certificates for:

  • Using the https connection

  • Configuring the Apache http as proxy for older SINUMERIK controls

  • Connecting to the MindSphere V3 Livesystem in older SINUMERIK controls

A minimum configuration that suffices for the connection is described below. Only the required modules are loaded. Only TLS 1.2 is permitted for the SSL connection. Only those ciphers that MindSphere requires for the function are enabled.

Creating a certificate for the SSL connection

  1. Create the directory for the certificate:
    mkdir /usr/local/apache2/ssl_cert

  2. Switch to the certificate directory:
    cd /usr/local/apache2/ssl_cert

  3. Create the certificate and the associated key file with the following command:

    Note: Run the following lines as a command:

    openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

    NOTE

    Validity of the certificate

    The certificate is valid for one year (365 days).

    To extend the validity, add the parameter "-days 365".

  4. Follow the instructions and enter the required information:
    Generating a 2048 bit RSA private key

    .............+++
    ..................+++
    writing new private key to 'key.pem'
    -----
    You are about to be asked to enter information that will be incorporated
    into your certificate request.
    What you are about to enter is what is called a Distinguished Name or a DN.
    There are quite a few fields but you can leave some blank
    For some fields there will be a default value,
    If you enter '.', the field will be left blank.
    -----
    Country Name (2 letter code) [AU]:DE
    State or Province Name (full name) [Some-State]:Bavaria
    Locality Name (e.g., city) []:Nuremberg
    Organization Name (e.g., company) [Internet Widgits Pty Ltd]:Siemens
    Organizational Unit Name (e.g., section) []:MindSphere
    Common Name (e.g. server FQDN or YOUR name) []:IoT2040
    Email Address []:

Editing Apache http configuration files

In the following configuration, the proxy is configured for connecting to the following systems.

The following options are available for editing the configuration files:

  • Via the connection with WinSCP

  • Via the connection with PuTTY or some other SSH client, and using the integrated Linux command line editor "nano" in the current image

  • In any other desired manner

The following files are edited:

  • /usr/local/apache2/conf/httpd.conf

  • /usr/local/apache2/conf/extra/httpd-ssl.conf

  • /usr/local/apache2/conf/extra/httpd-vhosts.conf

Editing httpd.conf

Enter the following lines:
Listen 8080
Listen 8081
Listen 8082
LoadModule socache_shmcb_module modules/mod_socache_shmcb.so

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule ssl_module modules/mod_ssl.so
#LoadModule status_module modules/mod_status.so
#LoadModule autoindex_module modules/mod_autoindex.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so
#LoadModule dir_module modules/mod_dir.so
#ServerAdmin you@example.com
ServerName localhost
Include conf/extra/httpd-vhosts.conf
Include conf/extra/httpd-ssl.conf

Inserting the supplement for the company proxy

If a company proxy is used in your company, you must insert an additional line in the configuration.

Example:

  • Proxy: 123.124.125.126

  • Proxy port: 4321

Add the following line at the end of the file:

  • httpd.conf:
    ProxyRemote * http://123.124.125.126:4321

    NOTE

    Proxy authorization in the proxy remote

    Proxy authorization is not supported in the remote proxy in the current Apache version. It could possibly be implemented by Apache in a future release.

    If you require this function for your application, one possible solution concept can be found at the following link:

    Proxy authorization

Editing extra\httpd-ssl.conf

Enter the following lines:
#Listen 443

#SSLCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES
#SSLProxyCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES

Note: Run the following lines as a command:
SSLCipherSuite ECDHE-RSA-AES128-CBC-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:AES128-SHA256

Note: Run the following lines as a command:
SSLProxyCipherSuite ECDHE-RSA-AES128-CBC-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:AES128-SHA256

SSLProtocol -all +TLSv1.2
SSLProxyProtocol -all +TLSv1.2

#ServerName www.example.com:443
#ServerAdmin you@example.com

ServerName IoT2040:443

SSLCertificateFile "/usr/local/apache2/ssl_cert/certificate.pem"

SSLCertificateKeyFile "/usr/local/apache2/ssl_cert/key.pem"

Editing extra\httpd-vhosts.conf

Enter the following lines:

#<VirtualHost *:80>
# ServerAdmin webmaster@dummy-host.example.com
# DocumentRoot "/usr/local/apache2/docs/dummy-host.example.com"
# ServerName dummy-host.example.com

# ServerAlias www.dummy-host.example.com
# ErrorLog "logs/dummy-host.example.com-error_log"
# CustomLog "logs/dummy-host.example.com-access_log" common
#</VirtualHost>

#<VirtualHost *:80>
# ServerAdmin webmaster@dummy-host2.example.com
# DocumentRoot "/usr/local/apache2/docs/dummy-host2.example.com"
# ServerName dummy-host2.example.com

# ServerAlias www.dummy-host2.example.com
# ErrorLog "logs/dummy-host2.example.com-error_log"
# CustomLog "logs/dummy-host2.example.com-access_log" common
#</VirtualHost>

<VirtualHost *:8080>
ServerName sinac.apps.mindsphere.io/
SSLProxyEngine On
RequestHeader set Front-End-Https "On"
ProxyPass / https://sinac.apps.mindsphere.io/
ProxyPassReverse / https://sinac.apps.mindsphere.io/
</VirtualHost>

<VirtualHost *:8081>
ServerName sinumerikagentcom-dev.apps.mindsphere.io/
SSLProxyEngine On
RequestHeader set Front-End-Https "On"
ProxyPass / https://sinumerikagentcom-dev.apps.mindsphere.io/

Note: Run the following lines as a command:

ProxyPassReverse / https://sinumerikagentcom-dev.apps.mindsphere.io/
</VirtualHost>

Configuration files - Export

httpd.conf

#

# This is the main Apache HTTP server configuration file. It contains the

# configuration directives that give the server its instructions.

# See <URL:http://httpd.apache.org/docs/2.4/> for detailed information.

# In particular, see # <URL:http://httpd.apache.org/docs/2.4/mod/directives.html>

# for a discussion of each configuration directive.

#

# Do NOT simply read the instructions here without understanding

# what they do. They are shown only as hints or reminders. If you are unsure,

# consult the online docs. You have been warned.

#

# Configuration and log file names: If the file names you specify for many

# of the server control files begin with "/" (or "drive:/" for Win32), the

# server will use that explicit path. If the file names do *not* begin

# with "/", the value of ServerRoot is prefixed -- so "logs/access_log"

# with ServerRoot set to "/usr/local/apache2" will be interpreted by the

# server as "/usr/local/apache2/logs/access_log", whereas "/logs/access_log"

# will be interpreted as '/logs/access_log'.

#

# ServerRoot: The top of the directory tree below which the server

# configuration, error and log files are kept.

#

# Do not add a slash at the end of the directory path. If you point

# ServerRoot at a non-local disk, be sure to specify a local disk on the

# Mutex directive, if file-based mutexes are used. If you wish to share the

# same ServerRoot for multiple httpd daemons, you will need to change at

# least PidFile.

#

ServerRoot "/usr/local/apache2"

#

# Mutex: Allows you to set the mutex mechanism and mutex file directory

# for individual mutexes, or change the global defaults

#

# Uncomment and change the directory if mutexes are file-based and the default

# mutex file directory is not on a local disk or is not appropriate for some

# other reason.

#

# Mutex default:logs

#

# Listen: Allows you to bind Apache to specific IP addresses and/or

# ports, instead of the default. See also the <VirtualHost>

# directive.

#

# Change this to Listen on specific IP addresses as shown below to

# prevent Apache from glomming onto all bound IP addresses.

#

#Listen 12.34.56.78:80

Listen 8080

Listen 8081

#

# Dynamic Shared Object (DSO) support

#

# To be able to use the functionality of a module that was built as a DSO, you

# must place corresponding 'LoadModule' lines at this location so the

# directives contained in it are actually available _before_ they are used.

# Statically compiled modules (those listed by 'httpd -l') do not need

# to be loaded here.

#

# Example:

# LoadModule foo_module modules/mod_foo.so

#

LoadModule authn_file_module modules/mod_authn_file.so

#LoadModule authn_dbm_module modules/mod_authn_dbm.so

#LoadModule authn_anon_module modules/mod_authn_anon.so

#LoadModule authn_dbd_module modules/mod_authn_dbd.so

#LoadModule authn_socache_module modules/
#mod_authn_socache.so

LoadModule authn_core_module modules/mod_authn_core.so

LoadModule authz_host_module modules/mod_authz_host.so

LoadModule authz_groupfile_module modules/
mod_authz_groupfile.so

LoadModule authz_user_module modules/mod_authz_user.so

#LoadModule authz_dbm_module modules/mod_authz_dbm.so

#LoadModule authz_owner_module modules/
#mod_authz_owner.so

#LoadModule authz_dbd_module modules/mod_authz_dbd.so

LoadModule authz_core_module modules/mod_authz_core.so

LoadModule access_compat_module modules/
mod_access_compat.so

LoadModule auth_basic_module modules/mod_auth_basic.so

#LoadModule auth_form_module modules/mod_auth_form.so

#LoadModule auth_digest_module modules/
#mod_auth_digest.so

#LoadModule allowmethods_module modules/
#mod_allowmethods.so

#LoadModule file_cache_module modules/mod_file_cache.so

#LoadModule cache_module modules/mod_cache.so

#LoadModule cache_disk_module modules/mod_cache_disk.so

#LoadModule cache_socache_module modules/
#mod_cache_socache.so

LoadModule socache_shmcb_module modules/
#mod_socache_shmcb.so

#LoadModule socache_dbm_module modules/
#mod_socache_dbm.so

#LoadModule socache_memcache_module modules/
#mod_socache_memcache.so

#LoadModule watchdog_module modules/mod_watchdog.so

LoadModule macro_module modules/mod_macro.so

#LoadModule dbd_module modules/mod_dbd.so

#LoadModule dumpio_module modules/mod_dumpio.so

#LoadModule buffer_module modules/mod_buffer.so

#LoadModule ratelimit_module modules/mod_ratelimit.so

LoadModule reqtimeout_module modules/mod_reqtimeout.so

#LoadModule ext_filter_module modules/mod_ext_filter.so

#LoadModule request_module modules/mod_request.so

#LoadModule include_module modules/mod_include.so

LoadModule filter_module modules/mod_filter.so

#LoadModule substitute_module modules/mod_substitute.so

#LoadModule sed_module modules/mod_sed.so

#LoadModule deflate_module modules/mod_deflate.so

LoadModule mime_module modules/mod_mime.so

LoadModule log_config_module modules/mod_log_config.so

#LoadModule log_debug_module modules/mod_log_debug.so

#LoadModule logio_module modules/mod_logio.so

LoadModule env_module modules/mod_env.so

#LoadModule expires_module modules/mod_expires.so

LoadModule headers_module modules/mod_headers.so

#LoadModule unique_id_module modules/mod_unique_id.so

LoadModule setenvif_module modules/mod_setenvif.so

LoadModule version_module modules/mod_version.so

#LoadModule remoteip_module modules/mod_remoteip.so

LoadModule proxy_module modules/mod_proxy.so

LoadModule proxy_connect_module modules/
mod_proxy_connect.so

#LoadModule proxy_ftp_module modules/mod_proxy_ftp.so

LoadModule proxy_http_module modules/mod_proxy_http.so

#LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

#LoadModule proxy_scgi_module modules/mod_proxy_scgi.so

#LoadModule proxy_uwsgi_module modules/
#mod_proxy_uwsgi.so

#LoadModule proxy_fdpass_module modules/
#mod_proxy_fdpass.so

#LoadModule proxy_wstunnel_module modules/
#mod_proxy_wstunnel.so

#LoadModule proxy_ajp_module modules/mod_proxy_ajp.so

#LoadModule proxy_balancer_module modules/
#mod_proxy_balancer.so

#LoadModule proxy_express_module modules/
#mod_proxy_express.so

#LoadModule proxy_hcheck_module modules/
#mod_proxy_hcheck.so

#LoadModule session_module modules/mod_session.so

#LoadModule session_cookie_module modules/
#mod_session_cookie.so

#LoadModule session_dbd_module modules/
#mod_session_dbd.so

#LoadModule slotmem_shm_module modules/
#mod_slotmem_shm.so

#LoadModule sed_module modules/mod_sed.so

#LoadModule lbmethod_byrequests_module modules/
#mod_lbmethod_byrequests.so

#LoadModule lbmethod_bytraffic_module modules/
#mod_lbmethod_bytraffic.so

#LoadModule lbmethod_bybusyness_module modules/
#mod_lbmethod_bybusyness.so

#LoadModule lbmethod_heartbeat_module modules/
#mod_lbmethod_heartbeat.so

LoadModule unixd_module modules/mod_unixd.so

#LoadModule dav_module modules/mod_dav.so

#LoadModule status_module modules/mod_status.so

#LoadModule autoindex_module modules/mod_autoindex.so

#LoadModule info_module modules/mod_info.so

#LoadModule cgid_module modules/mod_cgid.so

#LoadModule dav_fs_module modules/mod_dav_fs.so

LoadModule vhost_alias_module modules/
mod_vhost_alias.so

#LoadModule negotiation_module modules/
#mod_negotiation.so

#LoadModule dir_module modules/mod_dir.so

#LoadModule actions_module modules/mod_actions.so

#LoadModule speling_module modules/mod_speling.so

#LoadModule userdir_module modules/mod_userdir.so

LoadModule alias_module modules/mod_alias.so

#LoadModule rewrite_module modules/mod_rewrite.so

<IfModule unixd_module>

#

# If you wish httpd to run as a different user or group, you must run

# httpd as root initially and it will switch.

#

# User/Group: The name (or #number) of the user/group to run httpd as.

# It is usually good practice to create a dedicated user and group for

# running httpd, as with most system services.

#

User daemon

Group daemon

</IfModule>

# 'Main' server configuration

#

# The directives in this section set up the values used by the 'main'

# server, which responds to any requests that are not handled by a

# <VirtualHost> definition. These values also provide defaults for

# any <VirtualHost> containers defined later in the file.

#

# All of these directives may appear inside <VirtualHost> containers,

# in which case these default settings will be overridden for the

# virtual host being defined.

#

#

# ServerAdmin: The address where problems with the server should be

# e-mailed. This address appears on some server-generated pages, such

# as error documents. e.g. admin@your-domain.com

#

#ServerAdmin you@example.com

#

# ServerName gives the name and port that the server uses to identify itself.

# This can often be determined automatically, but we recommend you specify

# it explicitly to prevent problems during startup.

#

# If your host does not have a registered DNS name, enter its IP address here.

#

#ServerName www.example.com:80

ServerName localhost

#

# Deny access to the entirety of your server filesystem. You must

# explicitly permit access to Web content directories in other

#

<Directory />

AllowOverride none

Require all denied

</Directory>

#

# Note starting at this point, you must specifically allow

# particular features to be enabled - so if something is not working as

# expected, make sure that you have specifically enabled it

# below.

#

#

# DocumentRoot: The directory from which you access your

# documents. By default, all requests are taken from this directory, but

# symbolic links and aliases can be used to point to other locations.

#

DocumentRoot "/usr/local/apache2/htdocs"

<Directory "/usr/local/apache2/htdocs">

#

# Possible values for the Options directive are "None", "All",

# or any combination of them:

# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews

#

# Note that "MultiViews" must be named *explicitly* --- "Options All"

# does not suffice.

#

# The Options directive is both complicated and important. Please see

# http://httpd.apache.org/docs/2.4/mod/core.html

#options

# for more information.

# Options Indexes FollowSymLinks

#

# AllowOverride controls which directives may be placed in .htaccess files.

# They can be "All", "None" or any combination of the keywords:

# AllowOverride FileInfo AuthConfig Limit

# AllowOverride None

#

# Controls who that can get data from this server.

#

Require all granted

</Directory>

#

# DirectoryIndex: sets the file that Apache accesses if a directory

# is requested.

#

<IfModule dir_module>

DirectoryIndex index.html

</IfModule>

#

# The following lines prevent .htaccess and .htpasswd files from being

# viewed by Web clients.

#

<Files ".ht*">

Require all denied

</Files>

#

# ErrorLog: The location of the error log file.

# If you do not specify an ErrorLog directive within a <VirtualHost>

# container, error messages relating to that virtual host will be

# logged here. If you *do* define an error log file for a <VirtualHost>

# container, that host errors will be logged there and not here.

#

ErrorLog "logs/error_log"

#

# LogLevel: Control the number of messages logged to the error_log.

# Possible values include: debug, info, notice, warn, error, crit,

# alert, emerg.

#

LogLevel warn

<IfModule log_config_module>

#

# The following directives define some format nicknames for use with

# a CustomLog directive (see below).

#

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \
"%{User-Agent}i\"" combined

LogFormat "%h %l %u %t \"%r\" %>s %b" common

<IfModule logio_module>

# You need to enable mod_logio.c to use %I and %O

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \
"%{User-Agent}i\" %I %O"

combinedio

</IfModule>

#

# The location and format of the access log file (Common Logfile Format).

# If you do not define any access log files within a <VirtualHost>

# container, they will be logged here. If, however, you *do*

# define per-<VirtualHost> access log files, transactions will be

# logged therein and *not* in this file.

#

CustomLog "logs/access_log" common

#

# If you prefer a log file with access, agent and referrer information

# (Combined Logfile Format) you can use the following directive.

#

#CustomLog "logs/access_log" combined

</IfModule>

<IfModule alias_module>

#

# Redirect: Allows you to tell clients about documents that used to

# exist in your server namespace, but not anymore. The client

# will make a new request for the document at its new location.

# Example:

# Redirect permanent /foo http://www.example.com/bar

#

# Alias: Maps Web paths to filesystem paths and is used to

# access content not present at DocumentRoot.

# Example:

# Alias /webpath /full/filesystem/path

#

# If you include a trailing / on /webpath, the server

# requires it to be present in the URL. You will also likely

# need to provide a <Directory> section to allow access to

# the filesystem path.

#

# ScriptAlias: This controls which directories contain server scripts.

# ScriptAliases are essentially the same as Aliases, except that

# documents in the target directory are treated as applications and

# run by the server when requested rather than as documents sent to the

# client. The same rules about trailing "/" apply to ScriptAlias

# directives as to Alias.

#

ScriptAlias /cgi-bin/ "/usr/local/apache2/cgi-bin/"

</IfModule>

<IfModule cgid_module>

#

# ScriptSock: On threaded servers, designate the path to the UNIX

# socket used to communicate with the CGI daemon of mod_cgid.

#

#Scriptsock cgisock

</IfModule>

#

# "/usr/local/apache2/cgi-bin" should be changed to whatever your ScriptAliased

# CGI directory exists, if it has been configured.

#

<Directory "/usr/local/apache2/cgi-bin">

AllowOverride None

Options None

Require all granted

</Directory>

<IfModule headers_module>

# Avoid passing HTTP_PROXY environment to CGIs on this or any proxied

# backend servers that have lingering "httpoxy" defects.

# 'Proxy' request header is undefined by the IETF, not listed by IANA

#

RequestHeader unset Proxy early

</IfModule>

<IfModule mime_module>

#

# TypesConfig points to the file containing the list of mappings from

# file name extension to MIME type.

#

TypesConfig conf/mime.types

#

# AddType allows you to add to or override the MIME configuration

# file specified in TypesConfig for specific file types.

#

#AddType application/x-gzip .tgz

#

# AddEncoding allows certain browsers to uncompress

# information on the fly. Note: Not all browsers support this.

#

#AddEncoding x-compress .Z

#AddEncoding x-gzip .gz .tgz

#

# If the AddEncoding directives above are commented-out, then you

# probably should define those extensions to indicate media types:

#

AddType application/x-compress .Z

AddType application/x-gzip .gz .tgz

#

# AddHandler allows you to map certain file extensions to "handlers":

# actions unrelated to file type. They can be either built into the server

# or added with the Action directive (see below)

#

# To use CGI scripts outside of ScriptAliased directories:

# (You will also need to add "ExecCGI" to the "Options" directive.)

#

#AddHandler cgi-script .cgi

# For type maps (negotiated resources):

#AddHandler type-map var

#

# Filters allow you to process content before it is sent to the client.

#

# To parse .shtml files for server-side includes (SSI):

# (You will also need to add "Includes" to the "Options" directive.)

#

#AddType text/html .shtml

#AddOutputFilter INCLUDES .shtml

</IfModule>

#

# The mod_mime_magic module allows the server to use various hints from the

# contents of the file itself to determine its type. The MIMEMagicFile

# directive tells the module where the hint definitions are located.

#

#MIMEMagicFile conf/magic

#

# Customizable error responses come in three flavors:

# 1) plain text 2) local redirects 3) external redirects

#

# Some examples:

#ErrorDocument 500 "The server made a boo boo."

#ErrorDocument 404 /missing.html

#ErrorDocument 404 "/cgi-bin/missing_handler.pl"

#ErrorDocument 402 http://www.example.com/subscription_info.html

#

#

# MaxRanges: Maximum number of Ranges in a request before

# returning the entire resource, or one of the special

# values 'default', 'none' or 'unlimited'.

# Default setting is to accept 200 Ranges.

#MaxRanges unlimited

#

# EnableMMAP and EnableSendfile: On systems that support it,

# memory-mapping or the sendfile syscall can be used to deliver

# files. This usually improves server performance, but must

# be turned off when serving from networked-mounted

# filesystems or if support for these functions is otherwise

# broken on your system.

# Defaults: EnableMMAP On, EnableSendfile Off

#

#EnableMMAP off

#EnableSendfile on

# Supplemental configuration

#

# The configuration files in the conf/extra/ directory can be

# included to add extra features or to modify the default configuration of

# the server, or you may simply copy their contents here and change as

# necessary.

# Server-pool management (MPM-specific)

#Include conf/extra/httpd-mpm.conf

# Multi-language error messages

#Include conf/extra/httpd-multilang-errordoc.conf

# Fancy directory listings

#Include conf/extra/httpd-autoindex.conf

# Language settings

#Include conf/extra/httpd-languages.conf

# User home directories

#Include conf/extra/httpd-userdir.conf

# Real-time info on requests and configuration

#Include conf/extra/httpd-info.conf

# Virtual hosts

Include conf/extra/httpd-vhosts.conf

# Local access to the Apache HTTP Server Manual

#Include conf/extra/httpd-manual.conf

# Distributed authoring and versioning (WebDAV)

#Include conf/extra/httpd-dav.conf

# Various default settings

#Include conf/extra/httpd-default.conf

# Configure mod_proxy_html to understand HTML4/XHTML1

<IfModule proxy_html_module>

Include conf/extra/proxy-html.conf

</IfModule>

# Secure (SSL/TLS) connections

Include conf/extra/httpd-ssl.conf

#

# Note: The following must be present to support

# starting without SSL on platforms with no/dev/random equivalent

# but a statically compiled-in mod_ssl.

#

<IfModule ssl_module>

SSLRandomSeed startup builtin

SSLRandomSeed connect builtin

</IfModule>

#ProxyRemote * http://123.124.125.126:4321

extra\httpd-ssl.conf

#

# This is the Apache server configuration file providing SSL support.

# It contains the configuration directives to instruct the server how to

# access pages over an https connection. For detailed information about these

# directives, see <URL:http://httpd.apache.org/docs/2.4/mod/mod_ssl.html>

#

# Do NOT simply read the instructions here without understanding

# what they do. They are shown only as hints or reminders. If you are unsure,

# consult the online docs. You have been warned.

#

# Required modules: mod_log_config, mod_setenvif, mod_ssl,

# socache_shmcb_module (for default value of SSLSessionCache)

#

# Pseudo Random Number Generator (PRNG):

# Configure one or more sources to seed the PRNG of the SSL library.

# The seed data should be of good random quality.

# WARNING! On some platforms /dev/random blocks if insufficient entropy

# is available. This means you then cannot use the /dev/random device

# because it would lead to very long connection times (as long as

# it requires to make more entropy available). But usually those

# platforms additionally provide a /dev/urandom device that does not

# block. So, if available, use this one instead. Read the mod_ssl User

# Manual for more details.

#

#SSLRandomSeed startup file:/dev/random 512

#SSLRandomSeed startup file:/dev/urandom 512

#SSLRandomSeed connect file:/dev/random 512

#SSLRandomSeed connect file:/dev/urandom 512

#

# When we also provide SSL, we must listen to the

# standard HTTP port (see above) and to the HTTPS port

#

#Listen 443

##

## SSL Global Context

##

## All SSL configurations in this context apply to

## the main server and all SSL-enabled virtual hosts.

##

# SSL Cipher Suite:

# List the ciphers that the client is permitted to negotiate,

# and that httpd will negotiate as the client of a proxied server.

# See the OpenSSL documentation for a complete list of ciphers, and

# ensure they follow appropriate best practices for this deployment.

# httpd 2.2.30, 2.4.13 and later force-disable aNULL, eNULL and EXP ciphers,

# while OpenSSL disabled these by default in 0.9.8zf/1.0.0r/1.0.1m/1.0.2a.

#SSLCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES

#SSLProxyCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES

Note: Run the following lines as a command:

SSLCipherSuite ECDHE-RSA-AES128-CBC-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:AES128-SHA256

Note: Run the following lines as a command:

SSLProxyCipherSuite ECDHE-RSA-AES128-CBC-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:AES128-SHA256

# By the end of 2016, only TLSv1.2 ciphers should remain in use.

# Older ciphers should be disallowed as soon as possible, while the

# kRSA ciphers do not offer forward secrecy. These changes inhibit

# older clients (such as IE6 SP2 or IE8 on Windows XP, or other legacy

# non-browser tooling) from successfully connecting.

#

# To restrict mod_ssl to use only TLSv1.2 ciphers, and disable

# those protocols that do not support forward secrecy, replace

# the SSLCipherSuite and SSLProxyCipherSuite directives above with

# the following two directives, as soon as practicable.

# SSLCipherSuite HIGH:MEDIUM:!SSLv3:!kRSA

# SSLProxyCipherSuite HIGH:MEDIUM:!SSLv3:!kRSA

# User agents such as Web browsers are not configured for the user's

# own preference of either security or performance, therefore this

# must be the prerogative of the Web server administrator who manages

# CPU load versus confidentiality, so enforce the server's cipher order.

SSLHonorCipherOrder on

# SSL Protocol support:

# List the protocol versions that clients are allowed to connect with.

# Disable SSLv3 by default (cf. RFC 7525 3.1.1). TLSv1 (1.0) should be

# disabled as quickly as practicable. By the end of 2016, only the TLSv1.2

# protocol or later should remain in use. #SSLProtocol all -SSLv3

#SSLProxyProtocol all -SSLv3

SSLProtocol -all +TLSv1.2

SSLProxyProtocol -all +TLSv1.2

# Pass Phrase Dialog:

# Configure the pass phrase gathering process.

# The filtering dialog program ('builtin' is an internal

# terminal dialog) must provide the pass phrase on stdout.

SSLPassPhraseDialog builtin

# Inter-Process Session Cache:

# Configure the SSL Session Cache: First the mechanism

# to use and second the expiring timeout (in seconds).

#SSLSessionCache "dbm:/usr/local/apache2/logs/ssl_scache"

SSLSessionCache "shmcb:/usr/local/apache2/logs/ssl_scache(512000)"

SSLSessionCacheTimeout 300

# OCSP Stapling (requires OpenSSL as of 0.9.8h)

#

# This feature is disabled by default and requires at least

# the two directives SSLUseStapling and SSLStaplingCache.

# Refer to the documentation on OCSP Stapling in the SSL/TLS

# How-To for more information.

#

# Enable stapling for all SSL-enabled servers:

#SSLUseStapling On

# Define a relatively small cache for OCSP Stapling using

# the same mechanism that is used for the SSL session cache

# above. If stapling is used with more than a few certificates,

# the size may need to be increased. (AH01929 will be logged.)

#SSLStaplingCache "shmcb:/usr/local/apache2/logs/ssl_stapling(32768)"

# Seconds before valid OCSP responses are expired from the cache

#SSLStaplingStandardCacheTimeout 3600

# Seconds before invalid OCSP responses are expired from the cache

#SSLStaplingErrorCacheTimeout 600

##

## SSL Virtual Host Context

##

<VirtualHost _default_:443>

# General setup for the virtual host DocumentRoot "/usr/local/apache2/htdocs"

#ServerName www.example.com:443

#ServerAdmin you@example.com ServerName IoT2040:443

ErrorLog "/usr/local/apache2/logs/error_log"

TransferLog "/usr/local/apache2/logs/access_log"

# SSL Engine Switch:

# Enable/Disable SSL for this virtual host.

SSLEngine on

# Server Certificate:

# Point SSLCertificateFile at a PEM-encoded certificate. If

# the certificate is encrypted, then you will be prompted for a

# pass phrase. Note that a kill -HUP will prompt again. Keep

# in mind that if you have both an RSA and a DSA certificate, you

# can configure both in parallel (to also allow the use of DSA

# ciphers, etc.)

# Some ECC cipher suites (http://www.ietf.org/rfc/rfc4492.txt)

# require an ECC certificate that can also be configured in

# parallel.

SSLCertificateFile "/usr/local/apache2/ssl_cert/certificate.pem"

SSLCertificateFile "/usr/local/apache2/ssl_cert/certificate.pem"

#SSLCertificateFile "/usr/local/apache2/conf/server-ecc.crt"

# Server Private Key:

# If the key is not combined with the certificate, use this

# directive to point at the key file. Keep in mind that if

# you have both a RSA and a DSA private key, you can configure

# both in parallel (to also allow the use of DSA ciphers, etc.)

# ECC keys, when in use, can also be configured in parallel

SSLCertificateKeyFile "/usr/local/apache2/ssl_cert/key.pem"

#SSLCertificateKeyFile "/usr/local/apache2/conf/server-dsa.key"

#SSLCertificateKeyFile "/usr/local/apache2/conf/server-ecc.key"

# Server Certificate Chain:

# Point SSLCertificateChainFile at a file containing the

# concatenation of PEM-encoded CA certificates that form the

# certificate chain for the server certificate. Alternatively

# the referenced file can be the same as SSLCertificateFile

# when the CA certificates are directly appended to the server

# certificate for convenience.

#SSLCertificateChainFile "/usr/local/apache2/conf/server-ca.crt"

# Certificate Authority (CA):

# Set the CA certificate verification path where to find CA

# certificates for client authentication or alternatively one

# huge file containing all of them (file must be PEM-encoded)

# Note: Inside SSLCACertificatePath you need hash symlinks

# to point to the certificate files. Use the provided

# Make file to update the hash symlinks after changes.

#SSLCACertificatePath "/usr/local/apache2/conf/ssl.crt"

#SSLCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle.crt"

# Certificate Revocation Lists (CRL):

# Set the CA revocation path where to find CA CRLs for client

# authentication or alternatively one huge file containing all

# of them (file must be PEM-encoded).

# The CRL checking mode needs to be configured explicitly

# through SSLCARevocationCheck (defaults to "none" otherwise).

# Note: Inside SSLCACertificatePath you need hash symlinks

# to point to the certificate files. Use the provided

# Make file to update the hash symlinks after changes.

#SSLCARevocationPath "/usr/local/apache2/conf/ssl.crl"

#SSLCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle.crl"

#SSLCARevocationCheck chain

# Client Authentication (Type):

# Client certificate verification type and depth. Types are

# none, optional, require and optional_no_ca. Depth is a

# number that specifies how deeply to verify the certificate

# issuer chain before deciding the certificate is not valid.

#SSLVerifyClient require

#SSLVerifyDepth 10

# TLS-SRP mutual authentication:

# Enable TLS-SRP and set the path to the OpenSSL SRP verifier

# file (containing login information for SRP user accounts).

# Requires OpenSSL 1.0.1 or newer. See the mod_ssl FAQ for

# detailed instructions for creating this file. Example:

# "openssl srp -srpvfile /usr/local/apache2/conf/passwd.srpv -add username"

#SSLSRPVerifierFile "/usr/local/apache2/conf/passwd.srpv

# Access Control:

# With SSLRequire you can do per-directory access control based

# on arbitrary complex Boolean expressions containing server

# variable checks and other lookup directives. The syntax is a

# mixture between C and Perl. See the mod_ssl documentation

# for more details.

#<Location />

#SSLRequire (

%{SSL_CIPHER} !~ m/^(EXP|NULL)/ \

#

#

#

#

#

#

#

and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \

and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \

and %{TIME_WDAY} >= 1

and %{TIME_WDAY} <= 5 \

and %{TIME_HOUR} >= 8

and %{TIME_HOUR} <= 20 ) \

or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/

#</Location>

# SSL Engine Options:

# Set various options for the SSL engine.

#

#

#

#

#

#

o

FakeBasicAuth:

Translate the client X.509 into a Basic Authorization. This means that

the standard Auth/DBMAuth methods can be used for access control. The

user name is the 'one line' version of the client's X.509 certificate.

Note that no password is obtained from the user. Every entry in the user

file needs this password: 'xxj31ZMTZzkVA'.

#

#

#

#

#

#

o

ExportCertData:

This exports two additional environment variables: SSL_CLIENT_CERT and

SSL_SERVER_CERT. These contain the PEM-encoded certificates of the

server (always existent) and the client (only existent when client

authentication is used). This can be used to import the certificates

into CGI scripts.

#

#

#

#

#

o

StdEnvVars:

This exports the standard SSL/TLS related 'SSL_*' environment variables.

By default, this export is switched off for performance reasons,

because the extraction step is an expensive operation and is usually

useless for serving static content. So one usually enables the

export for CGI and SSI requests only.

#

#

#

#

o

StrictRequire:

This denies access when "SSLRequireSSL" or "SSLRequire" applied even

for a "Satisfy any" situation, i.e. when it applies, access is denied

and no other module can change it.

#

#

#

o

OptRenegotiate:

This enables optimized SSL connection renegotiation handling when SSL

directives are used in per-directory context.

#SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire

<FilesMatch "\.(cgi|shtml|phtml|php)$">

SSLOptions +StdEnvVars

</FilesMatch>

<Directory "/usr/local/apache2/cgi-bin">

SSLOptions +StdEnvVars

</Directory>

# SSL Protocol Adjustments:

# The safe and default, but still SSL/TLS standard compliant shutdown

# approach, is that mod_ssl sends the close notify alert but does not wait for

# the close notify alert from client. When you need a different shutdown

# approach, you can use one of the following variables:

#

#

#

#

#

#

o

ssl-unclean-shutdown:

This forces an unclean shutdown when the connection is closed, i.e. no

SSL close notify alert is sent or allowed to be received. This violates

the SSL/TLS standard, but is needed for some brain-dead browsers. Use

this when you receive I/O errors because of the standard approach where

mod_ssl sends the close notify alert.

#

#

#

#

#

#

#

o

ssl-accurate-shutdown:

This forces an accurate shutdown when the connection is closed, i.e. a

SSL close notify alert is sent and mod_ssl waits for the close notify

alert of the client. This is 100% SSL/TLS standard compliant, but in

practice often causes hanging connections with brain-dead browsers. Use

this only for browsers where you know that their SSL implementation

works correctly.

# Notice: Most problems of broken clients are also related to the HTTP

# keep-alive facility, so you usually additionally want to disable

# keep-alive for those clients, too. Use variable "nokeepalive" for this.

# Similarly, one has to force some clients to use HTTP/1.0 to workaround

# their broken HTTP/1.1 implementation. Use variables "downgrade-1.0" and

# "force-response-1.0" for this.

BrowserMatch "MSIE [2-5]" \

nokeepalive ssl-unclean-shutdown \

downgrade-1.0 force-response-1.0

# Per-server logging:

# The home of a custom SSL log file. Use this when you want a

# compact non-error SSL log file on a virtual host basis.

CustomLog "/usr/local/apache2/logs/ssl_request_log" \

"%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"

</VirtualHost>

extra\httpd-vhosts.conf

# Virtual Hosts

#

# Required modules: mod_log_config

# If you want to maintain multiple domains/hostnames on your

# machine you can setup VirtualHost containers for them. Most configurations

# use only name-based virtual hosts so the server doesn't need to worry about

# IP addresses. This is indicated by the asterisks in the directives below.

#

# Please see the documentation at

# <URL:http://httpd.apache.org/docs/2.4/vhosts/>

# for further details before you try to setup virtual hosts.

#

# You may use the command line option '-S' to verify your virtual host

# configuration.

#

# VirtualHost example:

# Almost any Apache directive may go into a VirtualHost container.

# The first VirtualHost section is used for all requests that do not

# match a ServerName or ServerAlias in any <VirtualHost> block.

#

#<VirtualHost *:80>

#

#

#

#

#

#

ServerAdmin webmaster@dummy-host.example.com

DocumentRoot "/usr/local/apache2/docs/dummy-host.example.com"

ServerName dummy-host.example.com

ServerAlias www.dummy-host.example.com

ErrorLog "logs/dummy-host.example.com-error_log"

CustomLog "logs/dummy-host.example.com-access_log" common

#</VirtualHost>

#

#<VirtualHost *:80>

#

#

#

#

#

ServerAdmin webmaster@dummy-host2.example.com

DocumentRoot "/usr/local/apache2/docs/dummy-host2.example.com"

ServerName dummy-host2.example.com

ErrorLog "logs/dummy-host2.example.com-error_log"

CustomLog "logs/dummy-host2.example.com-access_log" common

#</VirtualHost>

<VirtualHost *:8080>

ServerName sinac.apps.mindsphere.io/

SSLProxyEngine On

RequestHeader set Front-End-Https "On"

ProxyPass / https://sinac.apps.mindsphere.io/

ProxyPassReverse / https://sinac.apps.mindsphere.io/

</VirtualHost>

<VirtualHost *:8081>

ServerName sinumerikagentcom-dev.apps.mindsphere.io/

SSLProxyEngine On RequestHeader set Front-End-Https "On"

ProxyPass / https://sinumerikagentcom-dev.apps.mindsphere.io/

ProxyPassReverse / https://sinumerikagentcom-dev.apps.mindsphere.io/

</VirtualHost>

<VirtualHost *:8082>

ServerName gateway.eu1.mindsphere.io/

SSLProxyEngine On RequestHeader set Front-End-Https "On"

ProxyPass / https://gateway.eu1.mindsphere.io/

ProxyPassReverse / https://gateway.eu1.mindsphere.io/

</VirtualHost>