Skip to content

Add guide for migrating RBAC with custom roles#6476

Merged
DreaminDani merged 2 commits into
mainfrom
docs/migrating-rbac-custom-roles
Jul 2, 2026
Merged

Add guide for migrating RBAC with custom roles#6476
DreaminDani merged 2 commits into
mainfrom
docs/migrating-rbac-custom-roles

Conversation

@DreaminDani

Copy link
Copy Markdown
Contributor

Summary

Adds a new guide, Migrating RBAC with custom roles, under Security > Cloud access management. It covers:

  • A high-level explanation of the new role-based access control (RBAC) system — custom role definitions and more granular organization, service, and database permissions.
  • How to complete the migration wizard: creating roles for permissions that can't be migrated automatically, assigning a role to every member, invitation, and API key, and keeping at least one Administrator.
  • What happens for organizations that don't complete the migration in time — an automated migration creates one role per user and one per API key mirroring existing permissions, so no access is lost.
  • Post-migration follow-ups: reviewing OpenAPI and Terraform configurations, and the Query Endpoints → Basic service API reader transition.

Links to Console roles and permissions and Manage custom roles. Also adds a row to the Cloud access management index.

How it renders

Placed in the sidebar directly after "Manage custom roles" (03b_ prefix). Verified locally — page builds and renders cleanly.

🤖 Generated with Claude Code

Adds a guide under Security > Cloud access management explaining the new
role-based access control system, how to complete the migration wizard,
and what happens if an organization doesn't migrate before the deadline.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@DreaminDani DreaminDani requested a review from a team as a code owner July 1, 2026 18:17
@vercel

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jul 1, 2026 8:31pm
4 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-jp Ignored Ignored Jul 1, 2026 8:31pm
clickhouse-docs-ko Ignored Ignored Preview Jul 1, 2026 8:31pm
clickhouse-docs-ru Ignored Ignored Preview Jul 1, 2026 8:31pm
clickhouse-docs-zh Ignored Ignored Preview Jul 1, 2026 8:31pm

Request Review

Simplify two sentences flagged by the Oxford comma / complex-sentence
check and remove the "note that" phrase.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@DreaminDani DreaminDani merged commit 3b04fd1 into main Jul 2, 2026
17 checks passed
@mintlify

mintlify Bot commented Jul 2, 2026

Copy link
Copy Markdown

Docs PR opened: ClickHouse/mintlify-docs-dev#316

Added a new Cloud access management guide covering how administrators migrate to the new RBAC system using the migration wizard.

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