Modify Root URL for HTTPS in the SSP Application

To use HTTPS with the local server in the SSP application, you need to modify the ROOT variable to point to your secure domain. This ensures that your application can serve requests securely over HTTPS, which is crucial for data protection and security, especially in development environments.

Generate SSL Certificates and Private Keys

To access a secure domain via HTTPS when running the local server, you must generate an SSL certificate and a private key. Since the local server is only for testing purposes, a self-signed certificate is typically sufficient.

Steps to Generate SSL Certificate and Private Key

1. Download and Install OpenSSL.
2. Generate an RSA Private Key:
   Run the following command:
   bashCopy

   openssl genrsa -des3 -out ca.key 1024  

   Enter and confirm a password for the certificate. This password will be used in later steps.
3. Create a New SSL Certificate:
   Run the following command:
   bashCopy

   openssl req -new -sha256 -key ca.key -out ca.csr  

   Accept the defaults for fields; the only field required is localhost.
4. Create a Self-Signed Certificate:
   bashCopy

   openssl x509 -req -days 3600 -in ca.csr -out ca.crt -signkey ca.key  

5. Create a Server Key:
   bashCopy

   openssl genrsa -des3 -out server.key 1024  

6. Create a Certificate Signing Request (CSR):
   bashCopy

   openssl req -new -sha256 -key server.key -out server.csr  

7. (Optional) Remove the Password from the Server Certificate:
   bashCopy

   openssl rsa -in server.key.org -out server.key  

8. Create a Self-Signed Server Certificate:
   bashCopy

   openssl x509 -req -sha256 -days 3600 -in server.csr -signkey server.key -out server.crt  

Configure the KEYPEM and CERTPEM Environment Variables

After generating your certificates, define environment variables that point to these files to use them within your server configuration:

• KEYPEM: <path_to_file>/server.key
• CERTPEM: <path_to_file>/server.crt

For example, on Windows:

set KEYPEM=c:\OpenSSL-Win64\server.key  
set CERTPEM=c:\OpenSSL-Win64\server.crt  

Install the Generated Certificates

To enable your generated SSL and server certificates for browser access, use the Certificate Import Wizard on Windows:

1. Run the server.crt file.
2. Click Install Certificate and follow the wizard steps to place it in Trusted Root Certification Authorities.

Modify the Root URL of the SSP Application

To use HTTPS, change the value of the ROOT variable in your SSP application's index-local.ssp file:

1. Open <SCA_Source_Root>/index-local.ssp.
2. Update the ROOT variable:
   noneCopy

   var ROOT = 'https://localhost:7778/'  

3. Compile and deploy the application using:
   bashCopy

   gulp deploy  

Access the Local Server Using a Secure URL

To access your local server securely:

1. Run:
   bashCopy

   gulp local  

2. Access it via:
   noneCopy

   https://mysite.com/c.<account_id>/<SSP_application>/shopping-local.ssp  

Now, your local server should run securely over HTTPS, allowing you to develop and test under secure conditions.