Skip to content

Conversation

@noahwhite
Copy link
Owner

@noahwhite noahwhite commented Jan 23, 2026

Summary

  • Add comprehensive token rotation runbook (docs/token-rotation-runbook.md) documenting all CI/CD tokens and secrets
  • Add environment: dev to PR workflow so it can access environment-scoped secrets
  • Migrate all secrets from repository-level to environment-scoped
  • Documents rotation procedures, expiration policies, and verification steps for all tokens

Changes

New Documentation

  • docs/token-rotation-runbook.md - Complete runbook covering:
    • GitHub tokens (GHCR, Claude MCP)
    • Bitwarden Secrets Manager tokens
    • Cloudflare tokens (API, Token Creator, Bootstrap)
    • R2 storage credentials
    • Vultr, Tailscale, PagerDuty, Grafana Cloud credentials
    • Linear API token
    • Emergency rotation procedures
    • Rotation schedule recommendations

Workflow Update

  • Added environment: dev to PR workflow job
  • Changed to use environment-scoped secrets:
    • BWS_ACCESS_TOKEN (was BWS_ACCESS_TOKEN at repo level)
    • ADMIN_IP (was ADMIN_IP_DEV)
    • CLOUDFLARE_ZONE_ID (was CLOUDFLARE_ZONE_ID_DEV)

Cleanup After Merge

The following repository-level secrets can be deleted (environment-scoped versions are now used):

  • BWS_ACCESS_TOKEN (repository-level copy)
  • ADMIN_IP_DEV
  • CLOUDFLARE_ZONE_ID_DEV

Test plan

  • Verify PR workflow runs with environment-scoped secrets
  • Verify deploy workflow still works
  • Review runbook for completeness and accuracy
  • Delete repository-level secret copies after verification

Closes GHO-42

@linear
Copy link

linear bot commented Jan 23, 2026

- Create comprehensive token rotation runbook documenting all CI/CD
  tokens and secrets with rotation procedures
- Refactor PR workflow to use BWS_ACCESS_TOKEN_DEV for repository-level
  secret (matches ADMIN_IP_DEV naming pattern)
- Environment-scoped BWS_ACCESS_TOKEN remains for deploy workflows
@noahwhite noahwhite force-pushed the feature/gho-42-user-story-create-runbook-for-rotating-cicd-tokens-and branch from a7a9c59 to f3e0f1a Compare January 24, 2026 01:47
- Add `environment: dev` to PR workflow job
- Use environment-scoped BWS_ACCESS_TOKEN (no _DEV suffix needed)
- Update runbook to reflect simplified secret scoping
Remove _DEV suffix pattern - now that PR workflow uses environment: dev,
it can access environment-scoped secrets directly.

Repository-level copies (ADMIN_IP_DEV, CLOUDFLARE_ZONE_ID_DEV) can be deleted.
- Add rule to never add "Generated with Claude Code" to PRs/commits
- Update secrets management section to reflect environment-scoped pattern
- Reference token-rotation-runbook.md for complete token inventory
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.

2 participants