hanko

Hanko es una solución de autenticación y gestión de usuarios de código abierto diseñada para ser fácil de integrar, independiente del framework y construida sobre principios de privacidad por diseño, como el minimalismo de datos y la resistencia al phishing. El proyecto se posiciona como una alternativa de código abierto a servicios de identidad hospedados como Auth0, Clerk, WorkOS y Stych. Métodos y características de autenticación Según el README, Hanko admite identificadores de correo electrónico y nombre de usuario, contraseñas, códigos de acceso y passkeys, inicio de sesión social OAuth (Apple, Google, GitHub y otros), SSO empresarial SAML, conexiones OIDC/OAuth personalizadas, MFA mediante TOTP y claves de seguridad, sesiones del lado del servidor con revocación remota de sesiones, webhooks e internacionalización con traducciones personalizadas. La configuración es flexible, incluyendo configuraciones solo con passkeys, solo con OAuth y contraseñas eliminables por el usuario. Las organizaciones, roles y permisos se enumeran como en progreso, junto con el componente web hanko-menu y SDKs móviles/nativos para iOS, Android, React Native y Flutter. Arquitectura El repositorio se organiza en torno a tres bloques principales. El backend se describe como una API de autenticación escalable y ligera que maneja contraseñas, passkeys, códigos de acceso por correo, SSO OAuth, gestión de usuarios y sesiones, y emisión de JWT. Hanko Elements son componentes web construidos para esa API, que proporcionan funcionalidad de incorporación, inicio de sesión y perfil de usuario, personalizables con CSS. El hanko-frontend-sdk es un paquete cliente para la API de Hanko y constituye la base de los componentes web. El repositorio también contiene una aplicación de referencia de inicio rápido, ejemplos de implementación para frameworks y documentación (ahora trasladada a un repositorio separado). Primeros pasos Los usuarios pueden probar un ejemplo en vivo hospedado y el sitio complementario passkeys.io, o ejecutar la aplicación de inicio rápido localmente. Se documentan dos opciones locales: una configuración "bare-metal" usando el backend directamente, o Docker mediante la configuración de Docker Compose del inicio rápido, que inicia los componentes frontend y backend juntos. El archivo compose se puede recortar para ejecutar solo los servicios del backend, y la configuración se ajusta mediante config.yaml. Para frontends personalizados, el SDK frontend se puede usar directamente contra la API del backend. Comunidad y licencias Las preguntas, informes de errores y solicitudes de características se gestionan a través de discusiones y problemas de GitHub, con una comunidad en Discord y una cuenta X para novedades. La licencia está dividida: hanko-elements y hanko-frontend-sdk tienen licencia MIT, mientras que el resto del repositorio, incluyendo el backend, tiene licencia AGPL-3.0, con licencia comercial no copyleft disponible previa solicitud.