교육 문의커뮤니티 입장하기

OAuth 2.0 뜻: 초보자를 위한 인증과 인가 이해하기

다른 앱에 내 비밀번호를 주지 않고 일정 읽기 같은 권한을 맡기는 방법이 OAuth 2.0입니다. 호텔 카드키 비유로 인증과 인가를 구분하고, 연결 순서와 권한 동의 화면에서 볼 것을 정리했습니다.

지금까지 50명 넘게 읽었어요, 43%가 끝까지 읽었어요
Share
OAuth 2.0 뜻: 초보자를 위한 인증과 인가 이해하기 대표 이미지
목차
  1. 인증과 인가는 다른 질문에 답합니다
  2. 호텔 카드키로 보는 액세스 토큰
  3. 일정 앱을 연결하는 다섯 단계
  4. 앱 종류에 따라 비밀값을 다루는 방식
  5. API 키, 세션, JWT가 맡는 일
  6. AI가 만든 코드에서 볼 부분
  7. 권한 동의 화면에서 볼 것
  8. 자주 묻는 질문
  9. Sources

세 줄로 먼저 읽기

  1. 인증은 접속한 사람이 누구인지 확인하는 일이고 인가는 어떤 작업을 허용할지 정하는 일이며 OAuth 2.0은 비밀번호 대신 범위가 정해진 토큰으로 권한을 맡기는 표준입니다.
  2. 인가 코드 방식에서는 앱이 돌려받은 짧은 인가 코드를 액세스 토큰으로 바꾸고, 비밀값을 감출 수 없는 공개 클라이언트는 PKCE로 이 교환을 보호합니다.
  3. 로그인 확인에는 OAuth 위에 인증을 더한 OpenID Connect의 ID 토큰을 쓰며 API 키와 세션, JWT는 역할이 달라 한 서비스에서 함께 쓰입니다.

일정 요약 앱이 내 캘린더를 읽어 오늘 할 일을 정리해 준다고 해 봅시다. 이 앱에 캘린더 계정의 비밀번호를 알려 주고 싶지는 않습니다. 그렇다고 아무 권한도 주지 않으면 앱은 일정을 읽을 수 없습니다.

OAuth 2.0은 이럴 때 앱에 필요한 접근 권한만 맡기는 표준입니다. 사용자는 원래 캘린더 서비스의 화면에서 권한 요청을 보고 허용하며, 앱은 허용된 작업에만 쓸 수 있는 토큰을 받습니다. 여기서 토큰(Token)은 요청을 보낼 때 권한을 증명하는 값입니다. AI가 문장을 처리하는 단위인 토큰과는 다른 말입니다.

이 글은 로그인 기능을 직접 만들지 않는 사람을 기준으로, 용어가 무엇을 하는지와 연결할 때 어디를 볼지 정리합니다.

인증과 인가는 다른 질문에 답합니다

인증(Authentication)은 접속한 사람이 누구인지 확인하는 일입니다. 인가(Authorization)는 그 사람이나 앱에 어떤 작업을 허용할지 정하는 일입니다. 둘은 따로 판단합니다. 아파트 입주민이라는 확인이 끝나도 관리사무소 금고를 여는 권한까지 생기지는 않습니다.

인증과 인가가 각각 확인하는 것

항목인증Authentication인가Authorization
답하는 질문접속한 사람이 누구인지무엇을 해도 되는지
아파트 출입입주민 신원 확인공동 현관과
들어갈 수 있는 시설
웹사이트로그인한 사용자 확인남의 주문서, 관리자 설정
접근 여부
다루는 표준OpenID ConnectOAuth 2.0
쓰는 토큰ID 토큰액세스 토큰
로그인 버튼이 잘 작동해도 인가 쪽 권한 검사가 맞는지는 따로 봐야 합니다.

