|
All checks were successful
CI / Test and build embee-auth (push) Successful in 20m22s
|
||
|---|---|---|
| .forgejo/workflows | ||
| internal | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| main.go | ||
| README.md | ||
embee-auth
Servicio de autenticación de Embeejayz en Go. Implementa el login OAuth de Twitch con Goth y persiste usuarios y sesiones en el schema auth administrado por embee-migrations.
Requisitos
- Go 1.27+
Desarrollo local
cp .env.example .env
# Completa las credenciales y carga las variables en el shell.
set -a; . ./.env; set +a
go run .
Registra TWITCH_CALLBACK_URL exactamente como Redirect URL en la consola de Twitch. El frontend indica los scopes que solicita mediante el parámetro scope al iniciar OAuth (separados por espacios), por ejemplo scope=user:read:email%20channel:read:subscriptions.
El servidor escucha por defecto en :8080. Variables disponibles:
| Variable | Predeterminado | Descripción |
|---|---|---|
APP_ENV |
development |
Entorno informado en el log de inicio. |
HTTP_ADDR |
:8080 |
Dirección HTTP de escucha. |
FRONTEND_URL |
— | URL base del frontend a la que volver tras completar OAuth; debe ser HTTP(S), sin query ni fragmento. En producción debe usar HTTPS. |
PUBLIC_BASE_PATH |
/embee-auth |
Prefijo público de las cookies. Detrás de KrakenD, usar /api para que el navegador las envíe a las rutas públicas. |
DATABASE_URL |
— | URL de PostgreSQL con las migraciones del schema auth aplicadas. |
TWITCH_CLIENT_ID |
— | Client ID de la aplicación Twitch. |
TWITCH_CLIENT_SECRET |
— | Client secret de la aplicación Twitch. |
TWITCH_CALLBACK_URL |
— | Callback OAuth registrado en Twitch. |
OAUTH_STATE_COOKIE_SECRET |
— | Secreto aleatorio de al menos 32 caracteres para firmar/cifrar la cookie temporal OAuth; generarlo con openssl rand -base64 48. |
Cuando KrakenD publica la API en /api, establece PUBLIC_BASE_PATH=/api; así la cookie temporal queda limitada a /api/auth/twitch y la cookie de sesión a /api. El backend sigue atendiendo internamente bajo /embee-auth/. |
Todas las rutas del servicio usan el base path /embee-auth/, para facilitar el enrutamiento desde KrakenD y evitar colisiones con otros servicios.
GET /embee-auth/healthzdevuelve{"status":"ok"}.GET /embee-auth/docsy/embee-auth/openapi.jsonsirven la documentación Huma (por ahora documenta health; las rutas OAuth se registran directamente ennet/http).GET /embee-auth/auth/twitchinicia OAuth con Twitch. Requierescopecon uno o más scopes separados por espacios y aceptareturn_tocomo ruta relativa interna; devuelveauthorization_urlen JSON; el frontend debe navegar a esa URL en el browser para que KrakenD no intente cargar la página de Twitch como respuesta del API.GET /embee-auth/auth/twitch/callbackcompleta OAuth, crea o actualiza el usuario y la cuenta Twitch, crea una sesión, establece la cookie HttpOnlyembee_sessiony responde con una página HTML mínima que navega al frontend. Se evita una redirección HTTP porque KrakenD sigue redirects del backend. La URL de retorno se toma deFRONTEND_URL;return_tosolo permite rutas relativas al mismo origen.GET /embee-auth/auth/sessiondevuelve el usuario de la sesión actual.GET /embee-auth/internal/auth/validatevalida la cookieembee_sessiony devuelveuser_id, las organizaciones y sus roles, y los roles globales de plataforma. Está pensado solo para llamadas internas de KrakenD; no debe publicarse como endpoint accesible directamente desde Internet. Requiere las tablas de organizaciones/roles deembee-migrations.POST /embee-auth/auth/sign-outrevoca la sesión y elimina la cookie.
Las sesiones se guardan en PostgreSQL; en la tabla se persiste el hash del token, mientras que el token opaco se entrega solo en una cookie HttpOnly. El login solicita los scopes enviados por el frontend; estos deben estar disponibles para la aplicación Twitch configurada. No persiste el access/refresh token de Twitch. El prefijo de API también aparece como servers en el documento OpenAPI.
Build y pruebas
go test ./...
go build .
Docker y CI
docker build -t embee-auth .
docker run --rm -p 8080:8080 --env-file .env embee-auth
El workflow de Forgejo en .forgejo/workflows/ci.yml corre formato, tests con race detector, vet y build en cada push/PR. Al hacer push a main, publica git.pipis.app/<owner>/embee-auth:latest y una etiqueta con el SHA. Requiere el secret REGISTRY_TOKEN con permiso de escritura al Container Registry; opcionalmente, la variable FORGEJO_REGISTRY cambia el host. El workflow construye y publica la imagen, pero no hace rollout en Kubernetes.