Skip to content

Commit e616402

Browse files
micheleRPclaude
andauthored
DOC-1936: Document SR authorization enabled by default for Cloud (#581)
* DOC-1936: Document SR authorization enabled by default for Cloud Schema Registry Authorization is now enabled fleet-wide on BYOC and Dedicated clusters. The schema_registry_enable_authorization cluster property is set automatically at provisioning, and the predefined Admin, Writer, and Reader roles are seeded with Schema Registry permissions (subject/* and registry resources). Account impersonation also now supports Schema Registry as a separate subsystem from the Kafka API. - Add SR permissions table to predefined-roles partial - Update Account impersonation section to reflect per-subsystem toggles (Kafka API + Schema Registry) and the new default-role behavior - Add May 2026 What's New entries for SR auth-by-default and SR impersonation Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * DOC-1936: Accurately scope Writer role permissions in impersonation warning Writer lacks AlterConfigs and has no write ops at the registry resource level, so "full access" only applies to Admin. Split the bullet to reflect this. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 9b54736 commit e616402

3 files changed

Lines changed: 47 additions & 9 deletions

File tree

modules/get-started/pages/whats-new-cloud.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,14 @@ This page lists new features added to Redpanda Cloud.
88

99
== May 2026
1010

11+
=== Schema Registry Authorization enabled by default
12+
13+
Schema Registry Authorization is now enabled automatically on all new BYOC and Dedicated clusters. The xref:reference:properties/cluster-properties.adoc#schema_registry_enable_authorization[`schema_registry_enable_authorization`] cluster property is set to `true` at provisioning, and the predefined Admin, Writer, and Reader roles include Schema Registry permissions for the `subject` and `registry` ACL resource types. You can use ACLs and RBAC roles to grant fine-grained access to schemas and subjects without any additional setup. See xref:manage:schema-reg/schema-reg-authorization.adoc[Schema Registry Authorization] and xref:security:authorization/rbac/rbac.adoc#predefined-roles[Predefined roles].
14+
15+
=== Account impersonation: Schema Registry support
16+
17+
xref:security:cloud-authentication.adoc#account-impersonation[Account impersonation] now supports Schema Registry in addition to the Kafka API. With Schema Registry impersonation enabled, the schemas and subjects users see in the Redpanda Cloud UI match exactly what they can access with the Cloud API or `rpk`. You can enable impersonation independently for each subsystem from the *Dataplane settings* page.
18+
1119
=== Extended Serverless free trial
1220

1321
The free trial for Redpanda Serverless now lasts 30 days, up from 14 days. The $100 (USD) credit allowance and 7-day grace period are unchanged. Sign up at https://www.redpanda.com/try-data-streaming[redpanda.com^]. See xref:get-started:cluster-types/serverless.adoc[Serverless clusters].

modules/security/pages/cloud-authentication.adoc

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -115,27 +115,33 @@ Administrators can require MFA for all users in an organization.
115115

116116
=== Account impersonation
117117

118-
include::shared:partial$feature-flag.adoc[]
119-
120-
BYOC and Dedicated clusters support unified authentication and authorization between the Redpanda Cloud UI and Redpanda with account impersonation. With account impersonation enabled, the topics and resources users see in the UI match exactly what they can access with the Cloud API or `rpk`. You can use the same credentials to authenticate to both Redpanda Cloud and the underlying Redpanda cluster, with consistent permissions across all interfaces. This ensures accurate audit logs and unified identity enforcement across all client applications, including the Cloud UI.
118+
BYOC and Dedicated clusters support unified authentication and authorization between the Redpanda Cloud UI and Redpanda with account impersonation. With account impersonation enabled, the topics, schemas, and other resources users see in the UI match exactly what they can access with the Cloud API or `rpk`. You can use the same credentials to authenticate to both Redpanda Cloud and the underlying Redpanda cluster, with consistent permissions across all interfaces. This ensures accurate audit logs and unified identity enforcement across all client applications, including the Cloud UI.
121119

122120
* *Without account impersonation*: Redpanda Cloud uses a static service account to access your cluster. All UI requests appear to come from this generic admin user.
123-
* *With account impersonation*: Redpanda Cloud uses your individual user credentials and evaluates permissions using glossterm:ACL[,access control lists (ACLs)] and glossterm:RBAC[,role-based access control (RBAC)] in the data plane. Each user sees only the resources they have permission to access.
121+
* *With account impersonation*: Redpanda Cloud uses your individual user credentials and evaluates permissions using glossterm:ACL[,access control lists (ACLs)] and glossterm:RBAC[,role-based access control (RBAC)] in the data plane. Each user sees only the resources they have permission to access.
122+
123+
You can enable account impersonation independently for each subsystem:
124+
125+
* *Kafka API*: Impersonate users for topic, consumer group, and transaction operations.
126+
* *Schema Registry*: Impersonate users for schema and subject operations. Enabling Schema Registry impersonation also enables xref:manage:schema-reg/schema-reg-authorization.adoc[Schema Registry Authorization] on the cluster, and seeds Schema Registry permissions into the predefined Admin, Writer, and Reader roles. See xref:security:authorization/rbac/rbac.adoc#predefined-roles[Predefined roles].
124127

125128
To enable account impersonation:
126129

127-
. Go to the *Dataplane settings* page and select the option to enable account impersonation.
130+
. Go to the *Dataplane settings* page.
131+
. Enable impersonation for *Kafka API*, *Schema Registry*, or both.
128132
. Configure permissions for your users on the cluster *Security* page using ACLs or RBAC roles.
129133

130134
[IMPORTANT]
131135
====
132136
After enabling account impersonation:
133137
134-
* *Admin users* continue to have full access as before
135-
* *Reader and Writer users* will lose access to the cluster until you explicitly grant them permissions through ACLs or RBAC roles on the *Security* page
138+
* *Admin users* continue to have full Kafka and Schema Registry access through the predefined Admin role.
139+
* *Writer users* continue to have read and write permissions for Kafka topics and Schema Registry subjects through the predefined Writer role.
140+
* *Reader users* keep read access to topics, consumer groups, and Schema Registry subjects through the predefined Reader role.
141+
* *Custom roles or users without role bindings* will lose access until you explicitly grant them permissions through ACLs or RBAC roles on the *Security* page.
136142
137143
Plan to configure user permissions before or immediately after enabling this feature to avoid access disruption.
138-
====
144+
====
139145

140146
== Service authentication
141147

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,27 @@
1-
Redpanda Cloud provides several predefined roles that you cannot modify or delete, including Reader, Writer, and Admin.
1+
Redpanda Cloud provides several predefined roles that you cannot modify or delete, including Reader, Writer, and Admin.
22

33
Before assigning a role to a user or service account, review the *Organization IAM* - *Roles* tab to compare the full list of predefined roles and their permissions.
4+
5+
[NOTE]
6+
====
7+
On BYOC and Dedicated clusters, the Reader, Writer, and Admin roles include data plane permissions for the Schema Registry in addition to Kafka resources (topics, consumer groups, transactional IDs, and cluster operations). Permissions are scoped to the `subject` and `registry` ACL resource types.
8+
9+
[cols="1,3,2"]
10+
|===
11+
| Role | `subject` operations (resource name `*`) | `registry` operations (global)
12+
13+
| Reader
14+
| Read, Describe
15+
| Describe, DescribeConfigs
16+
17+
| Writer
18+
| Read, Write, Delete, Describe, DescribeConfigs
19+
| Describe, DescribeConfigs
20+
21+
| Admin
22+
| Read, Write, Delete, Describe, DescribeConfigs, AlterConfigs
23+
| Describe, DescribeConfigs, AlterConfigs
24+
|===
25+
26+
For more information on Schema Registry ACLs, including resource types and supported operations, see xref:manage:schema-reg/schema-reg-authorization.adoc[].
27+
====

0 commit comments

Comments
 (0)