mavenbox/maven-key repository overview

⁠Maven Key Docker Image

Maven Key es un sistema centralizado multi-tenant para autenticación y gestión de usuarios por roles, construido en Go con Gin, GORM y Kafka.

⁠📦 Imagen

• Nombre: mavenbox-key
• Base: Alpine Linux
• Puertos: 8080 (HTTP)

⁠⚡ Resumen del Sistema

Maven Key permite:

• Login local y social (Google/Facebook) por tenant
• Gestión de usuarios y roles por tenant
• Auditoría de eventos críticos mediante Kafka
• Configuraciones iniciales y versionadas por tenant

Diseñado para integrarse vía API REST o gRPC y listo para entornos multi-tenant.

⁠🛠️ Configuración

Cree un archivo .env con las variables necesarias:

# General
APP_NAME=
APP_PORT=

# Postgres
DB_HOST=
DB_PORT=
DB_USER=
DB_PASSWORD=
DB_NAME=
USE_REAL_DB=

#Cookies
COOKIE_DOMAIN=       # en prod: tudominio.com
COOKIE_SECURE=       # true en prod (requiere HTTPS)
COOKIE_SAME_SITE=    # strict | lax | none
COOKIE_MAX_AGE=      # 1 hora, igual que el JWT

# Migration
MIGRATIONS_DIR=

# Super Admin
ADMIN_USERNAME=
ADMIN_EMAIL=
ADMIN_PASSWORD=

# Kafka
KAFKA_BROKERS=

# API Keys
PRIVATE_KEY=
PUBLIC_KEY=

⁠🚀 Ejecutar con Docker

⁠Crear red (opcional)

docker network create mavenbox-net

Ruta del archivo .env en tu máquina local /path/to/your/project/.env

⁠Ejecutar contenedor

docker run -d \
  --name mavenbox-key \
  --platform linux/amd64 \
  --network=mavenbox-net \
  --env-file /path/to/your/project/.env \
  -v /path/to/your/project/.env:/app/.env \
  -p 8080:8080 \
  mavenbox/maven-key:<version>

⁠Comandos dentro del contenedor

• Ejecutar migraciones:

atlas migrate apply --env=production

• Iniciar la aplicación:

./server

⁠🔑 Recomendaciones

• Asegúrese de que Kafka y Postgres sean accesibles desde el contenedor.
• Configure correctamente el archivo .env.
• Use la red mavenbox-net para entornos con múltiples servicios.

⁠🔗 Recursos

• Go⁠
• Gin⁠
• GORM⁠
• Atlas⁠
• Kafka⁠