Mideye Server 4 SSL/TLS Certificate Management

Archived Documentation

This page documents Mideye Server version 4, which is no longer actively maintained. For current documentation, see Mideye Server v6.

Overview

Mideye Server uses HTTPS to secure the Web Admin interface. By default, a self-signed certificate is generated during installation. This guide explains how to replace it with a CA-signed certificate or configure client certificate authentication.

Use this guide to:

• Generate a new self-signed certificate
• Replace the default certificate with a CA-signed certificate (PFX or JKS format)
• Enable client certificate authentication for Web Admin access
• Troubleshoot certificate and HTTPS issues

---

Generate a New Self-Signed Certificate

Mideye Server includes a self-signed certificate for HTTPS. To regenerate it, run this command from the Mideye Server bin directory:

MideyeWebConfig configure server

Certificate Reset

This command replaces /opt/mideyeserver/certificates/webserver_https.keystore and resets web server configuration. If client certificate validation was enabled, it will be disabled.

Restart Required

Restart the Apache TomEE service after any certificate changes for them to take effect.

---

Replace with a CA-Signed Certificate

Two certificate formats are supported:

Format	Best For	File Extension
PFX/PKCS12	Windows environments, IIS-generated certificates	.pfx, .p12
JKS/JCEKS	Java keystores, existing enterprise PKI	.jks, .keystore

Option 1: PFX (PKCS12) Certificate

Use this method if you have a Windows CA or need to generate a certificate via IIS.

Step 1: Generate the Certificate in IIS

1. Open Internet Information Services (IIS) Manager
2. Select the server root and open Server Certificates

3. Click Create Domain Certificate in the Actions panel
4. Enter the certificate details:
   • Common name: FQDN of the Web Admin URL (e.g., mideye.company.com)
   • Fill in Organization, City, State, Country
5. Click Next

6. Select your Certificate Authority and enter a Friendly name
7. Click Finish

Step 2: Export and Install the Certificate

1. Right-click the certificate and select Export
2. Set a password (you’ll need this for server.xml)
3. Save the file
4. Copy the PFX file to:

   C:\Program Files (x86)\Mideye Server\certificates\<filename>.pfx

Step 3: Configure server.xml

1. Backup server.xml before editing:

   C:\Program Files (x86)\Mideye Server\webserver\conf\server.xml

2. Open server.xml with a text editor (run as Administrator)

3. Find the <Connector port="8443"...> section at the end of the file

4. Replace the keystore configuration:

   Original (self-signed):

   truststorePass="hN+JeFqq5hSsNaw" sslEnabledProtocols="TLSv1.2"
   keystoreFile="C:\Program Files (x86)\Mideye Server\certificates\webserver_https.keystore"
   truststoreFile="C:\Program Files (x86)\Mideye Server\certificates\webserver_https.keystore"
   keystorePass="hN+JeFqq5hSsNaw" maxThreads="150"
   useServerCipherSuitesOrder="true" clientAuth="false">

   New (PFX certificate):

   sslEnabledProtocols="TLSv1.2"
   keystoreFile="C:\Program Files (x86)\Mideye Server\certificates\<your-cert>.pfx"
   keystoreType="PKCS12"
   keystorePass="<your-password>"
   maxThreads="150" useServerCipherSuitesOrder="true" clientAuth="false">

5. Restart the Apache TomEE service

Complete Connector Example

Here’s a complete example of the configured connector:

<Connector port="8443" scheme="https" enableLookups="false"
  acceptCount="100" secure="true" minSpareThreads="25" maxSpareThreads="75"
  protocol="org.apache.coyote.http11.Http11Protocol" SSLEnabled="true"
  maxHttpHeaderSize="8192" disableUploadTimeout="true"
  ciphers="TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,..."
  sslEnabledProtocols="TLSv1.2"
  keystoreFile="C:\Program Files (x86)\Mideye Server\certificates\mideye.pfx"
  keystoreType="PKCS12" keystorePass="yourpassword"
  maxThreads="150" useServerCipherSuitesOrder="true" clientAuth="false">
</Connector>

---

Option 2: JKS/JCEKS Keystore

Use this method if you have an existing Java keystore.

1. Backup the existing keystore:

   C:\Program Files (x86)\Mideye Server\certificates\webserver_https.keystore

2. Replace the keystore file with your custom certificate, naming it webserver_https.keystore

3. Edit server.xml:

   • Location: C:\Program Files (x86)\Mideye Server\webserver\conf\server.xml
   • Find <Connector port="8443"...>
   • Update truststorePass and keystorePass with your keystore password

4. Restart the Apache TomEE service

---

Enable Client Certificate Authentication

For additional security, you can require administrators to present a client certificate when accessing the Web Admin. This provides mutual TLS (mTLS) authentication.

Generate a Client Certificate

1. Open Command Prompt and navigate to the Mideye Server installation directory

2. Run:

   MideyeWebConfig configure client

3. The command creates:

   C:\Program Files (x86)\Mideye Server\certificates\client.p12

4. Note the password displayed in the command prompt — you’ll need it to import the certificate

5. Restart the Apache TomEE service

Distribute the Client Certificate

Each administrator must import client.p12 into their browser:

Browser	Import Location
Chrome/Edge	Settings → Privacy and security → Security → Manage certificates
Firefox	Settings → Privacy & Security → Certificates → View Certificates → Import

Regenerate Certificate

Running MideyeWebConfig configure client again generates a new certificate with a new password. Previously issued certificates remain valid until the server certificate is regenerated.

---

Troubleshooting

Web Admin Not Accessible

Step	Action
1	Verify Apache TomEE service is running
2	Restart the TomEE service
3	Open Configuration Tool → Database Connection → click Save → Close
4	Restart Mideye services
5	Clear browser cache and retry

Verify Port Is Listening

Windows:

netstat -aon | find /i "8443"

Linux:

netstat -tnlp | grep 8443

If port 8443 is not listed, the TomEE service failed to start or the certificate is invalid.

Certificate Issues After Upgrade

If the Web Admin stops working after an upgrade:

1. Generate a new self-signed certificate:

   MideyeWebConfig configure server

2. Restart Apache TomEE
3. Re-apply any custom certificates if needed