You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

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.

Step 1. Stop AppServer

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



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



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

Or your can also run the stop.sh script from the AppServer directory:

/<WebSpellChecker_Installation_Dir>/WSC/AppServer/# sh stop.sh

Step 2. Setup SSL in AppServer Configuration File

1. 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

2. 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>

3. Change the default value for the EnableSSL parameter to True.

<EnableSSL>true</EnableSSL>

4. 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>

5. If your SSL certificate is password-protected, use the SSLCertificatePassword tag to provide a password.  

<SSLCertificatePassword>your_certificate_password</SSLCertificatePassword>

Step 3. Start AppServer

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


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



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