SSL Certificate

Qualitia Automation Studio (QAS) now supports a secure server portal with SSL certificates, providing secure and authenticated connections. HTTPS encryption ensures secure communication between the Qualitia - Client and Server, protecting against data breaches, tampering, and eavesdropping. This is essential for safeguarding sensitive information on servers that require secure connections, emphasizing user privacy and security.

Fresh installations launch on HTTPS by default with pre-bundled certificates, using the default port 443 without requiring manual configuration. Additionally, you have the flexibility to switch between HTTPS and HTTP as needed.

What is SSL Certificate?

The SSL certificate is a digital certificate that is used for authentication of a website. It creates a secure connection between the client and the web server. When the certificate is installed, it changes the website from HTTP to HTTPS.

📚Prerequisites

• To use HTTPS, ensure that the DNS server is configured for the server URL.

Steps to configure DNS Server for Server URL

1. Navigate to C:\Windows\System32\drivers\etc.

2. Open the hosts file in a text editor.

3. Add {Server IP} {abc}.qualitia.ai (For example, 127.0.0.1 loacl.qualitia.ai) on a new line.

4. Save the file.

5. Access the server using the URL: https://{domain name}.

Switching Between HTTP and HTTPS

You can switch between HTTP and HTTPS as needed.

Steps to switch from HTTPS to HTTP

1. Launch the Server Portal in your browser.

2. Go to the Configuration tab.

3. Uncheck the Enable SSL checkbox.

4. Click Save to apply the configuration.

5. Open the portal in your browser using the HTTP URL, e.g., http://localhost:8887.

Steps to switch from HTTP to HTTPS

1. Launch the Server Portal in your browser.

2. Go to the Configuration tab.

3. Check the Enable SSL checkbox.

4. Click Save to apply the configuration.

5. Open the portal in your browser using the HTTP URL, e.g., https://local.qualitia.ai.

Steps to Manually Configure SSL Certificate Paths (Other than Qualitia)

1. Navigate to the directory where the certificates are placed.

2. Identify and copy the full file path for each required certificate.

3. Open the Server Portal and navigate to the Configuration tab.

4. Check the Enable SSL checkbox.

5. Paste the copied paths into their respective fields under SSL Configuration.

6. Click Save to apply the configuration.

Steps to Download the SSL Certificate

1. Launch the Server Portal in your browser.

2. Click the Advanced option.

3. Click the link "Proceed to {Domain/IP} (unsafe)".

4. Click Not Secure to view site information.

5. Then click Certificate Details.

6. Now go to the Details tab and click Export.

7. Choose a folder location and click Save.

Steps to Install SSL Certificate on Your Local Machine

1. Open Manage User Certificates from the Start menu.

2. Expand the Trusted Root Certification Authorities node.

3. Right-click on the Certificates node.

4. Click All Tasks > Import.

5. Import the tasks and click Next.

6. Select the downloaded certificate and click Next > Finish.

7. Restart the machine.

8. Go to the secure link, for example, https://local.qualitia.ai.

9. Use the same server URL (e.g. https://local.qualitia.ai) in Qualitia - Client while logging in.

After going from not secure to secure, make sure to reload the page. If this does not work, relaunch the server portal.

Configure CICD execution using SSL Server

Once you have installed the SSL certificate on the local machine, you can configure CICD execution, such as Jenkins, TeamCity & Bamboo, using the SSL Server. Refer to Steps to install SSL certificate on your local machine for detailed information.

• Make sure to install the CA Root certificate on the Jenkins machine before execution.

• To execute any suite from the SSL-enabled server, use the following curl command:
  curl --ssl-no-revoke -o executionAgent.jar -LJ {Server URL}/api/v1/download/executionAgent

ADO execution using SSL Server

• For ADO execution, the URL you pass to the ADO Task should include the port number 443. For example, https://qualitiasoft.ssl:443.

• All other settings will be as per normal server execution.

Update the SSL Port and SSL Certificate path

1. Open the Configuration Section on the Qualitia Server.

2. Go to Secure Connections and select the Enable SSL check box.

3. Add the SSL Port number as 443.

4. Add the SSL Certificate Path as qualitiasoft.ssl.

5. Add the SSL Certificate Password and click Save.

You need to enable the SSL from the Configuration Section to get a secure connection. If not enabled, the SSL port defaults to 80, an unsecured server.

🔧 Got a problem? Let’s fix!

1. Issue: You may encounter the "Your connection isn't private" screen when accessing the server portal for the first time after enabling HTTPS.
   Solution: To resolve this issue, install the pre-bundled Qualitia certificate to access the server without trust-related issues. Follow these steps:

   • Step 1: Download the Certificate
     Refer SSL Certificate | Steps-to-Download-the-SSL-Certificate.

   • Step 2: Install the Certificate
     Refer SSL Certificate | Steps-to-Install-SSL-Certificate-on-Your-Local-Machine.

   • Access the server using the URL: https://{domain name}.