Estimated reading time: 7 min

Enabling HTTPS AccessTo Top

 

Legal WarningTo Top

Specifications, details, statements, and information in this manual are subject to change without any notice. All the information provided, procedures shared, or statements listed below are for Tegsoft technical experts only. Using this manual without Tegsoft Technical qualification should be avoided. Tegsoft has no obligation over the result of the application on any use. Some statements may not be suitable for the use; avoiding without technical qualification may be crucial. Users must take full responsibility for performing any steps part of this manual. Users who are not aware of technical terms and operations described here; should be aware that this document may not be suitable for their usage.

 

Changes to This DocumentTo Top

Date Change Summary
2020-09-01 Initial release of the document.

 

 

 

PrefaceTo Top

This document explains how to Enable HTTP Access. The preface for enabling HTTP access contains the following sections:

  • Prepare Certificate Files
  • SSH Connection
  • Configuring Tegsoft

 

Obtaining DocumentationTo Top

Tegsoft documentation and additional literature are available on Tegsoft Knowledge Base. This section explains the product documentation resources that Tegsoft offers.

Tegsoft Knowledge Base

You can access the most current Tegsoft documentation at this URL:

https://tegsoft.com/knowledge-base/

 

PrerequisitesTo Top

  • You must have basic knowledge of networking
  • You must have basic knowledge of SSH connection
  • You must have basic skills of Linux Command Line Interface

 

Instruction : To enable HTTPS for Tegsoft server you are going to prepare some files, transfer files to server and restart some services. Steps below will help to enable HTTPS access.

 

Prepare Certificate FilesTo Top

Note: All file are needed.

  1. Certificate public key (certificate.crt)
  2. Certificate private key (certificate.key)
  3. Certificate PEM format (certificate.pem) You can use certificate conversion tools/utilities to create PEM file from crt. A sample command line tool is below
  4. openssl x509 -in certificate.crt -out certificate.pem -outform PEM
  5. Certificate root and parent keys (bundle.crt) If you do not have a bundle.crt file please create an empty file with a name bundle.crt

 

SSH ConnectionTo Top

  1. Connect to server via SSH with root user
  2. Run command below
  3. ls -lrth /etc/httpd/conf.d/tegsoft.conf
  4. If you see a file listed like below you can continue with step 3
  5. -rw-r--r-- 1 root root 1.3K Jul 10 05:32 /etc/httpd/conf.d/tegsoft.conf
  6. If you do not see a listed file and receive a message “No such file or directory” then please run the command below
  7. rm -rf /root/custom_certificates
  8. Update Tegsoft to latest version and check again with step 2.2. If issue persists please contact with Tegsoft Software Support Team.

 

Configure TegsoftTo Top

Configure Tegsoft software not to override configuration. You need to create a file (/root/custom_certificates) if you want to customize HTTP configuration

  1. Connect to server via SSH with root user

  2. Below command will disable auto-generation of server certificates and will notify the server to allow user to use custom certificates.

  3. echo 1 > /root/custom_certificates

 

  • You are going to need a software to transfer files from local PC to server. WinSCP will be enough.
  • Transfer Certificate files from local folder to server /certificates (This folder must be created and all files must be transferred) All file names are case sensitive and they must match with the naming defined at Prepare Certificate Files step.
  • Restart http server to activate ssl engine.
    • service httpd restart
  • Check https access by a browser
    • Your https access must be over a DNS name