Skip to content

README: Google setup is per deployment, and needs no Google review for personal use - #13

Merged
BrewingCoder merged 1 commit into
mainfrom
claude/op2-283-google-setup-docs
Nov 4, 2026
Merged

BrewingCoder merged 1 commit into
mainfrom
claude/op2-283-google-setup-docs

Conversation

@BrewingCoder

Copy link
Copy Markdown
Owner

Corrects the Gmail setup docs. The README overstated Google's app review, and OP2-283 described it as a launch blocker. It isn't one, for two reasons.

  1. Every self-hosted deployment brings its own Google OAuth client. There's no shared Outpost app to approve; Google's rules apply to each instance separately.
  2. The seven-day sign-in expiry is tied to the "Testing" publishing status, not to being unverified. Google's docs: a project with an external user type "and a publishing status of 'Testing' is issued a refresh token expiring in 7 days." A client published to production for personal use (under 100 users, all known to you) needs no review. Users click through Google's "unverified app" warning, and there's a 100-account cap.

The full review (domain and brand verification, a demo video, and an annual independent CASA security assessment) is only for an app offered to the public, which the licence doesn't allow anyway.

Changes

  • New README section, "Google setup": the four setup steps, plus a table of the three consent-screen choices:

    Setting Who can connect Sign-in lifetime Review
    External, production (recommended for personal use) any account, up to 100 in total until revoked, or 6 months unused none; warning to click through
    External, Testing the test-user list (up to 100) 7 days none
    Internal (Workspace organisation) that organisation only until revoked none, no warning

    It also notes that Outpost's own GitHub allowlist is the real gate, so publishing to production doesn't open Gmail to anyone else, and that the Cloud Console may still show "needs verification" (fine for personal use).

  • Status table: "blocked on Google's app verification (OP2-283)" becomes "per-deployment Google client; no Google review needed for personal or internal use".

  • .env.example: now recommends publishing to production and explains Testing's seven-day expiry.

  • Two code comments no longer cite OP2-283 as a pending blocker. No behaviour changes.

Sources: Google's When is verification not needed, Restricted scope verification and refresh token expiration.


Generated by Claude Code

…r personal use

The README and .env.example said every Gmail sign-in would expire after
seven days "until the app passes Google's verification" (OP2-283), and the
status table called that review a launch blocker. Both overstated it.

- Google ties the seven-day refresh-token expiry to the "Testing"
  publishing status, not to being unverified. A client published to
  production for personal use keeps its sign-ins (until revoked or six
  months unused) and needs no review; users click through Google's
  unverified-app warning, with a 100-account cap.
- Each self-hosted deployment brings its own Google OAuth client, so there
  is no shared Outpost app to approve. The full review (brand verification,
  demo video, annual CASA assessment) is for apps offered to the public,
  which the licence does not allow.

New "Google setup" section: the four steps, and a table of the three
consent-screen choices (production for personal use - recommended -,
Testing, Internal for a Workspace organisation) with who can connect, how
long a sign-in lasts and what review applies. The status row and the
.env.example comment now say the same; two code comments that cited
OP2-283 as a pending blocker no longer do.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V7aurkG6ivoSJf2yFGtzi8
@BrewingCoder
BrewingCoder merged commit 3f167b8 into main Nov 4, 2026
1 check 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.

2 participants