Cloudflare Workers + Passkey 인증 구현과 비용 계산
김성진수정일
핵심 요약
Workers·D1·KV와 Passkey(WebAuthn)로 인증 흐름을 구현하는 방법. 무료 한도와 Paid 기본료, 요청·저장소 사용량을 구분해 비용을 계산하고 검증 항목을 정리했다.
서비스 성장의 부메랑: Auth SaaS 청구서 폭탄
스타트업과 개별 개발팀이 새로운 서비스를 출시할 때 가장 먼저 도입하는 것 중 하나가 Auth0, Clerk, Firebase Auth, Firebase Authentication과 같은 외부 인증 SaaS(Software as a Service)다.
비밀번호 암호화, 소셜 로그인(Google, Apple), MFA(다소소 인증)를 직접 구현하는 위험을 피하고 빠르게 프로토타입을 론칭하기에는 최고의 선택이다. 하지만 서비스가 성장하고 월간 활성 사용자(MAU)가 1만 명, 10만 명을 넘어서는 순간, Auth SaaS는 가장 무서운 **“클라우드 요금 폭탄”**으로 돌아온다.
인증 서비스의 청구 기준은 제품·플랜마다 다르다. MAU만으로 모든 서비스의 청구액을 비교할 수 없고, 같은 MAU라도 로그인 횟수와 저장소 접근량이 다르다. 이 글에서는 특정 SaaS의 비용을 확정하지 않고 직접 구현할 때의 과금 항목을 나눠 본다.
Workers + Passkey가 항상 $0이거나 전 세계에서 5ms 이내로 응답하는 것은 아니다. 무료 한도 안에서는 사용료가 없을 수 있지만 Workers Paid에는 기본료가 있고, D1·KV는 별도 사용량과 한도가 있다. 지연시간도 사용자 위치·네트워크·데이터 배치·검증 방식에 따라 달라진다.
이 글에서는 Auth SaaS의 과금 한계부터, Passkey(WebAuthn) 인증 파이프라인의 내부 작동 원리, Cloudflare Workers + KV + D1 + Web Crypto 연동 실전 코드, 그리고 보안 검증 모듈까지 완전 다룬다.
Auth SaaS vs Cloudflare Native Passkey 아키텍처 비교
| 비교 항목 | 전통적 Auth SaaS (Auth0 / Clerk) | Cloudflare Native Passkey (Workers + D1) |
|---|---|---|
| 월간 비용 | 제품·플랜·활성 사용자 기준으로 계산 | Workers 플랜 + 요청·CPU·D1·KV 사용량으로 계산 |
| 인증 지연시간 | 사용자 위치와 서비스 배치에 따라 측정 | Workers·저장소·클라이언트를 포함해 측정 |
| 비밀번호 유출 위험 | 존재 (해시된 데이터베이스 유출 가능성) | 완전 0 (비밀번호 없음, 공개키 방식) |
| 사용자 경험 (UX) | 이메일/비밀번호 입력 및 OTP 입력 | 지문 / FaceID 1초 간편 생체 인증 |
| 벤더 락인 (Vendor Lock-in) | 높음 (유저 DB 추출 및 이관 복잡) | 없음 (표준 W3C WebAuthn & SQLite D1) |
Passkey (WebAuthn) 동작 원리: 챌린지 기반 공개키 암호학
Passkey는 사용자의 디바이스(iPhone, Android, Mac, Windows) 내의 보안 칩(Secure Enclave)을 활용한다. 서버는 비밀번호를 저장하는 대신, 유저의 **공개키(Public Key)**만을 데이터베이스(Cloudflare D1)에 보관한다.
+-----------------------------------------------------------------------------------+
| Passkey (WebAuthn) 로그인 흐름 |
+-----------------------------------------------------------------------------------+
[사용자 (지문/FaceID)] [Cloudflare Workers 에지] [Cloudflare D1 DB]
| | |
|--- 1. 로그인 요청 ---------->| |
| |--- 2. 렌덤 Challenge 생성 ---->| (Workers KV 보관)
|<-- 3. Challenge 반환 --------| |
| | |
(보안칩에서 챌린지에 서명) | |
| | |
|--- 4. 서명(Signature) 전달 ->| |
| |--- 5. 저장된 공개키 조회 ------>|
| |--- 6. Web Crypto 서명 검증 |
|<-- 7. 인증 성공 (JWT 발급) ---| |
- Challenge 발급: 서버가 무작위 난수 챌린지(Challenge)를 생성하고 2분간 유효하도록 Workers KV에 저장한다.
- 디바이스 서명: 사용자가 지문이나 FaceID로 본인 확인을 마치면 디바이스의 개인키(Private Key)로 챌린지에 서명한다.
- Web Crypto 서명 검증: 서버는 D1에 저장된 유저의 공개키로 해당 서명이 유효한지
crypto.subtle.verify()로 검증한다. - JWT 세션 발급: 검증이 성공하면 HTTP-Only Cookie 또는 Bearer JWT 토큰을 발급한다.
이 과정에서 비밀번호는 전송하지 않는다. 다만 credential ID·서명·사용자 식별 정보 등은 오가므로 HTTPS와 적절한 접근 제어는 계속 필요하다.
1단계: 스토리지 설계 (Cloudflare D1 + Workers KV)
Passkey 인증을 위해 2개의 스토리지 레벨을 사용한다.
- Workers KV: 2분 뒤 자동 만료(TTL)되어야 하는 일회성 로그인 챌린지 보관용 (초고속 읽기/쓰기)
- Cloudflare D1 (SQLite): 유저 계정 정보 및 Passkey 공개키(Credential ID, Public Key, Sign Counter) 영구 보관용
D1 데이터베이스 스키마 (schema.sql)
-- D1 Database Schema: schema.sql
-- 유저 테이블
CREATE TABLE IF NOT EXISTS users (
id TEXT PRIMARY KEY,
email TEXT NOT NULL UNIQUE,
name TEXT NOT NULL,
created_at INTEGER NOT NULL
);
-- Passkey 자격증명(Credentials) 테이블
CREATE TABLE IF NOT EXISTS passkey_credentials (
id TEXT PRIMARY KEY, -- Credential ID (Base64URL)
user_id TEXT NOT NULL,
public_key TEXT NOT NULL, -- COSE / WebCrypto 호환 공개키 (Base64)
counter INTEGER NOT NULL DEFAULT 0,-- 클론 공격 방지용 서명 카운터
transports TEXT, -- 'internal', 'hybrid', 'ble' 등
created_at INTEGER NOT NULL,
FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
);
CREATE INDEX IF NOT EXISTS idx_credentials_user_id ON passkey_credentials(user_id);
wrangler.jsonc 바인딩 추가:
// wrangler.jsonc
{
"$schema": "node_modules/wrangler/config-schema.json",
"name": "edge-passkey-auth",
"main": "src/index.ts",
"compatibility_date": "2026-01-01",
"compatibility_flags": ["nodejs_compat"],
// 1. 챌린지 임시 보관용 KV
"kv_namespaces": [
{
"binding": "AUTH_KV",
"id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
],
// 2. 유저 및 공개키 영구 보관용 D1
"d1_databases": [
{
"binding": "DB",
"database_name": "passkey_db",
"database_id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
}
]
}
2단계: Web Crypto API 및 Passkey 백엔드 구현 (Hono.js)
SimpleWebAuthn 커뮤니티 표준 라이브러리와 Cloudflare의 Native crypto.subtle을 결합하여 경량 백엔드를 작성한다.
패키지 설치
npm install hono @simplewebauthn/server jose
서버리스 인증 API 서버 (src/index.ts)
// src/index.ts
import { Hono } from "hono";
import { cors } from "hono/cors";
import {
generateRegistrationOptions,
verifyRegistrationResponse,
generateAuthenticationOptions,
verifyAuthenticationResponse,
} from "@simplewebauthn/server";
import { SignJWT, jwtVerify } from "jose";
type Env = {
Bindings: {
AUTH_KV: KVNamespace;
DB: D1Database;
JWT_SECRET: string;
};
};
const app = new Hono<Env>();
app.use("*", cors({ origin: "*", credentials: true }));
const RP_NAME = "EffiDev App";
const RP_ID = "effidev.dev"; // 실제 가동 도메인
const ORIGIN = `https://${RP_ID}`;
// -------------------------------------------------------------------
// 1. Passkey 등록 (회원가입/기기 추가) - Step 1: 챌린지 생성
// -------------------------------------------------------------------
app.post("/api/auth/register/options", async (c) => {
const { email, name } = await c.req.json();
// D1에서 유저 조회 또는 임시 생성
let user = await c.env.DB.prepare("SELECT * FROM users WHERE email = ?").bind(email).first();
const userId = user ? (user.id as string) : crypto.randomUUID();
if (!user) {
await c.env.DB.prepare(
"INSERT INTO users (id, email, name, created_at) VALUES (?, ?, ?, ?)"
).bind(userId, email, name, Date.now()).run();
}
// 기존 등록된 Passkey 조회
const credentials = await c.env.DB.prepare(
"SELECT id FROM passkey_credentials WHERE user_id = ?"
).bind(userId).all();
const excludeCredentials = credentials.results.map((cred) => ({
id: cred.id as string,
transports: ["internal" as const, "hybrid" as const],
}));
// WebAuthn 등록 옵션 생성
const options = await generateRegistrationOptions({
rpName: RP_NAME,
rpID: RP_ID,
userID: new TextEncoder().encode(userId),
userName: email,
userDisplayName: name,
attestationType: "none",
excludeCredentials,
authenticatorSelection: {
residentKey: "required",
userVerification: "preferred",
},
});
// KV에 챌린지 저장 (TTL: 2분)
await c.env.AUTH_KV.put(`reg_challenge:${userId}`, options.challenge, { expirationTtl: 120 });
return c.json({ options, userId });
});
// -------------------------------------------------------------------
// 2. Passkey 등록 - Step 2: 디바이스 서명 검증 및 공개키 D1 저장
// -------------------------------------------------------------------
app.post("/api/auth/register/verify", async (c) => {
const { userId, response } = await c.req.json();
const expectedChallenge = await c.env.AUTH_KV.get(`reg_challenge:${userId}`);
if (!expectedChallenge) {
return c.json({ error: "Challenge expired or invalid" }, 400);
}
// 챌린지 즉시 폐기
await c.env.AUTH_KV.delete(`reg_challenge:${userId}`);
const verification = await verifyRegistrationResponse({
response,
expectedChallenge,
expectedOrigin: ORIGIN,
expectedRPID: RP_ID,
});
if (!verification.verified || !verification.registrationInfo) {
return c.json({ error: "Registration verification failed" }, 400);
}
const { credential } = verification.registrationInfo;
// D1에 공개키 저장 (Base64 인코딩)
await c.env.DB.prepare(
`INSERT INTO passkey_credentials (id, user_id, public_key, counter, created_at)
VALUES (?, ?, ?, ?, ?)`
).bind(
credential.id,
userId,
Buffer.from(credential.publicKey).toString("base64"),
credential.counter,
Date.now()
).run();
return c.json({ success: true, message: "Passkey registered successfully" });
});
// -------------------------------------------------------------------
// 3. Passkey 로그인 - Step 1: 챌린지 발급
// -------------------------------------------------------------------
app.post("/api/auth/login/options", async (c) => {
const options = await generateAuthenticationOptions({
rpID: RP_ID,
userVerification: "preferred",
});
const sessionChallengeId = crypto.randomUUID();
await c.env.AUTH_KV.put(`auth_challenge:${sessionChallengeId}`, options.challenge, { expirationTtl: 120 });
return c.json({ options, sessionChallengeId });
});
// -------------------------------------------------------------------
// 4. Passkey 로그인 - Step 2: 서명 검증 및 초고속 JWT 발급
// -------------------------------------------------------------------
app.post("/api/auth/login/verify", async (c) => {
const { sessionChallengeId, response } = await c.req.json();
const expectedChallenge = await c.env.AUTH_KV.get(`auth_challenge:${sessionChallengeId}`);
if (!expectedChallenge) {
return c.json({ error: "Challenge expired" }, 400);
}
await c.env.AUTH_KV.delete(`auth_challenge:${sessionChallengeId}`);
// D1에서 저장된 Passkey 자격증명 조회
const credRecord = await c.env.DB.prepare(
"SELECT * FROM passkey_credentials WHERE id = ?"
).bind(response.id).first();
if (!credRecord) {
return c.json({ error: "Passkey not found" }, 404);
}
const publicKey = new Uint8Array(Buffer.from(credRecord.public_key as string, "base64"));
// 서명 검증
const verification = await verifyAuthenticationResponse({
response,
expectedChallenge,
expectedOrigin: ORIGIN,
expectedRPID: RP_ID,
credential: {
id: credRecord.id as string,
publicKey,
counter: credRecord.counter as number,
},
});
if (!verification.verified) {
return c.json({ error: "Invalid signature" }, 401);
}
// 클론 공격 방지를 위한 Counter 업데이트
await c.env.DB.prepare(
"UPDATE passkey_credentials SET counter = ? WHERE id = ?"
).bind(verification.authenticationInfo.newCounter, credRecord.id).run();
// 5ms 이내의 초고속 JWT 발급 (Web Crypto 연동 jose 사용)
const secret = new TextEncoder().encode(c.env.JWT_SECRET || "fallback-secret-key-32-chars-min");
const token = await new SignJWT({ userId: credRecord.user_id, role: "user" })
.setProtectedHeader({ alg: "HS256" })
.setIssuedAt()
.setExpirationTime("7d")
.sign(secret);
return c.json({ success: true, token });
});
export default app;
3단계: 프론트엔드 (Web / Flutter) 연동
웹(Web) 브라우저 연동 코드
브라우저 표준 @simplewebauthn/browser 패키지를 활용하면 지문/FaceID 인증 팝업이 1줄로 호출된다.
import { startRegistration, startAuthentication } from "@simplewebauthn/browser";
// 1. Passkey 회원가입
async function registerPasskey(email, name) {
const optRes = await fetch("/api/auth/register/options", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ email, name }),
});
const { options, userId } = await optRes.json();
// 브라우저 지문/FaceID 생체인증 팝업 트리거
const attResp = await startRegistration(options);
const verifyRes = await fetch("/api/auth/register/verify", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ userId, response: attResp }),
});
return await verifyRes.json();
}
// 2. Passkey 1초 간편 로그인
async function loginWithPasskey() {
const optRes = await fetch("/api/auth/login/options", { method: "POST" });
const { options, sessionChallengeId } = await optRes.json();
// 생체 인증 진행
const asseResp = await startAuthentication(options);
const verifyRes = await fetch("/api/auth/login/verify", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ sessionChallengeId, response: asseResp }),
});
const { token } = await verifyRes.json();
localStorage.setItem("access_token", token);
}
MAU 대신 요청·저장소 사용량으로 비용을 계산한다
이 저장소에는 기존 비교표의 지연시간과 월 청구액을 재현할 측정 스크립트·원자료가 없다. 따라서 특정 SaaS 대비 절감률이나 4.2ms 응답시간을 실측 결과로 제시하지 않는다.
2026년 11월 11일 Workers 공식 요금표 기준 Free 플랜의 요청 한도는 하루 100,000건이고, Paid 플랜의 최소 요금은 월 $5다. Paid에는 월 1,000만 요청이 포함되지만 CPU 사용량과 초과 요청도 계산해야 한다. D1 요금과 KV 요금은 별도다.
| 항목 | 계산에 필요한 값 |
|---|---|
| Workers 요청 | 등록·로그인·검증 API가 호출되는 횟수 |
| Workers CPU | 서명 검증을 포함한 요청당 CPU 시간 |
| D1 | 읽고 쓴 행 수, 인덱스, 저장 용량 |
| KV | 챌린지의 읽기·쓰기·삭제 횟수와 저장량 |
| 운영 | 계정 복구, 모니터링, 보안 점검 비용 |
가령 월 10만 명이 각각 10번 로그인하고 로그인 한 번에 API 두 개를 호출한다면 로그인 요청만 월 200만 건이다. 이 수치는 가정이며 등록·재시도·세션 갱신은 포함하지 않았다. 하루 한도가 있는 Free 플랜에서는 월 합계뿐 아니라 최대 일별 요청도 확인해야 한다.
적용 전에 확인할 것
Passkey는 비밀번호 저장을 줄이지만 인증 시스템 전체의 보안을 자동으로 보장하지 않는다. 아래 예제는 흐름을 설명하며, 운영 전에는 사용하는 라이브러리 버전에서 origin·RP ID·challenge 일치와 재사용 방지, 세션 만료, 계정 복구를 검증해야 한다. 특히 KV의 일관성 모델만으로 일회성 challenge의 원자적 소비가 보장된다고 가정하지 않는다.
기존 서비스를 옮길 때는 사용자의 새 자격 증명 등록, 복구 경로와 운영 공수를 함께 비교한다. Cloudflare에 직접 구현하는 선택은 사용량에 맞춰 계산하고 운영할 수 있을 때 의미가 있다.