OAuth 2.0 자체는 권한을 맡기는 방법을 정합니다. 로그인한 사람이 누구인지 앱이 확인하려면 OpenID Connect(OIDC)를 씁니다. OIDC는 OAuth 2.0 위에 인증 기능을 더한 표준이고, 인증 결과를 ID 토큰에 담아 줍니다.

그래서 소셜 로그인 버튼을 만들 때는 액세스 토큰을 받는 것만으로 로그인이 끝나지 않습니다. 그 서비스의 로그인 규격에 맞춰 ID 토큰으로 사용자를 확인하고, 액세스 토큰은 허용된 API 요청에 씁니다. API는 프로그램끼리 정해진 방식으로 요청과 응답을 주고받는 접점입니다.

호텔 카드키로 보는 액세스 토큰

호텔에서 내 방에 물건을 가져다줄 직원에게 출입 권한을 준다고 해 봅시다. 모든 방과 금고를 여는 마스터키를 건네는 대신, 내 방에만 들어가고 정한 기간이 지나면 못 쓰는 카드키를 받게 합니다.

OAuth의 액세스 토큰(Access Token)이 이 카드키에 해당합니다. 카드키가 내 방 문만 열듯, 일정 읽기 권한만 받은 토큰으로는 일정을 읽는 요청만 통과합니다. 범위를 검사하는 쪽은 일정을 보관한 서버입니다. 같은 토큰으로 일정 삭제를 요청하면 서버가 거절합니다.

일정 서버로 보낸 요청
일정 하나 삭제 요청
함께 보낸 토큰의 권한은 일정 읽기
거절: 이 토큰으로 허용된 작업은 일정 읽기뿐입니다
토큰을 가진 앱이라도 범위 밖 요청은 막힙니다
설명을 위해 만든 화면입니다. 실제 오류 문구는 서비스마다 다릅니다.

토큰을 쓸 수 있는 기간과 취소하는 방식은 서비스의 정책과 구현에 따라 다릅니다. Bearer 토큰은 가진 쪽이 그대로 쓸 수 있는 형태의 토큰입니다. 비밀번호가 아니라고 해서 공개해도 되는 값이 아니며, 카드키처럼 잃어버리지 않게 보관합니다.

일정 앱을 연결하는 다섯 단계

OAuth 연결에는 네 역할이 등장합니다. 일정 요약 앱을 예로 들면 이렇습니다.

역할이 예에서 하는 일
사용자(Resource Owner)내 일정 접근을 허용할지 결정
연결할 앱(Client)일정을 읽어 요약
인가 서버(Authorization Server)권한 요청을 처리하고 토큰 발급
리소스 서버(Resource Server)일정 데이터를 보관하고 허용된 요청에 응답

서버는 요청을 받아 처리하는 프로그램입니다. 인가 서버와 리소스 서버는 하는 일로 나눈 이름이어서, 한 회사가 같은 서비스 안에서 둘 다 운영하기도 합니다.

가장 많이 쓰는 인가 코드 방식(Authorization Code Flow)은 다음 순서로 진행됩니다.

인가 코드 방식으로 일정 앱 연결하기

  1. 1. 권한 요청앱이 일정 읽기 권한을 요청하며
    원래 일정 서비스로 이동
  2. 2. 로그인과 동의사용자가 그 서비스에서 로그인하고
    요청 권한 확인
  3. 3. 인가 코드서비스가 앱이 등록한 주소로
    짧게 쓰는 코드를 보냄
  4. 4. 토큰 교환앱이 코드를 토큰으로 바꾸고
    서비스가 조건을 검사
  5. 5. 일정 요청앱이 토큰과 함께 일정을 요청
    서버는 권한을 보고 응답

2번에서 이미 로그인했거나 전에 동의했다면 일부 화면이 나오지 않을 수 있습니다. 3번의 등록 주소를 Redirect URI라고 하며, 앱을 등록할 때 정해 두므로 사용자가 마음대로 바꾸는 값이 아닙니다. 1번에서 앱이 요청하는 '일정 읽기' 같은 권한 범위는 스코프(Scope)라고 부릅니다.

