Getting Started
데모 준비물·기동 순서·개발용 자격 증명
두 개의 데모로 SnowPass 의 두 factor 를 시연한다.
| 데모 | 시나리오 | Factor |
|---|---|---|
| T-money 홈페이지 | 외부 사용자 회원가입 → 로그인 → PassKey 등록·인증 → Mobile Tmoney 소개 | PassKey (WebAuthn) |
| 카드관리시스템 (Card System) | 관리자 직원 등록 → 직원 로그인 → TOTP QR 등록 → 인증 → 대시보드 | TOTP (Google/Microsoft Authenticator) |
Prerequisites (준비물)
- JDK 17+ (빌드는 JDK 21 확인됨), Maven 3.9, Node 20
- Database: AWS RDS PostgreSQL — database
snowpass에 schemasnowpass(서버) /snowpass_demo(데모 2종 공용) 사용. 접속 정보는 Internal 문서 참고 - TOTP 시연용 스마트폰: Google Authenticator 또는 Microsoft Authenticator 설치
- PassKey 시연용 브라우저: Chrome/Safari/Edge (Touch ID·Windows Hello 가능 기기)
- localhost 는 secure context 라 HTTPS 없이 시연 가능
Start Order (기동 순서)
# 0) DB 는 RDS 를 사용하므로 별도 기동 불필요 (schema 는 앱이 자동 생성)
# 1) 라이브러리 빌드 (최초 1회)
cd mfa/snowpass-client-java && mvn install -DskipTests
cd ../snowpass-sdk-js && npm install && npm run build
# 2) SnowPass 서버 (포트 8080)
cd ../snowpass-server && mvn spring-boot:run
# 3) 데모 1 — T-money 홈페이지 (8081)
cd ../demo-tmoney-home && mvn spring-boot:run
# 4) 데모 2 — Card System 백엔드 (8082) + 관리자 웹 (5174)
cd ../demo-card-system/server && mvn spring-boot:run
cd ../admin-web && npm install && npm run dev
# 5) SnowPass 관리자 콘솔 (5173)
cd ../../snowpass-admin-web && npm install && npm run devDemo URLs
| 시스템 | URL |
|---|---|
| T-money 홈페이지 | http://localhost:8081 |
| Card System 직원 | http://localhost:5174/login |
| Card System 관리자 | http://localhost:5174/admin |
| SnowPass 콘솔 | http://localhost:5173 |
개발용 계정·API 키 seed 값은 Internal 문서 (내부 개발자 전용 빌드) 에서 관리한다.