포스트

Passkey 기반 MFA

Passkey 기반 MFA

이전 글인 TOTP 기반 2FA에서는 1차 인증과 최종 Session 사이에 MFA Challenge를 두고, 등록 상태와 Session의 인증 수준을 분리한 과정을 정리했다. TOTP는 범용적이고 현실적인 추가 인증 수단이지만 사용자가 별도의 인증 앱을 준비하고 6자리 코드를 옮겨 적어야 한다. 코드를 가짜 사이트에 직접 입력하면 공격자에게 전달될 수도 있다.

이번에는 기존 MFA 흐름을 다시 만들지 않고, Challenge를 통과하는 새로운 수단으로 Passkey를 추가했다. 사용자는 기기의 지문·얼굴·PIN으로 Local User Verification(기기 사용자 확인)을 하고, 서버는 공유 Secret 대신 공개키 서명을 검증한다.

이 글에서는 Passkey와 WebAuthn의 개념부터 등록·인증 Ceremony, 기존 MFA Challenge와 결합한 방법, Web·Native Client의 차이와 Credential 생명주기까지 정리한다. 실제 구현에서 사용한 제품명, Domain, RP ID, Origin, API 경로, App 식별자와 내부 정책 수치는 모두 일반화했다.


I. Passkey와 WebAuthn

1. Passkey는 공개키 Credential이다

FIDO Alliance는 Passkey를 특정 Platform에 종속된 기능이 아닌 FIDO Credential의 공통 명칭으로 설명한다. Passkey는 WebAuthn과 CTAP를 포함하는 FIDO2 기술을 바탕으로 한다.

Web 환경에서는 WebAuthn이 Relying Party와 Authenticator를 연결하는 Browser API를 정의한다. 등록에는 navigator.credentials.create()를 사용하고, 인증에는 navigator.credentials.get()을 사용한다.

구성요소역할
Relying PartyPasskey로 사용자를 인증하려는 Server와 Service
ClientBrowser 또는 Native Application
AuthenticatorPrivate Key를 보관하고 서명하는 Device 또는 Security Key
CredentialRP ID에 귀속된 Credential ID와 Key Pair

Authenticator는 노트북이나 휴대전화에 내장된 Platform Authenticator일 수도 있고, 별도의 Security Key 같은 Roaming Authenticator일 수도 있다. Passkey는 여러 Device 사이에 동기화되는 Synced Passkey와 한 Device에만 남는 Device-bound Passkey로도 나눌 수 있다.

2. 생체정보가 서버로 전달되는 것은 아니다

사용자가 Passkey를 선택하면 운영체제는 지문, 얼굴, PIN 또는 Device 암호로 User Verification을 수행할 수 있다. 그러나 서버가 지문이나 얼굴 데이터를 받는 구조는 아니다.

1
2
3
4
5
6
7
8
Device
  ├─ 지문·얼굴·PIN 확인
  ├─ Private Key 사용 승인
  └─ Challenge에 대한 서명 생성

Server
  ├─ Public Key로 서명 검증
  └─ User Verification Flag 확인

서버는 Authenticator가 User Verification을 수행했다는 UV Flag를 확인한다. 어떤 생체 방식이나 PIN을 사용했는지는 알 수 없고 알 필요도 없다.

이번 구현에서는 등록과 인증 모두 userVerification=required로 요청했다. 따라서 User Verification을 수행할 수 없거나 UV Flag가 없는 응답은 인증에 사용할 수 없다.

3. 이번에는 Passwordless Login이 아니라 MFA 수단으로 사용했다

Passkey의 대표적인 사용 사례는 Password를 대체하는 1차 인증이다. 하지만 Passkey를 반드시 Passwordless Login에만 사용해야 하는 것은 아니다.

이번 구조에서는 외부 Identity Provider를 통한 1차 인증 뒤에 Passkey를 추가 인증 수단으로 배치했다. 기존 TOTP, Passkey와 복구 수단 중 정책이 허용한 방법으로 MFA Challenge를 통과하면 정식 Session을 발급한다.

Passkey를 사용했다는 사실만으로 인증이 항상 2FA가 되는 것은 아니며, 전체 인증 흐름과 User Verification 정책을 함께 봐야 한다.


