✅ TIL

---

오늘은 cors가 무엇인지 알아보고 node.js를 이용하여 서버를 구축했다.

또한 과제 mini-node server를 공식 문서를 참고하여 직접 만들어볼 에정이다.

같은 JavaScript를 사용하지만 node.js 환경에서 사용하는 코드에는,
CommonJS나 모듈 등 브라우저에서 찾아볼 수 없는 다소 생소한 개념이 포함되어 있다.

node.js에서 사용하는 이 개념들은 백엔드뿐만 아니라,
프론트엔드에서도 적극 사용하고 있으며, API 서버 또한 구현할 줄 알아야 한다.

새로운 서비스를 만들려고 해도, 필요한 데이터를 저장하거나 불러오는 기본적인 API 서버를
구현할 수 없다면 아무런 동적 활동을 할 수 없는 클라이언트만 구현하게 될 것이기 때문이다.

CORS, SOP

---

이 사진은 웹 개발을 하다 보면, 이 에러를 적어도 한 번쯤은 겪게 되고, 골머리를 앓게 되는 CORS 에러이다.

CORS가 대체 뭐길래.. 알아보기 전에, CORS가 필요하게 된 배경인 SOP에 대해서 먼저 알아보도록 하자.

SOP

SOP은 Same-Origin Policy의 줄임말로, 동일 출처 정책을 뜻한다.

한 마디로 ‘같은 출처의 리소스만 공유가 가능하다’라는 정책이다. 여기서 말하는 ‘출처(Origin)’는 다음과 같다.

출처는 프로토콜, 호스트, 포트의 조합으로 되어있다. 이 중 하나라도 다르면 동일한 출처로 보지 않는다.

그렇다면 SOP은 왜 생겨났을까?

동일 출처 정책은 잠재적으로 해로울 수 있는 문서를 분리함으로써 공격받을 수 있는 경로를 줄여준다.

네이버 같은 웹 페이지에 로그인해서 서비스를 이용하고 있다고 해보자.
만약 로그아웃을 깜빡했거나 자동 로그인 기능으로 인해 브라우저에 로그인 정보가 남아있는 상황이라면?
그 상태에서 나의 로그인 정보를 노리는 코드가 있는 다른 사이트에 방문하게 된다면?

해커는 로그인 정보를 이용해서 네이버에서 사용할 수 있는 모든 기능을 이용할 수 있게 된다.

SOP이 있었다면?

애초에 SOP는 다른 사이트와의 리소스 공유를 제한하기 때문에 로그인 정보가 타 사이트의 코드에 의해서 새어나가는 것을 방지할 수 있었다. 이러한 보안상 이점 때문에 SOP은 모든 브라우저에서 기본적으로 사용하고 있는 정책이다.

그런데, 다른 출처의 리소스를 사용하게 될 일은 너무나도 많다.
당장 로컬 환경에서 개발할 때에도 클라이언트와 서버를 따로 개발하게 된다면 둘은 출처가 달라진다.

개발 중인 웹 사이트에서 네이버 지도 api를 사용하고 싶다면? github 정보를 받아와서 사용하고 싶다면?
모두 다른 출처의 리소스를 사용해야 하는 일이다.

하지만, 말했듯 모든 브라우저는 기본적으로 SOP 정책을 사용하고 있다.
어떻게 하면 다른 출처의 리소스를 받아올 수 있을까?

CORS

위 문제 상황에서 필요한 것이 바로 CORS이다.
CORS는 Cross-Origin Resource Sharing의 줄임말로 교차 출처 리소스 공유를 뜻한다.

MDN에서는 CORS를 다음과 같이 정의하고 있다.

CORS - 교차 출처 리소스 공유(Cross-Origin Resource Sharing, CORS)는 추가 HTTP 헤더를 사용하여, 한 출처에서 실행 중인 웹 애플리케이션이 다른 출처의 선택한 자원에 접근할 수 있는 권한을 부여하도록 브라우저에 알려주는 체제

즉, 브라우저는 SOP에 의해 기본적으로 다른 출처의 리소스 공유를 막지만, CORS로 접근 권한을 얻을 수 있게 되는 것이다.

지금까지 공부한 내용을 바탕으로 이 에러를 쉽고 친절하게 풀어서 쓰면 다음과 같을 것이다.

다른 출처의 리소스를 가져오려고 했지만 SOP 때문에 접근이 불가능하다.
CORS 설정을 통해 서버의 응답 헤더에 ‘Access-Control-Allow-Origin’을 작성하면 접근 권한을 얻을 수 있다.

즉, 이 에러는 CORS 때문이 아니라, SOP 때문이다.
CORS는 오히려 이 에러를 해결해 줄 수 있는 방안이었던 것이다!

