HTTP 상태코드 및 일반 헤더

본 글은 인프런의 "모든 개발자를 위한 HTTP 웹 기본 지식" 강의를 듣고 정리한 일지입니다.

상태 코드

클라이언트가 보낸 요청의 처리 상태를 응답에서 알려주는 기능

1xx (Informational): 요청이 수신되어 처리중 (거의 사용하지 않음)
2xx (Successful): 요청 정상 처리
3xx (Redirection): 요청을 완료하려면 유저 에이전트의 추가 행동이 필요
4xx (Client Error): 클라이언트 오류, 잘못된 문법 등으로 서버가 요청을 수행할 수 없음
5xx (Server Error): 서버 오류, 서버가 정상 요청을 처리하지 못함

만약 모르는 상태 코드가 나타나면?

클라이언트가 인식할 수 없는 상태코드를 서버가 반환하면, 클라이언트는 상위 상태코드로 해석해서 처리한다. 예를 들어, 299라는 상태코드가 넘어왔는데 인식하지 못할 경우 클라이언트는 2xx (Successful)로 받아들인다.

2xx - 성공

200 OK
- 요청 성공
201 Created
- 요청이 성공해서 새로운 리소스가 생성됨(생성된 리소스는 응답의 Location 헤더 필드로 식별)
202 Accepted
- 요청이 접수되었으나 처리가 완료되지 않았음
- 배치 처리 같은 곳에서 사용(요청 접수 후 1시간 뒤에 배치 프로세스가 요청 처리) 
204 No Content
- 서버가 요청을 성공적으로 수행했지만, 응답 페이로드 본문에 보낼 데이터가 없음
예) 웹 문서 편집기에서 save 버튼
      - save 버튼의 결과로 아무 내용이 없어도 됨(204 메시지만으로 성공을 인식할 수 있기 때문)
      - save 버튼을 눌러도 같은 화면을 유지해야 함

3xx - 리다이렉션

웹 브라우저는 3xx 응답 결과에 Location 헤더가 있으면, Location 위치로 자동 이동(리다이렉트)
플로우: 없어진 경로로 들어오려고 하면, 새롭게 업데이트된 경로를 다시 응답으로 내보내고, 웹 브라우저에서 이 경로를 바탕으로 다시 요청을 보내게 됨

종류
1. 영구 리다이렉션 - 특정 리소스의 URI가 영구적으로 이동
ex) /members -> /users
2. 일시 리다이렉션 - 일시적인 변경
ex) 주문 완료 후 주문 내역 화면으로 이동
3. 특수 리다이렉션
- 결과 대신 캐시 사용

영구 리다이렉션

원래의 URL을 사용 X, 검색 엔진 등에서도 변경 유지
1. 301 Moved Permanently
- 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있음 -> 즉 작성 중인 정보가 있었다면 처음부터 다시 작성해야 함

2. 308 Permanent Redirect
- 301과 기능은 같음
- 리다이렉트시 요청 메서드와 본문 유지(처음 POST를 보내면 리다이렉트에서도 유지)
(참고) 실무에선 308보단 301이 훨씬 많이 쓰임

일시적 리다이렉션

일시적으로 변경되기 때문에 검색 엔진 등에서 URL을 변경하면 안됨
1. 302 Found
- 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있음

2. 307 Temporary Redirect
- 302와 기능은 같음
- 리다이렉트시 요청 메서드와 본문 유지(요청 메서드를 변경하면 안됨)

3. 303 See Other
- 302와 기능은 같음
- 리다이렉트시 요청 메서드가 GET으로 변경

PRG: Post / Redirect / Get

일시적인 리다이렉션 - 예시

POST로 주문 후에 웹 브라우저를 새로고침하면?

새로고침은 다시 요청하는 것이므로 중복 주문이 될 수 있다.

- POST로 주문 후에 새로고침으로 인한 중복 주문 방지
- POST로 주문 후에 주문 결과 화면을 GET 메서드로 리다이렉트
- 새로고침해도 결과 화면을 GET으로 조회
- 중복 주문 대신에 결과 화면만 GET으로 다시 요청
=> 새로고침 해도 GET으로 결과 화면만 조회

그래서 뭘 사용해야 하는가?

역사
- 처음 302 스펙의 의도는 HTTP 메서드를 유지하는 것
- 하지만 웹 브라우저들이 대부분 GET으로 바꾸어버림
- 모호한 302를 대신하는 명확한 307, 303이 등장

현실
- 307, 303을 권장하지만 현실적으로 이미 많은 애플리케이션 라이브러리들이 302를 기본값으로 사용
- 자동 리다이렉션 시 GET으로 변해도 되면 그냥 302를 사용해도 큰 문제 없음