리프레시 토큰(Refresh Token)은 새 액세스 토큰을 받을 때 쓰는 값입니다. 모든 앱에 발급되지는 않고, 발급됐더라도 취소되거나 만료되면 다시 연결해야 합니다. 액세스 토큰과 마찬가지로 남에게 노출되지 않게 보관합니다.

앱 종류에 따라 비밀값을 다루는 방식

Client ID는 어떤 앱인지 구분하는 공개 식별자이고, Client Secret은 앱 자신을 인증할 때 쓰는 비밀값입니다. Client ID는 드러나도 되지만 Client Secret은 외부에 노출하면 안 됩니다.

비밀값을 숨길 수 있는지는 앱이 어디서 동작하는지에 달려 있습니다. 서버에서 동작하는 앱은 비밀값을 서버에 둘 수 있습니다. 브라우저나 배포된 모바일 앱 안에 넣은 비밀값은 이용자가 꺼내 볼 수 있으므로, 이런 앱은 비밀값을 감출 수 없다고 보고 공개 클라이언트로 설계합니다. 여기서 '공개'는 사용자 자료가 아니라 앱 안의 값이 드러난다는 뜻입니다.

서버형 앱과 공개 클라이언트의 비밀값 처리

항목서버형 앱서버에서 동작공개 클라이언트브라우저, 모바일 앱
Client ID공개 식별자공개 식별자
Client Secret 보관서버에 보관넣으면 이용자가
꺼낼 수 있음
PKCE권장필수
OAuth 보안 권고 RFC 9700 기준입니다.

PKCE는 인가 코드 방식에서 코드 요청과 토큰 교환을 서로 묶어, 중간에 코드를 가로챈 쪽이 토큰으로 바꾸지 못하게 하는 보호 장치입니다. 공개 클라이언트는 Client Secret 없이도 PKCE로 토큰 교환을 보호합니다.

state 값도 요청과 응답을 짝지어 위조된 요청을 막는 데 씁니다. 코드에 이 이름이 들어 있는 것으로는 부족하고, 앱이 돌아온 값을 처음 보낸 값과 실제로 대조해야 합니다. 이런 절차는 직접 조합하기보다 쓰는 서비스와 인증 라이브러리의 최신 안내를 따라 구현합니다.

API 키, 세션, JWT가 맡는 일

세 용어는 차례로 나온 대체 기술이 아니라 하는 일이 달라서, 한 서비스 안에서 함께 쓰입니다.

API 키, 세션, JWT의 역할

항목API 키세션JWT
하는 일요청하는 프로젝트나
앱을 식별
로그인 상태를
이어서 관리
정보를 담는
토큰 형식
대표 방식사용할 API와
앱을 제한해 발급
서버가 기록하고
브라우저는 식별자만
서명으로
변조 여부 확인
함께 볼 점권한 제한과 만료는
서비스마다 다름
공용 저장소로
여러 서버에서도 운영
서명돼도
내용은 보임
API 키 제한의 예는 Google Cloud, JWT는 표준 문서 RFC 7519 기준입니다.

API 키의 권한과 만료는 서비스마다 다릅니다. 예를 들어 Google Cloud에서는 키마다 쓸 수 있는 API와 애플리케이션을 제한할 수 있습니다.

세션(Session)은 로그인 뒤 상태를 이어 가는 방식입니다. 서버 세션 방식에서는 로그인하면 서버가 기록을 만들고 브라우저에는 세션 식별자만 줍니다. 놀이공원 입구에서 받은 팔찌로 이후 이용 자격을 확인하는 것과 같은 구조입니다.

JWT(JSON Web Token)는 정보를 담는 토큰 형식이고, OAuth와 OIDC에서도 이 형식을 씁니다. 서명된 JWT는 변조 여부를 확인할 수 있지만 내용은 누구나 풀어 볼 수 있습니다. 그래서 내용을 풀어 볼 수 있다는 것만으로 믿지 않고, 서명과 발급자, 대상 서비스, 유효 기간을 규격대로 검증합니다.

