Skip to content

Commit 56bd8ba

Browse files
lfranckeclaude
andcommitted
Explain the openldap-tls SecretClass in the LDAP tutorial
The AuthenticationClass references an openldap-tls SecretClass for TLS server verification that the tutorial-openldap stack creates silently. Explain what it is and link to the TLS server verification concepts page so readers know how to create one for a real LDAP server. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent e77c74c commit 56bd8ba

2 files changed

Lines changed: 9 additions & 1 deletion

File tree

modules/tutorials/examples/ldap-auth/ldap-authenticationclass.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,4 @@ spec:
1515
verification:
1616
server:
1717
caCert:
18-
secretClass: openldap-tls
18+
secretClass: openldap-tls # <4>

modules/tutorials/pages/authentication_with_openldap.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,10 +120,18 @@ include::example$ldap-auth/ldap-authenticationclass.yaml[]
120120
<1> The name of the AuthenticationClass, which needs to be referenced later
121121
<2> The hostname in this case is the Service at which the OpenLDAP is running, inside of Kubernetes.
122122
<3> Here the SecretClass name is referenced
123+
<4> A SecretClass used to verify the LDAP server's TLS certificate, see below.
123124

124125
// [source,bash]
125126
// include::example$ldap-auth/30-install-openldap.sh[tag=apply-ldap-authenticationclass]
126127

128+
The AuthenticationClass connects to LDAP over TLS (port `1636`) and verifies the server's certificate against the CA provided by the `openldap-tls` SecretClass.
129+
You did not have to create that SecretClass: the `tutorial-openldap` stack installed it for you, together with the CA certificate that OpenLDAP's TLS certificate was signed with.
130+
131+
When you connect to a *real* LDAP server, this SecretClass does not exist yet and you have to create it yourself from your LDAP server's CA certificate.
132+
A SecretClass used only for server verification needs nothing but the CA certificate; it does not need a key.
133+
See xref:concepts:tls-server-verification.adoc[] for a complete, copy-pasteable example.
134+
127135
Remember the name of the AuthenticationClass (`openldap`), you will use it in the next steps when configuring the products.
128136

129137
[#superset]

0 commit comments

Comments
 (0)