By default, all the requests to AppServer are sent over HTTP protocol. In order to configure secure SSL connection, you need to enable SSL for AppServer as described here.

1. Stop AppServer

Before making with any changes, it is recommended to stop AppServer.


 Click to see how to stop AppServer on a Windows server ...


Stop AppServer on a Windows server

There are three possible options how you can stop AppServer on Windows-based environments.

Option A: Go to Windows Start –> All Programs –> WebSpellChecker –> AppServer –> Stop WebSpellChecker Application Server

Option B: Open Command Prompt –> Switch to [WebSpellChecker_Installation_Path]/AppServer –> Run AppServerX -stop

Option C:

  • Go to Windows Start –> Control Panel –> Administrative Tools –> Services
  • Find WebSpellChecker Application Server Service on the list of all services
  • Click Stop


 Click here to see how to stop AppServer on a Linux server ...


Stop AppServer on a Linux server

Run the stop.sh script to stop AppServer using the following command below:

sudo sh <WebSpellChecker_Installation_Path>/WSC/AppServer/stop.sh

2. Setup SSL in AppServer Configuration File

  • Locate the AppServerX.xml configuration file in the WebSpellChecker installation folder on your server. The default path to AppServerX.xml file: <WebSpellChecker_Installation_Path>/AppServer/AppServerX.xml
  • Scroll down to the section with parameters responsible for secure connection: <SSL>...</SSL>.
		<!-- Secure connection -->
		<SSL>
			<EnableSSL>false</EnableSSL>
			<!-- Transport Layer Security (TLS) version. Possible values: TLSV1, TLSV1_1, TLSV1_2 -->
			<TLSVersion>TLSV1_2</TLSVersion>
			<!--For Linux: path to certificate file (PEM format). Path example: /opt/WSC/AppServer/cert.pem -->
			<!--For Windows: path to PKCS #12 (*.pfx) file containing the certificate and corresponding private key. Path example: C:/Program Files/WebSpellChecker/AppServer/certificate.pfx -->
			<SSLCertificateFile></SSLCertificateFile>
			<!--For Linux only. Path to private key file (PEM format). Path example: /opt/WSC/AppServer/key.pem -->
			<SSLCertificateKeyFile></SSLCertificateKeyFile>
			<!--Certificate Export Password. Leave empty if you don't have password -->
			<SSLCertificatePassword>your_certificate_password</SSLCertificatePassword>
		</SSL>

Please pay attention to whether your SSL certificate password protected. If yes, please specify it using the following parameter:

<SSLCertificatePassword>your_certificate_password</SSLCertificatePassword>

  • Change the default value for the EnableSSL parameter to True.
<EnableSSL>true</EnableSSL>
  • Specify path to your certificate file (*.pfx or *.pem) in the SSLCertificateFile parameter.
<!--For Linux: path to certificate file (PEM format). Path example: /opt/WSC/AppServer/cert.pem -->
<!--For Windows: path to PKCS #12 (*.pfx) file containing the certificate and corresponding private key. Path example: C:/Program Files/WebSpellChecker/AppServer/certificate.pfx -->
<SSLCertificateFile></SSLCertificateFile>
<!--For Linux only. Path to private key file (PEM format). Path example: /opt/WSC/AppServer/key.pem -->
<SSLCertificateKeyFile></SSLCertificateKeyFile>

3. Start AppServer

As soon as the modifications are completed, start AppServer for the changes to take effect.


 Click here to see how to start AppServer on a Windows server ...


Start AppServer on Windows

There are three possible options how you can start AppServer on Windows-based environments.

Option A: Go to Windows Start –> All Programs –> WebSpellChecker –> AppServer –> Start WebSpellChecker Application Server

Option B: Open Command Prompt –> Switch to [WebSpellChecker_Installation_Path]/AppServer –> Run AppServerX -start

Option C:

  • Go to Windows Start –> Control Panel –> Administrative Tools –> Services
  • Find WebSpellChecker Application Server Service on the list of all services
  • Click Start


 Click here to see how to start AppServer on a Linux server ...


Start AppServer on Linux

Run the start.sh script to start AppServer using the following command below:

sudo sh <WebSpellChecker_Installation_Path>/WSC/AppServer/start.sh

  • No labels