세 가지는 한 흐름 안에서 이어지기도 합니다. 외부 계정으로 OIDC 로그인을 마친 뒤, 내 서비스는 세션으로 로그인 상태를 유지할 수 있습니다.

AI가 만든 코드에서 볼 부분

AI 코딩 도구가 만든 로그인 화면이 잘 작동해도 권한 검사와 비밀값 보관이 맞는지는 따로 봐야 합니다. "안전하게 해 주세요"라고만 요청하면 AI도 무엇을 점검할지 정하기 어렵습니다. 어떤 값을 어디에 두는지 구체적으로 묻습니다.

Claude, 코드 검토 요청
이 프로젝트의 로그인 코드를 검토해 주세요.
Client ID와 Client Secret을 구분하고, 이 앱이 서버형인지 공개 클라이언트인지 설명해 주세요.
비밀값이 브라우저 코드, 로그, Git 기록에 들어가는 경로가 있는지, 확인한 파일과 확인하지 못한 부분도 알려 주세요.
서버형 앱입니다. Client Secret은 서버 코드에서만 읽고 있습니다.
NEXT_PUBLIC_으로 시작하는 환경 변수에는 비밀값이 없습니다.
확인하지 못한 부분은 배포 서버의 로그 설정입니다.
확인하지 못한 부분을 따로 답하게 합니다
설명을 위해 만든 화면입니다. 실제 비밀값은 요청문에 넣지 않습니다.

비밀값과 토큰이 새어 나가는 곳은 주로 아래 세 군데입니다.

  • 브라우저 코드: 환경 변수는 프로그램이 실행될 때 읽는 설정값이고 .env는 그 값을 담는 파일입니다. 비밀값을 코드에서 떼어 두는 데 쓰지만, 브라우저로 가는 코드에 들어가면 그대로 보입니다. 웹사이트 개발 도구인 Next.js에서는 NEXT_PUBLIC_이 붙은 환경 변수가 브라우저 코드에 포함되므로 비밀값에 쓰지 않습니다.
  • Git 기록: Git은 파일 변경 이력을 관리하는 도구입니다. .gitignore는 아직 추적하지 않는 파일을 제외할 뿐, 이미 등록했거나 공개한 비밀값을 기록에서 지우지 않습니다. 한 번 공개된 값은 서비스에서 폐기하고 새 값으로 바꿉니다.
  • 토큰 저장 위치: 브라우저의 localStorage에 둔 토큰은 같은 출처의 JavaScript가 읽을 수 있어, 악성 스크립트가 실행되는 XSS 공격에 노출되면 빼앗깁니다. HttpOnly 쿠키는 JavaScript가 값을 직접 읽지 못하게 하지만, 쿠키의 다른 보안 설정과 요청 위조 방어가 함께 있어야 합니다. 서버에 저장한다면 접근 통제와 기록 관리가 필요합니다.

토큰을 교환하는 위치, 저장 방식, HTTPS 사용, 요청과 응답 검증은 앱 구조와 묶어서 검토합니다. 이 중 한두 가지만 맞추면 나머지 위험은 그대로 남습니다.

권한 동의 화면에서 볼 것

직접 개발하지 않아도 OAuth를 가장 자주 만나는 곳은 "이 앱이 다음 권한을 요청합니다" 같은 동의 화면입니다. 오늘 일정을 요약하는 앱이 일정 읽기, 일정 삭제, 메일 발송을 함께 요청한다면 요약에 필요한 것은 일정 읽기뿐입니다. 삭제와 발송의 이유가 화면에 없다면 연결을 보류합니다.

동의 버튼을 누르기 전 순서

  1. 1. 주소원래 서비스의
    웹 주소가 맞는지
  2. 2. 앱과 제공자연결하려던 앱 이름과
    만든 회사
  3. 3. 권한과 목적 대조하려는 일에 필요한
    권한만 있는지
  4. 4. 잘못 허용했다면계정 설정의 연결된 앱에서
    권한 취소

