Skip to content

Commit 882bd53

Browse files
Feediver1claude
andcommitted
Address Michele's review: location-explicit intro bullets and K8s gating for the troubleshooting H2
Two follow-ups from @micheleRP's final-pass review: 1. Intro bullets now name where each method is configured upfront (cluster-configuration property vs. listener settings in each broker's redpanda.yaml) so the cluster-config-vs-broker-config-file distinction lands before the reader gets into the per-method sections. Addresses @mattschumpert's March feedback. 2. Wrap the new 'Authentication and authorization troubleshooting' H2 in ifndef::env-kubernetes[] ... endif::[]. The partial is included by both modules/manage/pages/security/authentication.adoc (Linux) and modules/manage/pages/kubernetes/security/authentication/k-authentication.adoc (sets :env-kubernetes: true). The resolution step uses systemctl restart redpanda, which doesn't apply on Kubernetes. A platform-agnostic rewrite (or a K8s-specific variant) can be a follow-up if needed. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 427dd39 commit 882bd53

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

modules/manage/partials/authentication.adoc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -458,8 +458,8 @@ rpk cluster config edit
458458

459459
Redpanda provides the following options for enabling SASL authentication:
460460

461-
* *`enable_sasl`*: A legacy (not deprecated) approach that is maintained for backwards compatibility. It applies SASL globally to all Kafka listeners with a single command.
462-
* *Per-listener configuration*: A more flexible approach that lets you configure different authentication methods on different listeners.
461+
* *`enable_sasl`*: A cluster-configuration property (set with `rpk cluster config set enable_sasl true`). A legacy (not deprecated) approach maintained for backwards compatibility. It applies SASL globally to all Kafka listeners with a single command.
462+
* *Per-listener configuration*: Listener settings in each broker's `redpanda.yaml`. A more flexible approach that lets you configure different authentication methods on different listeners.
463463

464464
Use the following criteria to help you select the best authentication option for your needs:
465465

@@ -2056,6 +2056,7 @@ redpanda:
20562056
----
20572057
endif::[]
20582058

2059+
ifndef::env-kubernetes[]
20592060
== Authentication and authorization troubleshooting
20602061

20612062
This section covers common authentication and authorization issues you may encounter and how to resolve them.
@@ -2153,6 +2154,7 @@ Verify the fix by checking the role again and testing schema registration.
21532154
* Only enable `schema_registry_enable_authorization` when the cluster is stable.
21542155
* Avoid enabling during cluster restarts or controller failovers.
21552156
* Verify role completeness after enabling Schema Registry authorization.
2157+
endif::[]
21562158

21572159
== Generate security report
21582160

0 commit comments

Comments
 (0)