How motiv-labs/janus works
Janus is an API gateway and management platform. A client request is routed through the configured gateway, where authentication and policy plugins can control access before traffic reaches an upstream service; the gateway also exposes an API for managing definitions and credentials. The server loads and refreshes definitions, then registers API routes. The README documents additional capabilities such as rate limiting, retries, circuit breaking, CORS, and tracing. Some plugin wiring is not shown in the excerpts, so those relationships are left unverified.
Main entry points: server.go HTTP Server · reverse_proxy.go Reverse Proxy · api_loader.go API Loader · router.go Request Router
Components 17
Server Runtime
- Janus CLI
main.go - HTTP Server
pkg/server/server.go - API Loader
pkg/loader/api_loader.go
Gateway Routing
- Reverse Proxy
pkg/proxy/reverse_proxy.go - Request Router
pkg/router/router.go - Upstream Balancer
pkg/proxy/balancer/balancer.go
Management API
- Definition API
pkg/web/api_handler.go - Organization API
pkg/plugin/organization/handler.go
Access and Plugins
- Auth Plugins
pkg/plugin/oauth2 - JWT Validation
pkg/jwt/handler.go - Gateway Policies
pkg/plugin
State and Observability
- API Definitions
pkg/api - Organization Store
pkg/plugin/organization/cassandra_repository.go - Metrics and Tracing
pkg/observability/observability.go
Other components
- API Client
- Backend Services
- Admin Client
Connections 17
- Janus CLI → HTTP Server: starts
main.go - HTTP Server → API Loader: registers APIs
pkg/server/server.go - API Loader → Reverse Proxy: configures proxies
pkg/loader/api_loader.go - API Client → HTTP Server: sends request
- HTTP Server → Request Router: creates router
- Request Router → Reverse Proxy: routes traffic
- Reverse Proxy → Upstream Balancer: selects backend
- Reverse Proxy → Backend Services: forwards request
- Admin Client → Definition API: manages definitions
- Definition API → HTTP Server: sends config changes
pkg/web/api_handler.go - HTTP Server → API Definitions: loads definitions
pkg/server/server.go - Admin Client → Organization API: manages organizations
- Organization API → Organization Store: reads and writes
pkg/plugin/organization/handler.go - Reverse Proxy → Auth Plugins: checks access
- Auth Plugins → JWT Validation: builds JWT manager
pkg/plugin/oauth2/manager_factory.go - Reverse Proxy → Gateway Policies: applies policies
- HTTP Server → Metrics and Tracing: records telemetry
pkg/server/server.go