Skip to content

Commit b5b8104

Browse files
committed
doc/mgr/dashboard: add note that only RSA keys are supported for TLS
The dashboard module fails to start when configured with ECDSA/EC private keys due to pyOpenSSL limitations ("key type unsupported"). Add a note to the SSL/TLS documentation advising users to use RSA keys until ECDSA is supported. References: https://tracker.ceph.com/issues/73324 Signed-off-by: Martin Koch <[email protected]>
1 parent 7d5298b commit b5b8104

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

doc/mgr/dashboard.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -244,6 +244,19 @@ For example, a key pair can be generated with a command similar to:
244244
-subj "/O=IT/CN=ceph-mgr-dashboard" -days 3650 \
245245
-keyout dashboard.key -out dashboard.crt -extensions v3_ca
246246

247+
.. note::
248+
249+
Currently, the Ceph Dashboard supports only RSA private keys for SSL/TLS
250+
certificates. If you attempt to configure the dashboard with an ECDSA/EC
251+
key, the module will fail to start with an error similar to:
252+
253+
``MGR_MODULE_ERROR: Module 'dashboard' has failed: key type unsupported``
254+
255+
This limitation exists because the verification routine in the Ceph Manager
256+
uses pyOpenSSL, which supports only RSA keys in its
257+
``PKey.check()`` method. Until this restriction is lifted, generate or
258+
request certificates with RSA keys.
259+
247260
The ``dashboard.crt`` file should then be signed by a CA. Once that is done, you
248261
can enable it for Ceph manager instances by running the following commands:
249262

0 commit comments

Comments
 (0)