II. TOTP와 무엇이 다른가

1. Shared Secret 대신 비대칭키를 사용한다

TOTP에서는 서버와 Authenticator가 같은 Secret S를 가진다. 양쪽이 S와 현재 시각으로 같은 OTP를 계산해야 하므로 서버도 필요할 때 Secret을 복호화할 수 있어야 한다.

1
2
3
TOTP
Authenticator: OTP = TOTP(S, time)
Server:        OTP = TOTP(S, time)

Passkey에서는 Authenticator가 Private Key k를 보관하고 서버에는 Public Key K만 저장한다. 인증할 때 Authenticator가 새로운 Challenge에 서명하고 서버는 Public Key로 이를 검증한다.

1
2
3
Passkey
Authenticator: signature = SIGN(k, challenge + context)
Server:        VERIFY(K, signature, challenge + context)
항목TOTPPasskey
Server 저장값암호화된 Shared SecretCredential ID와 Public Key
사용자 동작일회용 코드 입력OS 인증 화면에서 승인
Freshness현재 Time StepServer가 만든 Random Challenge
피싱 저항성사용자가 코드를 전달할 수 있음RP ID와 Origin에 Credential이 귀속됨
시각 동기화필요필요하지 않음
Device 간 사용Secret을 다시 등록Passkey Provider 동기화 또는 추가 등록

DB의 Public Key와 Credential ID가 노출됐다고 그것만으로 유효한 서명을 만들 수는 없다. 하지만 Session 탈취, 계정 복구와 Client 취약점까지 해결되는 것은 아니므로 Public Key 인증 하나만으로 전체 보안이 끝나지는 않는다.

2. RP ID와 Origin이 Credential의 범위를 정한다

Passkey가 피싱에 강한 핵심 이유는 사용자가 사이트 이름을 보고 코드를 전달하지 않아도 된다는 데 있다. Authenticator와 Browser가 Credential의 RP ID 범위를 확인하고, 서버도 응답의 Origin과 rpIdHash를 검증한다.

1
2
3
4
5
RP ID   : example.com
Origin  : https://login.example.com

가능한 관계
Origin의 Domain이 RP ID와 같거나 그 하위 Domain

RP ID는 Scheme이나 Port를 포함하지 않는 Domain 문자열이고 Credential의 Scope가 된다. Origin은 https://login.example.com처럼 Scheme과 Host, Port를 포함하며 서버는 허용 목록과 정확히 비교해야 한다.

가짜 Domain에서는 정상 Authenticator가 원래 RP ID의 Credential을 사용하지 않는다. 공격자가 다른 곳에서 받은 Assertion을 전달하더라도 Challenge와 Origin이 현재 요청과 맞지 않으면 검증에 실패한다.

RP ID는 등록된 Credential의 귀속 범위이므로 운영 중 가볍게 변경할 수 있는 설정이 아니다. Domain 이전 가능성을 포함해 처음부터 Web과 Native Application이 함께 사용할 범위를 정해야 한다.


III. 기존 MFA 흐름에 Passkey를 추가한다

1. Session 구조는 유지하고 통과 방법만 늘린다

기존 흐름은 1차 인증이 끝난 뒤 바로 정식 Session을 발급하지 않고 제한된 MFA Transaction을 만든다. Passkey를 도입하면서 이 경계를 바꾸지 않고, MFA Transaction을 완료하는 수단만 확장했다.

flowchart LR
    P[1차 인증 완료] --> C[MFA Transaction]
    C --> T[TOTP]
    C --> K[Passkey]
    C --> R[Recovery Code]
    T --> V[MFA 검증 완료]
    K --> V
    R --> V
    V --> S[정식 Session 발급]

Passkey로 검증한 Session도 TOTP로 검증한 Session과 동일하게 MFA를 통과한 것으로 다룬다. Refresh 뒤에도 인증 수단이 사라지지 않도록 Refresh Session에 통과 방법을 기록하고 새 Access Token에 다시 반영했다.

권한 Guard가 TOTP와 Passkey의 세부 구현을 각각 알게 하지는 않았다. Session의 인증 방법을 입력받아 “MFA를 통과했는가”를 판단하는 공통 함수 하나를 두고 Gateway와 Application 정책이 이를 사용하게 했다.