CORS 동작 방식

CORS의 동작 방식에는 크게 세 가지가 있다.

1. 프리플라이트 요청 (Preflight Request)

실제 요청을 보내기 전, 'OPTIONS' 메서드로 사전 요청을 보내 해당 출처 리소스에
접근 권한이 있는지부터 확인하는 것을 프리플라이트 요청이라고 한다.

위 이미지의 흐름과 같이, 브라우저는 서버에 실제 요청을 보내기 전에 프리플라이트 요청을 보내고,
응답 헤더의 Access-Control-Allow-Origin으로 요청을 보낸 출처가 돌아오면 실제 요청을 보내게 된다.

만약에 요청을 보낸 출처가 접근 권한이 없다면 브라우저에서 CORS 에러를 띄우게 되고, 실제 요청은 전달되지 않는다.

이러한 과정 덕분에 실제 요청을 처음부터 통째로 보내는 것보다 리소스 측면에서 효율적이며,
CORS에 대비가 되어있지 않은 서버를 보호할 수 있다.

like.. internet Explorer

CORS 이전에 만들어진 서버들은 SOP 요청만 들어오는 상황을 고려하고 만들어졌다.
따라서 다른 출처에서 들어오는 요청에 대한 대비가 되어있지 않았다.

2. 단순 요청 (Simple Request)

단순 요청은 특정 조건이 만족되면, 프리플라이트 요청을 생략하고 요청을 보내는 것을 말한다.

대표적으로 아래 3가지 경우를 만족할 때만 가능하다.

• 요청의 메소드는 GET, HEAD, POST 중 하나여야 한다.
• Accept, Accept-Language, Content-Language, Content-Type, DPR, Downlink, Save-Data, Viewport-Width, Width 헤더일 경우 에만 적용된다.
• Content-Type 헤더가 application/x-www-form-urlencoded, multipart/form-data, text/plain중 하나여야한다. 아닐 경우 예비 요청으로 동작된다.

이처럼 다소 까다로운 조건들이 많기 때문에, 위 조건을 모두 만족되어 단순 요청이 일어나는 상황은 드물다고 보면 된다.
대부분 HTTP API 요청은 text / xml 이나 application / json 으로 통신하기 때문에 3번째 Content-Type이 위반되기 때문이다.

따라서 '대부분의 API 요청은 예비 요청(preflight)이다' 라고 이해하면 된다.

3. 인증정보를 포함한 요청 (Credentialed Request)

요청 헤더에 인증 정보를 담아 보내는 요청이다.
출처가 다를 경우에는 별도의 설정을 하지 않으면 쿠키를 보낼 수 없다. 민감한 정보이기 때문이다.
이 경우에는 클라이언트, 서버 양측 모두 CORS 설정이 필요하다.

• 클라이언트 측에서는 요청 헤더에 withCredentials : true를 넣어줘야 한다.
• 서버 측에서는 응답 헤더에 Access-Control-Allow-Credentials : true를 넣어줘야 한다.
• 서버 측에서 Access-Control-Allow-Origin을 설정할 때, 모든 출처를 허용한다는 뜻의 와일드카드(*)로 설정하면 에러가 발생한다. 인증 정보를 다루는 만큼 출처를 정확하게 설정해주어야 한다.

CORS 설정 방법

1. Node.js 서버

const http = require('http');

const server = http.createServer((request, response) => {
// 모든 도메인
  response.setHeader("Access-Control-Allow-Origin", "*");

// 특정 도메인
  response.setHeader("Access-Control-Allow-Origin", "https://codestates.com");

// 인증 정보를 포함한 요청을 받을 경우
  response.setHeader("Access-Control-Allow-Credentials", "true");
})

Node.js로 간단한 HTTP 서버를 만들 경우, 다음과 같이 응답 헤더를 설정해 줄 수 있다.

2. Express 서버

const cors = require("cors");
const app = express();

//모든 도메인
app.use(cors());

//특정 도메인
const options = {
  origin: "https://codestates.com", // 접근 권한을 부여하는 도메인
  credentials: true, // 응답 헤더에 Access-Control-Allow-Credentials 추가
  optionsSuccessStatus: 200, // 응답 상태 200으로 설정
};

app.use(cors(options));

//특정 요청
app.get("/example/:id", cors(), function (req, res, next) {
  res.json({ msg: "example" });
});

Express 프레임워크를 사용해서 서버를 만드는 경우에는,
cors 미들웨어를 사용해서 더욱 간단하게 CORS 설정을 해줄 수 있다.

💬 Sprint Review

---

