Install Self-Signed SSL for Faveo on Ubuntu

Introduction:

This document will guide on how to install Self-Signed SSL certificates on Ubuntu with nginx.

Setting up the SSL certificate

To Install Self Signed SSL certificates in Ubuntu, We need to create SSL Cetificates which is signed by the CA certificate, after that we need to add the Virtual host file for the SSL certificate and edit the php.ini file and the hosts file the steps are explained below.

Steps

Generate a private key for the CA (Certificate Authority).
Generate a certificate signing request for the CA.
Generate a root certificate.
Create a private key for the certificate.
Create a certificate signing request.
Create a certificate and sign it with the CA private key.
Installing the SSL certificate.

Generate a private key for the CA

Create a directory named SSL in the home or on any directory, the following commands will create the SSL files those files will be saved in the directory which we create.

From the SSL folder that was created run the below commands.
Run the below command to create a Private key for the rootCA this command will save a file name faveoroot.key in the SSL folder.

openssl ecparam -out faveoroot.key -name prime256v1 -genkey

Generate a certificate signing request for the CA

Run the below command which will create a CSR (certificate signing request) for the Root CA.

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

The above command will ask for the below information if needed you can provide them or you can just hit enter and skip them but it is recommended to give the meaningful details.
- Country Name.
- State Name.
- Organization.
- Comman name (Leave this as blank or provide the company domain not the faveo domain)
- Email address.
The above command will save a file in the name faveoroot.csr in the SSL directory.

Generate a root certificate

The below ccommand will create the Root CA certificate which we will use to sign the SSL certificates.

openssl x509 -req -sha256 -days 3650 -in faveoroot.csr -signkey faveoroot.key -out faveorootCA.crt

The above command will create a file and save it as faveorootCA.crt in the SSL directory.

Create a private key for the certificate

The below command will create a private key file for the server SSL certificate.

openssl ecparam -out private.key -name prime256v1 -genkey

The above command will save a key file with the name private.key for the server SSL certificate.

Create a certificate signing request for the server SSL

The below command will create a Certificate Signing Request for the Server webpage SSL.

openssl req -new -sha256 -key private.key -out faveolocal.csr

It will ask for the details as below we should give the details as shown below.
- Country Name.
- State Name.
- Organization.
- Common name (Here please provide the Domain or the IP through which you need to access faveo)).
- Email address.
The rest can be left blank and after this is completed it will create the CSR file and save it with the name faveolocal.csr in the SSL directory.

Create a certificate and sign it with the CA private key

The below command will create the server SSL certificate which is signed by the Root CA that we created above.

openssl x509 -req -in faveolocal.csr -CA  faveorootCA.crt -CAkey faveoroot.key -CAcreateserial -out faveolocal.crt -days 3650 -sha256 

The above command will create a server SSL file and save it in the name faveolocal.crt, this certificate will be valid for 3650 days that is ten years.

Setting up the Virtual host file for the Self signed SSL certificate’s.

Before creating the Virtual host file for SSL we need to copy the created SSL certificate’s and Key file to the corresponding directory with below command, these commands should be runned from the SSL Directory.
```
cp faveolocal.crt /etc/ssl/certs
cp private.key /etc/ssl/private
cp faveorootCA.crt /usr/local/share/ca-certificates/
```
Then adding the Virtual host file, for that we need to create a file in webserver directory as /etc/nginx/sites-available/faveo.conf

nano /etc/nginx/sites-available/faveo.conf

Then need to copy the below configuration inside the faveo.conf file.

server {
    listen 80;
    listen [::]:80;
    root /var/www/faveo/public;
    index  index.php index.html index.htm;
    server_name  ---DomainName or IP---;

     client_max_body_size 100M;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
               include snippets/fastcgi-php.conf;
               fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
               fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
               include fastcgi_params;
    }
    listen 443 ssl;
    ssl_certificate /etc/ssl/certs/faveolocal.crt;
    ssl_certificate_key /etc/ssl/private/private.key;
    ssl_trusted_certificate /usr/local/share/ca-certificates/faveorootCA.crt;
}

After Creating the Virtual Host file we need to add the local host for the domain.

Then need to update the CA certificate’s to that run the below command.
```
sudo update-ca-certificates
```
After adding the SSL certificates and virtual hosts we need to add the domain to the hosts file to the local host as below.
```
nano /etc/hosts
```
In the above file add the below line replace the domain or the IP which is used for the faveo.
```
127.0.0.1  ---Domain or IP---
```
After the above is done then we need to add the the ca-cert file path to the /etc/php/8.2/fpm/php.ini file add the path to the openssl.cafile like this :
```
openssl.cafile = "/etc/pki/tls/certs/ca-bundle.crt"
```
```
systemctl restart php8.2-fpm
systemctl restart nginx
```
Now check the faveo on the Browser it will take you to probe page, if everything is good then you can proceed with the installation in Browser.