Install Self-Signed SSL for Faveo on Alma Linux

Introduction

This document will guide on how to install Self-Signed SSL certificates on Alma Linux with apahce.

Setting up the SSL certificate

To Install Self Signed SSL certificates in Amla Linux 9, 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.

We need to enable some Modules for the ssl as below :
```
dnf install mod_ssl
systemctl restart httpd
```
The above will install mod_ssl module and restart apache.
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/pki/tls/certs
cp private.key /etc/pki/tls/private
cp faveorootCA.crt /etc/pki/ca-trust/source/anchors/
```
Then adding the Virtual host file, for that we need to create a file in webserver directory as /etc/httpd/conf.d/faveo-ssl.conf.

nano /etc/httpd/conf.d/faveo-ssl.conf

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

<IfModule mod_ssl.c>
        <VirtualHost *:443>
                ServerAdmin ---DomainName or IP---

                DocumentRoot /var/www/faveo/public

                ErrorLog /var/log/httpd/faveo-error.log 
                CustomLog /var/log/httpd/faveo-access.log combined

                SSLEngine on

                SSLCertificateFile      /etc/pki/tls/certs/faveolocal.crt
                SSLCertificateKeyFile /etc/pki/tls/private/private.key

                <FilesMatch "\.(cgi|shtml|phtml|php)$">
                                SSLOptions +StdEnvVars
                </FilesMatch>
                <Directory /usr/lib/cgi-bin>
                                SSLOptions +StdEnvVars
                </Directory>

        </VirtualHost>
</IfModule>

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

Need to update the CA certificate’s run the below command to update the CA certs.
```
update-ca-trust extract
```
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 php.ini file add the path to the openssl.cafile like this : “openssl.cafile = “/etc/pki/tls/certs/ca-bundle.crt”
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.