3번에서 목적이 '새 일정 추가'라면 일정 만들기 권한이 필요하지만 메일 발송은 필요 없습니다. 서비스에 따라 만들기, 수정, 삭제를 하나의 쓰기 권한으로 묶어 보여 주기도 하고, 일부 권한만 골라 허용하는 화면이 없기도 합니다. 그럴 때는 묶인 권한 전체를 맡겨도 되는 앱인지로 판단합니다.

비밀번호를 넘기지 않아도 앱은 허용받은 권한으로 실제 데이터를 읽거나 바꿉니다. 4번에서 권한을 취소해도 앱이 이미 가져간 사본이 지워지는지는 서비스마다 다르므로, 해당 앱의 데이터 삭제 안내도 함께 봅니다.

자주 묻는 질문

액세스 토큰은 모두 60일 동안 유효한가요?

아닙니다. 유효 기간은 서비스와 토큰 종류, 발급 조건에 따라 다릅니다. 토큰을 발급할 때 받는 응답과 그 서비스의 문서에 만료 정보가 있습니다.

토큰이 만료되면 무조건 다시 로그인하나요?

리프레시 토큰과 갱신 절차가 있으면 새 액세스 토큰을 받아 계속 씁니다. 리프레시 토큰이 없거나 취소됐다면 다시 연결합니다. 같은 요청을 반복해 보내기보다 서비스가 돌려준 오류 문구에 적힌 조치를 따릅니다.

OAuth를 쓰면 비밀번호는 전혀 필요 없나요?

원래 서비스에 로그인할 때는 비밀번호나 다른 로그인 방법을 씁니다. OAuth의 핵심은 연결할 외부 앱에 그 비밀번호를 넘기지 않는 데 있습니다. 인가 코드 방식에서는 외부 앱이 원래 계정의 비밀번호를 받지 않습니다.

비개발자는 어디까지 이해하면 될까요?

어느 앱이 어떤 데이터를 읽거나 바꾸려 하는지, 그 권한이 지금 하려는 일에 필요한지 설명할 수 있으면 충분합니다. 직접 서비스를 만든다면 여기에 코드와 실제 권한 검사까지 검토해야 하고, 판단이 어려우면 변경 파일과 검사 결과를 검토할 수 있는 사람에게 넘깁니다.

Sources

Share

제대로 이해했는지 한 문제로 확인해 볼까요?

답을 고르면 바로 풀이가 나와요.

오늘 일정을 읽어 요약하는 앱이 일정 읽기, 일정 삭제, 메일 발송 권한을 모두 요청합니다. 어떻게 판단하면 될까요?

이 글이 도움이 되었나요?

이 글 다음 배우기AI 업무 자동화 입문입문 코스 · 3편

메일, 회의록, 리포트처럼 반복되는 일을 AI로 자동화하는 순서와 안전장치를 다룹니다

  1. 1AI 업무 자동화 뜻과 규칙 자동화와 다른 점
  2. 2n8n 이해하기, 노드로 잇는 자동화와 셀프호스팅
  3. 3회의록 자동화, 녹음과 받아쓰기와 요약과 배포
코스 전체 보기 →
이어서 읽기 좋은 글클로드 페이블 5.2(Claude Fable 5.2) 공개: 가격, 성능, 플랜 조건 →

앤트로픽이 2026년 11월 9일 공개한 클로드 페이블 5.2와 미토스 5.2를 정리했습니다. 입력과 출력 단가 20% 인하, 2.5배 빠른 패스트 모드, Opus 5.5와 GPT-6 아스트라를 포함한 벤치마크 비교, 안전장치 오탐 감소, 플랜별 이용 조건과 출시 기념 한도 초기화권, 클로드 코드에서 바꾸는 순서를 다룹니다.