기타 리다이렉션

304 Not Modified
- 캐시를 목적으로 사용
- 클라이언트에게 리소스가 수정되지 않았음을 알려주는 것으로, 클라이언트는 로컬PC에 저장된 캐시를 재사용(캐시로 리다이렉트)
- 304 응답은 메시지 바디를 포함하면 안됨(로컬 캐시를 사용해야 하기 때문)
- 조건부 GET, HEAD 요청시 사용

4xx - 클라이언트 오류

- 클라이언트의 요청에 잘못된 문법 등으로 서버가 요청을 수행할 수 없음
- 오류의 원인이 클라이언트에 있음
- 클라이언트가 이미 잘못된 요청, 데이터를 보내고 있기 때문에 똑같은 재시도가 실패(복구 불가)

400 Bad Request
- 요청 구문, 메시지 등등 오류
- 클라이언트는 요청 내용을 다시 검토하고 보내야 함
ex) 요청 파라미터가 잘못되거나, API 스펙이 맞지 않을 때

401 Unauthorized
클라이언트가 해당 리소스에 대한 인증이 필요함
- 인증(Authentication)되지 않음
- 401 오류 발생시 응답에 WWW-Authenticate 헤더와 함께 인증 방법을 설명
(참고)
- 인증(Authentication): 본인이 누구인지 확인(로그인)
- 인가(Authorization): 권한부여(ADMIN 권한처럼 특정 리소스에 접근할 수 있는 권한, 인증이 있어야 인가가 있음)
- 오류 메시지가 Unauthorized이지만 인증되지 않았다는 것임...

403 Forbidden
서버가 요청을 이해했지만 승인을 거부함
- 주로 인증 자격 증명은 있지만, 접근 권한이 불충분한 경우
- 어드민 등급이 아닌 사용자가 로그인은 했지만, 어드민 등급의 리소스에 접근하는 경우

404 Not Found
요청 리소스를 찾을 수 없음
- 요청 리소스가 서버에 없음
- 또는 클라이언트가 권한이 부족한 리소스에 접근할 때 해당 리소스를 숨기고 싶을 때

5xx - 서버 오류

- 서버 문제로 오류 발생(DB 다운 등)
- 서버에 문제가 있기 때문에 재시도하면 성공할 수도 있음(복구 가능)

500 Internal Server Error
- 서버 문제로 오류 발생
- 애매하면 500 오류

503 Service Unavailable 
서비스 이용 불가
- 서버가 일시적인 과부하 또는 예정된 작업으로 잠시 요청을 처리할 수 없음
- Retry-After 헤더 필드로 얼마 뒤에 복구되는지 보낼 수도 있음

---

HTTP 헤더

- HTTP 전송에 필요한 모든 부가정보
예) 메시지 바디의 내용, 메시지 바디 크기, 압축, 인증, 요청 클라이언트, 서버 정보, 캐시 관리 정보
- 표준 헤더가 너무 많음
- 필요시 임의의 헤더 추가 가능

RFC2616(과거)
헤더 분류
1. General 헤더: 메시지 전체에 적용되는 정보, ex) Connection: close
2. Request 헤더: 요청 정보, ex) User-Agent: Mozailla/5.0 (Macintosh; ..)
3. Response 헤더: 응답 정보, ex) Server: Apache
4. Entity 헤더: 엔터티 바디 정보, ex) Content-Type: text/html, Content-Length: 3423

메시지 바디
- 메시지 본문은 엔티티 본문을 전달하는 데 사용
- 엔티티 본문은 요청이나 응답에서 전달할 실제 데이터
- 엔티티 헤더는 엔티티 본문의 데이터를 해석할 수 있는 정보 제공
ex) 데이터 유형(html, json), 데이터 길이, 압축 정보 등

RFC723x 변화
- 엔티티 -> 표현(Representation)
- Representation = Representation Metadata + Representation Data
- 표현 = 표현 메타데이터 + 표현 데이터

메시지 바디(RFC7230 최신)
- 메시지 본문을 통해 표현 데이터 전달
- 메시지 본문 = 페이로드(payload)
- 표현은 요청이나 응답에서 전달할 실제 데이터
- 표현 헤더는 표현 데이터를 해석할 수 있는 정보 제공
ex) 데이터 유형(html, json), 데이터 길이, 압축 정보 등
(참고) 표현 헤더는 표현 메타데이터와 페이로드 메시지를 구분해야 하지만, 너무 복잡해져서 하지 않는다.

표현

