CORS와 SOP 정리: 출처, 단순 요청과 Preflight, 자격 증명 요청
브라우저는 동일 출처 정책(SOP)에 따라 다른 출처의 응답을 스크립트가 읽지 못하게 막는다. CORS는 서버가 응답 헤더로 "이 출처는 읽어도 된다"고 허락하는 방식이다. 출처는 스킴 + 호스트 + 포트이고, 조건을 벗어난 요청은 본 요청 전에 OPTIONS Preflight로 먼저 허락을 받는다. CORS는 브라우저가 지키는 규칙이라 서버 간 통신에는 적용되지 않는다.1. 출처(Origin)란
출처는 https://app.example.com:443처럼 스킴, 호스트, 포트 세 가지로 정해진다. 셋 중 하나라도 다르면 다른 출처다. 경로나 쿼리는 상관없다.
| 비교 대상 (기준: https://app.example.com) | 같은 출처? | 이유 |
| https://app.example.com/orders?id=1 | 같음 | 경로·쿼리는 무관 |
| http://app.example.com | 다름 | 스킴이 다름 |
| https://api.example.com | 다름 | 호스트가 다름 (서브도메인도 다른 호스트) |
| https://app.example.com:8443 | 다름 | 포트가 다름 |
| http://localhost:3000 vs http://localhost:8080 | 다름 | 포트가 다름 (로컬 개발에서 가장 흔한 경우) |
2. SOP가 막는 것과 막지 않는 것
| 구분 | 다른 출처에서 |
| img, script, link(CSS) 태그로 리소스 불러오기 | 허용 (단, 스크립트가 내용을 읽는 것은 제한) |
| form 제출 | 허용 (응답을 스크립트로 읽지 못할 뿐) |
| fetch/XHR로 요청 보내고 응답 읽기 | CORS 허락이 없으면 응답을 읽을 수 없음 |
| 다른 출처 iframe의 DOM 접근 | 차단 |
중요한 점은 단순 요청의 경우 요청 자체는 서버에 도착하고 처리된다는 것이다. 브라우저는 응답에 허락 헤더가 없으면 그 응답을 스크립트에 넘기지 않을 뿐이다. 그래서 CORS는 서버를 보호하는 장치가 아니라, 사용자의 브라우저에서 악성 사이트가 다른 사이트의 응답을 몰래 읽는 것을 막는 장치다. 상태를 바꾸는 요청에 대한 방어는 CSRF 대책(토큰, SameSite 쿠키)이 따로 필요하다.
3. CORS 헤더
| 헤더 | 방향 | 의미 |
| Origin | 요청 | 요청을 보낸 페이지의 출처 (브라우저가 자동으로 붙임) |
| Access-Control-Request-Method | Preflight 요청 | 본 요청에서 쓸 메서드 |
| Access-Control-Request-Headers | Preflight 요청 | 본 요청에서 쓸 비표준 헤더 |
| Access-Control-Allow-Origin | 응답 | 허용할 출처 (하나의 출처 또는 *) |
| Access-Control-Allow-Methods | Preflight 응답 | 허용할 메서드 |
| Access-Control-Allow-Headers | Preflight 응답 | 허용할 요청 헤더 |
| Access-Control-Allow-Credentials | 응답 | true면 쿠키 등 자격 증명이 포함된 요청의 응답도 읽기 허용 |
| Access-Control-Max-Age | Preflight 응답 | Preflight 결과를 캐시할 시간(초) |
| Access-Control-Expose-Headers | 응답 | 스크립트가 읽을 수 있게 노출할 응답 헤더 |
4. 단순 요청 vs Preflight 요청
다음 조건을 모두 만족하면 단순 요청(Simple Request)이라 Preflight 없이 바로 보낸다.
- 메서드가
GET,HEAD,POST중 하나 - 직접 설정한 헤더가
Accept,Accept-Language,Content-Language,Content-Type등 안전 목록에 있는 것뿐 Content-Type이application/x-www-form-urlencoded,multipart/form-data,text/plain중 하나
그래서 JSON을 POST하거나(Content-Type: application/json), Authorization 헤더를 붙이거나, PUT·DELETE를 쓰면 Preflight가 발생한다. 대부분의 API 호출이 여기에 해당한다.
5. 자격 증명(쿠키)을 포함한 요청
다른 출처 요청에는 기본적으로 쿠키가 실리지 않는다. 쿠키를 보내려면 클라이언트와 서버 양쪽에서 설정해야 한다.
| 위치 | 설정 |
| 클라이언트 | fetch(url, { credentials: "include" }) / axios는 withCredentials: true |
| 서버 | Access-Control-Allow-Credentials: true |
| 서버 | Access-Control-Allow-Origin에 * 대신 정확한 출처를 지정 (자격 증명 요청에서는 * 불가) |
| 쿠키 | 다른 사이트로 보내야 하면 SameSite=None; Secure 필요 |
출처(origin)와 사이트(site)는 다르다. 사이트는 대략 등록 가능한 도메인 단위라서 app.example.com과 api.example.com은 출처는 다르지만 같은 사이트다. CORS는 출처 기준, 쿠키의 SameSite는 사이트 기준으로 판단한다.
6. 서버 설정 예
스프링 시큐리티를 쓰면 Preflight OPTIONS 요청이 인증 필터에서 401로 막힐 수 있다. 시큐리티 설정에서도 CORS를 활성화해 Preflight가 인증 전에 처리되게 한다.
7. 실제로 어떻게 적용되나
- 로컬 개발 프록시: 프론트(3000)와 API(8080)의 포트가 달라 CORS 에러가 나면, 개발 서버의 프록시(Next.js
rewrites, Viteserver.proxy)로 같은 출처에서 호출하는 것처럼 만든다. 프록시 서버가 API를 대신 호출하는 것은 서버 간 통신이라 CORS가 없다. - 운영에서 같은 출처로 묶기: 리버스 프록시로
/api경로를 백엔드로 보내면 프론트와 API가 같은 출처가 되어 CORS 설정 자체가 필요 없다. - 허용 출처는 목록으로: 요청의
Origin을 그대로Allow-Origin에 반사하면 사실상 모든 출처를 허용하는 셈이다. 허용 목록과 비교해서 맞을 때만 돌려준다. 응답이 Origin에 따라 달라지므로 캐시를 위해Vary: Origin도 붙인다. - 에러 메시지 읽는 법: 브라우저 콘솔의 CORS 에러는 응답 헤더 문제지만, 실제 원인은 서버가 500을 내며 헤더를 못 붙인 경우도 많다. 네트워크 탭에서 응답 상태 코드부터 확인한다.
8. 면접 질문으로 정리
- Q. CORS란? 다른 출처의 리소스 접근을 서버가 응답 헤더로 허용하는 메커니즘이다. 브라우저는 Access-Control-Allow-Origin 등을 확인해 허용된 경우에만 스크립트에 응답을 넘긴다.
- Q. 출처는 무엇으로 판단하나? 스킴, 호스트, 포트가 모두 같아야 같은 출처다.
- Q. Preflight 요청은 언제 발생하나? GET·HEAD·POST 외의 메서드, 안전 목록 밖의 헤더(Authorization 등), application/json 같은 Content-Type을 쓸 때 본 요청 전에 OPTIONS로 허용 여부를 확인한다.
- Q. 쿠키를 포함한 CORS 요청의 조건은? 클라이언트는 credentials: include를 설정하고, 서버는 Allow-Credentials: true와 와일드카드가 아닌 정확한 Allow-Origin을 응답해야 한다.
- Q. Postman에서는 되는데 브라우저에서 CORS 에러가 나는 이유는? CORS는 브라우저가 적용하는 정책이라 Postman이나 서버 간 호출에는 적용되지 않기 때문이다.