2. 이름이 같은 두 Challenge를 구분한다

Passkey를 기존 MFA에 넣으면 서로 다른 두 상태가 모두 Challenge라고 불린다.

구분MFA Transaction ChallengeWebAuthn Challenge
질문이 사용자가 1차 인증 후 MFA를 진행 중인가?이 Assertion이 방금 요청에 대한 서명인가?
형태짧게 유지되는 Application 상태암호학적으로 안전한 Random Nonce
귀속사용자와 Client 유형Registration 또는 Authentication Ceremony
성공 시최종 Session 발급 후 소비검증한 Transaction과 함께 소비

MFA Transaction만 확인하면 과거 Assertion을 재전송할 수 있고, WebAuthn Challenge만 확인하면 이 사용자가 1차 인증을 마쳤는지 표현할 수 없다. 따라서 로그인용 MFA Transaction에 WebAuthn Challenge를 붙여 같은 흐름으로 묶었다.

1
2
3
4
5
MFA Transaction
  ├─ 1차 인증을 통과한 사용자
  ├─ Client 유형
  ├─ 실패 횟수와 만료 시각
  └─ 요청한 WebAuthn Challenge

Options를 요청한 것만으로는 인증 실패 횟수를 늘리지 않는다. 잘못된 Assertion은 기존 MFA 실패 제한에 포함하고, 성공하면 Transaction을 원자적으로 소비해 동시에 두 Session이 발급되지 않게 했다.

3. 인증 수단의 생명주기 정책도 함께 바꾼다

Passkey를 추가하면 TOTP 등록 여부라는 Boolean만으로는 상태를 표현할 수 없다. 등록된 수단의 집합과 현재 Session의 검증 상태를 나누어야 한다.

1
2
3
4
5
6
7
사용자 계정
└─ MFA Methods
   ├─ TOTP 0 또는 1개
   └─ Passkey 0개 이상

현재 Session
└─ MFA Verified + Method

적용한 정책은 다음과 같다.

  • TOTP 또는 Passkey 중 하나 이상을 등록하면 MFA 등록 상태로 본다.
  • 첫 번째 수단은 아직 MFA를 통과할 방법이 없으므로 제한된 로그인 Session에서 등록할 수 있다.
  • 두 번째 수단 추가, 수단 삭제와 복구 정보 변경은 이미 MFA를 통과한 Session만 허용한다.
  • 마지막으로 남은 MFA 수단은 삭제할 수 없다.
  • 복구 코드는 TOTP Credential이 아니라 사용자 계정에 귀속한다.

추가 수단 등록에 MFA를 요구하지 않으면 1차 인증 Session을 탈취한 공격자가 자신의 Passkey를 피해자 계정에 끼워 넣을 수 있다. 마지막 수단 삭제를 막지 않으면 복구 코드만 남은 상태가 사실상 MFA 해제가 될 수 있다.


IV. Passkey 등록 Ceremony

1. Server가 Options와 Challenge를 만든다

등록은 Client가 임의로 Key Pair를 만들어 Public Key만 보내는 작업이 아니다. Server가 계정과 RP 정보를 담은 PublicKeyCredentialCreationOptions를 먼저 만들고, Authenticator의 응답을 다시 검증해야 한다.

sequenceDiagram
    actor User
    participant Client
    participant Server as Relying Party
    participant Store as Challenge Store
    participant Auth as Authenticator

    User->>Client: Passkey 등록 요청
    Client->>Server: Registration Options 요청
    Server->>Server: Random Challenge 생성
    Server->>Store: 사용자와 Ceremony에 Challenge 저장
    Server-->>Client: Creation Options
    Client->>Auth: navigator.credentials.create
    Auth->>User: 지문·얼굴·PIN 확인
    Auth->>Auth: RP 전용 Key Pair 생성
    Auth-->>Client: PublicKeyCredential
    Client->>Server: Credential JSON
    Server->>Store: Challenge 원자적 조회와 소비
    Server->>Server: Challenge·RP ID·Origin·UV 검증
    Server->>Server: Credential ID와 Public Key 저장
    Server-->>Client: 등록 완료와 교체된 Session

