Ir al contenido

Autenticación y acceso

FrameKit admite dos modos de acceso controlados por FRAMEKIT_AUTH_ENABLED.

Cuando FRAMEKIT_AUTH_ENABLED no está definido o es false, /editor y /brand están disponibles sin sesión, /login redirige a /editor, /settings y la API de acceso no existen, y el renderizado de imágenes no requiere credenciales.

Usa el modo abierto solo en entornos locales o internos de confianza. Define FRAMEKIT_AUTH_ENABLED=true antes de exponer un despliegue a una red no confiable.

Define:

Ventana de terminal
FRAMEKIT_AUTH_ENABLED=true
FRAMEKIT_ADMIN_PASSWORD='replace-with-a-strong-password'

FRAMEKIT_ADMIN_USERNAME es opcional y su valor predeterminado es admin.

Con una base de datos vacía, el primer inicio de sesión correcto crea el administrador inicial. Después de ese bootstrap, los usuarios y las credenciales se administran desde Settings en Studio en lugar de variables de entorno.

El modo autenticado protege /editor, /brand y /settings mediante la cookie framekit_session. Los tokens de API son credenciales separadas pensadas para integraciones externas, como el renderizado de imágenes desde servidor.

Los usuarios autenticados pueden actualizar su propia cuenta, cambiar su contraseña, cerrar sesión y crear o revocar sus propios tokens de API.

Consulta Administrar tu cuenta y tokens para el flujo completo.

Los administradores también pueden crear, editar, desactivar, restablecer y eliminar usuarios, inspeccionar metadatos de sus tokens y revocar tokens de otros usuarios.

Consulta Administrar usuarios para los flujos de administración.

El modo autenticado almacena usuarios, sesiones y metadatos de tokens de API en SQLite de forma predeterminada. En despliegues Docker, persiste /data y conserva FRAMEKIT_DATABASE_PATH=/data/framekit.sqlite salvo que configures intencionalmente otra ubicación.

Consulta Despliegue y Docker y persistencia para la configuración de producción.