13년차의 서버실

서버, 인프라, 홈랩 기술 블로그

[태그:] 애플리케이션 보안

  • [보안] 웹 취약점 진단: Burp Suite vs OWASP ZAP 심층 비교

    [보안] 웹 취약점 진단: Burp Suite vs OWASP ZAP 심층 비교

    [보안] 웹 취약점 진단: Burp Suite vs OWASP ZAP 심층 비교

    웹 취약점 진단을 시작하려고 하면 가장 먼저 부딪히는 고민이 있습니다. Burp Suite OWASP ZAP 비교를 검색해보신 분들이라면 아마 저와 비슷했을 겁니다. “둘 다 프록시(Proxy, 중간에서 트래픽을 가로채는 도구) 기반인데 뭐가 다른 거지?”, “초보자는 뭘 먼저 써야 하지?”, “실무에서는 어떤 기준으로 고르지?” 이런 질문이 계속 생기거든요. 특히 보안 도구 선택을 앞두면, 단순히 어느 것이 유명한지가 아니라 자신의 업무 방식에 맞는 게 뭔지 판단하기가 참 어렵더라고요. 저도 처음엔 이름만 많이 들었지, 막상 프로젝트에 적용하려고 하니 생각보다 판단 포인트가 많아서 삽질 좀 했습니다 ㅎㅎ

    특히 웹 취약점 스캐너나 모의 해킹 도구를 고를 때는 “더 강력한 것”보다, 내 목적에 정확히 맞는지 보는 게 훨씬 중요해요. 실제로 써보니까 Burp Suite는 수동 분석(Manual Testing, 사람이 직접 흐름을 따라가며 검증하는 방식)과 확장성에서 강점이 분명했고, OWASP ZAP은 자동화와 접근성에서 진입 장벽이 낮더라고요.

    Burp Suite OWASP ZAP 비교 개요를 보여주는 웹 취약점 진단 이미지

    Burp Suite와 OWASP ZAP의 핵심 구성 요소와 사용 흐름을 한눈에 보여주는 개요 이미지입니다.

    왜 Burp Suite와 OWASP ZAP 비교가 중요한가

    쉽게 말해 둘 다 웹 애플리케이션 보안 테스트를 도와주는 대표 웹 취약점 스캐너예요. 그런데 실제 현장에서는 쓰임새가 미묘하게 다릅니다. 예를 들어 개발 단계에서 빠르게 기본 점검을 돌리고 싶다면 자동화 친화성이 중요하고, 로그인 흐름이나 복잡한 요청 재현처럼 정밀한 분석이 필요하면 인터셉트(Intercept, 요청 가로채기)와 리피터(Repeater, 요청 반복 재생성)가 훨씬 중요해집니다.

    여기서 중요한 포인트! 보안 도구 선택은 기능 개수보다도 팀의 숙련도, 테스트 범위, 자동화 필요성, 보고서 작성 흐름에 따라 갈려요. 저도 한때는 “강력한 도구 하나면 끝”이라고 생각했었는데, 실제 운영 환경에서는 그게 잘 안 맞더라고요. 도구보다 워크플로우(Workflow, 작업 흐름)가 더 중요했습니다.

    핵심 개념 정리: 두 도구를 어떻게 봐야 하나

    Burp Suite와 OWASP ZAP은 둘 다 프록시 기반으로 브라우저와 서버 사이 트래픽을 들여다봅니다. 사용자가 브라우저에서 요청을 보내면, 이 웹 취약점 스�닝 도구들이 그 요청을 가로채고 수정하고 다시 전송할 수 있게 해주는 구조죠. 이 구조 덕분에 다음 같은 작업이 가능합니다.

    • 요청/응답(Request/Response, 클라이언트와 서버 간 통신 내용) 분석
    • 쿠키(Cookie), 헤더(Header), 토큰(Token) 확인
    • 인증 흐름(Authentication Flow, 로그인/세션 처리 방식) 검증
    • 입력값 변조와 반복 테스트
    • 취약점 스캔과 결과 정리

    차이는 어디서 나느냐. Burp Suite는 수동 분석 경험이 꽤 잘 다듬어져 있다는 느낌이 강합니다. 반면 OWASP ZAP은 오픈소스(Open Source, 소스가 공개된 소프트웨어) 특유의 유연함과 자동화 친화성이 눈에 띕니다. 특히 ZAP은 API(Application Programming Interface, 외부 연동용 인터페이스)를 활용한 스캔 자동화 사례가 많아서 CI/CD(지속적 통합/지속적 배포) 파이프라인에 붙이기 편한 편이었어요.

    한눈에 보는 Burp Suite vs OWASP ZAP 웹 취약점 진단 도구 비교

    항목 Burp Suite OWASP ZAP
    라이선스 상용 제품 중심, Community Edition 제공 오픈소스
    대표 강점 수동 테스트, 정교한 요청 재현, 확장 기능 접근성, 자동화, 비용 부담 적음
    입문 난이도 기능이 많아 초반엔 다소 복잡함 비교적 시작이 쉬운 편
    자동화 적합성 가능하지만 구성에 따라 차이 큼 API 및 스크립팅 활용이 쉬운 편
    학습 포인트 프록시, Repeater, Intruder, 확장 활용 Spider, Active Scan, Automation 기반 흐름
    추천 대상 정밀 분석이 많은 실무자, 심화 학습자 예산이 제한된 팀, 자동화 중심 팀

    실전 구현: 로컬 테스트 환경에서 둘 다 붙여보기

    이론만 보면 감이 안 옵니다. 그래서 저는 보통 로컬 테스트 환경부터 붙여봐요. 가장 단순한 흐름은 브라우저 프록시 설정을 바꾸고, 테스트용 웹앱에 요청을 보내서 인터셉트가 되는지 확인하는 방식입니다. 처음엔 이게 뭔가 싶었는데, 한 번만 제대로 붙여두면 이후 학습 속도가 확 올라갑니다.

    1. 테스트용 환경 준비

    1. 로컬 또는 사내 승인된 테스트 대상 애플리케이션을 준비합니다.
    2. Burp Suite 또는 OWASP ZAP을 실행합니다.
    3. 브라우저 프록시를 도구가 리슨(Listen, 대기) 중인 주소와 포트로 지정합니다.
    4. 도구의 인증서(Certificate)를 브라우저에 신뢰 등록합니다. HTTPS 테스트에 꼭 필요합니다.

    테스트용 Docker Compose를 간단히 두고 시작하면 반복하기 좋습니다.

    version: '3'
    services:
      webgoat:
        image: webgoat/webgoat
        ports:
          - "8080:8080"
    

    저는 예전엔 무조건 실제 서비스 스테이징에서 바로 보려다가 세션 꼬이고 인증서 이슈 만나고 난리였거든요. 지금은 무조건 로컬 검증부터 합니다. 이게 훨씬 덜 힘듭니다.

    2. 브라우저 프록시 설정 예시

    리눅스(Linux) 계열에서 환경 변수를 써서 확인할 때는 아래처럼 접근할 수 있습니다.

    export HTTP_PROXY=http://127.0.0.1:8080
    export HTTPS_PROXY=http://127.0.0.1:8080
    curl -k https://example.local

    브라우저 기반 테스트가 일반적이지만, 이렇게 CLI(Command Line Interface, 명령줄 환경)에서도 프록시가 잘 타는지 먼저 보는 습관이 꽤 도움이 되거든요. 네트워크 경로가 안 맞는 문제를 빨리 찾을 수 있어요.

    Burp Suite와 OWASP ZAP 프록시 설정 흐름을 설명하는 웹 취약점 스캐너 이미지

    브라우저, Burp Suite 또는 OWASP ZAP, 대상 웹 애플리케이션 사이의 프록시 연결 구조를 설명하는 이미지입니다.

    3. Burp Suite에서 먼저 볼 포인트

    Burp Suite를 처음 열면 메뉴가 많아서 약간 압도됩니다. 저도 처음엔 어디부터 봐야 할지 몰라서 여기저기 눌러보다가 시간을 꽤 썼어요. 그런데 핵심은 의외로 단순합니다.

    1. Proxy: 요청이 실제로 잡히는지 확인
    2. HTTP history: 어떤 요청이 오가는지 전체 흐름 파악
    3. Repeater: 특정 요청을 수정해서 반복 검증
    4. Target: 사이트 구조와 엔드포인트 확인

    실제로 써보니까 Burp Suite는 Repeater가 정말 편하더라고요. 인증 토큰 하나 바꿔보고, 파라미터(Parameter, 요청 값) 하나 바꿔보고, 응답 차이를 바로 확인하는 흐름이 자연스럽습니다. 세밀하게 파고들 때는 이 장점이 커요.

    4. OWASP ZAP에서 먼저 볼 포인트

    ZAP은 상대적으로 접근이 부드러워요. 웹 취약점 진단 입문자 입장에서는 구조가 덜 위협적으로 느껴질 수 있습니다. 대표적으로 많이 보게 되는 기능은 다음과 같습니다.

    1. Sites: 수집된 사이트 구조 확인
    2. Spider: 링크 탐색 자동화
    3. Active Scan: 알려진 패턴 기반 점검
    4. Alerts: 탐지 결과 정리

    특히 자동화 관점에서는 ZAP이 꽤 실용적이거든요. 아래처럼 Docker 이미지 기반으로 헤드리스(Headless, 화면 없이 실행) 스캔 흐름을 잡는 예시가 자주 쓰입니다.

    docker run --rm -t owasp/zap2docker-stable zap-baseline.py \
      -t https://target.example.com \
      -r zap-report.html
    

    물론 여기서 중요한 건 허가된 대상만 테스트해야 한다는 점입니다. 승인 없는 스캔은 절대 안 돼요. 이 부분은 아무리 강조해도 지나치지 않아요.

    실무 관점에서 본 보안 도구 선택 기준

    Burp Suite가 더 잘 맞는 경우

    • 복잡한 로그인과 세션 흐름을 세밀하게 봐야 할 때
    • 수동 검증 비중이 높을 때
    • 특정 요청을 다양한 형태로 재현해야 할 때
    • 확장 기능을 활용한 심화 테스트가 필요할 때

    제가 직접 해보니, API 인증 우회 가능성이나 권한 검증 누락처럼 “한 번 더 꼬아서 봐야 드러나는 문제”는 Burp Suite 쪽이 손에 더 잘 붙었어요.

    OWASP ZAP이 더 잘 맞는 경우

    • 예산 제약이 있는 팀
    • 오픈소스 기반으로 빠르게 시작하고 싶은 경우
    • 자동화된 웹 취약점 스캐너 흐름을 만들고 싶은 경우
    • 보안 점검을 개발 파이프라인에 가볍게 포함하고 싶은 경우

    특히 작은 팀이나 홈랩(Home Lab, 개인 실험용 인프라 환경)에서는 ZAP이 진입 장벽이 낮아서 좋거든요. 부담 없이 돌려보고, 결과를 보면서 필요한 지점을 수동으로 더 파는 식이 잘 맞더라고요.

    ⚠️ 주의사항과 트러블슈팅: 제가 실제로 많이 막혔던 부분

    웹 취약점 진단은 도구보다 환경 이슈에서 더 많이 막혀요. 진짜로요. 기능 비교표만 보면 금방 끝날 것 같은데, 막상 해보면 프록시가 안 잡히거나 HTTPS가 깨지거나 세션이 꼬여서 멈추는 경우가 많습니다.

    1. HTTPS 인증서 문제

    증상: 브라우저에서 보안 경고가 뜨고 정상 로딩이 안 됩니다.

    원인: Burp Suite 또는 ZAP의 CA(Certificate Authority, 인증서 발급 주체) 인증서를 브라우저가 신뢰하지 않는 상태입니다.

    해결: 도구가 제공하는 인증서를 브라우저 또는 시스템 신뢰 저장소에 등록합니다.

    2. 로그인 후 요청이 안 보이는 문제

    증상: 로그인 화면까진 잡히는데, 이후 요청이 안 보입니다.

    원인: 브라우저 일부 트래픽이 프록시를 우회하거나, HSTS/브라우저 프로필 문제일 수 있어요.

    해결: 전용 브라우저 프로필을 따로 만들고, 프록시 설정이 전체 트래픽에 적용되는지 다시 확인합니다.

    3. 스캔 결과가 너무 많아서 판단이 어려운 문제

    증상: 경고가 쏟아지는데 뭐가 중요한지 모르겠어요.

    원인: 자동 스캔은 오탐(False Positive, 실제 취약점이 아닌데 경고로 잡히는 경우)이 섞일 수 있습니다.

    해결: 결과를 바로 보고서로 넘기지 말고, 재현 가능한지 수동 검증을 붙입니다. 이 단계 안 거치면 나중에 개발팀과 커뮤니케이션이 꼬이더라고요.

    웹 취약점 진단 중 인증서와 세션 문제를 해결하는 Burp Suite OWASP ZAP 비교 이미지

    HTTPS 인증서 등록, 세션 확인, 오탐 분류 등 현장에서 자주 겪는 문제를 시각화한 이미지입니다.

    4. 자동 스캔만 믿고 끝내는 실수

    이건 제가 초반에 가장 크게 했던 실수거든요. 스캐너가 잡아주면 다 끝난 줄 알았어요. 근데 실제로는 비즈니스 로직(Business Logic, 서비스 기능 흐름 자체의 문제) 취약점이나 권한 상승 같은 건 수동 검증 없이 놓치기 쉬워요. 그래서 보안 도구 선택과 활용을 할 때도 저는 항상 “자동화 + 수동 분석의 조합”으로 봅니다.

    검증과 결과: 어떤 흐름으로 마무리해야 하나

    도구를 돌렸다면 마지막은 결과를 검증하고 팀이 이해할 수 있게 정리하는 단계예요. 여기서 문서화가 허술하면 테스트를 잘해도 가치가 반감됩니다.

    1. 탐지된 항목 중 재현 가능한 이슈만 선별합니다.
    2. 요청/응답 캡처를 남깁니다.
    3. 영향 범위와 재현 조건을 짧게 정리합니다.
    4. 개발팀이 바로 확인할 수 있도록 수정 포인트를 연결합니다.

    예를 들어 결과 정리는 이런 식으로 남기면 좋습니다.

    Issue: Reflected XSS suspected
    Endpoint: /search?q=
    Validation: Reproduced manually in proxy repeater
    Risk: User input reflected without proper encoding
    Next step: Confirm output encoding and template escaping
    

    이런 형태가 좋은 이유는 단순 경고 메시지보다 훨씬 실무적이거든요. 보안팀 입장에서도 좋고, 개발팀 입장에서도 바로 액션이 가능해요.

    Burp Suite OWASP ZAP 비교 결과와 웹 취약점 진단 검증 과정을 보여주는 이미지

    스캔 결과, 경고 우선순위, 수동 재현 여부를 함께 확인하는 결과 검증 이미지입니다.

    그래서 무엇을 선택하면 좋을까

    결론부터 말씀드리면, 어느 하나가 무조건 우위라고 보긴 어렵습니다. 보안 도구 선택은 목적 중심으로 봐야 해요.

    • 입문 + 자동화 + 비용 효율이 중요하면 OWASP ZAP
    • 정밀 분석 + 반복 검증 + 심화 테스트가 중요하면 Burp Suite
    • 실무 최적화를 원하면 둘을 함께 운용하는 전략도 충분히 현실적

    저는 홈랩에서는 ZAP으로 전체 그림을 먼저 보고, 세밀한 검증이 필요한 지점은 Burp Suite로 파고드는 식을 자주 써요. 이 조합이 생각보다 괜찮습니다. 처음엔 도구 두 개를 같이 쓴다고 해서 비효율적일 줄 알았는데, 실제로 써보니까 역할 분리가 되니 오히려 머리가 덜 복잡하더라고요.

    정리와 다음 단계

    오늘 내용 정리해보면 이렇습니다. Burp Suite OWASP ZAP 비교에서 가장 중요한 건 “무슨 기능이 더 많으냐”가 아니라 “내 테스트 방식에 뭐가 맞느냐”예요. Burp Suite는 수동 중심 분석에 강하고, OWASP ZAP은 자동화와 접근성에서 장점이 커요. 둘 다 훌륭한 웹 취약점 스캐너이고, 웹 취약점 진단을 제대로 하려면 결국 도구 자체보다 검증 습관과 보고 체계가 더 중요합니다.

    혹시 지금 웹 취약점 스캐너를 처음 고르고 계신가요? 그렇다면 ZAP으로 흐름을 익히고, 이후 Burp Suite로 수동 분석 감각을 붙이는 순서를 추천드립니다. 반대로 이미 모의 해킹 도구를 다뤄보셨고 요청 재현이 많은 환경이라면 Burp Suite가 더 손에 맞으실 가능성이 커요.

    다음 글에서는 인증(Authorization/Authentication) 테스트 흐름을 중심으로, 로그인 세션이 있는 웹앱에서 프록시 기반 점검을 어떻게 설계하면 좋은지 다뤄볼 예정입니다. 이전 글에서 다뤘던 리버스 프록시(Reverse Proxy, 서버 앞단 중계 계층)와 TLS(Traffic Layer Security, 전송 구간 암호화) 정리 내용도 함께 보시면 훨씬 이해가 빠르실 겁니다.

    보안 도구 선택 관점에서 Burp Suite OWASP ZAP 비교를 요약한 이미지

    입문자, 자동화 중심 팀, 정밀 분석 중심 실무자 관점에서 두 도구의 선택 기준을 요약한 이미지입니다.

    자주 묻는 질문

    Q1. 초보자는 Burp Suite와 ZAP 중 무엇부터 시작하면 좋나요?

    처음이라면 OWASP ZAP이 부담이 덜할 수 있어요. 다만 수동 분석 감각을 익히려면 Burp Suite도 꼭 한 번은 써보시는 게 좋습니다.

    Q2. 자동 스캔만으로 충분한가요?

    아니에요. 자동 스캔은 출발점으로는 좋지만, 오탐 분류와 수동 재현이 빠지면 실제 위험도를 제대로 판단하기 어렵습니다.

    Q3. 실무에서는 둘 중 하나만 쓰나요?

    꼭 그렇진 않아요. 팀 상황에 따라 두 도구를 병행하는 경우도 충분히 많습니다. 저도 실제로 그렇게 쓰는 편입니다.

  • [보안] OAuth 2.0 보안 허점 파헤치기: 실제 공격 사례와 방어 전략

    [보안] OAuth 2.0 보안 허점 파헤치기: 실제 공격 사례와 방어 전략

    목차

    [보안] OAuth 2.0 보안 허점 파헤치기: 실제 공격 사례와 방어 전략

    서비스 로그인 붙이다 보면 OAuth 2.0 보안 이야기를 꼭 만나게 됩니다. 처음엔 그냥 소셜 로그인 한 번 붙이면 끝나는 줄 알았거든요. 근데 운영 환경으로 올라가고, 모바일 앱이 붙고, 리버스 프록시(Reverse Proxy, 역방향 프록시) 뒤에 애플리케이션이 숨어버리면 얘기가 완전히 달라집니다. 제가 홈랩과 사내 테스트 환경에서 직접 굴려보니, OAuth 공격은 거창한 제로데이보다도 설정 실수, 검증 누락, 토큰 저장 위치 같은 데서 시작되는 경우가 훨씬 많더라고요. 이번 글에서는 OAuth 2.0 보안을 실제 공격 흐름 중심으로 풀어보고, 현업에서 바로 적용할 수 있는 방어 전략까지 정리해보겠습니다.

    OAuth 2.0 보안 전체 흐름과 공격 지점을 보여주는 아키텍처 다이어그램

    OAuth 2.0 인증 흐름에서 사용자, 애플리케이션, 인증 서버, 리소스 서버 사이의 이동 경로와 주요 공격 지점을 한눈에 보여주는 다이어그램입니다.

    1. 왜 OAuth 2.0 보안이 자꾸 사고로 이어질까요

    쉽게 말해 OAuth 2.0은 비밀번호를 직접 주고받지 않고 권한을 위임하는 방식입니다. 문제는 구조가 유연한 만큼, 잘못 붙이면 공격자에게도 길을 열어준다는 점입니다. 특히 아래 세 가지가 자주 문제를 만듭니다.

    • Redirect URI(리다이렉트 URI) 검증이 느슨한 경우가 많더라고요
    • state 값 검증이 빠져 CSRF(Cross-Site Request Forgery, 사이트 간 요청 위조)가 가능한 경우
    • Access Token(액세스 토큰)을 브라우저에 무방비로 저장하는 경우

    저도 예전에 테스트 앱 하나 만들면서 redirect URI를 와일드카드 비슷하게 처리했다가, “이거 설마 되겠어?” 했던 우회가 진짜 성립하는 걸 보고 식은땀 난 적이 있습니다. 드디어 됐다 싶었던 로그인 연동이, 보안 관점에서는 시작점이었던 거죠.

    2. OAuth 2.0 핵심 개념, 헷갈리는 부분만 딱 짚어보겠습니다

    OAuth 2.0 보안을 보려면 역할을 먼저 분리해서 봐야 합니다.

    구성 요소 역할 보안 포인트
    Resource Owner 사용자 피싱 페이지 유도 방지
    Client 웹/모바일 애플리케이션 state, PKCE, redirect URI 검증
    Authorization Server 인증 및 토큰 발급 정확한 클라이언트 검증
    Resource Server API 서버 토큰 검증과 권한 범위 확인

    여기서 중요한 포인트가 있습니다. 인증(Authentication, 본인 확인)과 인가(Authorization, 권한 부여)를 섞어 생각하면 설계가 꼬입니다. OAuth 2.0은 기본적으로 인가 프레임워크이고, 로그인은 보통 OpenID Connect(OIDC, 인증 레이어)를 함께 붙여 다룹니다. 이 차이를 놓치면 토큰을 너무 많은 곳에서 믿어버리게 되거든요.

    Authorization Code Flow와 PKCE를 기본값으로 봐야 하는 이유

    요즘은 Authorization Code Flow(인가 코드 흐름)에 PKCE(Proof Key for Code Exchange, 코드 교환용 증명 키)를 붙이는 구성이 사실상 기본입니다. 예전엔 Implicit Flow(암시적 흐름)도 많이 보였는데, 실제로 써보니까 브라우저 노출 면이 넓고 운영상 통제가 까다롭더라고요. 그래서 저는 브라우저 기반 앱도 가능하면 백엔드 연계나 BFF(Backend For Frontend, 프론트엔드 전용 백엔드) 구조를 함께 검토합니다.

    3. 실제 OAuth 공격 사례, 패턴으로 보면 훨씬 잘 보입니다

    특정 회사 사고를 끌어와 자극적으로 보기보다, 반복되는 공격 패턴으로 보는 게 실무에는 훨씬 도움이 되거든요. 아래 세 가지는 제가 테스트 환경에서 재현도 해봤고, 보안 리뷰 때도 정말 자주 보는 유형입니다.

    사례 1. state 누락으로 인한 로그인 CSRF

    애플리케이션이 인증 요청을 보낼 때 state를 만들지 않거나, 만들어도 응답에서 검증하지 않으면 공격자가 자기 계정으로 발급한 인가 응답을 피해자 세션에 주입할 수 있습니다. 겉으로는 로그인 성공처럼 보이는데, 실제로는 피해자가 공격자 계정에 연결된 상태가 되는 거죠.

    • 증상: 사용자가 모르는 계정으로 연결됨
    • 원인: state 생성 또는 검증 누락
    • 방어: 요청별 고유 state 생성, 서버 세션과 비교, 1회성 사용

    사례 2. Redirect URI 오검증으로 인가 코드 탈취

    이건 진짜 위험합니다. Redirect URI를 정확히 일치시키지 않고 접두어(prefix) 비교나 부분 문자열 비교로 처리하면, 공격자가 비슷한 주소를 만들어 인가 코드나 토큰을 가로챌 수 있습니다. 처음엔 “도메인만 같으면 괜찮지 않나” 싶었는데, 하위 경로나 쿼리 문자열까지 엮이면 생각보다 쉽게 틈이 생기더라고요.

    • 증상: 정상 로그인 후 공격자 페이지로 코드 전달
    • 원인: 느슨한 redirect URI 검증
    • 방어: 사전 등록된 URI와 정확히 일치 비교

    사례 3. PKCE 미적용으로 인가 코드 가로채기 위험

    특히 퍼블릭 클라이언트(public client)인 모바일 앱, SPA(Single Page Application, 단일 페이지 애플리케이션) 계열에서 PKCE가 없으면 코드가 중간에서 노출됐을 때 교환 방어가 어렵습니다. PKCE는 code_verifier와 code_challenge를 사용해서, 코드를 훔쳐도 토큰으로 못 바꾸게 막는 장치입니다.

    • 증상: 코드 탈취 후 토큰 교환 시도
    • 원인: PKCE 미적용
    • 방어: S256 기반 PKCE 강제
    OAuth 2.0 보안에서 state 누락과 redirect URI, PKCE 문제를 비교한 공격 흐름 이미지

    세 가지 대표적인 OAuth 공격 패턴이 어디서 시작되고 어느 지점에서 차단할 수 있는지 비교하는 흐름도입니다.

    4. 실전 구현: 안전한 OAuth 2.0 보안 체크포인트를 코드로 붙여보겠습니다

    여기서는 Python Flask(플라스크) 예시로 보겠습니다. 프레임워크는 달라도 핵심은 같습니다. state 검증, PKCE 적용, redirect URI 고정, 이 세 개는 기본값으로 가져가셔야 합니다.

    Step 1. state 값을 만들고 세션에 묶기

    1. 로그인 시작 시 난수 기반 state 생성
    2. 서버 세션 또는 안전한 저장소에 보관
    3. 콜백에서 반드시 동일성 검증
    import secrets
    from flask import Flask, redirect, request, session, abort
    from urllib.parse import urlencode
    
    app = Flask(__name__)
    app.secret_key = "replace-with-secure-secret"
    
    AUTHORIZATION_ENDPOINT = "https://auth.example.com/oauth2/authorize"
    CLIENT_ID = "demo-client"
    REDIRECT_URI = "https://app.example.com/callback"
    
    @app.route("/login")
    def login():
        state = secrets.token_urlsafe(32)
        session["oauth_state"] = state
    
        params = {
            "response_type": "code",
            "client_id": CLIENT_ID,
            "redirect_uri": REDIRECT_URI,
            "scope": "openid profile email",
            "state": state,
        }
        return redirect(f"{AUTHORIZATION_ENDPOINT}?{urlencode(params)}")
    
    @app.route("/callback")
    def callback():
        returned_state = request.args.get("state")
        expected_state = session.pop("oauth_state", None)
    
        if not returned_state or returned_state != expected_state:
            abort(400, "invalid state")
    
        code = request.args.get("code")
        if not code:
            abort(400, "missing code")
    
        return "state validation passed"
    

    이 코드는 단순하지만 중요합니다. 제가 직접 해보니 state를 검증하는 순간, 재현되던 로그인 CSRF 시나리오가 바로 막히더라고요.

    Step 2. PKCE 붙이기

    PKCE는 생각보다 어렵지 않습니다. code_verifier를 만들고, 그걸 SHA-256으로 해시해서 code_challenge를 보내면 됩니다.

    import base64
    import hashlib
    import secrets
    
    
    def generate_pkce_pair():
        code_verifier = secrets.token_urlsafe(64)
        digest = hashlib.sha256(code_verifier.encode("ascii")).digest()
        code_challenge = base64.urlsafe_b64encode(digest).rstrip(b"=").decode("ascii")
        return code_verifier, code_challenge
    
    code_verifier, code_challenge = generate_pkce_pair()
    session["code_verifier"] = code_verifier
    
    params = {
        "response_type": "code",
        "client_id": CLIENT_ID,
        "redirect_uri": REDIRECT_URI,
        "scope": "openid profile email",
        "state": session["oauth_state"],
        "code_challenge": code_challenge,
        "code_challenge_method": "S256",
    }
    

    토큰 교환 시에는 저장한 code_verifier를 함께 보내야 합니다. 이 부분 빠뜨리면 “분명 PKCE 넣었는데 왜 안 되지?” 하고 삽질 좀 하게 됩니다 ㅎㅎ

    Step 3. Redirect URI는 정확히 고정하기

    운영 환경에서 제일 많이 깨지는 부분이기도 합니다. 프록시 뒤에서 http로 인식하거나, path가 달라지거나, 포트가 틀어지면 인증 서버와 애플리케이션의 인식이 어긋납니다.

    oauth:
      client_id: demo-client
      redirect_uri: https://app.example.com/callback
      allowed_redirect_uris:
        - https://app.example.com/callback
    

    여기서 중요한 포인트! 부분 일치 금지, 와일드카드 지양, 환경별 URI 명확 분리입니다.

    Step 4. 로컬에서 공격 시나리오 점검하기

    제가 홈랩에서 자주 쓰는 방식은 curl로 콜백을 강제로 때려보는 겁니다. 최소한의 재현만 해도 어디서 검증이 빠졌는지 바로 보입니다.

    curl -i "https://app.example.com/callback?code=test-code&state=wrong-state"
    
    curl -i "https://app.example.com/callback?code=test-code"
    

    정상이라면 둘 다 거절돼야 합니다. 하나라도 통과하면 바로 수정해야 합니다.

    OAuth 2.0 보안 구현에서 state와 PKCE 설정을 설명하는 구성 이미지

    안전한 OAuth 클라이언트 구현에서 state, PKCE, redirect URI 고정이 각각 어디에 들어가는지 보여주는 구성 이미지입니다.

    5. OAuth 2.0 보안 운영 팁: 코드보다 설정에서 더 많이 무너집니다

    사실 OAuth 공격은 코드보다 운영 설정에서 더 자주 터집니다. 애플리케이션 보안 관점에서 특히 아래 항목은 꼭 챙기셔야 합니다.

    • Access Token 저장 위치: 브라우저의 localStorage는 XSS에 취약할 수 있으니 신중히 접근
    • HTTPS 강제: 토큰과 코드가 평문으로 흘러가면 끝입니다
    • Scope 최소화: 꼭 필요한 권한만 요청
    • 토큰 수명 짧게: 장기 유효 토큰은 사고 반경을 키웁니다
    • Refresh Token 보호: 서버 측 저장과 회전(rotation) 전략 검토
    • 로그 마스킹: 토큰, 인가 코드, 사용자 식별자 노출 금지

    이건 제가 정말 여러 번 봤는데요. 개발 편의 때문에 디버그 로그에 전체 콜백 URL을 남기면, 거기에 code나 token이 그대로 찍히는 경우가 있습니다. 테스트 때는 편한데, 운영에서는 그대로 사고 증거가 되더라고요.

    6. ⚠️ 트러블슈팅: 제가 실제로 자주 겪었던 문제들

    문제 1. 프록시 뒤에서 redirect URI가 http로 바뀌는 경우

    Nginx나 Ingress(인그레스, 외부 트래픽 진입점) 뒤에 둘 때 앱이 원래 스킴을 못 알아차리면 https:// 대신 http://로 redirect URI를 만들어버립니다.

    • 해결: X-Forwarded-Proto 신뢰 설정
    • 해결: 프레임워크별 proxy headers 설정 확인
    • 해결: 인증 서버 등록 URI와 앱 생성 URI를 동일하게 맞춤

    문제 2. state를 세션에 저장했는데 콜백에서 사라지는 경우

    도메인, 서브도메인, SameSite 쿠키 정책이 엮이면 세션이 유지되지 않을 수 있습니다. 저도 처음엔 코드만 의심했는데, 알고 보니 쿠키 속성이 문제였던 적이 많았습니다.

    • 해결: 세션 쿠키 도메인과 SameSite 정책 점검
    • 해결: 로드밸런서 환경에서 세션 일관성 확인
    • 해결: 다중 인스턴스면 중앙 세션 저장소 사용

    문제 3. 모바일 앱에서 PKCE는 넣었는데 교환 실패

    대부분은 code_verifier를 로그인 시작 시점과 토큰 교환 시점에 다르게 쓰거나, Base64 URL 인코딩 처리가 어긋난 경우였습니다.

    • 해결: 최초 생성한 code_verifier를 그대로 유지
    • 해결: code_challenge_method=S256 확인
    • 해결: URL-safe Base64 처리와 패딩 제거 확인

    7. 검증과 결과: 무엇을 통과해야 “안전하다”고 말할 수 있을까요

    보안은 느낌으로 끝내면 안 됩니다. 체크리스트로 검증해야 합니다. 저는 아래 항목을 통과해야 최소 기준은 넘겼다고 봅니다.

    1. state가 없거나 틀리면 콜백이 거절된다
    2. 등록되지 않은 redirect URI는 인증 서버에서 거절된다
    3. PKCE 없이 또는 잘못된 verifier로는 토큰 교환이 실패한다
    4. 토큰과 code가 애플리케이션 로그에 남지 않는다
    5. 브라우저 개발자 도구에서 민감한 토큰 노출 면이 최소화돼 있다
    6. 권한 범위(scope)가 필요한 수준으로 제한돼 있다

    이렇게 점검하고 나면 OAuth 2.0 보안이 훨씬 단단해집니다. 화려한 기능 추가는 없어 보여도, 실제로는 장애와 사고를 줄이는 가장 값진 작업이더라고요.

    OAuth 2.0 보안 검증 결과와 체크리스트를 보여주는 대시보드 이미지

    state 검증, PKCE, redirect URI 검사, 로그 마스킹 여부를 통과/실패로 시각화한 결과 이미지입니다.

    8. OAuth 공격 방어 전략 한눈에 정리

    공격 유형 주요 원인 방어 전략
    로그인 CSRF state 검증 누락 고유 state 생성, 세션 바인딩, 1회성 사용
    인가 코드 탈취 redirect URI 오검증 정확 일치 비교, 사전 등록 URI만 허용
    코드 재사용/가로채기 PKCE 미적용 S256 PKCE 강제
    토큰 유출 부적절한 저장/로그 출력 로그 마스킹, 저장 위치 최소화, HTTPS 강제
    과도한 권한 넓은 scope 요청 최소 권한 원칙 적용

    혹시 지금 운영 중인 서비스가 있다면, 위 표 기준으로 하나씩 점검해보세요. 특히 OAuth 2.0 보안은 한 군데만 잘한다고 끝나는 게 아니라, 클라이언트와 인증 서버, 프록시와 브라우저 저장소까지 같이 봐야 합니다.

    OAuth 2.0 보안 공격 유형과 방어 전략을 요약한 인포그래픽

    대표적인 OAuth 공격 유형과 대응책을 좌우 비교 형태로 정리한 인포그래픽입니다.

    9. 마무리: OAuth 2.0 보안은 기능이 아니라 운영 습관입니다

    정리해보면, OAuth 2.0 보안의 핵심은 복잡한 암호 기술보다도 기본기입니다. state 검증, PKCE 적용, redirect URI 정확 일치, 토큰 노출 최소화. 이 네 가지만 제대로 해도 공격면이 눈에 띄게 줄어듭니다. 저도 처음엔 문서만 보고 붙였다가 왜 자꾸 이상한 케이스가 생기나 했었는데, 결국 문제는 대부분 “설마 이 정도는 괜찮겠지”에서 시작됐습니다.

    다음 글에서는 OAuth와 함께 자주 등장하는 OpenID Connect(OIDC, 인증 레이어)의 ID Token 검증 포인트를 따로 다뤄볼 예정입니다. 이전 글에서 다룬 리버스 프록시와 쿠키 보안 설정을 함께 보시면 더 이해가 잘 되실 겁니다.

    FAQ. 자주 헷갈리는 질문

    Q1. SPA에서도 OAuth를 안전하게 쓸 수 있나요?

    가능합니다. 다만 PKCE를 기본으로 하고, 토큰 저장 전략과 XSS 대응을 같이 설계해야 합니다.

    Q2. state와 nonce는 같은 건가요?

    완전히 같지는 않습니다. state는 요청 위조 방지에, nonce는 주로 재생 공격 방지와 토큰 검증 맥락에서 쓰입니다.

    Q3. redirect URI를 여러 개 등록해도 괜찮나요?

    괜찮습니다. 다만 각각을 명시적으로 등록하고 정확히 일치 비교해야 합니다. 범용 패턴 허용은 조심하셔야 합니다.