Servicio de autenticación 100 % serverless escrito en Go: cada operación es una AWS Lambda independiente detrás de API Gateway, con DynamoDB como almacén y toda la infraestructura definida en Terraform.
| Endpoint | Lambda | Descripción |
|---|---|---|
POST /signup |
auth-signup |
Registro con contraseña hasheada con Argon2id |
POST /login |
auth-login |
Login con access token (15 min) y refresh token (30 días) |
POST /verify-otp |
auth-verify-otp |
Segundo factor (MFA) por OTP enviado al correo |
POST /refresh-token |
auth-refresh-token |
Rotación de refresh tokens agrupados por familia de sesión |
POST /request-reset |
auth-request-reset |
Solicitud de recuperación de contraseña por correo |
POST /reset-password |
auth-reset-password |
Cambio de contraseña con el código de recuperación |
Cliente ──► API Gateway (HTTP API) ──► Lambda por endpoint (Go, arm64)
│
├──► DynamoDB (single-table: usuarios, sesiones, OTP con TTL)
├──► SSM Parameter Store (JWT secret, credenciales SMTP)
└──► SMTP (envío de OTP y recuperación)
- Single-table design en DynamoDB (
PK/SK) con TTL sobreexpires_atpara que sesiones y OTP caduquen solos. - Secretos fuera del código: se leen de SSM Parameter Store.
- Binarios
arm64conlambda.norpc: arranques en frío más rápidos y más baratos.
cmd/ # un main.go por Lambda
internal/
auth/ # Argon2id + JWT
email/ # envío SMTP
handler/ # respuestas HTTP comunes
models/ # User, Session, OTP
repository/ # acceso a DynamoDB
infrastructure/terraform/ # API Gateway, Lambdas, DynamoDB, IAM, SSM
.github/workflows/deploy.yml
Cada push a main ejecuta el pipeline de GitHub Actions:
go test ./...- Compila las 6 Lambdas para
linux/arm64y las empaqueta en.zip - Se autentica en AWS con OIDC (sin llaves de larga duración)
terraform applyy actualización del código de cada función
Para desplegar desde tu máquina:
cd infrastructure/terraform
terraform init
terraform applyAntes de usarlo, reemplaza
YOUR_AWS_ACCOUNT_IDy el rol de GitHub Actions en.github/workflows/deploy.yml.
Hecho por Harold Camargo · LinkedIn