"""패스키(WebAuthn) 등록과 로그인을 붙인 Flask 연습 앱. 저장소는 메모리라 재시작하면 사라집니다.""" from flask import Flask, jsonify, request, session from webauthn import ( generate_authentication_options, generate_registration_options, options_to_json, verify_authentication_response, verify_registration_response, ) from webauthn.helpers import base64url_to_bytes, bytes_to_base64url from webauthn.helpers.structs import ( PublicKeyCredentialDescriptor, UserVerificationRequirement, ) PORT = 5050 RP_ID = "localhost" # 도메인만. 포트와 스킴은 넣지 않습니다. RP_NAME = "Passkey Lab" EXPECTED_ORIGIN = f"http://localhost:{PORT}" # 서버가 믿는 유일한 origin app = Flask(__name__) app.secret_key = "lab-only-secret-key" # 실습용 고정값. 운영에서는 환경 변수로 주입합니다. # 비밀번호 로그인과 비교하려고 비밀번호 계정도 하나 둡니다. 실습용 평문입니다. USERS = {"alice": {"password": "Summer2024!", "id": b"user-alice-0001", "creds": {}}} EVENTS = [] # 화면에 보여 줄 서버 쪽 판정 기록 def log(kind, ok, detail): EVENTS.append({"kind": kind, "ok": ok, "detail": detail}) del EVENTS[:-12] def fail(kind, exc): log(kind, False, f"{type(exc).__name__}: {exc}") return jsonify(ok=False, error=str(exc)), 400 @app.get("/") def index(): return PAGE @app.get("/state") def state(): u = USERS["alice"] return jsonify( user=session.get("user"), via=session.get("via"), host=request.host, creds=[{"id": cid[:12] + "...", "sign_count": c["sign_count"]} for cid, c in u["creds"].items()], events=EVENTS, ) @app.post("/pw-login") def pw_login(): data = request.get_json() user = USERS.get(data.get("username")) if user and user["password"] == data.get("password"): session.clear() session["user"], session["via"] = data["username"], "password" log("password", True, f"비밀번호 로그인 허용 (접속 주소 {request.host})") return jsonify(ok=True) log("password", False, "비밀번호 불일치") return jsonify(ok=False), 401 @app.post("/register/options") def register_options(): if session.get("via") != "password": return jsonify(ok=False, error="먼저 비밀번호로 로그인하세요"), 401 user = USERS[session["user"]] opts = generate_registration_options( rp_id=RP_ID, rp_name=RP_NAME, user_id=user["id"], user_name=session["user"], exclude_credentials=[ PublicKeyCredentialDescriptor(id=base64url_to_bytes(cid)) for cid in user["creds"] ], ) session["challenge"] = bytes_to_base64url(opts.challenge) # 서버가 발급한 값을 저장 return app.response_class(options_to_json(opts), mimetype="application/json") @app.post("/register/verify") def register_verify(): challenge = session.pop("challenge", None) # 꺼내면서 지웁니다. 1회용입니다. if challenge is None: return fail("register", ValueError("발급된 챌린지가 없거나 이미 사용했습니다")) user = USERS[session["user"]] try: v = verify_registration_response( credential=request.get_json(), expected_challenge=base64url_to_bytes(challenge), expected_rp_id=RP_ID, expected_origin=EXPECTED_ORIGIN, ) except Exception as exc: return fail("register", exc) user["creds"][bytes_to_base64url(v.credential_id)] = { "public_key": v.credential_public_key, "sign_count": v.sign_count, } log("register", True, f"패스키 등록 (공개키 {len(v.credential_public_key)}바이트 저장, 개인키는 서버에 없음)") return jsonify(ok=True) @app.post("/login/options") def login_options(): user = USERS["alice"] opts = generate_authentication_options( rp_id=RP_ID, allow_credentials=[ PublicKeyCredentialDescriptor(id=base64url_to_bytes(cid)) for cid in user["creds"] ], user_verification=UserVerificationRequirement.PREFERRED, ) session["challenge"] = bytes_to_base64url(opts.challenge) return app.response_class(options_to_json(opts), mimetype="application/json") @app.post("/login/verify") def login_verify(): challenge = session.pop("challenge", None) # 1회용 if challenge is None: return fail("login", ValueError("발급된 챌린지가 없거나 이미 사용했습니다")) body = request.get_json() cred = USERS["alice"]["creds"].get(body.get("id")) if cred is None: return fail("login", ValueError("등록되지 않은 패스키입니다")) try: v = verify_authentication_response( credential=body, expected_challenge=base64url_to_bytes(challenge), expected_rp_id=RP_ID, expected_origin=EXPECTED_ORIGIN, # 다른 origin 에서 만든 서명은 여기서 거부 credential_public_key=cred["public_key"], credential_current_sign_count=cred["sign_count"], ) except Exception as exc: return fail("login", exc) cred["sign_count"] = v.new_sign_count # 카운터를 올려 저장 session.clear() session["user"], session["via"] = "alice", "passkey" log("login", True, f"패스키 로그인 허용 (서명 카운터 {v.new_sign_count})") return jsonify(ok=True, sign_count=v.new_sign_count) @app.post("/logout") def logout(): session.clear() return jsonify(ok=True) PAGE = """Passkey Lab

Passkey Lab

접속 주소: (서버가 믿는 origin: http://localhost:5050)
1. 비밀번호 로그인
2. 패스키 등록 (비밀번호로 로그인한 뒤)
3. 패스키 로그인
서버 판정 기록
""" if __name__ == "__main__": # evil.localhost 로도 접속해 볼 수 있게 localhost 이름 전체에서 받습니다. app.run(host="127.0.0.1", port=PORT)