examples: Switched to ed25519, nodes -> noenc
PATCH 1/1 examples: Switched to ed25519, nodes -> noenc
From: Eric Toombs <[email protected]...>
I switched the curve to ed25519, a generally more trustworthy curve and the default in openssh. As a bonus, it *really* simplifies what is already a complicated command.
The old command wouldn't even run in all shells because it used process substitution.
'nodes' is deprecated in favour of 'noenc', so I switched that too.
--- doc/man-sections/example-fingerprint.rst | 4 ++-- doc/man-sections/examples.rst | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-)
doc/man-sections/example-fingerprint.rst +2 -2
@@ -18,7 +18,7 @@ Server setup 2. Generate a self-signed certificate for the server: :: - openssl req -x509 -newkey ec:<(openssl ecparam -name secp384r1) -keyout server.key -out server.crt -nodes -sha256 -days 3650 -subj '/CN=server' + openssl req -x509 -newkey ed25519 -keyout server.key -out server.crt -noenc -sha256 -days 3650 -subj '/CN=server' 3. Generate SHA256 fingerprint of the server certificate
@@ -85,7 +85,7 @@ Adding a client different name for each client. :: - openssl req -x509 -newkey ec:<(openssl ecparam -name secp384r1) -nodes -sha256 -days 3650 -subj '/CN=alice' + openssl req -x509 -newkey ed25519 -noenc -sha256 -days 3650 -subj '/CN=alice' This generate a certificate and a key for the client. The output of the command will look something like this:
doc/man-sections/examples.rst +3 -3
@@ -95,12 +95,12 @@ First build a self-signed certificate on bob and display its fingerprint. :: - openssl req -x509 -newkey ec:<(openssl ecparam -name secp384r1) -keyout bob.pem -out bob.pem -nodes -sha256 -days 3650 -subj '/CN=bob' + openssl req -x509 -newkey ed25519 -keyout bob.pem -out bob.pem -noenc -sha256 -days 3650 -subj '/CN=bob' openssl x509 -noout -sha256 -fingerprint -in bob.pem and the same on alice:: - openssl req -x509 -newkey ec:<(openssl ecparam -name secp384r1) -keyout alice.pem -out alice.pem -nodes -sha256 -days 3650 -subj '/CN=alice' + openssl req -x509 -newkey ed25519 -keyout alice.pem -out alice.pem -noenc -sha256 -days 3650 -subj '/CN=alice' openssl x509 -noout -sha256 -fingerprint -in alice.pem
@@ -132,7 +132,7 @@ On alice:: ping 10.4.0.1 -Note: This example use a elliptic curve (`secp384`), which allows +Note: This example use a elliptic curve (`ed25519`), which allows ``--dh`` to be set to ``none``. Example 3: A tunnel with full PKI and TLS-based security
Signature · 1 line
2.45.2
Am 30.07.2024 um 19:00 schrieb Eric Toombs via Openvpn-devel:
Quoted 1 line
From: Eric Toombs <[email protected]...>
We prefer real email addresses in our commits.
Quoted 6 lines
I switched the curve to ed25519, a generally more trustworthy curve and the default in openssh. As a bonus, it *really* simplifies what is already a complicated command.
The old command wouldn't even run in all shells because it used process substitution.'nodes' is deprecated in favour of 'noenc', so I switched that too.
While ed25519 might have its advantages, its usage in X509 certificates is really really uncommon. I have seen more brainpoool usages in the wild than ed25519. It is also not allowed on hosts that use FIPS settings and also older OpenVPN clients/OpenSSL clients might not support it. Also in contrast to secp384r1, I know absolutely no secure certficate store that supports it (Android Keystore, YubiKey and so on all support secp384r1 but there is no ed25519 support). So I don't think we are at the point where we want to recommend in an easy-to-setup guide a group/curve that is a lot less supported to the basically universially supported secp384r1.
So for the purpose of this guide, I think secp384r1 is a much better choice compared to ed25519.
Arne