리소스를 html로 표현해서 클라이언트와 서버 간 주고 받을 것인지, json으로 표현해서 할 것인지

Content-Type: 표현 데이터의 형식
Content-Encoding: 표현 데이터의 압축 방식
Content-Language: 표현 데이터의 자연 언어
Content-Length: 표현 데이터의 길이

표현 헤더는 전송, 응답 둘 다 사용한다.

Content-Type: 표현 데이터의 형식 설명

미디어 타입, 문자 인코딩
예) 1. text/html; charset=utf-8
      2. application/json
      3. image/png

Content-Encoding: 표현 데이터 인코딩

- 표현 데이터를 압축하기 위해 사용
- 데이터를 전달하는 곳에서 압축 후 인코딩 헤더 추가
- 데이터를 읽는 쪽에서 인코딩 헤더의 정보로 압축 해제
예) 1. gzip
      2. deflate
      3. identity(압축하지 않는다는 의미)

Content-Language: 표현 데이터의 자연 언어

표현 데이터의 자연 언어를 표현
예) 1. ko
      2. en
      3. en-US

Content-Length: 표현 데이터의 길이

- 바이트 단위
- Transfer-Encoding(전송 코딩)을 사용하면 Content-Length를 사용하면 안됨

협상(콘텐츠 네고시에이션)

클라이언트가 선호하는 표현 요청으로 요청시에만 사용한다.

1. Accept: 클라이언트가 선호하는 미디어 타입 전달
2. Accept-Charset: 클라이언트가 선호하는 문자 인코딩
3. Accept-Encoding: 클라이언트가 선호하는 압축 인코딩
4. Accept-Language: 클라이언트가 선호하는 자연 언어

협상과 우선순위1

Quality Values(q)

- 0~1, 클수록 높은 우선순위를 갖고 생략하면 1을 가리키게 된다.
- Accept-Language: ko-KR, ko;q=0.9, en-US;q=0.8, en;q=0.7
1. ko-KR;q=1(q 생략)
2. ko;q=0.9
3. en-US;q=0.8
4. en;q=0.7

협상과 우선순위2

- 구체적인 것이 우선한다.
- Accept: text/*, text/plain, text/plain;format=flowed, */*
1. text/plain;format=flowed
2. text/plain
3. text/*
4. */*

협상과 우선순위3

- 구체적인 것을 기준으로 미디어 타입을 맞춘다.
- Accept: text/*;q=0.3, text/html;q=0.7, text/html;level=1, text/html;level=2;q=0.4, */*;q=0.5

전송 방식

1. 단순 전송 -> Content-Length: 3423
2. 압축 전송 -> Content-Encoding: gzip
3. 분할 전송 -> Transfer-Encoding: chunked
ex) Hello(5 bytes), World(5 bytes), \r\n(0 byte)
4. 범위 전송 -> Range: bytes=1001-2000(클라이언트) <-> Content-Range: bytes 1001-2000 / 2000(서버)

일반 정보

From: 유저 에이전트의 이메일 정보

- 일반적으로 잘 사용되지 않음
- 검색 엔진 같은 곳에서 주로 사용
- 요청에서 사용

Referer: 이전 웹 페이지 주소

- 현재 요청된 페이지의 이전 웹 페이지 주소
- A -> B로 이동하는 경우 B를 요청할 때 Referer: A를 포함해서 요청
- Referer를 사용해서 유입 경로 분석 가능
- 요청에서 사용
(참고) 
referer는 단어 referrer의 오타

User-Agent: 유저 에이전트 애플리케이션 정보

- user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36
- 클라이언트 애플리케이션 정보(웹 브라우저 정보 등)
- 통계 정보
- 어떤 종류의 브라우저에서 장애가 발생하는지 파악 가능
- 요청에서 사용

Server: 요청을 처리하는 ORIGIN 서버의 소프트웨어 정보

- 실질적 정보를 가지고 있는 ORIGIN 서버와 통신하기 위해선 중간에 여러 서버를 거치게 됨
- Server: Apache/2.2.22(Debian)
- server: nginx
- 응답에서 사용

Date: 메시지가 발생한 날짜와 시간

- Date: Tue, 15 Nov 1994 08:12:31 GMT
- 응답에서 사용

특별한 정보

Host: 요청한 호스트 정보(도메인)

- 요청에서 사용
- 필수
- 하나의 서버가 여러 도메인을 처리해야 할 때
- 하나의 IP 주소에 여러 도메인이 적용되어 있을 때

따라서 아래와 같이 Host 정보를 필수로 넣어줘야 한다.

GET /hello HTTP/1.1
Host: aaa.com

Location: 페이지 리다이렉션