이번 등록 Options에는 다음 정책을 넣었다.

  • userVerification=required: Local User Verification을 반드시 수행한다.
  • residentKey=preferred: Discoverable Credential을 선호하지만 지원하지 않는 Authenticator까지 무조건 배제하지 않는다.
  • excludeCredentials: 이 계정에 이미 등록한 Credential ID를 보내 중복 생성을 줄인다.
  • attestation=none: 특정 Authenticator 제조사나 Hardware 등급의 증명을 요구하지 않는다.

residentKey=preferred는 Discoverable Credential을 항상 강제한다는 뜻이 아니다. 이번 로그인은 1차 인증에서 사용자를 이미 식별하므로 Server가 해당 사용자의 Credential ID를 allowCredentials로 내려줄 수 있다.

2. Browser는 Options를 전달하고 결과를 직렬화한다

WebAuthn Options에는 ArrayBuffer로 변환해야 하는 Base64URL 값이 포함된다. 지원하는 Browser에서는 JSON 변환 API를 사용해 Server 응답을 WebAuthn 입력으로 바꿀 수 있다.

1
2
3
4
5
6
const publicKey =
  PublicKeyCredential.parseCreationOptionsFromJSON(options);

const credential = await navigator.credentials.create({ publicKey });

await submitRegistration(credential.toJSON());

Client가 RP ID나 Challenge를 새로 조립하지 않고 Server가 준 Options를 그대로 Platform API에 전달하도록 했다. Browser가 반환한 PublicKeyCredential도 toJSON() 결과를 Server에 보내고, 최종 신뢰 판단은 Server가 수행한다.

parseCreationOptionsFromJSON()과 toJSON()을 지원하지 않는 Browser까지 지원해야 한다면 Base64URL 변환을 직접 구현하거나 검증된 Client Library를 사용해야 한다. 기능 지원 여부를 먼저 확인하고 미지원 환경에서는 TOTP 같은 다른 수단을 제공하는 편이 안전하다.

3. Server는 응답 전체를 검증한 뒤 저장한다

Server는 Client가 보낸 Credential을 그대로 신뢰하지 않는다. 등록 응답에서 최소한 다음 항목을 검증한다.

  1. type이 등록 Ceremony에 맞는가?
  2. 응답의 Challenge가 Server가 발급한 값과 같은가?
  3. Origin이 정확히 허용된 값인가?
  4. rpIdHash가 기대한 RP ID와 일치하는가?
  5. User Presence와 필수 User Verification Flag가 있는가?
  6. Credential ID가 이미 다른 계정에 등록되지 않았는가?
  7. Attestation 형식과 Public Key를 정상적으로 파싱할 수 있는가?

Python에서는 직접 CBOR와 COSE Key를 해석하기보다 검증된 WebAuthn Library를 Adapter 뒤에 두었다.

1
2
3
4
5
6
7
verified = verify_registration_response(
    credential=credential,
    expected_challenge=challenge,
    expected_rp_id=rp_id,
    expected_origin=allowed_origins,
    require_user_verification=True,
)

검증이 끝난 뒤 저장하는 값은 다음과 같다.

저장값용도
Credential IDAssertion이 사용할 Credential 조회
Public KeySignature 검증
Signature Counter지원하는 Authenticator의 이상 징후 확인
TransportsClient가 보고한 사용 가능한 전송 경로 기록
표시 이름여러 Passkey를 사용자가 구분
생성·최근 사용 시각Credential 관리 화면과 사용 이력

Private Key, 지문·얼굴 정보와 Device PIN은 저장하지 않는다. Public Key는 비밀값이 아니지만 Credential ID와 함께 계정에 연결된 인증 데이터이므로 Log나 Analytics Event에 무분별하게 남기지 않는다.

4. Attestation을 요구하지 않은 이유

Attestation을 사용하면 Credential이 특정 Authenticator Model에서 만들어졌는지 검증하는 정책을 구성할 수 있다. 반면 Certificate Trust, Metadata와 Device 호환성을 추가로 운영해야 하고 Authenticator 식별 정보에 대한 Privacy도 고려해야 한다.

