0
edits
Changes
How to generate TLS certificates (Windows)? (view source)
Revision as of 09:58, 28 March 2023
, 09:58, 28 March 2023Created page with "==Introduction== '''Transport Layer Security''' ('''TLS''') is a cryptographic protocol that provides communications security over a computer network and is also the successo..."
==Introduction==
'''Transport Layer Security''' ('''TLS''') is a cryptographic protocol that provides communications security over a computer network and is also the successor to SSL.
The TLS protocol aims primarily to provide privacy and data integrity between two communicating computer applications. When secured by TLS, connections between a client and a server have one or more of the following properties:
* The connection is private (or secure) because symmetric cryptography is used to encrypt the data transmitted. The keys for this symmetric encryption are generated uniquely for each connection and are based on a shared secret negotiated at the start of the session. The server and client negotiate the details of which encryption algorithm and cryptographic keys to use before the first byte of data is transmitted. The negotiation of a shared secret is both secure (the negotiated secret is unavailable to eavesdroppers and cannot be obtained, even by an attacker who places themselves in the middle of the connection) and reliable (no attacker can modify the communications during the negotiation without being detected).
* The identity of the communicating parties can be authenticated using public-key cryptography. This authentication can be made optional, but is generally required for at least one of the parties (typically the server).
* The connection ensures integrity because each message transmitted includes a message integrity check using a message authentication code to prevent undetected loss or alteration of the data during transmission.
This article provides a guide on how to generate your own TLS certificates and keys for OpenVPN connection that uses TLS authentication. This guide is aimed at Windows users.
==Step 1: installing OpenVPN software==
<ul>
<li>Download an OpenVPN installer file from <b>[https://openvpn.net/index.php/open-source/downloads.html here]</b>.<br>Run the downloaded file.</li>
<li>Before starting the installation process, <b>click 'Customize'</b>:<br>[[File:Mobility_device_configuration_examples_how_to_generate_tls_certificates_windows_1.png]]
</li>
<li>While in the 'Custom Installation' window, scroll down to <b>find OpenSSL Utilities → EasyRSA 3 Certificate Management Scripts</b>; make sure it is installed along with OpenVPN and <b>click 'Install Now'</b>:<br>[[File:Mobility_device_configuration_examples_how_to_generate_tls_certificates_windows_2.png]]
</li>
</ul>
==Step 2: preparing EasyRSA==
<ul>
<li>Now we can start preparing to generate certificates and keys. For this we'll be using the <b>EasyRSA 3</b> application that was installed along with OpenVPN.<br>EasyRSA commands have to be executed via the Windows Command Prompt. It can be opened by typing <i>cmd</i> in the Windows search bar (<i>Windows button + S</i>). When you launch it, make sure you <b>run it as administrator</b>:<br>[[File:Mobility_device_configuration_examples_how_to_generate_tls_certificates_windows_3.png]]
</li>
<li>Change the current directory to the EasyRSA folder. To do so, execute this command:<pre>cd "C:\Program Files\OpenVPN\easy-rsa"</pre></li>
<li>Launch EasyRSA:<pre>EasyRSA-Start.bat</pre></li>
<li>Before you can generate files with EasyRSA, you must first initialize a directory for the Public Key Infrastructure (PKI). This can be done with the following command:<pre>./easyrsa init-pki</pre></li>
</ul>
==Step 3: generating certificates and keys==
<ul>
<li>Now we can start generating the certificates and keys. Begin with the '''certificate authority''' ('''CA''') - the root certificate file that will be used to sign other certificates and keys:
<ul>
<pre>./easyrsa build-ca nopass</pre>
</ul>
<li>'''Common name''' must be the domain of your server. For example, when using flespi platform, it is ‘*.flespi.gw’. When prompted the sign and commit the certificate, type y and press "Enter".
'*.flespi.gw' – where * is flespi platform assigned 5 digit number.
</li>
<li>Next, build the '''server''' certificate and key:
<ul>
<pre>./easyrsa --subject-alt-name="DNS:*.flespi.gw" build-server-full platform nopass</pre>
</ul>
</li>
</ul>
==Step 4: setting up TLS encryption on flespi channel==
<ul>
* Enable TLS in '''Teltonika channel''' configuration and upload the '''pki/issued/platform.crt''' as a server certificates chain and '''pki/private/platform.key''' as a server private key:<br>
<br>
[[File:Mobility_device_configuration_examples_how_to_set_up_tls_encryption_on_flespi_1.png]]<br>
==Step 5: loading certificate to the device==
* Get the file '''pki/ca.crt'''<br>
'''Hint:''' change extension from '''ca.crt''' to '''root.pem''' to make it visible for the tool. This can be done with any text editing tool.<br>
[[File:TLS_Changing_extension.gif]]
* Go to '''Security tab → Certificates section → Upload''' and select the recently created '''root.pem''' file:<br>
* Go to the '''GPRS section''', switch the device to the new channel with TLS configured, enable TLS, save new settings to the device, and reboot it.<br>
[[File:TLS_Uploading_certificate.gif]]<br>
<br>
* In the channel’s '''Toolbox''' is the log records about successful connection and parsed data! <br>
[[File:Mobility_device_configuration_examples_how_to_set_up_tls_encryption_on_flespi_4.png]]<br>
</ul>
'''Transport Layer Security''' ('''TLS''') is a cryptographic protocol that provides communications security over a computer network and is also the successor to SSL.
The TLS protocol aims primarily to provide privacy and data integrity between two communicating computer applications. When secured by TLS, connections between a client and a server have one or more of the following properties:
* The connection is private (or secure) because symmetric cryptography is used to encrypt the data transmitted. The keys for this symmetric encryption are generated uniquely for each connection and are based on a shared secret negotiated at the start of the session. The server and client negotiate the details of which encryption algorithm and cryptographic keys to use before the first byte of data is transmitted. The negotiation of a shared secret is both secure (the negotiated secret is unavailable to eavesdroppers and cannot be obtained, even by an attacker who places themselves in the middle of the connection) and reliable (no attacker can modify the communications during the negotiation without being detected).
* The identity of the communicating parties can be authenticated using public-key cryptography. This authentication can be made optional, but is generally required for at least one of the parties (typically the server).
* The connection ensures integrity because each message transmitted includes a message integrity check using a message authentication code to prevent undetected loss or alteration of the data during transmission.
This article provides a guide on how to generate your own TLS certificates and keys for OpenVPN connection that uses TLS authentication. This guide is aimed at Windows users.
==Step 1: installing OpenVPN software==
<ul>
<li>Download an OpenVPN installer file from <b>[https://openvpn.net/index.php/open-source/downloads.html here]</b>.<br>Run the downloaded file.</li>
<li>Before starting the installation process, <b>click 'Customize'</b>:<br>[[File:Mobility_device_configuration_examples_how_to_generate_tls_certificates_windows_1.png]]
</li>
<li>While in the 'Custom Installation' window, scroll down to <b>find OpenSSL Utilities → EasyRSA 3 Certificate Management Scripts</b>; make sure it is installed along with OpenVPN and <b>click 'Install Now'</b>:<br>[[File:Mobility_device_configuration_examples_how_to_generate_tls_certificates_windows_2.png]]
</li>
</ul>
==Step 2: preparing EasyRSA==
<ul>
<li>Now we can start preparing to generate certificates and keys. For this we'll be using the <b>EasyRSA 3</b> application that was installed along with OpenVPN.<br>EasyRSA commands have to be executed via the Windows Command Prompt. It can be opened by typing <i>cmd</i> in the Windows search bar (<i>Windows button + S</i>). When you launch it, make sure you <b>run it as administrator</b>:<br>[[File:Mobility_device_configuration_examples_how_to_generate_tls_certificates_windows_3.png]]
</li>
<li>Change the current directory to the EasyRSA folder. To do so, execute this command:<pre>cd "C:\Program Files\OpenVPN\easy-rsa"</pre></li>
<li>Launch EasyRSA:<pre>EasyRSA-Start.bat</pre></li>
<li>Before you can generate files with EasyRSA, you must first initialize a directory for the Public Key Infrastructure (PKI). This can be done with the following command:<pre>./easyrsa init-pki</pre></li>
</ul>
==Step 3: generating certificates and keys==
<ul>
<li>Now we can start generating the certificates and keys. Begin with the '''certificate authority''' ('''CA''') - the root certificate file that will be used to sign other certificates and keys:
<ul>
<pre>./easyrsa build-ca nopass</pre>
</ul>
<li>'''Common name''' must be the domain of your server. For example, when using flespi platform, it is ‘*.flespi.gw’. When prompted the sign and commit the certificate, type y and press "Enter".
'*.flespi.gw' – where * is flespi platform assigned 5 digit number.
</li>
<li>Next, build the '''server''' certificate and key:
<ul>
<pre>./easyrsa --subject-alt-name="DNS:*.flespi.gw" build-server-full platform nopass</pre>
</ul>
</li>
</ul>
==Step 4: setting up TLS encryption on flespi channel==
<ul>
* Enable TLS in '''Teltonika channel''' configuration and upload the '''pki/issued/platform.crt''' as a server certificates chain and '''pki/private/platform.key''' as a server private key:<br>
<br>
[[File:Mobility_device_configuration_examples_how_to_set_up_tls_encryption_on_flespi_1.png]]<br>
==Step 5: loading certificate to the device==
* Get the file '''pki/ca.crt'''<br>
'''Hint:''' change extension from '''ca.crt''' to '''root.pem''' to make it visible for the tool. This can be done with any text editing tool.<br>
[[File:TLS_Changing_extension.gif]]
* Go to '''Security tab → Certificates section → Upload''' and select the recently created '''root.pem''' file:<br>
* Go to the '''GPRS section''', switch the device to the new channel with TLS configured, enable TLS, save new settings to the device, and reboot it.<br>
[[File:TLS_Uploading_certificate.gif]]<br>
<br>
* In the channel’s '''Toolbox''' is the log records about successful connection and parsed data! <br>
[[File:Mobility_device_configuration_examples_how_to_set_up_tls_encryption_on_flespi_4.png]]<br>
</ul>