Sobre o projeto
Hanko é uma solução de autenticação e gerenciamento de usuários open-source, projetada para ser fácil de integrar, agnóstica de framework e construída sobre princípios de privacidade, como minimalismo de dados e resistência a phishing. O projeto se posiciona como uma alternativa open-source a serviços de identidade hospedados como Auth0, Clerk, WorkOS e Stych.
Métodos e recursos de autenticação
De acordo com o README, o Hanko suporta identificadores por e-mail e nome de usuário, senhas, códigos de acesso e passkeys, login social via OAuth (Apple, Google, GitHub e outros), SSO empresarial via SAML, conexões personalizadas OIDC/OAuth, MFA via TOTP e chaves de segurança, sessões no lado do servidor com revogação remota de sessão, webhooks e internacionalização com traduções personalizadas. A configuração é flexível, incluindo setups somente com passkeys e somente com OAuth, além de senhas que podem ser excluídas pelo usuário. Organizações, papéis e permissões estão listados como em andamento, juntamente com um componente web hanko-menu e SDKs móveis/nativos para iOS, Android, React Native e Flutter.
Arquitetura
O repositório está organizado em torno de três blocos principais. O backend é descrito como uma API de autenticação escalável e leve, que lida com senhas, passkeys, códigos de acesso por e-mail, SSO OAuth, gerenciamento de usuários e sessões, e emissão de JWTs. Hanko Elements são componentes web criados para essa API, fornecendo funcionalidades de onboarding, login e perfil de usuário que podem ser personalizadas com CSS. O hanko-frontend-sdk é um pacote de cliente para a API do Hanko e forma a base dos componentes web. O repositório também contém um aplicativo de referência de início rápido, exemplos de implementação em frameworks e documentação (agora movida para um repositório separado).
Começando
Os usuários podem testar um exemplo hospedado ao vivo e o site complementar passkeys.io, ou executar o aplicativo de início rápido localmente. Duas opções locais estão documentadas: uma configuração bare-metal usando o backend diretamente, ou Docker via a configuração Docker Compose de início rápido, que inicia os componentes frontend e backend juntos. O arquivo compose pode ser reduzido para rodar apenas os serviços do backend, e a configuração é ajustada por meio do config.yaml. Para frontends personalizados, o SDK frontend pode ser usado diretamente contra a API do backend.
Comunidade e licenciamento
Dúvidas, relatórios de bugs e solicitações de recursos são tratados por meio de discussões e issues no GitHub, com uma comunidade no Discord e uma conta no X para atualizações. O licenciamento é dividido: hanko-elements e hanko-frontend-sdk são licenciados sob MIT, enquanto o restante do repositório, incluindo o backend, é AGPL-3.0, com licenciamento comercial sem copyleft disponível sob solicitação.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.