이번 요구사항은 특정 Hardware 제품만 허용하는 것이 아니라 사용자가 가진 Platform Passkey를 MFA 수단으로 제공하는 것이었다. 따라서 Attestation Conveyance를 none으로 두고, Challenge·RP ID·Origin·UV와 Signature 검증에 집중했다.

Attestation을 요구하지 않는다는 것은 서명 검증을 생략한다는 뜻이 아니라, Key가 특정 Hardware에서 생성됐다는 별도의 출처 증명을 요구하지 않는다는 뜻이다.


V. Passkey 인증 Ceremony

1. Authenticator가 새로운 Challenge에 서명한다

인증에서는 등록 때 저장한 Public Key에 대응하는 Private Key를 현재 사용자가 사용할 수 있는지 확인한다. Server가 새 Challenge를 만들고, Authenticator가 authenticatorData와 clientDataJSON의 Hash를 포함한 값에 서명한다.

sequenceDiagram
    actor User
    participant Client
    participant Server as Relying Party
    participant Store as MFA Transaction Store
    participant Auth as Authenticator

    Client->>Server: Authentication Options 요청
    Server->>Store: MFA Transaction에 Challenge 연결
    Server-->>Client: Request Options + Allow Credentials
    Client->>Auth: navigator.credentials.get
    Auth->>User: 지문·얼굴·PIN 확인
    Auth->>Auth: Private Key로 Assertion 서명
    Auth-->>Client: Assertion
    Client->>Server: Credential JSON
    Server->>Server: Credential 소유자와 Public Key 조회
    Server->>Server: Challenge·RP ID·Origin·UV·Signature 검증
    Server->>Store: MFA Transaction 원자적 소비
    Server-->>Client: 정식 또는 승격된 Session

Browser의 호출 형태는 등록과 비슷하다.

1
2
3
4
5
6
const publicKey =
  PublicKeyCredential.parseRequestOptionsFromJSON(options);

const credential = await navigator.credentials.get({ publicKey });

await submitAssertion(credential.toJSON());

이번 구조는 Username-less Passkey Login이 아니다. 1차 인증으로 사용자가 이미 식별되었기 때문에 Server가 그 사용자의 Credential ID 목록을 allowCredentials에 넣는다.

2. Signature 하나만 확인해서는 부족하다

Assertion 검증에서는 다음 조건을 함께 확인한다.

  • Credential ID가 현재 사용자의 등록된 Passkey인가?
  • 응답의 type과 Challenge가 현재 Authentication 요청과 일치하는가?
  • Origin과 rpIdHash가 기대한 Relying Party 범위인가?
  • UP와 필수 UV Flag가 설정됐는가?
  • 저장한 Public Key로 Signature가 검증되는가?
  • Signature Counter가 정책상 허용되는가?
1
2
3
4
5
6
7
8
9
verified = verify_authentication_response(
    credential=credential,
    expected_challenge=challenge,
    expected_rp_id=rp_id,
    expected_origin=allowed_origins,
    credential_public_key=stored_public_key,
    credential_current_sign_count=stored_sign_count,
    require_user_verification=True,
)

검증에 성공하면 먼저 MFA Transaction을 원자적으로 소비한다. 그 뒤 새 Counter와 최근 사용 시각을 저장하고 Session을 발급해 같은 Assertion의 동시 제출이 여러 Session을 만들지 못하게 했다.

3. Login과 Step-up은 같은 검증기를 공유한다

새 로그인에서는 1차 인증 뒤 만들어진 MFA Transaction에 WebAuthn Challenge를 연결한다. 성공하면 처음으로 정식 Access·Refresh Session을 발급한다.

Step-up에서는 이미 존재하는 Session의 사용자를 기준으로 별도의 짧은 WebAuthn Ceremony를 만든다. 성공하면 현재 Refresh Session을 폐기하고 Passkey 검증 사실이 담긴 새 Session으로 교체한다.

1
2
3
4
5
Login
1차 인증 → MFA Transaction → Passkey Assertion → 새 Session

Step-up
기존 Session → Passkey Assertion → 기존 Refresh 폐기 → 승격된 Session

Web과 Native Client는 Session 교체 중 자동 Refresh가 동시에 실행되지 않도록 한 경로에서 Token을 교체해야 한다. 폐기된 Refresh Token을 뒤늦은 요청이 다시 사용하면 정상적인 Step-up 직후 로그아웃되는 Race가 생길 수 있다.