브라우저에는 서버에 요청을 보내기 위해 fetch 같은 HTTP 요청을 보내는 도구가 기본적으로 내장되어 있다.
서버는 클라이언트(브라우저)의 HTTP 요청에 맞게 응답을 보낼 수 있도록 코드를 작성해야 한다.

Node.js는 HTTP 요청을 보내거나, 응답을 받을 수 있는 도구들을 제공한다
HTTP 요청을 처리하고 응답을 보내 주는 프로그램을 웹 서버(Web Server)라고 부른다.

이번 과제에서는 Node.js의 http 모듈을 이용해 웹 서버를 만든다. - 참고자료 ✨
Node.js에서 파일을 읽거나 쓰기 위해 fs 모듈을 사용하듯이, HTTP 요청과 응답을 다루기 위해 HTTP 모듈을 사용한다.

서버 실행

클라이언트 실행

• client/index.html를 웹 브라우저에서 실행합니다.

• 특정 포트로 클라이언트를 실행하고 싶다면, serve를 이용할 수 있습니다.

  • npx serve -l 포트번호 client/

🔥 Bare minimum requirements

---

이번 과제에서 구현하는 웹 서버의 기능은 매우 단순하다.

클라이언트의 액션(버튼 클릭)에 따라 각기 다른 HTTP 요청을 서버로 보내고,
HTTP 요청에 담아 보낸 단어를 소문자 또는 대문자로 응답을 받아 화면에 보여 준다.

⚙️ Code

// 💬 주어진 코드

const http = require("http");
const PORT = 4999;
const ip = "localhost";

const server = http.createServer((request, response) => {
  console.log(
    `http request method is ${request.method}, url is ${request.url}`
  );
  response.writeHead(200, defaultCorsHeader);
  response.end("hello mini-server sprints");
});

server.listen(PORT, ip, () => {
  console.log(`http server listen on ${ip}:${PORT}`);
});

const defaultCorsHeader = {
  "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,
};

// ✅ 구현한 코드

const http = require("http");
const PORT = 4999;
const ip = "localhost";

const server = http.createServer((request, response) => {
  // GET / 요청 처리
  if (request.method === "GET" && request.url === "/") {
    response.writeHead(200, defaultCorsHeader); // 200 OK 응답 코드와 CORS 헤더를 반환
    response.end("hello mini-server sprints"); // "hello mini-server sprints"를 응답으로 보냄
  }

  // OPTIONS 메서드에 대한 처리
  else if (request.method === "OPTIONS") {
    response.writeHead(204, defaultCorsHeader); // 204 No Content 응답 코드와 CORS 헤더를 반환
    response.end();
    return;
  }

  // POST /lower 요청 처리
  else if (request.method === "POST" && request.url === "/lower") {
    let requestBody = "";

    request.on("data", (text) => {
      requestBody += text.toString();
    });

    request.on("end", () => {
      const convertedText = requestBody.toLowerCase(); // 받은 텍스트를 소문자로 변환
      response.writeHead(200, defaultCorsHeader); // 200 OK 응답 코드와 CORS 헤더를 반환
      response.end(convertedText); // 변환된 텍스트를 응답으로 보냄
    });
  }
  // POST /upper 요청 처리
  else if (request.method === "POST" && request.url === "/upper") {
    let requestBody = "";

    request.on("data", (text) => {
      requestBody += text.toString();
    });

    request.on("end", () => {
      const convertedText = requestBody.toUpperCase(); // 받은 텍스트를 대문자로 변환
      response.writeHead(200, defaultCorsHeader); // 200 OK 응답 코드와 CORS 헤더를 반환
      response.end(convertedText); // 변환된 텍스트를 응답으로 보냄
    });
  }
  // 그 외의 요청에 대한 처리 (404 Not Found)
  else {
    response.statusCode = 404; // 404 Not Found 응답 코드를 설정
    response.end(); // 응답 종료
  }
  // 조금 더 보편적인 에러 처리 방법
  // request.on("error", (err) => {
  //   console.error(err);
  //   response.statusCode = 400;
  //   response.end();
  // });
  // response.on("error", (err) => {
  //   console.error(err);
  // });

  console.log(
    `http request method is ${request.method}, url is ${request.url}`
  );
});

server.listen(PORT, ip, () => {
  console.log(`http server listen on ${ip}:${PORT}`);
});

// 응답 헤더
const defaultCorsHeader = {
  "Access-Control-Allow-Origin": "*", // 모든 출처에서의 요청을 허용
  "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS", // 원하는 HTTP 메서드를 명시
  "Access-Control-Allow-Headers": "Content-Type, Accept", // 허용하는 요청 헤더를 명시
  "Access-Control-Max-Age": 10, // Preflight 요청의 캐싱 시간을 설정
};

구현한 서버

구현한 클라이언트

작동 영상