Skip to content

Fixes #28449: Complete documlentation for the new HTTPS protocol#1133

Open
m-bouissou wants to merge 2 commits intoNormation:branches/rudder/9.0from
m-bouissou:bug_28449/complete_documlentation_for_the_new_https_protocol
Open

Fixes #28449: Complete documlentation for the new HTTPS protocol#1133
m-bouissou wants to merge 2 commits intoNormation:branches/rudder/9.0from
m-bouissou:bug_28449/complete_documlentation_for_the_new_https_protocol

Conversation

@m-bouissou
Copy link
Copy Markdown
Contributor

@m-bouissou m-bouissou requested a review from ncharles February 27, 2026 15:25
Copy link
Copy Markdown
Member

@ncharles ncharles left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a nice change, but there are some typos and imprecision that needs to be corrected

Comment thread src/reference/modules/administration/pages/security.adoc Outdated

**Certificates with node ID in SAN**

By default the server looks for the node id in the certificate in the `UID` value of the `DN`. But it is not always possible to sign such certificates. In this case it is possible to move the node into into the Subject Alternative Name (`SAN`) part of the certificate.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"it is not always possible to sign such certificates." isn't the issue in creating this certificate, or issuing this certificate ?

"move the node into into" -> "move the node ID"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Double into will be fixed in upcoming fixup.

The issue is with obtaining the signed certificate from a CA, it is always possible to generate a certificate request, but a commercial CA will almost always check that the provided DN resolves is DNS and that the requester has effetctive ownership of this machine, which boils down to “its reachable from the Internet using the name provided as DN”, which would not be possible with a node's UID of course.

So the phrasing looks correct to me if we don't want to enter long explanations, the documentation is already somewhat long and complex...

Comment thread src/reference/modules/administration/pages/security.adoc
Fixes #28449: Complete documlentation for the new HTTPS protocol
@m-bouissou
Copy link
Copy Markdown
Contributor Author

PR updated with a new commit

@m-bouissou m-bouissou requested a review from ncharles March 3, 2026 08:07
@amousset
Copy link
Copy Markdown
Member

@m-bouissou there is a typo to fix to allow merge

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants