Skip to content

[Access] Document leaked service token recovery - #34341

Draft
kennyj42 wants to merge 2 commits into
productionfrom
kjohnson/leaked-service-token-recovery
Draft

kennyj42 wants to merge 2 commits into
productionfrom
kjohnson/leaked-service-token-recovery

Conversation

@kennyj42

Copy link
Copy Markdown
Collaborator

Summary

Documents recovery for Access service tokens reported as leaked: rotate without a grace period, update services, then re-enable the token. Includes leak metadata, API error behavior, and a changelog entry.

This change covers recovery, not a new notification subscription workflow.

Documentation checklist

  • Includes a changelog entry.
  • The change adheres to the documentation style guide.

To recover a disabled token after a leak report:

<Steps>
1. [Rotate the token's secret](#rotate-service-token-secrets). In the dashboard, select _Revoke immediately_. In an API rotation request, omit `previous_client_secret_expires_at`.

@jayjesskay jayjesskay Oct 14, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would update this to: "In the dashboard, select Rotate secret — the current secret is revoked immediately."

There is no 'revoke immediately' option. It looks like:

Image Image

When editing an Access application, selecting **Revoke existing tokens** revokes existing sessions but does not prevent the user from starting a new session. As long as the Client ID and Client Secret are still valid, they can be exchanged for a new token on the next request. To revoke access, you must delete the service token.
:::

## Set a token expiration alert

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you want to group these changes I would also update this section to include leaked service token notifications

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://kjohnson-leaked-service-token-recovery.previews.developers.cloudflare.com (commit b5c789b)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://8c370277.previews.developers.cloudflare.com b5c789b 2026-10-16T21:58:07.130Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://32edb07d.previews.developers.cloudflare.com 8210dc8 2026-10-14T21:56:45.448Z Visit the dashboard ↗

- access
- cloudflare-one
---

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to mention the automatic disablement portion (how the service token gets reported as leaked). Something like: "When a leak is reported by a secret scanning partner such as GitHub, Cloudflare automatically disables the token and notifies account administrators by email"

Not sure if you were just waiting on the GitHub partnership being finalized for this

@cloudflare-docs-bot

Copy link
Copy Markdown
Contributor

⚠️ @kennyj42 This pull request adds a changelog entry dated in the past:

  • src/content/changelog/access/2026-10-14-leaked-service-token-recovery.mdx — dated 2026-10-14

Typically, changelog entries should be dated the day they merge. This is not blocking — if the date is unintentional, please update it.

@cloudflare cloudflare deleted a comment from github-actions Bot Oct 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants