routes

func AssignRole ¶ added in v0.0.21

func AssignRole(db *orm.DB, rbacSvc *rbac.Service) router.HandlerFunc

AssignRole concede roleCode al usuario en el proyecto del llamante. Idempotente: si ya lo tiene, no es un error. Si el rol no existe en ese proyecto, se crea.

func Health ¶

func Health() router.HandlerFunc

Health responde si este Worker esta vivo y sirviendo. A proposito NO toca la base: quien consulta esta ruta pregunta por el Worker, y meter una consulta a D1 aqui costaba ~160 ms de viaje a la region de la base ademas de convertir un hipo de red en una falsa alarma de caida. La alcanzabilidad de la base tiene su propia ruta, PathHealthDB.

func HealthDB ¶ added in v0.0.20

func HealthDB(db *orm.DB) router.HandlerFunc

HealthDB comprueba que la base responde. Es deliberadamente una ruta aparte: cuesta un viaje completo a la region donde vive D1, asi que se consulta cuando se quiere esa respuesta, no en cada latido de un monitor.

func Register ¶

func Register(r router.Router, db *orm.DB, authMod *authority.Module, rbacSvc *rbac.Service, secret []byte)

Register monta todas las rutas de iam en el router.

modules is the single, exhaustive list of everything this server mounts through router.APIModule. It is intentionally the ONLY place iam calls MountAPI: a module with routes to serve belongs in this slice, never invoked ad hoc elsewhere, so adding a module here is the only way its routes reach a caller — and leaving it out is the only way they don't. That is what closes the hole this plan exists for: authMod's OAuth routes (/oauth/google, /oauth/callback/google) and /logout were built and enabled (config/auth.go, config/auth_local.go) but never mounted, so every login attempt 404'd, silently, since Stage 4 — MountAPI existed and was correct, nothing ever called it.

Ninguna ruta lleva CORS: el llamador es siempre el SERVIDOR de un proyecto consumidor (server-to-server), nunca el navegador del usuario directamente — el client_secret no puede vivir en un bundle WASM/JS (ver ARCHITECTURE.md §6.4/§7). Sin llamador cross-origin, no hay cabeceras CORS que emitir.

func ResolveUser ¶ added in v0.0.9

func ResolveUser(db *orm.DB, authMod *authority.Module) router.HandlerFunc

ResolveUser busca un usuario por email dentro de la identidad global de iam (no hay tabla de usuarios por proyecto: la identidad es una sola, ver ARCHITECTURE.md §1) y lo crea si no existe. Devuelve su Sub — el mismo id que llevará el Sub de su token cuando inicie sesión, así que un consumidor puede asignarle recursos (ej. dueño de un sitio) ANTES de que esa persona haga login por primera vez.

func Token ¶

func Token(db *orm.DB, authMod *authority.Module, rbacSvc *rbac.Service, secret []byte) router.HandlerFunc

Token emite un token de autorización project-scoped para el usuario de la sesión activa, si project_id/client_secret validan contra el proyecto registrado.