프로젝트 소개

Hanko는 통합이 쉽고, 프레임워크에 구애받지 않으며, 데이터 최소화 및 피싱 저항성 같은 프라이버시 우선 원칙에 기반한 오픈소스 인증 및 사용자 관리 솔루션입니다. 이 프로젝트는 Auth0, Clerk, WorkOS, Stytch 같은 호스팅 ID 서비스의 오픈소스 대안으로 자리매김합니다. 인증 방법 및 기능 README에 따르면, Hanko는 이메일 및 사용자 이름 식별자, 비밀번호, 패스코드, 패스키, OAuth 소셜 로그인(Apple, Google, GitHub 등), SAML 엔터프라이즈 SSO, 맞춤 OIDC/OAuth 연결, TOTP 및 보안 키를 통한 MFA, 원격 세션 폐기가 가능한 서버 측 세션, 웹훅, 맞춤 번역을 통한 국제화를 지원합니다. 구성은 유연하여 패스키 전용, OAuth 전용 설정 및 사용자 삭제 가능한 비밀번호를 포함합니다. 조직, 역할 및 권한은 진행 중으로 표시되며, hanko-menu 웹 컴포넌트와 iOS, Android, React Native, Flutter용 모바일/네이티브 SDK도 개발 중입니다. 아키텍처 저장소는 세 가지 주요 구성 요소로 구성됩니다. 백엔드는 비밀번호, 패스키, 이메일 패스코드, OAuth SSO, 사용자 및 세션 관리, JWT 발급을 처리하는 확장 가능하고 가벼운 인증 API로 설명됩니다. Hanko Elements는 해당 API용으로 구축된 웹 컴포넌트로, CSS로 사용자 정의할 수 있는 온보딩, 로그인 및 사용자 프로필 기능을 제공합니다. hanko-frontend-sdk는 Hanko API용 클라이언트 패키지로 웹 컴포넌트의 기반을 형성합니다. 저장소에는 빠른 시작 참조 애플리케이션, 프레임워크 예제 구현 및 문서(이제 별도 저장소로 이동)도 포함되어 있습니다. 시작하기 사용자는 호스팅된 라이브 예제와 함께 제공되는 passkeys.io 사이트를 시도하거나 로컬에서 빠른 시작 앱을 실행할 수 있습니다. 두 가지 로컬 옵션이 문서화되어 있습니다: 백엔드를 직접 사용하는 베어메탈 설정, 또는 프론트엔드와 백엔드 구성 요소를 함께 시작하는 빠른 시작 Docker Compose 구성을 통한 Docker. Compose 파일은 백엔드 서비스만 실행하도록 축소할 수 있으며, 구성은 config.yaml을 통해 조정됩니다. 맞춤 프론트엔드의 경우, 프론트엔드 SDK를 백엔드 API에 직접 사용할 수 있습니다. 커뮤니티 및 라이선스 질문, 버그 보고 및 기능 요청은 GitHub 토론 및 이슈를 통해 처리되며, Discord 커뮤니티와 업데이트용 X 계정이 있습니다. 라이선스는 분할되어 있습니다: hanko-elements와 hanko-frontend-sdk는 MIT 라이선스이고, 백엔드를 포함한 나머지 저장소는 AGPL-3.0이며, 요청 시 비카피레프트 상업용 라이선스도 제공됩니다.