Skip to content

docs(security): add a secrets register and rotation schedule#41308

Open
rusackas wants to merge 1 commit into
masterfrom
docs/secrets-rotation-schedule
Open

docs(security): add a secrets register and rotation schedule#41308
rusackas wants to merge 1 commit into
masterfrom
docs/secrets-rotation-schedule

Conversation

@rusackas

Copy link
Copy Markdown
Member

SUMMARY

The production hardening guide documented a rotation schedule for SUPERSET_SECRET_KEY but did not cover the other security-critical secrets, so operators following the checklist could rotate only the secret key and leave guest-token / async-query JWT secrets and SMTP/DB credentials un-rotated after a leak.

This adds Appendix C: Secrets Register and Rotation Schedule to docs/admin_docs/security/securing_superset.mdx, enumerating each security-critical secret (SUPERSET_SECRET_KEY, GUEST_TOKEN_JWT_SECRET, GLOBAL_ASYNC_QUERIES_JWT_SECRET, SMTP password, database connection passwords) with its purpose, leak risk, and suggested rotation cadence, and references it from the ongoing-maintenance checklist.

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

N/A — documentation only.

TESTING INSTRUCTIONS

Docs-only change. Build/preview the docs site and confirm Appendix C renders in the "Securing Superset" page and the maintenance checklist links to it.

ADDITIONAL INFORMATION

  • Has associated issue:
  • Required feature flags:
  • Changes UI
  • Includes DB Migration (follow approval process in SIP-59)
    • Migration is atomic, supports rollback & is backwards-compatible
    • Confirm DB migration upgrade and downgrade tested
    • Runtime estimates and downtime expectations provided
  • Introduces new feature or API
  • Removes existing feature or API

The production hardening guide documented rotation for SUPERSET_SECRET_KEY but
not for the other security-critical secrets, so operators following the
checklist could leave guest-token/async-query JWT secrets and SMTP/DB
credentials un-rotated after a leak.

Add an "Appendix C: Secrets Register and Rotation Schedule" enumerating all
security-critical secrets with their purpose, leak risk, and rotation cadence,
and reference it from the ongoing-maintenance checklist.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@rusackas rusackas added the asvs label Jun 23, 2026
@github-actions github-actions Bot added the doc Namespace | Anything related to documentation label Jun 23, 2026
@bito-code-review

bito-code-review Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Code Review Agent Run #e58e23

Actionable Suggestions - 0
Review Details
  • Files reviewed - 1 · Commit Range: 531b89e..531b89e
    • docs/admin_docs/security/securing_superset.mdx
  • Files skipped - 0
  • Tools
    • Whispers (Secret Scanner) - ✔︎ Successful
    • Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

  • /review - Manually triggers a full AI review.

  • /pause - Pauses automatic reviews on this pull request.

  • /resume - Resumes automatic reviews.

  • /resolve - Marks all Bito-posted review comments as resolved.

  • /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by Bito Logo

@dosubot dosubot Bot added the doc:user User / Superset documentation label Jun 23, 2026
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for superset-docs-preview ready!

Name Link
🔨 Latest commit 531b89e
🔍 Latest deploy log https://app.netlify.com/projects/superset-docs-preview/deploys/6a39db0cc5afa20008a61902
😎 Deploy Preview https://deploy-preview-41308--superset-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

asvs doc:user User / Superset documentation doc Namespace | Anything related to documentation size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants