Herramientas para desarrolladores solución

Ejecuta Keycloak en local con FlyEnv

Keycloak usa Java y una base de datos, con un proxy local al probar la autenticación basada en el navegador. FlyEnv gestiona esas dependencias locales del servicio de identidad.

Descargar FlyEnv Documentación oficial

Stack del proyecto local

Servicios que FlyEnv puede gestionar para Keycloak

Acerca de Keycloak

Keycloak es un servidor de gestión de identidad y acceso para single sign-on, OAuth 2.0, OpenID Connect, SAML e identity brokering. Sus conceptos centrales son realms, clients, usuarios, roles, grupos, scopes y flujos de autenticación, que las aplicaciones consumen mediante protocolos estándar.

El desarrollo local con Keycloak gira principalmente en torno a una URL de issuer estable y redirect URIs realistas. El servidor de desarrollo puede usar una base de datos de desarrollo, mientras que PostgreSQL es habitual para realms locales persistentes; la federación de usuarios externa, SMTP y el HTTPS del proxy inverso solo deben introducirse cuando se prueban esos flujos.

Capacidades principales

Realms y clients
OAuth 2.0 y OpenID Connect
SAML
Flujos de autenticación
Identity brokering
Federación de usuarios

Casos de uso comunes

Single sign-on para aplicaciones
Pruebas de integración OAuth/OIDC
Gestión centralizada de roles
Federación de proveedores de identidad

Las pruebas de Keycloak dependen de las URLs de issuer y redirección

El servidor de autenticación y un almacén persistente de realms son lo esencial; los demás servicios derivan del escenario de autenticación.

Servidor Keycloak e importación de realms: Ejecuta el proveedor de identidad y puede cargar clients, roles y usuarios de prueba repetibles.
PostgreSQL para realms persistentes: Habitual para datos de identidad locales duraderos; el modo de desarrollo puede usar otra opción soportada para experimentos rápidos.
Dominio HTTPS y redirect URIs: Permiten que los clients de navegador, las cookies, CORS y la validación de callbacks se comporten como en un entorno integrado.
SMTP o IdP externo opcional: Necesarios solo para la verificación de correo, la recuperación de contraseña o los flujos de inicio de sesión con broker.

Recursos del proyecto

Para los comandos de instalación, las versiones compatibles y la configuración específica del proyecto, consulta la documentación oficial de Keycloak .

Stack local típico

Los servicios exactos dependen del proyecto, su versión y su configuración local. Esta es una configuración local común, no un requisito fijo.

Componente	Rol típico
Java	Ejecuta Java para el entorno local de Keycloak.
PostgreSQL MySQL	Ejecuta PostgreSQL / MySQL para el entorno local de Keycloak.
Nginx Caddy	Ejecuta Nginx / Caddy para el entorno local de Keycloak.

Cómo ayuda FlyEnv

Adapta el runtime del proyecto
Elige la versión de runtime que necesita Keycloak.
Gestiona los servicios locales
Inicia bases de datos, cachés y otros servicios solo cuando el proyecto los necesite.
Mantén los proyectos aislados
Permite que cada proyecto use sus propias versiones y configuraciones de servicios.
Configura dominios locales
Accede a los proyectos mediante dominios locales y HTTPS cuando sea necesario.

Configura el entorno local

La instalación del proyecto sigue la documentación oficial. FlyEnv gestiona los runtimes, las bases de datos, los servidores web y los servicios auxiliares que lo rodean.

1Instala el proyecto y sus dependencias siguiendo la documentación oficial de Keycloak.
2Selecciona en FlyEnv la versión de runtime que necesita el proyecto.
3Inicia los servicios de base de datos indicados en la configuración del proyecto.
4Inicia la caché, la búsqueda u otros servicios auxiliares solo cuando sean necesarios.
5Configura el servidor web local, los dominios y HTTPS según sea necesario.
6Agrupa los servicios relacionados para iniciarlos juntos de nuevo con facilidad.