- 웹 브라우저는 3xx 응답의 결과에 Location 헤더가 있으면, Location 위치로 자동 이동(리다이렉트)
- 201 (Created): Location 값은 요청에 의해 생성된 리소스 URI
- 3xx (Redirection): Location 값은 요청을 자동으로 리디렉션하기 위한 대상 리소스를 가리킴

Allow: 허용 가능한 HTTP 메서드

- 405 (Method Not Allowed) 에서 응답에 포함해야 함
- Allow: GET, HEAD, PUT
(참고)
- 거의 구현되어 있지 않음

Retry-After: 유저 에이전트가 다음 요청을 하기까지 기다려야 하는 시간

- 503 (Service Unavailable): 서비스가 언제까지 불능인지 알려줄 수 있음
- Retry-After: Fri, 31 Dec 1999 23:59:59 GMT(날짜 표기)
- Retry-After: 120(초단위 표기)
(참고)
- 거의 구현하지 않음

인증

Authorization: 클라이언트 인증 정보를 서버에 전달

- Authorization: Basic xxxxxxxx
- allauth, oauth 등 다양한 메커니즘 존재

WWW-Authenticate: 리소스 접근 시 필요한 인증 방법 정의

- 401 Unauthorized 응답과 함께 사용
- WWW-Authenticate: Newauth realm="apps", type=1, title="Login to \"apps\"", Basic realm="simple"

쿠키

1. Set-Cookie: 서버에서 클라이언트로 쿠키 전달(응답)
2. Cookie: 클라이언트가 서버에서 받은 쿠키를 저장하고, HTTP 요청 시 서버로 전달

Stateless
- HTTP는 무상태 프로토콜
- 클라이언트와 서버가 요청과 응답을 주고 받으면 연결이 끊어진다.
- 클라이언트가 다시 요청하면 서버는 이전 요청을 기억하지 못한다.
- 클라이언트와 서버는 서로 상태를 유지하지 않는다.

쿠키를 미사용하는 경우
대안: 모든 요청과 링크에 사용자 정보를 포함한다? -> 보안 위험 요소 존재 / 개발의 불편함

예) set-cookie: sessionId=abcde1234; expires=Sat, 26-Dec-2020 00:00:00 GMT; path=/; domain=.google.com; Secure
-> 세션 아이디로 홍길동 판별

1. 사용처
- 사용자 로그인 세션 관리
- 광고 정보 트래킹

2. 쿠키 정보는 항상 서버에 전송
- 네트워크 트래픽 추가 유발
- 최소한의 정보만 사용(세션 Id, 인증 토큰)
- 서버에 전송하지 않고, 웹 브라우저 내부에 데이터를 저장하고 싶다면 웹 스토리지(localStorage, sessionStorage) 참고
(주의)
- 보안에 민감한 데이터는 저장하면 안됨(주민번호, 신용카드 번호 등)

쿠키 - 생명 주기

- 만료일이 되면 쿠키 삭제
ex) Set-Cookie: expires=Sat, 26-Dec-2020 04:39:21 GMT
- 0이나 음수를 지정하면 쿠키 삭제
ex) Set-Cookie: max-age=3600(3600초)
- 세션 쿠키: 만료 날짜를 생략하면 브라우저 종료 시까지만 유지
- 영속 쿠키: 만료 날짜를 입력하면 해당 날짜까지 유지

쿠키 - 도메인

예) domain=exmaple.org
1. 명시: 명시한 문서 기준 도메인 + 서브 도메인 포함
- domain=example.org를 지정해서 쿠키 생성
- example.org는 물론이고 하위 도메인인 dev.example.org도 쿠키 접근
2. 생략: 현재 문서 기준 도메인만 적용
- example.org에서 쿠키를 생성하고 domain 지정을 생략
- example.org에서만 쿠키가 접근하고, dev.example.org는 쿠키가 미접근

쿠키 - 경로

예) path=/home
- 이 경로를 포함한 하위 경로 페이지만 쿠키 접근
- 일반적으로 path=/ 루트로 지정
예를 들어, path=/home 으로 지정할 경우
1. /home : 가능
2. /home/level1 : 가능
3. /home/level1/level2 : 불가능
4. /hello : 불가능

쿠키 - 보안

1. Secure
- 쿠키는 http, https를 구분하지 않고 전송
- Secure를 적용하면 https인 경우에만 전송

2. HttpOnly
- XSS 공격 방지
- 자바스크립트에서 접근 불가
- HTTP 전송에만 사용

3. SameSite
- XSRF 공격 방지
- 요청 도메인과 쿠키에 설정된 도메인이 같은 경우만 쿠키 전송