본문 바로가기
Q&A해결2026년 4월 23일1분 읽기

OAuth 2.1 PKCE에서 code_verifier 길이가 라이브러리마다 달라요

인
인증담당
조회 821댓글 1

모바일 앱(React Native + expo-auth-session)과 백엔드(Node.js + openid-client) 사이 OAuth 2.1 PKCE 플로우를 구현 중입니다.

auth code 교환 단계에서 invalid_grant 에러가 떨어집니다. 디버깅해보니 클라이언트가 보낸 code_verifier 길이가 백엔드가 기대하는 것과 다릅니다.

RFC 7636을 보면 43~128자라 되어 있는데, 실제로는 라이브러리마다 다른 길이를 만드네요. 정확한 가이드라인이 궁금합니다.

댓글 1

김김영삼7개월 전

RFC 7636 §4.1의 길이 규정은 명확한데, 라이브러리들이 "안전한 기본값"으로 다른 값을 쓰는 게 혼란의 원인입니다.

RFC 7636 §4.1 정확한 규정

  • code_verifier: 43~128자, charset = [A-Z][a-z][0-9]-._~ (unreserved)
  • 32바이트 random → base64url-encode 결과가 정확히 43자
  • 최소 256비트 엔트로피 권장

라이브러리별 기본값

라이브러리기본 길이엔트로피expo-auth-session128 (96바이트 → 128자)768비트openid-client (node)43 (32바이트 → 43자)256비트oauth4webapi43256비트AppAuth-iOS43~64 가변256~384비트MSAL.js43256비트

실제 invalid_grant 원인

길이 자체가 문제가 아니라 다음 중 하나일 가능성이 높습니다:

1) URL safe base64 vs 일반 base64

// 잘못된 예 (일반 base64)
const verifier = crypto.randomBytes(32).toString('base64')
// "abc/def+ghi==" — / + = 가 들어감

// 올바른 예 (base64url)
const verifier = crypto.randomBytes(32).toString('base64url')
// "abc_def-ghi" — URL safe

2) code_challenge_method 불일치

// 클라이언트
const challenge = base64url(sha256(verifier))
const auth_url = `...&code_challenge=${challenge}&code_challenge_method=S256`

// 서버는 "plain"만 지원하는데 클라이언트가 "S256"으로 보내면 fail

3) verifier에 trailing newline·공백

// React Native AsyncStorage 저장 후 읽을 때 자주 발생
const verifier = (await AsyncStorage.getItem('verifier')).trim()

표준 구현 (검증된 패턴)

// 클라이언트 — 32바이트 → 43자 verifier
import * as Crypto from 'expo-crypto'

function generatePKCE() {
const verifierBytes = Crypto.getRandomBytes(32)
const verifier = base64URLEncode(verifierBytes) // 43자

const challengeBytes = Crypto.digest(
Crypto.CryptoDigestAlgorithm.SHA256,
new TextEncoder().encode(verifier)
)
const challenge = base64URLEncode(challengeBytes) // 43자

return { verifier, challenge }
}

function base64URLEncode(bytes) {
return btoa(String.fromCharCode(...bytes))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '')
}

서버 측 검증

function verifyPKCE(verifier, storedChallenge) {
const computed = base64url(sha256(verifier))
if (computed !== storedChallenge) {
throw new Error('invalid_grant: PKCE verification failed')
}
}

OAuth 2.1 신규 사항

OAuth 2.1 (Draft 11+)에서는 PKCE가 confidential client에도 필수입니다. 또한 plain method는 deprecated — S256만 허용됩니다.

실무 체크리스트

  1. verifier·challenge 모두 base64url (URL safe), 패딩 제거
  2. code_challenge_method = S256 고정
  3. 저장·읽기 시 trim, charset 확인
  4. 길이 43~128 강제 검증 (RFC 외 길이는 거부)
  5. 인증 서버 로그에서 verifier·challenge 비교 — 환경 차이 즉시 보임

"길이가 다르다"는 표면이고 본질은 거의 항상 base64 인코딩 변종입니다. 양쪽 모두 base64url 사용하는지부터 확인하세요.

Ctrl+Enter로 등록