🔐 Auth Microservice API

OAuth2 authentication and session management

🏠 Home & Health

GET /
Welcome page with service information
GET /health
Health check endpoint

🔑 OAuth Authentication

GET /auth/github?redirect_uri=http://localhost:3000
Initiate GitHub OAuth flow (redirect_uri is optional, defaults to http://localhost:3000)
GET /auth/github/callback
GitHub OAuth callback handler
GET /auth/google?redirect_uri=http://localhost:3000
Initiate Google OAuth flow
GET /auth/google/callback
Google OAuth callback handler
GET /auth/microsoft?redirect_uri=http://localhost:3000
Initiate Microsoft OAuth flow
GET /auth/microsoft/callback
Microsoft OAuth callback handler
GET /auth/discord?redirect_uri=http://localhost:3000
Initiate Discord OAuth flow
GET /auth/discord/callback
Discord OAuth callback handler

🎫 Session Management

POST /session/create
Create a new session from auth code. Body: {"auth_code": "..."}
POST /session/refresh
Refresh an existing session. Body: {"session_id": "..."}
GET /session/validate?session_token=...
Validate a session token
GET /session/active
Get active sessions for authenticated user (requires JWT)
POST /session/manage
Manage sessions (extend, revoke, etc.)
GET /session/logout?session_token=...
Logout a specific session
GET /session/health
Session system health check

🪙 Token Operations

POST /token/exchange
Exchange authorization code for tokens
POST /token/validate
Validate a token
POST /token/refresh
Refresh an access token
GET /token/userinfo
Get user information (requires valid token)
GET /token/.well-known/jwks.json
Get JSON Web Key Set for token verification

📚 Documentation

GET /docs
This documentation page