OAuth 2.0오어스 · OAuth 2.0 Authorization Framework
사용자가 비밀번호를 넘기지 않고도 제3자 응용(클라이언트)이 정해진 범위와 기간 안에서 사용자의 자원에 접근하도록, 인가 서버가 접근 토큰을 발급하는 인가 위임 프레임워크다.
1요약
- OAuth 2.0 은 HTTP 위에서 도는 IETF 인가 위임 프레임워크(RFC 6749 · 2012)로, 자원 소유자 · 클라이언트 · 인가 서버 · 자원 서버 넷이 접근 토큰을 주고받고, 그 위에서 OpenID Connect 로그인과 API 의 Bearer 토큰 확인이 돈다.
- 토큰이 없으면 제3자 앱이 사용자 비밀번호를 받아 계정 전체에 기한 없이 접근하고, 공용 앱의 코드를 다른 앱이 가로채는 공격까지 겹쳐 2025년 RFC 9700 은 공용 클라이언트에 PKCE 를 의무로, 비밀번호 그랜트를 금지로 정했다.
- 「OAuth 로그인이 안 된다」는 어느 단계의 오류 응답인가로 가른다 — 돌아오지 못하고 인가 서버 화면에 멈추면 redirect_uri 등록 값이, 토큰 요청의 invalid_grant 면 코드 · verifier 가, API 의 401 · 403 이면 토큰 수명 · 범위가 원인이다.
2등장 배경
2000년대 중반 웹 서비스는 다른 서비스의 주소록 · 사진을 가져오려고 사용자 비밀번호를 직접 받았다. 받은 앱은 계정 전체 권한을 기한 없이 가졌고, 한 앱만 끊으려 해도 비밀번호를 바꿔 모든 앱을 끊는 수밖에 없었다.
2007년 12월 커뮤니티 명세 OAuth Core 1.0 이 비밀번호 대신 토큰을 쓰는 방식을 냈고(2010년 RFC 5849), 요청마다 서명을 계산하는 부담을 덜려고 2012년 10월 TLS 와 Bearer 토큰에 기대는 RFC 6749 · RFC 6750 이 OAuth 2.0 으로 나와 RFC 5849 를 대체했다.
모바일 앱이 늘자 2015년 RFC 7636(PKCE)이 코드 가로채기를, 2017년 RFC 8252 가 앱의 외부 브라우저 사용을 정했다. 2025년 1월 RFC 9700 이 보안 권고를 묶어 RFC 6749 를 갱신했고, 이를 합칠 OAuth 2.1 은 2026년 10월 현재 draft-ietf-oauth-v2-1-17 로 아직 RFC 가 아니다.
3쉽게 이해하기 — 호텔 프런트가 내주는 세탁 업체용 카드키
호텔 투숙객이 세탁할 옷을 방 앞 보관함에 넣어 두었다. 세탁 업체 직원이 「방 열쇠를 빌려 달라」고 하자 투숙객은 열쇠 대신 업체를 프런트로 보내고, 업체는 이때 봉인 봉투 하나를 투숙객 편에 함께 맡긴다. 프런트는 투숙객 본인에게 「보관함만, 15분 동안」 열어 줄지 묻고 교환표 한 장을 투숙객 편에 업체로 보낸다. 업체가 교환표와 그 봉투의 짝이 되는 쪽지를 함께 내자, 프런트는 둘이 맞는지 보고 보관함 하나만 열리는 카드키를 내준다.
그림 1 · 투숙객은 열쇠를 넘기지 않고 동의만 하고, 업체는 교환표와 짝 쪽지를 맞춰야 보관함 하나만 여는 카드키를 받는다.
그림 2 · 마스터 키와 카드키의 차이는 범위 · 기간 · 끊는 단위 세 가지이고, 비밀번호 공유와 접근 토큰의 차이도 같은 세 가지다.
| 비유 | OAuth 요소 | 실제로 하는 일 |
|---|---|---|
| 투숙객 | 자원 소유자 | 동의 화면에서 범위를 허락한다 · 비밀번호는 인가 서버에만 입력 |
| 세탁 업체 | 클라이언트 | client_ |
| 프런트 | 인가 서버 | 사용자를 인증하고 코드 · 토큰을 발급한다 |
| 보관함 | 자원 서버 | 토큰의 범위 · 만료를 확인하고 자원을 내준다 |
| 교환표 | 인가 코드 | 브라우저 주소에 실려 전달 · 한 번만 · 최대 10분 권고 |
| 봉인 봉투와 짝 쪽지 | code_ | 해시는 인가 요청에, 원본은 토큰 요청에만 싣는다 |
| 카드키 | 접근 토큰 · 범위 | Bearer 헤더로 요청마다 제시한다 |
| 재발급권 | 갱신 토큰 | 새 접근 토큰을 받고, 쓸 때마다 새 갱신 토큰으로 바뀐다 |
⚠ 비유에서는 투숙객이 교환표를 손으로 건네지만 실제 인가 코드는 브라우저 리다이렉트 주소에 실려 사람이 보지 않고, 카드키는 꽂으면 열리지만 접근 토큰은 자원 서버가 요청마다 만료 · 범위 · 대상을 따로 확인한다.
4구조 — 네 역할과 두 엔드포인트
RFC 6749 1.1절은 역할을 넷으로 나누고, 인가 서버는 브라우저가 오는 인가 엔드포인트와 클라이언트가 직접 부르는 토큰 엔드포인트를 연다(3.1 · 3.2절). 클라이언트는 비밀을 지킬 수 있는 기밀 클라이언트(서버 앱)와 못 지키는 공용 클라이언트(모바일 · 브라우저 앱)로 나뉜다(2.1절).
그림 3 · 사용자 동의와 인가 코드는 브라우저를 지나는 앞 채널로, 토큰은 서버 사이 직접 연결인 뒤 채널로만 오가고, 두 채널은 인가 서버에서 만난다.
| 요소 | 맡는 일 | 대표 값 | 근거 |
|---|---|---|---|
| 자원 소유자 | 접근 허락 | 동의한 scope | RFC 6749 1.1절 |
| 클라이언트 | 토큰을 받아 API 호출 | client_ | RFC 6749 2.1 · 3.1.2절 |
| 인가 서버 | 인증 · 동의 · 발급 | /authorize · /token | RFC 6749 3.1 · 3.2절 |
| 자원 서버 | 토큰 확인 · 자원 응답 | 401 invalid_ | RFC 6750 3.1절 |
| 인가 코드 | 토큰으로 교환할 재료 | 한 번만 · 최대 10분 권고 | RFC 6749 4.1.2절 |
| 접근 토큰 | 자원 요청마다 제시 | expires_ | RFC 6749 1.4 · 5.1절 |
| 갱신 토큰 | 새 접근 토큰 받기 | 공용 클라이언트는 회전 또는 발신자 제한 | RFC 9700 2.2.2절 |
| 범위(scope) | 권한의 크기 | 공백으로 나눈 문자열 | RFC 6749 3.3절 |
그랜트(토큰을 받는 방법) 다섯 중 지금 쓰는 것은 앞 셋이다.
| 그랜트 | 쓰는 곳 | 지금 상태 |
|---|---|---|
| 인가 코드 + PKCE | 사용자가 있는 웹 · 모바일 앱 | 권장 · 공용 클라이언트는 PKCE 필수(RFC 9700 2.1.1절) |
| 클라이언트 자격 증명 | 서버 사이 호출 | 기밀 클라이언트만 · 갱신 토큰을 주지 않음 권고(RFC 6749 4.4 · 4.4.3절) |
| 장치 인가 | TV 처럼 입력이 어려운 장치 | RFC 8628(2019) |
| 암묵(implicit) | 옛 브라우저 앱(토큰을 주소로 받음) | 쓰지 않음 권고(RFC 9700 2.1.2절) · 2.1 초안에서 삭제 |
| 자원 소유자 비밀번호 | 앱이 비밀번호를 직접 받음 | 금지(RFC 9700 2.4절) · 2.1 초안에서 삭제 |
5동작 — 인가 코드 + PKCE 로 사진 앨범 읽기
설명용 가정 값 — 인화 서비스(기밀 클라이언트 print.example.org)가 사진 앨범(photos.example.net)을 읽고, 인가 서버는 login.example.net 이다. PKCE 값은 RFC 7636 4.2절 식으로 직접 계산했다.
- 클라이언트가 32바이트를 BASE64URL 로 바꾼 code_verifier
MDEyMzQ1Njc4OTo7PD0-P0BBQkNERUZHSElKS0xNTk8(43자 · 실제로는 난수)에서 code_challengef83nC9hdXQsHEZE_8X6ONhcwXB2CfSt9S1XjhVCHGFo를 계산한다(RFC 7636 4.1 · 4.2절). - 브라우저를
/로 보낸다(RFC 6749 4.1.1절).authorize?response_type= code&client_id= print-web-71&redirect_uri= …/ cb&scope= photos. read&state= k3Vq9&code_challenge= f83nC9…&code_challenge_method= S256 - 인가 서버가 사용자를 로그인시키고 「사진 읽기(photos.read)」 동의를 받은 뒤, challenge 를 발급할 코드에 묶어 저장한다.
- 인가 서버가
302 Location: https:로 돌려보내고, 클라이언트는 state 가 보낸 값과 같은지 대조한다(RFC 6749 10.12절)./ / print. example. org/ cb?code= Sp1mQ7&state= k3Vq9 - 클라이언트가
POST https:에 grant_type=authorization_code · code · redirect_uri · code_verifier 와 클라이언트 인증을 실어 보낸다(RFC 6749 4.1.3절)./ / login. example. net/ token - 인가 서버는 verifier 의 해시 · redirect_uri · 코드 첫 사용을 확인한 뒤 access_token ·
expires_in: 900· refresh_token · scope 를 돌려준다(RFC 7636 4.6절 · RFC 6749 5.1절). - 클라이언트가
GET https:에/ / photos. example. net/ v1/ albums Authorization: Bearer <접근 토큰>을 실어 보내고, 자원 서버는 범위 photos.read 를 확인해 200 을 준다(RFC 6750 2.1절). - 900초 뒤 401 invalid_token 을 받으면 grant_type=refresh_token 으로 새 접근 토큰과 새 갱신 토큰을 받고, 옛 갱신 토큰은 무효가 된다(RFC 9700 4.14.2절).
그림 4 · 사용자 동의와 코드는 브라우저를 지나는 앞 채널로, verifier 와 토큰은 클라이언트가 직접 여는 뒤 채널로만 오간다.
그림 5 · 가로챈 쪽은 코드는 갖지만 verifier 가 없어 인가 서버의 해시 비교에서 걸러진다 — 앞 채널에는 해시만 나가기 때문이다.
🔑 PKCE 는 인가 코드를 숨기지 않는다. 코드가 새어도 쓸 수 없게, 원본 verifier 는 뒤 채널에만 싣고 앞 채널에는 그 해시만 보낸다.
6비교 — OAuth 2.0 · OpenID Connect · SAML 2.0 · API 키
| 기준 | OAuth 2.0 | OpenID Connect | SAML 2.0 | API 키 |
|---|---|---|---|---|
| 푸는 문제 | 인가 위임 | 인증(로그인) + 사용자 정보 | 기업 웹 SSO 인증 · 속성 전달 | 호출하는 앱 식별 |
| 결과물 | 접근 토큰(형식 자유) | ID 토큰(JWT · iss · sub · aud · exp · iat 필수) + 접근 토큰 | 서명한 XML 어설션 | 고정 문자열 |
| 읽는 쪽 | 자원 서버(API) | 클라이언트 자신 | 서비스 제공자 | API |
| 사용자 동의 · 범위 | scope | scope 에 openid 필수 | IdP 정책 | 없음 |
| 수명 · 끊기 | 짧은 수명 + 갱신 · 폐기 | ID 토큰 수명 + 세션 | 어설션 유효 기간 | 바꿀 때까지 |
| 표준 | RFC 6749(2012) | OIDC Core 1.0(2014 · ISO/IEC 26131:2024) | OASIS(2005) | 없음 |
분석사용자 대신 API 를 부를 권한이 필요하면 OAuth 2.0, 그 앱에 «누가» 로그인했는지 알려야 하면 그 위에 OIDC, 이미 SAML IdP 를 쓰는 사내 웹 SSO 는 SAML 을 고른다. ID 토큰은 aud 가 클라이언트 자신이지만(OIDC Core 1.0 2절) 접근 토큰에는 그런 규칙이 없어, 접근 토큰을 로그인 증거로 쓰면 다른 앱이 받은 토큰으로도 로그인되는 틈이 생긴다.
🔑 접근 토큰은 «이 앱이 무엇을 해도 되는가»를 자원 서버에, ID 토큰은 «방금 누가 로그인했는가»를 클라이언트에 말한다.
7실무 진단 — 실패한 단계 가르기
분석오류가 보인 곳(인가 서버 화면 · 토큰 응답 · API 응답)으로 단계를 먼저 가르고, 그 단계의 error 값을 RFC 정의와 대조한다. 인가 서버는 redirect_uri 가 틀리면 클라이언트로 돌려보내지 않고(RFC 6749 4.1.2.1절), 토큰 단계 오류는 JSON 의 error 값으로(5.2절), 자원 단계 오류는 WWW-Authenticate 헤더로(RFC 6750 3.1절) 알리기 때문이다.
| # | 증상 | 의심 원인 | 단계 | 확인 명령 · 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 동의 뒤 앱으로 돌아오지 않고 인가 서버 오류 화면 | redirect_/ · 포트 · http) | 인가 요청 | 브라우저 개발자 도구 네트워크 탭의 /authorize 요청 redirect_ | 정확한 문자열 일치(RFC 9700 2.1절) · 틀리면 리다이렉트하지 않음(RFC 6749 4.1.2.1절) |
| 2 | 토큰 요청이 400 invalid_grant | 코드 재사용 · 10분 초과 · verifier 불일치 · redirect_ | 토큰 교환 | curl -i https: | error 값 정의(RFC 6749 5.2절) · 해시 비교(RFC 7636 4.6절) |
| 3 | API 가 403 insufficient_scope | 인가 서버가 요청보다 좁은 scope 를 줌 | 자원 요청 | 토큰 응답의 scope 값 · curl -i -H "Authorization: Bearer $AT" https: | 발급 scope 가 요청과 다르면 응답에 scope 를 실음(RFC 6749 3.3절) · 403(RFC 6750 3.1절) |
| 4 | 갱신 직후 세션이 invalid_grant 로 끊김 | 회전된 옛 갱신 토큰 재사용(동시 요청 · 탈취) | 갱신 | 인가 서버 로그의 같은 갱신 토큰 두 번 사용 | 옛 토큰 재사용 = 현재 갱신 토큰 폐기(RFC 9700 4.14.2절) |
인가 서버 화면부터 보는 까닭은 그 단계에서 멈추면 클라이언트 로그에 아무것도 남지 않기 때문이다.
8시험 대비
www.q-net.or.kr시험에서는 네 역할과 인가 코드 흐름을 묻는 정의 · 특징형, PKCE · RFC 9700 · OAuth 2.1 초안으로 바뀐 점을 묻는 동향 · 발전형이 나올 수 있고, OIDC · SAML 과 견주는 비교형으로 넓어질 수 있다. 차이는 그림 5 의 «앞 채널에는 해시만»과 폐기된 두 그랜트의 RFC 9700 절 번호에서 난다.
- 개요 — 정의(인가 위임) · RFC 6749(2012) · 비밀번호 공유 문제 · 인증(OIDC)과 구분
- 구성 — 그림 3 구조(네 역할 · 인가 · 토큰 엔드포인트 · 앞 · 뒤 채널) + 기밀 · 공용 클라이언트
- 인가 코드 흐름 — 그림 4 순서도(authorize → 302 code · state → token → Bearer → 갱신) + 코드 최대 10분 · 한 번
- PKCE — 그림 5(S256 = BASE64URL(SHA-256(verifier)) · 43 ~ 128자 · 가로챈 코드 무력화)
- 그랜트와 보안 — 그랜트 표(코드 + PKCE · 클라이언트 자격 증명 · 장치 / 암묵 · 비밀번호 폐기) + redirect_uri 정확 일치 · 갱신 토큰 회전
- 동향 — OAuth 2.1 초안 · RFC 9700(2025) · DPoP(RFC 9449) 발신자 제한 토큰 · OIDC 결합
꼭 쓸 키워드
인가 위임자원 소유자인가 서버인가 코드PKCE접근 토큰갱신 토큰scoperedirect_uriBearer
9오해와 사실
- 오해OAuth 2.0 으로 로그인을 구현할 수 있으니 OAuth 는 인증 프로토콜이다.사실RFC 6749 는 접근 토큰의 형식과 사용자 신원 전달을 정하지 않으며, 로그인한 사용자를 알리는 ID 토큰은 OIDC Core 1.0 2절이 따로 정한다.
- 오해client_secret 이 있는 서버 앱에는 PKCE 가 필요 없다.사실RFC 9700 2.1.1절은 기밀 클라이언트에도 PKCE 를 권장하며, 남이 받은 코드를 끼워 넣는 코드 주입은 비밀로 막지 못한다(4.5절).
- 오해redirect_uri 는 도메인만 같으면 된다.사실앞부분 일치나 와일드카드는 공격자 경로로 코드를 보내는 틈이 되어(RFC 9700 4.1절), 같은 문서 2.1절은 등록 값과 정확한 문자열 일치를 요구한다.
10핵심 정리
| 구분 | 맡는 일 | 대표 값 | 오가는 채널 | 지금 규칙 |
|---|---|---|---|---|
| 자원 소유자 | 범위 동의 | scope=photos.read | 앞 채널 | 비밀번호는 인가 서버에만 |
| 클라이언트 | 토큰으로 API 호출 | client_ | 앞 · 뒤 | 공용 클라이언트는 PKCE 필수 |
| 인가 서버 | 인증 · 동의 · 발급 | /authorize · /token | 앞 · 뒤 | redirect_ |
| 자원 서버 | 토큰 확인 · 응답 | 401 · 403 | 뒤 | 토큰 대상 제한 권고 |
| 인가 코드 | 토큰 교환 재료 | 최대 10분 · 한 번 | 앞 → 뒤 | PKCE challenge 에 묶음 |
| 접근 토큰 | 요청마다 제시 | expires_ | 뒤 | 최소 권한 · 짧은 수명 |
| 갱신 토큰 | 새 접근 토큰 받기 | grant_ | 뒤 | 회전 또는 발신자 제한 |
| 폐기된 그랜트 | 암묵 · 비밀번호 | response_ | — | 쓰지 않음 · 금지 |
11참고 문헌
- 먼저 볼 문헌
- ★ RFC 6749 The OAuth 2.0 Authorization Framework — 네 역할 · 그랜트 다섯 · 인가 코드 수명과 오류 응답 규정을 원문으로 볼 때
- ★ RFC 7636 Proof Key for Code Exchange by OAuth Public Clients — code_verifier 길이 · S256 계산식 · 서버 대조 순서를 볼 때
- ★ RFC 9700 Best Current Practice for OAuth 2.0 Security — 폐기된 그랜트 · redirect_uri 정확 일치 · 갱신 토큰 회전 등 지금 지켜야 할 규칙을 볼 때
- ★ OpenID Connect Core 1.0 incorporating errata set 2 — ID 토큰의 필수 클레임과 openid 범위로 인가와 인증을 가를 때
- ★ draft-ietf-oauth-v2-1-17 The OAuth 2.1 Authorization Framework — RFC 6749 과 보안 권고를 한 문서로 합치는 진행 상태를 볼 때
- 본문 근거
- RFC 6750 The OAuth 2.0 Authorization Framework: Bearer Token Usage — IETF · 2012-10 ·
www.rfc-editor.org/rfc/rfc6750· 확인 2026-11-04 - RFC 8252 OAuth 2.0 for Native Apps (BCP 212) — IETF · 2017-10 ·
www.rfc-editor.org/rfc/rfc8252· 확인 2026-11-04 - RFC 8628 OAuth 2.0 Device Authorization Grant — IETF · 2019-08 ·
www.rfc-editor.org/rfc/rfc8628· 확인 2026-11-04 - RFC 9449 OAuth 2.0 Demonstrating Proof of Possession (DPoP) — IETF · 2023-09 ·
www.rfc-editor.org/rfc/rfc9449· 확인 2026-11-04 - RFC 7009 OAuth 2.0 Token Revocation — IETF · 2013-08 ·
www.rfc-editor.org/rfc/rfc7009· 확인 2026-11-04 - RFC 7662 OAuth 2.0 Token Introspection — IETF · 2015-10 ·
www.rfc-editor.org/rfc/rfc7662· 확인 2026-11-04 - RFC 5849 The OAuth 1.0 Protocol (RFC 6749 로 대체) — IETF · 2010-04 ·
www.rfc-editor.org/rfc/rfc5849· 확인 2026-11-04 - OAuth Core 1.0 — OAuth Core Workgroup · 2007-12 ·
oauth.net/core/1.0/· 확인 2026-11-04 - Assertions and Protocols for the OASIS Security Assertion Markup Language (SAML) V2.0 — OASIS · 2005-03 ·
docs.oasis-open.org/security/saml/v2.0/saml-core-2.0-os.pdf· 확인 2026-11-04 - ISO/IEC 26131:2024 OpenID Connect Core 1.0 incorporating errata set 2 — ISO/IEC JTC 1 · 2024-10 ·
www.iso.org/standard/89056.html· 확인 2026-11-04