CORS credentials — 쿠키와 와일드카드 함정

credentials: include 요청에서 왜 Access-Control-Allow-Origin: *가 거부되는지 시뮬레이션합니다. Allow-Credentials와 출처 명시가 왜 세트인지 확인하세요.

시나리오 프리셋

요청 — 브라우저(페이지) 쪽

Method

Content-Type

커스텀 헤더

응답 — 서버가 보내는 헤더

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

요청에 필요한 헤더 + 자주 쓰는 값 — 클릭으로 토글

브라우저 처리 단계

→

페이지에서 fetch 요청 발생

•

단순 요청(CORS-safelisted) — 프리플라이트 없이 바로 전송

→

본 요청 전송

GET /data HTTP/1.1
Origin: https://myapp.example.com
Content-Type: text/plain
Cookie: session=abc123
←

서버의 본 응답 도착

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true

{"status": "ok"}
✗

credentials 요청에 와일드카드 '*' 사용 불가

✗

브라우저가 응답을 차단하고 fetch를 reject

브라우저 콘솔

✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: The value of the 'Access-Control-Allow-Origin' header in the response must not be the wildcard '*' when the request's credentials mode is 'include'.

(index):1

값을 바꾸면 아래 단계가 즉시 다시 계산됩니다. 'credentials + *' 시나리오에서 와일드카드가 왜 막히는지 확인해 보세요.

fetch에 credentials: 'include'를 넣으면 쿠키·Authorization이 크로스 오리진으로도 전송됩니다. 이때 브라우저는 훨씬 엄격해져서, Access-Control-Allow-Origin: *를 거부합니다 — 와일드카드로 모든 사이트에 내 로그인 세션 응답을 열어주면 안 되기 때문입니다.

credentials 요청이 통과하려면 두 조건이 세트입니다. 서버가 정확한 출처를 Access-Control-Allow-Origin에 적고(반영 허용), Access-Control-Allow-Credentials: true를 함께 보내야 합니다. 둘 중 하나라도 빠지면 다른 이유로 차단됩니다.

SameSite 쿠키 정책과도 얽힙니다. 크로스 사이트로 쿠키를 보내려면 쿠키 자체가 SameSite=None; Secure 속성을 가져야 해서, CORS 설정과 쿠키 설정 양쪽을 맞춰야 동작합니다. 이 시뮬레이터의 '*' → '요청 출처 반영' 전환으로 차단이 풀리는 과정을 확인해 보세요. CORS 시뮬레이터에서 다른 시나리오도 같은 설정으로 비교해 보세요.

자주 묻는 질문

ACAO를 *로 두고 ACAC: true만 추가하면 안 되나요?
안 됩니다. credentials 모드에서 와일드카드는 ACAC 유무와 관계없이 항상 거부됩니다. 요청 Origin 값을 그대로 ACAO에 반영(reflect)하는 방식으로 특정 출처만 허용해야 합니다.
쿠키를 보냈는데 서버에 안 닿아요. 왜죠?
CORS 외에 SameSite 쿠키 규칙 때문일 수 있습니다. 크로스 사이트 요청에 쿠키를 실으려면 쿠키가 SameSite=None; Secure여야 하고, 브라우저의 서드파티 쿠키 차단 설정도 영향을 줍니다.
여러 출처를 허용하려면 ACAO에 콤마로 나열하면 되나요?
안 됩니다. ACAO는 단일 값만 허용하므로, 서버가 요청 Origin을 화이트리스트와 비교해 허용된 출처만 헤더에 되돌려주는 방식으로 구현합니다.

다른 시나리오 보기