:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
/**
* oauth.posthog.com — Cross-Region OAuth Proxy
*
* A Cloudflare Worker that sits in front of both US and EU PostHog instances,
* providing a single OAuth endpoint that handles region routing transparently.
*
* Used by the PostHog MCP server, PostHog Desktop, and any future OAuth integration
* so they don't need separate US/EU URLs.
*/
import { handleAuthorize } from '@/handlers/authorize'
import { handleCallback } from '@/handlers/callback'
import { FONT_PATHS, handleFont } from '@/handlers/fonts'
import { handleClientManifest, handleMetadata, handleOpenIdConfiguration } from '@/handlers/metadata'
import { handleIntrospect, handleJwks, handleRevoke, handleUserInfo } from '@/handlers/passthrough'
import { handleRegister } from '@/handlers/register'
import { handleToken } from '@/handlers/token'
import type { SigningKeyEnv } from '@/lib/idtoken'
import { type Validator, errorResponse, noDuplicateParams, runValidators } from '@/lib/validation'
export interface Env extends SigningKeyEnv {
AUTH_KV: KVNamespace
}
type Handler = (request: Request, kv: KVNamespace, env: Env) => Response | Promise<Response>
interface Route {
paths: string[]
method?: string
validators?: Validator[]
handler: Handler
}
function normalizePath(path: string): string {
return path.endsWith('/') ? path.slice(0, -1) : path
}
const routes: Route[] = [
{
paths: ['/.well-known/oauth-authorization-server'],
handler: handleMetadata,
},
{
paths: ['/.well-known/openid-configuration'],
handler: handleOpenIdConfiguration,
},
{
paths: ['/auth.md'],
handler: handleClientManifest,
},
{
paths: ['/.well-known/jwks.json'],
handler: handleJwks,
},
{
paths: ['/oauth/register', '/register'],
method: 'POST',
handler: handleRegister,
},
{
paths: ['/oauth/authorize', '/authorize'],
// The proxy reads these with `.get()` (first value) for KV keying but forwards
// the last value downstream via `.set()`; a duplicate would split those reads
// and let an attacker route a victim's callback to a preloaded redirect URI.
// `resource` (RFC 8707) is intentionally excluded — it is allowed to repeat.
validators: [
noDuplicateParams(
'state',
'client_id',
'redirect_uri',
'response_type',
'scope',
'code_challenge',
'code_challenge_method'
),
],
handler: handleAuthorize,
},
{
paths: ['/oauth/callback'],
handler: handleCallback,
},
{
paths: ['/oauth/token', '/token'],
method: 'POST',
handler: handleToken,
},
{
paths: ['/oauth/revoke'],
method: 'POST',
handler: handleRevoke,
},
{
paths: ['/oauth/introspect'],
method: 'POST',
handler: handleIntrospect,
},
{
paths: ['/oauth/userinfo'],
handler: handleUserInfo,
},
{
paths: FONT_PATHS,
handler: handleFont,
},
]
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const url = new URL(request.url)
const normalized = normalizePath(url.pathname)
try {
for (const route of routes) {
if (route.method && request.method !== route.method) {
continue
}
if (route.paths.some((p) => normalizePath(p) === normalized)) {
if (route.validators) {
const validationError = runValidators(route.validators, request, url)
if (validationError) {
return errorResponse(validationError)
}
}
return await route.handler(request, env.AUTH_KV, env)
}
}
if (normalized === '') {
return new Response('PostHog OAuth Proxy - https://posthog.com/docs/api/oauth', {
headers: { 'Content-Type': 'text/plain' },
})
}
return new Response('Not found', { status: 404 })
} catch (error) {
console.error('Unhandled error:', error instanceof Error ? error.message : error)
return new Response(
JSON.stringify({ error: 'server_error', error_description: 'An internal error occurred' }),
{
status: 500,
headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' },
}
)
}
},
}