참고! 중요한 문서 :
교차 출처 리소스 공유 (CORS) - HTTP | MDN
1. 동일 출처 정책 (Same-Origin Policy)
하나의 출처에서 다른 출처의 문서나 스크립트에서 가져온 리소스와 상호작용하는 것을 제한하는 정책. 기본적으로 동일한 출처의 리소스와 상호작용만 하도록 허용합니다.
1-1. 출처(Origin)
어떤 웹 컨텐츠에 접근하려고 할 때 사용하는 URL의 스킴(protocol), 호스트명(domain), 포트번호를 출처(Origin) 라고 함
아래의 두 개의 URL은 동일한 출처를 가진다고 할 수 있다. 리소스의 경로는 다르지만 동일한 프로토콜(http), 도메인(example.com), 포트번호(기본 80포트)를 가졌기 때문. (단, Internet Explorer는 프로토콜과 포트번호를 별도로 검사하지 않음)
1-2. 동일 출처 정책의 한계
요즘에는 Open API 등 다른 출처의 URL에 자원을 요청하는 경우가 굉장히 많아졌다. 동일 출처 정책은 웹을 충분히 활용하지 못하도록하는 방해꾼이 되었다. 그래서 서로 다른 출처끼리 상호작용 할 때는 CORS의 관리하에 가능해졌음!
❗️브라우저가 origin(출처) 다르다고 판단하는 경우
예시) https://hanamon.kr:442/username/1/
예시에 URL의 경우 아래와 같이 구분할 수 있다.
https -> 프로토콜hanamon.kr -> 호스트(도메인):442 -> 포트 번호/username/1/ -> URL pathname
위 URL에 구성 중 origin을 구분하는 기준은 “프로토콜”, “호스트(도메인)”, “포트 번호” 이다.
2. CORS (Cross-Origin Resource Sharing)
브라우저는 보안상의 이유로 교차출처 HTTP 요청을 제한한다. 브라우저의 Web API인 XMLHttpRequest와 Fetch API 역시 동일 출처 정책을 따른다. 그래서 다른 출처에서 리소스를 가져오기 위해서는 그 출처에서 CORS 헤더를 포함한 응답을 반환해야 함
2-1. Preflight 요청
OPTIONS 메서드를 통해 도메인의 리소스로 HTTP요청을 보내 실제 요청을 안전하게 요청할 수 있는지 확인한다. 이 과정을 거치는 이유는 아무 클라이언트나 서버에 접근해 유저 데이터에 영향을 미치는 것을 방지하기 위함이다. 그래서 Preflight 과정을 통해 서버에서 허용하는 출처들의 목록이나 허용 가능한 메소드 등을 확인하는 과정을 거치는 것
- 간단히 정리한 해결법
1. 미들웨어 설치 & 설정 (프론트엔드/백엔드 둘다 해당)
2. 프록시방식 사용 : 브라우저에서 프론트서버로 요청 > 프론트서버에서 백엔드서버로 요청.
프론트에서 요청 header에 Access-Control-Allow-Origin:'도메인:포트 or *(모든도메인)' 옵션 사용요청 헤더에 Origin과 Access-Control-Request-Method를 포함해 어떤 출처에서 보낸 것이며, 어떤 메소드를 사용할지 서버에 알려준다. Access-Control-Request-* 헤더는 Preflight 요청에서만 보내고 실제 요청을 보낼 때는 포함시키지 않음
서버는 응답 헤더에 가능한 출처의 목록(*는 모든 도메인에서 접근가능함을 의미)과 요청 가능한 메소드들의 종류를 보내줌
그래서 정리하자면?
- 웹 브라우저에서 외부 도메인 서버와 통신하기 위한 방식을 표준화한 HTTP 헤더 기반 메커니즘이다.
- 클라이언트와 서버가 서로 다른 도메인일 경우(HTTP 헤더의 origin이 다른 경우)가 있으므로 CORS 기술이 도입 되었다.
- CORS는 웹 브라우저가 만들고 실행하는 도메인이 달라도 리소스에 액세스할 수 있도록 하는 보안 메커니즘이다. (원래는 다르면 안주는 게 맞음)
- 달라도 줄 것이냐? 말 것이냐? 특정 도메인에만 허락할 것이냐? 모든 도메인에 허락할 것이냐?를 서버가 정한다. (기본은 안줌 웹 브라우저가 막음)
- 교차 출처 자원 공유(cross-origin-resource-sharing)이라는 이름으로 표준화 되었다.
- 서버쪽에서 클라이언트를 대상으로 리소스의 허용 여부를 결정하는 방법이다.
- 같은 origin에서 AJAX를 시도하면 CORS 문제가 발생하지 않는다.
- 클라이언트는 서버가 어떤 origin 요청을 허용하는지는 알 수 없다.
- 클라이언트에서 요청을 보낸 후, 서버로부터 받은 Access-Control-Allow-Origin 헤더 속성을 통해서 접속 가능 여부를 확인한다.
3. CORS 해결방법
3-1. 서버에서 CORS를 허용해주기
서버를 직접 제어할 수 있다면, 서버에서 Access-Control-Allow-Origin 헤더에 클라이언트 출처를 허용해주면 됩니다. 가장 정석인 방법이지만, Open API를 사용할 때처럼 서버를 직접 제어할 수 없는 경우에는 사용할 수 없습니다.
'Access-Control-Allow-Origin': '*',
'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
'Access-Control-Allow-Headers': 'Content-Type, Accept',
'Access-Control-Max-Age': 10👉 Requset headers (클라이언트 요청 헤더)
- Origin: 요청을 보내는 페이지의 출처 (도메인)
- Access-Content-Request-Method: 실제 요청하려는 메서드
- Access-Content-Request-Headers: 실제 요청에 포함되어 있는 헤더 이름
👉 Response headers (서버 응답 헤더)
- Access-Control-Allow-Origin: 요청을 허용하는 출처 ( * 와일드 카드이면 모든 곳에서 허용, 특정하려면 프로토콜 + 호스트 + 포트번호 입력)
- Access-Control-Allow-Credentials: 클라이언트 요청이 쿠키를 통해서 자격 증명을 하는 경우에 true, true를 응답받은 클라이언트는 실제 요청 시 서버에서 정의된 규격의 인증값이 담긴 쿠키를 같이 보내야 한다.
- Access-Control-Expose-Headers: 클라이언트 요청에 포함되어도 되는 사용자 정의 헤더
- Access-Control-Max-Age: 클라이언트에서 Preflight 의 요청 결과를 저장할 기간을 지정, 클라이언트에서 Preflight 요청의 결과를 저장하고 있을 시간이다. 해당 시간 동안은 Preflight 요청을 다시 하지 않게된다.
- Access-Control-Allow-Methods: 요청을 허용하는 메서드, 기본값은 GET, POST라고 보면된다. 이 헤더가 없으면 GET과 POST요청만 가능하다. 만약 이 헤더가 지정되어 있으면 클라이언는 헤더 값에 해당하는 메서드일 경우에만 실제 요청을 시도한다.
- Access-Control-Allow-Headers: 요청을 허용하는 헤더.
const express = require('express');
const app = express();
app.get('/allow-cors', function(request, response) {
response.set('Access-Control-Allow-Origin', '허용 도메인');
response.sendFile(__dirname + '/message.json');
});
const listener = app.listen(process.env.PORT, function() {
console.log('Your app is listening on port ' + listener.address().port);
});
위의 방법은 가장 정석이지만, 서버에서 응답을 보낼 때마다 Access-Control-Allow-Origin 헤더를 추가해줘야하는 번거로움이 있다. Express를 이용해 서버를 구축한 경우 Node.js 미들웨어인 CORS를 설치하면 매번 CORS관련 설정을 직접해줄 필요가 없습니다.
const express = require('express');
const cors = require('cors');
const app = express();
app.use(cors({ origin: '허용 도메인' }));
3-2. 프록시 서버 사용하기
서버를 직접 제어할 수 없는 상황이라면 프록시 서버를 사용하는 방법이 있다. CORS 정책은 브라우저에서 강제하는 방법이다. 서버에서 브라우저에게 몇몇 조건이 걸린 헤더들을 내려주면 브라우저에서는 SOP를 지키며 작업을 처리하지만 프록시 서버는 그렇지 않다. 서버 간 통신에서는 이 정책이 적용되지 않기 때문이다.
또한 프록시 서버는 클라이언트에게 응답을 보낼 때 Access-Control-Allow-Origin의 출처로 요청 도메인의 출처를 포함시켜주면 되기 때문에 CORS 문제를 해결 할 수 있습니다.
3-3. https-proxy-middleware 라이브러리 설치
개발 중에 로컬 환경에서 클라이언트와 서버의 출처의 포트번호가 달라 CORS 문제가 발생할 때 사용하는 방법입니다. CRA환경에서 개발중일 때도 사용할 수 있습니다.
요약
- SOP는 동일한 출처에서만 리소스를 상호작용하도록 제한하는 정책
- 현실적으로 SOP를 지키기는 어렵기 때문에, 브라우저에서는 CORS 정책을 통해 출처가 다른 도메인 간의 리소스 상호작용을 제한적으로 허용
- 브라우저는 Preflight 요청을 통해서 서버에 요청을 보내도 되는지 확인 요청을 보낸다. 이때 클라이언트의 출처를 밝히는
Origin헤더를 포함해 요청을 보내고, 서버에서는 요청이 가능한 출처를 포함한Access-Control-Allow-Origin헤더를 포함해 응답을 보내줌 - CORS 이슈는 서버에서 클라이언트를 허용 출처로 포함해주는 것이 가장 최선이지만, 서버를 제어할 수 없는 환경에서는 프록시 서버를 이용해 해결할 수 있음
참고
