Skip to content

Describe the Google connectors' Disconnect, now that it exists - #76

Merged
jerelvelarde merged 1 commit into
mainfrom
jerel/openduet-docs-disconnect
Oct 26, 2026
Merged

jerelvelarde merged 1 commit into
mainfrom
jerel/openduet-docs-disconnect

Conversation

@jerelvelarde

Copy link
Copy Markdown
Collaborator

The problem

#75 made Disconnect work for a person's own Google account. The Gmail and Google Calendar page (openbot/docs/plugins/google-workspace.md) and the Google Drive page (google-drive.md) still said "Not built yet" and sent people to Google's third-party access settings.

The approach

Both pages now describe what Disconnect does:

  • it disconnects only the signed-in person's own account;
  • it asks Google to revoke the refresh token at the catalogue's revokeUrl (https://oauth2.googleapis.com/revoke for both connectors);
  • it then revokes the stored credential and removes the connection, and writes an audit event.

They also cover the two failure cases: Google unreachable (nothing changes, try again), and Google refusing (access ends here; finish at myaccount.google.com/connections).

What is not covered

Removing a person from People still does not revoke their Google access at Google. That is unchanged by #75, and these pages don't claim otherwise.

Verification

Docs only. The wording was checked against #75's disconnectHeld and the catalogue's revoke URLs. Biome format is clean.

#75 made Disconnect real for user-held accounts: it asks Google to revoke the
refresh token, then revokes the stored credential and removes the connection.
The Gmail and Calendar and Google Drive pages still said it was not built and
sent people to Google's settings instead.
@jerelvelarde

Copy link
Copy Markdown
Collaborator Author

Security review: no actionable findings. Docs only. The text matches #75's behaviour: own account only, revoke at Google before removing our copy, and access is never reported withdrawn when Google couldn't be reached.

@jerelvelarde
jerelvelarde merged commit 79ce1c4 into main Oct 26, 2026
19 checks passed
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