VI. Credential 생명주기

1. 여러 Passkey를 등록할 수 있게 한다

사용자는 휴대전화, 노트북과 Security Key에 서로 다른 Passkey를 만들 수 있다. 하나의 Boolean 대신 Credential 목록을 두고 각 항목에 사용자가 구분할 이름과 생성·최근 사용 시각을 제공했다.

중복 등록은 두 곳에서 막았다.

  • Options의 excludeCredentials로 Authenticator가 이미 알려진 Credential을 다시 만들지 않게 한다.
  • Server 저장소에서도 Credential ID에 Unique Constraint를 두어 다른 계정을 포함한 중복을 거부한다.

Client의 중복 방지는 사용자 경험을 위한 장치이고, Server의 Unique Constraint가 최종 무결성 경계다.

2. 추가·삭제에는 현재 MFA 증명을 요구한다

첫 번째 MFA 수단은 비교할 기존 수단이 없으므로 1차 인증을 마친 제한된 Session에서 등록할 수 있다. 하지만 이미 수단이 하나라도 있다면 새 Passkey 추가 전에 현재 MFA를 다시 확인한다.

1
2
3
4
5
MFA 수단이 없음
└─ 제한된 로그인 Session으로 첫 수단 등록

MFA 수단이 있음
└─ MFA Verified Session만 추가·삭제 가능

삭제에서도 같은 원칙을 적용하고, TOTP와 Passkey를 합쳐 마지막 하나는 지울 수 없게 했다. 기기를 잃어 모든 수단을 사용할 수 없는 경우는 일반 삭제가 아니라 별도의 본인 확인과 계정 복구 절차로 다룬다.

복구 코드는 특정 TOTP나 Passkey 아래에 두지 않고 사용자 계정에 귀속했다. 그래야 TOTP를 지우고 Passkey만 남거나 그 반대가 되어도 같은 복구 정책을 유지할 수 있다.

3. Signature Counter를 절대적인 판정으로 보지 않는다

WebAuthn의 signCount는 복제된 Authenticator의 이상 징후를 찾는 데 도움을 줄 수 있다. 이전 값보다 새 값이 작거나 같다면 복제, Authenticator 오작동 또는 요청 순서 Race를 의심할 수 있다.

그러나 모든 Authenticator가 Counter를 구현하는 것은 아니다. WebAuthn 명세는 Counter를 지원하지 않는 Authenticator가 값을 계속 0으로 둘 수 있다고 설명한다. Synced Passkey에서도 0을 사용하는 구현이 있으므로 Counter가 증가하지 않는다는 이유만으로 모든 인증을 거부할 수는 없다.

이번 구현에서는 다음 규칙을 사용했다.

  • 기존 값과 새 값이 모두 0이면 Counter를 Clone 판정에 사용하지 않는다.
  • 둘 중 하나라도 0이 아니고 새 값이 기존 값보다 작거나 같으면 검증을 거부한다.
  • 성공한 새 값을 저장하되 Counter만으로 Authenticator의 진위를 단정하지 않는다.

Counter는 Challenge, RP ID, Origin, UV와 Signature 검증을 보완하는 Signal이지 그 검증들을 대신하는 장치가 아니다.


VII. Web과 Native Application

1. 같은 Ceremony를 다른 Platform API로 실행한다

Server는 Web과 Native Client에 같은 WebAuthn JSON 형태의 Options를 제공한다. Web은 Browser의 Credential Management API를 사용하고, Native Application은 운영체제의 Passkey API를 사용한다.

1
2
3
4
5
6
Server Options JSON
  ├─ Web    → navigator.credentials.create / get
  └─ Native → Platform Passkey API

Platform Credential JSON
  └─ Server의 동일한 WebAuthn Verifier

Client는 Passkey 지원 여부를 먼저 확인한다. 지원하지 않는 Browser나 OS에서는 Passkey 버튼을 숨기고 TOTP 같은 대체 수단을 유지했다.

사용자가 OS 인증 화면을 닫은 경우도 Server 오류와 구분해야 한다. 취소는 치명적 오류로 표시하지 않고 현재 화면에 남겨 다시 시도하거나 다른 수단을 선택할 수 있게 하는 편이 자연스럽다.

