teamhanko/hanko

어떤 프로젝트인가요?

핵심 기능

• 01비밀번호, 패스코드, 패스키, 소셜 로그인을 지원합니다
• 02TOTP와 보안 키를 사용한 MFA를 제공합니다
• 03SAML 엔터프라이즈 SSO와 사용자 지정 OIDC/OAuth 연결을 지원합니다
• 04로그인 및 프로필 화면에 사용할 수 있는 사용자 지정 가능한 웹 컴포넌트를 제공합니다
• 05원격으로 해지할 수 있는 서버 측 세션과 웹훅을 지원합니다

활용 사례

• 웹 앱에 패스키 기반 비밀번호 없는 로그인을 추가할 때
• 호스팅형 인증 서비스를 자체 관리형 백엔드로 대체할 때
• B2B 애플리케이션에 엔터프라이즈 SAML SSO를 제공할 때
• JWT를 발급하는 인증 API를 기반으로 사용자 지정 로그인 UI를 구축할 때

빠른 시작

1. 1

   호스팅된 라이브 예제 또는 퀵스타트 앱에서 로그인 화면을 확인해 보세요

2. 2

   로컬에서 실행하려면 quickstart/README.md의 Docker 퀵스타트 가이드(‘Run the quickstart’ 섹션)를 따르세요

3. 3

   Docker 등을 사용하지 않고 설정하려면 백엔드 README를 따라 Hanko backend를 실행하세요

4. 4

   프레임워크별 예제와 가이드를 참고해 hanko-elements 웹 컴포넌트를 통합하세요

사용 전 알아둘 점

• !백엔드는 카피레프트 라이선스인 AGPL-3.0에 따라 제공됩니다. 상업적으로 사용하려면 공급업체와 별도의 라이선스를 협의해야 합니다.
• !조직, 역할, 권한 기능은 아직 개발 중이며 iOS, Android, React Native, Flutter SDK도 아직 제공되지 않습니다.
• !셀프 호스팅하려면 백엔드와 관련 서비스를 직접 설정하거나 유료 Hanko Cloud를 이용해야 합니다.

토픽

자주 묻는 질문

hanko은(는) 무엇인가요?

패스키, 비밀번호, MFA, OAuth 및 SAML SSO와 웹 컴포넌트를 제공하는 오픈소스 인증·사용자 관리 백엔드입니다. Hanko는 프런트엔드 프레임워크에 관계없이 웹 앱에 통합할 수 있는 오픈소스 인증 및 사용자 관리 솔루션입니다. 비밀번호, 패스코드, 패스키, MFA(TOTP 및 보안 키), 소셜 로그인, SAML 엔터프라이즈 SSO를 지원하며, 패스키 전용 또는 OAuth 전용 로그인으로 구성할 수도 있습니다.

hanko은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

hanko은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

hanko은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. hanko의 마지막 커밋은 2026년 10월 20일입니다.

hanko은(는) 어디에 사용할 수 있나요?

웹 앱에 패스키 기반 비밀번호 없는 로그인을 추가할 때 호스팅형 인증 서비스를 자체 관리형 백엔드로 대체할 때 B2B 애플리케이션에 엔터프라이즈 SAML SSO를 제공할 때 JWT를 발급하는 인증 API를 기반으로 사용자 지정 로그인 UI를 구축할 때

hanko는 어떻게 설치하나요?

호스팅된 라이브 예제 또는 퀵스타트 앱에서 로그인 화면을 확인해 보세요 로컬에서 실행하려면 quickstart/README.md의 Docker 퀵스타트 가이드(‘Run the quickstart’ 섹션)를 따르세요 Docker 등을 사용하지 않고 설정하려면 백엔드 README를 따라 Hanko backend를 실행하세요 프레임워크별 예제와 가이드를 참고해 hanko-elements 웹 컴포넌트를 통합하세요

hanko은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/teamhanko/hanko