Skip to content

Commit e38ab6b

Browse files
committed
Cleaned up Google sections
1 parent 62e3d08 commit e38ab6b

1 file changed

Lines changed: 22 additions & 18 deletions

File tree

docs/oauth.md

Lines changed: 22 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -75,19 +75,33 @@ Provider naming is mostly the same:
7575

7676
Use your real public domain, for example `https://home.planexe.org`.
7777

78-
### Google (production)
78+
### Google - production
7979

80-
1. In Google Cloud Console, create OAuth client type `Web application`.
81-
2. Add authorized redirect URI:
82-
`https://home.planexe.org/auth/google/callback`
83-
3. Set client ID/secret in:
84-
`PLANEXE_OAUTH_GOOGLE_CLIENT_ID` and `PLANEXE_OAUTH_GOOGLE_CLIENT_SECRET`.
80+
In Google OAuth client (`Web application`), add:
81+
82+
- `https://home.planexe.org/auth/google/callback`
83+
84+
Set:
85+
86+
- `PLANEXE_OAUTH_GOOGLE_CLIENT_ID`
87+
- `PLANEXE_OAUTH_GOOGLE_CLIENT_SECRET`
8588

8689
Verify what the app is using:
8790

8891
- Open `https://home.planexe.org/api/oauth-redirect-uri`
8992
- Confirm `redirect_uri=` matches the URI in Google exactly.
9093

94+
### Google - localhost
95+
96+
In Google OAuth client (`Web application`), add:
97+
98+
- `http://localhost:5001/auth/google/callback`
99+
100+
Set:
101+
102+
- `PLANEXE_OAUTH_GOOGLE_CLIENT_ID`
103+
- `PLANEXE_OAUTH_GOOGLE_CLIENT_SECRET`
104+
91105
### GitHub - production
92106

93107
Create OAuth App at [github.com/settings/developers](https://github.com/settings/developers):
@@ -174,20 +188,10 @@ Discord flow:
174188

175189
Use `http://localhost:5001` as public URL.
176190

177-
### Google (localhost)
178-
179-
In Google OAuth client (`Web application`), add:
180-
181-
- `http://localhost:5001/auth/google/callback`
182-
183-
Set:
184-
185-
- `PLANEXE_FRONTEND_MULTIUSER_PUBLIC_URL=http://localhost:5001`
186-
- Google client ID/secret env vars.
187-
188191
## Troubleshooting
189192

190-
- `404` on `/login/<provider>`: provider env vars are missing (client ID/secret).
193+
- `404` on `/login/<provider>`: provider env vars are missing.
194+
Required pairs: `PLANEXE_OAUTH_GOOGLE_CLIENT_ID`/`PLANEXE_OAUTH_GOOGLE_CLIENT_SECRET`, `PLANEXE_OAUTH_GITHUB_CLIENT_ID`/`PLANEXE_OAUTH_GITHUB_CLIENT_SECRET`, `PLANEXE_OAUTH_DISCORD_CLIENT_ID`/`PLANEXE_OAUTH_DISCORD_CLIENT_SECRET`.
191195
- Redirect mismatch errors: callback URI in provider console does not exactly match PlanExe callback.
192196
- Login does not persist after redirect: `PLANEXE_FRONTEND_MULTIUSER_SECRET_KEY` is missing or changed.
193197
- Browser says insecure cookie on localhost over HTTP: expected in local dev; production should use HTTPS.

0 commit comments

Comments
 (0)