🔐HTTPS & SSL Configuration for Qualitia Server

Qualitia Automation Studio (QAS) now supports a secure server portal powered by SSL certificates and HTTPS encryption, enabling authenticated and protected communication between the Qualitia Client and Server. This enhancement is essential for maintaining data security, privacy, and for enabling features like Single Sign-On (SSO).

🚀 Default HTTPS Setup for Fresh Installations

Fresh installations now launch over HTTPS by default using pre-bundled SSL certificates on port 443, with no manual configuration required.

⚠️ Important: To use SSO, your server must run on HTTPS. SSO is not supported on HTTP.

You can still switch between HTTP and HTTPS manually, but HTTPS is strongly recommended for security and full feature compatibility.

🔒 What is an SSL Certificate?

An SSL (Secure Sockets Layer) certificate is a digital certificate that authenticates a server’s identity and establishes an encrypted connection. Installing an SSL certificate upgrades your server access from HTTP to HTTPS, ensuring secure, tamper-proof communication.

📚 Prerequisites

• Ensure that your DNS server is properly configured for the server URL.

✅ Steps to Configure DNS 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 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.

⚙️ Manual Configuration for Custom SSL Certificates (Other than Qualitia)

If you're using your own SSL certificates:

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.

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

💻 Install the SSL Certificate Locally

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 enabling HTTPS, if the portal doesn’t load correctly, try reloading the page or restarting the server.

🔄 Configure CI/CD 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 Install the SSL Certificate Locally 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 with 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 SSL Port and 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. Enter 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 Download the SSL Certificate.

   • Step 2: Install the Certificate
     Refer Install the SSL Certificate Locally.

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