2. Native App과 RP Domain을 연결한다

Web에서는 Origin의 Domain 관계를 Browser가 확인할 수 있다. Native Application이 같은 RP ID의 Passkey를 사용하려면 App과 Domain이 서로 연결돼 있음을 Platform에 증명해야 한다.

PlatformDomain에 필요한 연결Application 설정
Apple/.well-known/apple-app-site-associationwebcredentials:<RP ID> Associated Domain
Android/.well-known/assetlinks.jsonPackage와 Signing Certificate 관계

Apple은 Passkey 요청에 webcredentials Associated Domain을 요구한다. Android은 Digital Asset Links로 Website와 App이 같은 RP ID를 공유하도록 안내한다.

Association 파일에는 실제 App ID나 Signing Certificate Hash가 들어간다. 따라서 예제 값을 운영 파일에 남기지 않고, HTTPS에서 Redirect 없이 올바른 Content-Type으로 제공되는지 배포 환경별로 검증해야 한다.

Server의 허용 Origin에도 Web Origin과 Platform이 전달하는 Native App Origin을 명시적으로 등록한다. 모든 Origin을 넓게 허용하는 방식은 Passkey의 중요한 보안 경계를 약화시킨다.

3. RP ID는 환경과 배포 전략의 일부다

Local, Test와 Production 환경이 서로 다른 Domain을 사용하면 RP ID와 허용 Origin도 환경별로 분리해야 한다. 다른 환경의 Credential이나 설정으로 자동 Fallback하지 않고 필수 설정이 빠졌을 때 검증을 실패시키는 편이 안전하다.

WebAuthn은 HTTPS Secure Context에서 사용하며 localhost에는 개발을 위한 예외가 있다. 등록을 시작한 뒤 RP ID를 바꾸면 기존 Passkey를 새 RP ID에서 사용할 수 없으므로 Domain과 Native Association을 기능 배포 전에 먼저 확정해야 한다.


VIII. 구현 경계와 검증

1. WebAuthn Library를 Infrastructure 경계에 둔다

WebAuthn 검증은 Challenge 비교 하나로 끝나지 않는다. CBOR, COSE Key, Attestation Object, Authenticator Data와 Signature Algorithm을 정확히 처리해야 한다.

직접 구현하기보다 WebAuthn Library를 Infrastructure Adapter로 두고 Application은 다음 Port만 사용하게 했다.

계층책임
ClientOptions 변환, Platform API 호출과 Credential JSON 직렬화
PresentationWeb·Native 요청 형식과 Session 전달 방식 변환
ApplicationCeremony 순서, Challenge, 수단 정책과 Session 교체
DomainPasskey Credential과 사용 기록
InfrastructureWebAuthn 생성·검증 Library, DB와 짧은 Challenge 저장소
1
2
3
4
5
6
7
Application
  → Passkey Authenticator Port
      ← WebAuthn Library Adapter

Application
  → Passkey Repository Port
      ← Database Repository

이 경계를 두면 Application Test에서는 실제 Verifier를 사용할 수도 있고, WebAuthn Library 교체가 인증 수단 정책 전체로 퍼지는 것도 줄일 수 있다.

2. 문자열 Mock보다 실제 서명을 검증한다

단순 Mock이 항상 “검증 성공”을 반환하면 Origin이나 Challenge 비교를 빼먹어도 Test가 통과한다. 그래서 Test용 Software Authenticator가 실제 EC Key Pair를 만들고 Registration과 Assertion Payload를 서명하도록 했다.

Production WebAuthn Verifier에 이 응답을 넣어 다음 항목을 확인했다.

검증 Case기대 결과
정상 Registration과 Assertion성공
다른 Private Key의 Signature거부
다른 Origin거부
오래되거나 다른 Challenge거부
UV Flag 없음거부
등록되지 않은 Credential ID거부
의미 있는 Counter 역행거부
소비한 MFA Transaction 재사용거부
마지막 MFA 수단 삭제거부
기존 TOTP 흐름계속 성공

