OpenID Connect: OAuth 2.0 위에 인증 레이어 추가

지난 글에서 PKCE로 공개 클라이언트를 보호하는 방법을 다뤘다. OAuth 2.0은 인가(Authorization) 프레임워크이고 인증이 아니다. 사용자가 누구인지 확인하려면 OAuth 2.0 위에 OpenID Connect(OIDC)를 얹어야 한다.

OAuth 2.0과 OIDC의 차이

“Google로 로그인” 기능을 OAuth 2.0만으로 구현하면 Access Token으로 사용자 정보 API를 호출해야 한다. 하지만 이 방식은 표준이 없어 프로바이더마다 다르다. OIDC는 이를 표준화한다.

OIDC의 핵심 추가 사항:

• scope에 openid 추가
• ID Token (JWT) 발급 — 사용자 신원 정보 포함
• /userinfo 엔드포인트 표준화
• Discovery 문서 (/.well-known/openid-configuration)

ID Token 완전 검증

ID Token을 검증하지 않거나 부분적으로만 검증하면 심각한 취약점이 생긴다.

import httpx
from jose import jwt, JWTError

# 1. Discovery에서 JWKS URI 가져오기
async def get_jwks():
    async with httpx.AsyncClient() as client:
        discovery = await client.get(
            f"{ISSUER_URL}/.well-known/openid-configuration"
        )
        jwks_uri = discovery.json()["jwks_uri"]
        jwks = await client.get(jwks_uri)
        return jwks.json()

async def verify_id_token(id_token: str, nonce: str) -> dict:
    jwks = await get_jwks()
    
    try:
        claims = jwt.decode(
            id_token,
            jwks,
            algorithms=["RS256"],  # 알고리즘 고정
            audience=CLIENT_ID,    # aud 클레임 검증
            issuer=ISSUER_URL,     # iss 클레임 검증
        )
    except JWTError as e:
        raise ValueError(f"ID Token 검증 실패: {e}")
    
    # nonce 검증 (리플레이 공격 방어)
    if claims.get("nonce") != nonce:
        raise ValueError("nonce 불일치")
    
    # at_hash 검증 (Access Token과 바인딩 확인)
    # (생략 가능하나 권장)
    
    return claims

리플레이 공격 방어: nonce

같은 ID Token을 재사용하는 리플레이 공격을 막기 위해 nonce를 사용한다.

import secrets

async def start_oidc_login(request: Request):
    nonce = secrets.token_urlsafe(32)
    state = secrets.token_urlsafe(32)
    
    request.session["oidc_nonce"] = nonce
    request.session["oauth_state"] = state
    
    params = {
        "client_id": CLIENT_ID,
        "redirect_uri": REDIRECT_URI,
        "response_type": "code",
        "scope": "openid email profile",  # openid 필수
        "state": state,
        "nonce": nonce,  # 리플레이 방어
        "code_challenge": challenge,
        "code_challenge_method": "S256",
    }
    return RedirectResponse(f"{AUTHORIZATION_ENDPOINT}?{urlencode(params)}")

토큰 교환 후 ID Token 처리

async def oidc_callback(code: str, state: str, request: Request):
    # state, nonce 세션에서 가져오기
    if not secrets.compare_digest(state, request.session.pop("oauth_state", "")):
        raise HTTPException(400, "Invalid state")
    nonce = request.session.pop("oidc_nonce", "")
    
    # 토큰 교환
    tokens = await exchange_code_for_tokens(code)
    
    # ID Token 검증
    user_info = await verify_id_token(tokens["id_token"], nonce)
    
    # sub 클레임으로 사용자 식별 (email은 변경 가능)
    user_id = f"{user_info['iss']}|{user_info['sub']}"
    
    # 세션 생성 (ID Token 자체를 세션에 저장하지 말 것)
    request.session["user_id"] = user_id
    request.session["email"] = user_info.get("email")
    
    return RedirectResponse("/dashboard")

흔한 실수

1. aud 클레임 미검증

# 위험: audience 검증 없음
claims = jwt.decode(id_token, jwks, algorithms=["RS256"])

# 올바름: audience 명시
claims = jwt.decode(id_token, jwks, algorithms=["RS256"], audience=CLIENT_ID)

다른 앱의 ID Token이 내 앱에서 유효한 것처럼 받아들여질 수 있다.

2. sub 대신 email로 사용자 식별

# 위험: email은 변경 가능
user_id = claims["email"]

# 올바름: iss+sub 조합은 불변
user_id = f"{claims['iss']}|{claims['sub']}"

3. JWKS 캐싱 미갱신

인가 서버는 주기적으로 키를 교체한다. 캐시 TTL을 1시간 이하로 설정하고, 키 검증 실패 시 즉시 갱신해야 한다.

import functools
import time

_jwks_cache = {"keys": None, "expires": 0}

async def get_jwks_cached():
    if time.time() > _jwks_cache["expires"]:
        _jwks_cache["keys"] = await fetch_jwks()
        _jwks_cache["expires"] = time.time() + 3600  # 1시간 TTL
    return _jwks_cache["keys"]

보안 체크리스트

• scope에 openid 포함
• ID Token의 iss, aud, exp 모두 검증
• nonce 생성 및 검증 (리플레이 방어)
• 사용자 식별에 sub 사용 (email 금지)
• JWKS 주기적 갱신 (캐시 TTL ≤ 1시간)
• ID Token을 API 인증에 직접 사용 금지

---

지난 글: OAuth 2.0 PKCE

다음 글: 다중 인증(MFA) 완전 구현

읽어주셔서 감사합니다. 😊