docs: clarify ExtensionTLS type

[nareddyt]

Current document says to mount a secret that has a TLS private key. This is incorrect - Envoy Gateway acting as a client should not receive any private key.

Envoy Gateway doesn't support mTLS when connecting to extension server, so there is no need for private key today. This is verified by reading the code. EG is only looking for tls.crt

gateway/internal/extension/registry/extension_manager.go

Lines 265 to 276 in 28e1a48

	certRef := ext.Service.TLS.CertificateRef
	secret, secretNamespace, err := kubernetes.ValidateSecretObjectReference(ctx, client, &certRef, namespace)
	if err != nil {
	return nil, err
	}
	cp, err := parseCA(secret)
	if err != nil {
	return nil, fmt.Errorf("error parsing cert in Secret %s in namespace %s", string(certRef.Name), secretNamespace)
	}
	creds = credentials.NewClientTLSFromCert(cp, "")

Cert-manager docs explain this concept concisely, so link directly to it.

Release Notes: No

[guydc]

The implementation right now is a bit confusing. tls.crt should usually be a certificate to be used by the process as either a client or a server certificate, not as a trusted CA. ca.crt, also as seen in the referenced docs, is more appropriate here.

I propose that we adopt something similar to GW-API caCertificateRefs here to avoid the confusion.

Regarding the change at hand: I would avoid linking cert-manager here, and keep it more concise, like:

CertificateRef is a reference to a Kubernetes Secret with a CA certificate in a key named tls.crt. The CA certificate is used by Envoy Gateway the verify the server certificate presented by the extension server. At this time, Envoy Gateway does not support Client Certificate authentication of Envoy Gateway towards the extension server"

[nareddyt]

Thanks for the quick review @guydc ! Overall agree with what you said. Updated docs to match current state

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 67.94%. Comparing base (6022624) to head (449d9f3).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #5154   +/-   ##
=======================================
  Coverage   67.94%   67.94%           
=======================================
  Files         214      214           
  Lines       33522    33522           
=======================================
+ Hits        22776    22777    +1     
+ Misses       9358     9357    -1     
  Partials     1388     1388           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[zirain]

@nareddyt can you run make -k gen-check to make CI happy?

[nareddyt]

Sorry for the delay @zirain . Can I get another +1 @guydc ?