Registration·Login·Step-up과 Session 교체까지 Application과 HTTP 경계에서 검증했다. 다만 이는 구현 단계의 Test 결과이며 실제 사용자 환경의 성공률이나 운영 성능을 측정한 결과는 아니다.


IX. 구현 결과와 한계

1. 기존 MFA 구조를 재사용할 수 있었다

기존 MFA Transaction과 Session 경계를 유지하면서 TOTP 외에 Passkey를 선택할 수 있는 구조로 확장했다. Passkey 전용으로 새 로그인 체계를 만들지 않았기 때문에 다음 부분을 그대로 재사용할 수 있었다.

  • 1차 인증 후 정식 Session 발급을 보류하는 흐름
  • Web과 Native의 MFA Transaction 전달 방식
  • 실패 횟수 제한과 원자적 Challenge 소비
  • Session의 MFA 인증 수준과 권한 Guard
  • Step-up과 Refresh Session 교체
  • 복구 코드와 계정 복구 정책

서버에는 Passkey Private Key나 TOTP와 같은 Shared Secret을 추가로 저장하지 않는다. 사용자가 코드를 옮겨 적지 않고 Platform UI에서 확인하며, Assertion은 RP ID와 Origin에 묶여 TOTP보다 피싱에 강한 특성을 갖는다.

가장 큰 구현 결과는 새로운 인증 기술을 별도 흐름으로 고립시키지 않고, 기존 MFA 상태 모델의 또 하나의 검증 수단으로 넣은 것이다.

2. Passkey만으로 사라지지 않는 문제도 있다

Passkey는 강한 인증 수단이지만 다음 문제를 자동으로 해결하지는 않는다.

  • 이미 발급된 Session이나 Client Application 자체의 탈취
  • Passkey Provider와 Cloud Sync 계정의 복구 보안
  • 모든 Device를 잃었을 때의 계정 복구
  • 구형 Browser와 OS의 호환성
  • RP ID 또는 Domain 이전
  • Native Association 파일과 App Signing Key 운영
  • 사용자가 Platform 인증 화면을 취소하거나 Passkey 저장소를 사용할 수 없는 상황

Attestation을 요구하지 않았으므로 등록한 Credential이 특정 Hardware 등급에서 생성됐다고 보증할 수도 없다. Synced Passkey까지 허용하므로 모든 Passkey를 Hardware-bound Key라고 부르는 것도 정확하지 않다.

또한 약한 복구 경로를 그대로 두면 강한 Passkey 인증의 전체 효과가 복구 경로 수준으로 낮아질 수 있다. 복구 코드, 관리자 지원과 Session 폐기 정책을 Passkey 도입과 함께 점검해야 한다.


X. 정리

이번 구현에서 Passkey는 기존 인증을 모두 대체하는 Passwordless Login이 아니었다. 1차 인증 뒤의 MFA Transaction을 TOTP 또는 Passkey로 통과할 수 있게 만든 추가 수단이었다.

핵심은 다음과 같다.

  1. Authenticator는 Private Key와 Local User Verification을 담당하고, Server는 Public Key와 검증 Metadata만 저장한다.
  2. WebAuthn Challenge를 기존 MFA Transaction에 바인딩하고 성공 시 Transaction을 원자적으로 소비한다.
  3. Challenge, RP ID, Origin, UV와 Signature를 모두 검증한다.
  4. 추가 수단 등록과 삭제에는 이미 MFA를 통과한 Session을 요구하고 마지막 수단은 지우지 못하게 한다.
  5. Web과 Native Application은 같은 Ceremony를 사용하되 Native에서는 Domain Association을 별도로 구성한다.
  6. Signature Counter, Attestation과 복구 경로의 한계를 별도 정책으로 다룬다.

Passkey API를 호출하는 Client 코드는 짧다. 실제 설계의 대부분은 Credential을 만드는 순간보다 Challenge를 어떤 상태에 묶고, 어떤 Session을 발급하며, Credential 생명주기를 어떻게 제한할 것인가에 있었다.


XI. 참고

  1. W3C - Web Authentication: An API for accessing Public Key Credentials Level 3
  2. FIDO Alliance - Passkeys
  3. RFC 8176 - Authentication Method Reference Values
  4. Apple Developer - Supporting Passkeys
  5. Android Developers - Choose the right Passkey implementation
이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.