No description
Find a file
tomasjs 870f5f8039
All checks were successful
CI / Test and build embee-auth (push) Successful in 20m22s
feat: actualizar version go
2026-10-25 03:16:25 -03:00
.forgejo/workflows feat: actualizar version go 2026-10-25 03:16:25 -03:00
internal feat: changes auth 2026-10-23 05:38:53 -03:00
.dockerignore feat: start project 2026-10-19 02:04:32 -03:00
.env.example feat: changes 2026-10-19 12:48:59 +00:00
.gitignore feat: start project 2026-10-19 02:04:32 -03:00
Dockerfile feat: actualizar version go 2026-10-25 03:16:25 -03:00
go.mod feat: actualizar version go 2026-10-25 03:16:25 -03:00
go.sum feat: start project 2026-10-19 02:04:32 -03:00
main.go feat: changes 2026-10-19 12:48:59 +00:00
README.md feat: changes auth 2026-10-23 05:38:53 -03:00

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/healthz devuelve {"status":"ok"}.
  • GET /embee-auth/docs y /embee-auth/openapi.json sirven la documentación Huma (por ahora documenta health; las rutas OAuth se registran directamente en net/http).
  • GET /embee-auth/auth/twitch inicia OAuth con Twitch. Requiere scope con uno o más scopes separados por espacios y acepta return_to como ruta relativa interna; devuelve authorization_url en 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/callback completa OAuth, crea o actualiza el usuario y la cuenta Twitch, crea una sesión, establece la cookie HttpOnly embee_session y 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 de FRONTEND_URL; return_to solo permite rutas relativas al mismo origen.
  • GET /embee-auth/auth/session devuelve el usuario de la sesión actual.
  • GET /embee-auth/internal/auth/validate valida la cookie embee_session y devuelve user_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 de embee-migrations.
  • POST /embee-auth/auth/sign-out revoca 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.