pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
Deprecated openssl command option in documentation
2+ messages / 2 participants
[nested] [flat]

* Deprecated openssl command option in documentation
@ 2025-06-18 11:24  PG Doc comments form <noreply@postgresql.org>
  0 siblings, 1 reply; 2+ messages in thread

From: PG Doc comments form @ 2025-06-18 11:24 UTC (permalink / raw)
  To: pgsql-docs@lists.postgresql.org; +Cc: mg2216@cam.ac.uk

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/ssl-tcp.html
Description:

Hi
In the documentation at https://www.postgresql.org/docs/17/ssl-tcp.html, it
says, in 18.9.5. Creating Certificates:
```
To create a simple self-signed certificate for the server, valid for 365
days, use the following OpenSSL command, replacing dbhost.yourdomain.com
with the server's host name:
openssl req -new -x509 -days 365 -nodes -text -out server.crt \
  -keyout server.key -subj "/CN=dbhost.yourdomain.com"
```
However, on Ubuntu, running "openssl req --help" shows the following:
```
Output options:
...
 -noenc                Don't encrypt private keys
 -nodes                Don't encrypt private keys; deprecated
```
Therefore, I suggest you replace the "-nodes" switch in the command example
to "-noenc".
Ubuntu version:
```
$ cat /etc/os-release
PRETTY_NAME="Ubuntu 22.04.5 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.5 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/";
SUPPORT_URL="https://help.ubuntu.com/";
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/";
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy";
UBUNTU_CODENAME=jammy
```


^ permalink  raw  reply  [nested|flat] 2+ messages in thread

* Re: Deprecated openssl command option in documentation
@ 2025-06-18 11:59  Daniel Gustafsson <daniel@yesql.se>
  parent: PG Doc comments form <noreply@postgresql.org>
  0 siblings, 0 replies; 2+ messages in thread

From: Daniel Gustafsson @ 2025-06-18 11:59 UTC (permalink / raw)
  To: mg2216@cam.ac.uk; pgsql-docs@lists.postgresql.org

> On 18 Jun 2025, at 13:24, PG Doc comments form <noreply@postgresql.org> wrote:

> -noenc                Don't encrypt private keys
> -nodes                Don't encrypt private keys; deprecated
> ```
> Therefore, I suggest you replace the "-nodes" switch in the command example
> to "-noenc".

Thanks for your report!

The noenc option, and subsequent deprecation notice on nodes, came in OpenSSL
3.0 but PostgreSQL still support OpenSSL 1.1.1.  nodes is still available in
the recent 3.5 version so sticking with it is the safe option for us (until we
deprecate 1.1.1 support, which is a fair bit into the future).

--
Daniel Gustafsson






^ permalink  raw  reply  [nested|flat] 2+ messages in thread


end of thread, other threads:[~2025-06-18 11:59 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2025-06-18 11:24 Deprecated openssl command option in documentation PG Doc comments form <noreply@postgresql.org>
2025-06-18 11:59 ` Daniel Gustafsson <daniel@yesql.se>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox