Skip to content

docs: clarify Data Sources tab permission requirement for custom roles#6327

Closed
dhtclk wants to merge 1 commit into
mainfrom
permission-callout
Closed

docs: clarify Data Sources tab permission requirement for custom roles#6327
dhtclk wants to merge 1 commit into
mainfrom
permission-callout

Conversation

@dhtclk
Copy link
Copy Markdown
Collaborator

@dhtclk dhtclk commented Jun 2, 2026

What

Adds two :::note admonitions clarifying that the Data Sources tab in the ClickHouse Cloud console is gated on control-plane:service:manage ("Manage and Delete Selected Services" in the UI), not on control-plane:service:manage-clickpipes.

Custom roles built with only the ClickPipes permission won't see the Data Sources tab, which covers ClickPipes, data lake integrations, and file uploads.

Changes

  • docs/cloud/reference/09_security/01_console-roles.md — note after the Console Permissions table.
  • docs/cloud/guides/security/01_cloud_access_management/03_manage-custom-roles.md — note inside the permission-scope step, beside the existing :::tip.

Notes for reviewers

  • This describes current RBAC behavior, which is a known gap engineering is tracking (RBAC review pending). The copy avoids committing to a specific future change.
  • ⚠️ Please verify before merge: the exact UI label "Manage and Delete Selected Services" could not be confirmed from the repo (not present in docs text; the permission-picker screenshot only shows top-level categories). Confirm against the live console.
  • The reference-page note was placed after the table rather than mid-table (the requested line 79 is between rows) to avoid breaking Docusaurus table rendering.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only changes with no runtime, API, or security behavior impact.

Overview
Documents that the Cloud console Data Sources tab (ClickPipes, data lake integrations, file uploads) requires control-plane:service:manage (“Manage and Delete Selected Services”), not ClickPipes-only permissions.

Adds matching :::note blocks in the custom roles guide (permission-scope step) and Console roles and permissions reference (after the permissions table), so admins building roles with only manage-clickpipes know why the tab stays hidden.

Reviewed by Cursor Bugbot for commit 7c5c734. Bugbot is set up for automated code reviews on this repo. Configure here.

The Data Sources tab (ClickPipes, data lake integrations, file uploads)
is gated on control-plane:service:manage, not control-plane:service:manage-clickpipes.
Custom roles built with only the ClickPipes permission won't see the tab.
Add notes to the console roles reference and the custom roles guide.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dhtclk dhtclk requested a review from a team as a code owner June 2, 2026 14:41
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 2, 2026

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

Project Deployment Actions Updated (UTC)
clickhouse-docs Building Building Preview, Comment Jun 2, 2026 2:41pm
clickhouse-docs-jp Building Building Preview, Comment Jun 2, 2026 2:41pm
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview Jun 2, 2026 2:41pm
clickhouse-docs-ru Ignored Ignored Preview Jun 2, 2026 2:41pm
clickhouse-docs-zh Ignored Ignored Preview Jun 2, 2026 2:41pm

Request Review

@dhtclk
Copy link
Copy Markdown
Collaborator Author

dhtclk commented Jun 2, 2026

Closing — opened prematurely. Will revisit.

@mintlify
Copy link
Copy Markdown

mintlify Bot commented Jun 2, 2026

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

Added notes on two Cloud security pages clarifying the Data Sources tab requires the Manage and Delete Selected Services permission.

Once this PR is merged, we'll do a second pass to capture any additional changes and update the docs PR.

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.

1 participant