# Native SSL via ZeroSSL

{% hint style="danger" %}
**ZeroSSL is not recommended as a free implementation; instead, use**[ Let's Encrypt.](https://docs.emaildelivery.com/docs/options-for-adding-https/free-native-ssl-via-lets-encrypt)
{% endhint %}

{% hint style="danger" %}
**Only use ZeroSSL if you have a compelling reason such as being a commercial customer with a paid certificate.**&#x20;
{% endhint %}

{% hint style="info" %}
Before you begin, make sure Port 443 is open and unblocked by any other application, firewall, or SELinux policies on your server.&#x20;
{% endhint %}

We use ZeroSSL instead of Let's Encrypt as our native SSL implementation for a simpler and more streamlined integration.&#x20;

[ZeroSSL](https://zerossl.com/) allows you to generate trusted certificates through an online wizard right on the front page of their site and download them to your desktop in a zip file:

{% embed url="<https://zerossl.com/>" %}

To get started with ZeroSSL, enter your platform domain name, including subdomain, into the wizard right at the top of their website:

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FuyPFStwzgNE5QvEiGvnN%2Fimage.png?alt=media&#x26;token=96380343-64c3-4d79-941b-dfd9d74d9da3" alt=""><figcaption></figcaption></figure>

Walk through the wizard until you reach the **Verification** step.&#x20;

{% hint style="info" %}
Choose **DNS CNAME** for your Verification Method
{% endhint %}

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FecToGTdZ2oNKYdr7g2Ms%2Fverification.png?alt=media&#x26;token=fb15f7ca-4753-4e9c-9d10-93ccdfcb3831" alt=""><figcaption></figcaption></figure>

Create a CNAME record on your DNS hosting provider and copy over the content from ZeroSSL:

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FrgdmLNKXs2bhkF3cZOng%2FScreenshot%202023-09-17%20at%2011.53.45%20PM.png?alt=media&#x26;token=429cd744-cc9c-4ce7-9f74-3a3d14f52edc" alt=""><figcaption></figcaption></figure>

Using Cloudflare for our example, we'll click Add record and select CNAME from the dropdown

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2F6S4Ueh30lgs2j9Z4VWxu%2Faddrecordcloudflare.png?alt=media&#x26;token=65797f15-d485-48ab-94fb-a6a2812712e1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2F2zBVU6Apse8yd2MAmuqD%2Fcnamecloudflare.png?alt=media&#x26;token=3b7d5a1a-a15a-49bf-80cc-7afbf8879f77" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2F3yFZW05pAiSjonVfXbQY%2FScreenshot%202023-09-17%20at%2011.55.46%20PM.png?alt=media&#x26;token=672aec4d-9e25-41f6-a061-464f4e93b507" alt=""><figcaption></figcaption></figure>

Back on ZeroSSL click **Next Step** then **Verify Domain**:

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FZDRMPUKTM99r6YSwMn16%2FScreenshot%202023-09-17%20at%2011.56.00%20PM.png?alt=media&#x26;token=59c84261-2b55-4161-a2a8-15435b175e15" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Verified!
{% endhint %}

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FTXy1ghpn9cLXalwXxQ7s%2FScreenshot%202023-09-17%20at%2011.56.09%20PM.png?alt=media&#x26;token=e42262e3-be37-4dc2-83bc-5c533fa1ba87" alt=""><figcaption></figcaption></figure>

Download the zip file and you're done on the ZeroSSL website. &#x20;

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2Fjmz1XSC20izIQmRvap4l%2FScreenshot%202023-09-17%20at%2011.56.53%20PM.png?alt=media&#x26;token=d02bbaaf-6efa-4eda-894f-ef5bdd92a7d6" alt=""><figcaption></figcaption></figure>

Now that you've authenticated your domain with ZeroSSL and downloaded the zip file, you're going to need to copy the zip ZeroSSL provided you with to your platform installation server:

```
scp esp.fivetacofiesta.com.zip root@137.184.6.0:/root
```

Back on the server we're going to extract the archive:

```
unzip esp.fivetacofiesta.com.zip
```

You'll see the archive has extracted three files into the current directory:

```
Archive:  esp.fivetacofiesta.com.zip
 extracting: certificate.crt         
 extracting: ca_bundle.crt           
 extracting: private.key 
```

Now we're going to combine two of the files into a new file using the cat command:

```
cat certificate.crt ca_bundle.crt > certificate_chain.crt
```

Copy our newly created file into the proper directory

```
mv certificate_chain.crt private.key edcom-install/config/
```

Change directory to your platform installation :

```
cd edcom-install
```

Run the automated SSL conversion script:

```
./convert_to_ssl.sh
```

Restart your platform:

```
./restart.sh
```

{% hint style="success" %}
**You're done.**&#x20;

You should now be able to access your platform using https\:// instead of http\://
{% endhint %}

{% hint style="info" %}
You'll need to log in again, as your previous non-SSL cookies are no longer valid.
{% endhint %}

Before ZeroSSL:

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2F6ulCmhu8gz429fPLhvcT%2FScreenshot%202023-09-18%20at%2012.31.35%20AM.png?alt=media&#x26;token=90ce2a48-17bc-4ae6-8cb3-155637aec114" alt=""><figcaption></figcaption></figure>

After ZeroSSL:&#x20;

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FzJ5spwhCUSn1LwHKyry0%2FScreenshot%202023-09-18%20at%2012.32.10%20AM.png?alt=media&#x26;token=b953a322-d15d-4d1c-a996-08d12d1f75d8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2024949584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHNgw7cfnOYHQr0B6GDXr%2Fuploads%2FPobAaRzecKqSQOcTCuqe%2FScreenshot%202023-09-18%20at%2012.32.57%20AM.png?alt=media&#x26;token=5745a5c2-d073-4bc8-9136-4a788e01cb7e" alt=""><figcaption></figcaption></figure>
