Devin.KR

AI 개발 · 실무

웹 서비스 해부도 - 서버·백엔드·프런트엔드·보안 구성요소 실무

보안 구성요소 - 헤더·입력 검증·비밀값 관리

보안 헤더(CSP·HSTS·X-Content-Type-Options·frame-ancestors), 입력 검증과 출력 이스케이프 위치, 비밀값 보관과 교체, 의존성 점검, 로그에 개인정보 남기지 않기, 완성 코드는 응답 헤더·설정 묶음을 검사해 빠진 방어를 점수로 출력(공격 절차는 쓰지 않는다)

개발자KR · 원고 갱신

이 장에서 배우는 것

앞 장에서 서점은 로그인한 손님과 주문을 열람할 수 있는 손님을 구분했다. 이번에는 검색어를 받는 순간부터 검색 결과를 돌려주고 운영 기록을 남기는 순간까지 살펴본다. 같은 검색 요청을 처리하더라도 브라우저에 보내는 정책, 서버가 받아들이는 데이터, 기록에 남기는 데이터는 각각 다른 기준으로 결정된다.

  • 응답 헤더 네 항목이 브라우저의 어떤 동작을 제한하는지 설명한다.
  • 검색어를 검사하는 위치와 HTML에 맞게 이스케이프하는 위치를 구분한다.
  • 비밀값의 보관과 교체 절차, 의존성 점검 기록, 개인정보를 줄인 로그를 확인한다.
  • 서점의 응답과 설정을 검사하는 프로그램을 실행하고 항목별 점수의 근거를 읽는다.

문제 상황

서점의 검색 화면에 새 디자인을 배포한 날, 검색 결과는 평소처럼 표시됐다. 그런데 앞단 설정을 바꾸면서 보안 헤더가 검색 성공 응답에만 붙게 됐다. 검색어가 너무 길어서 돌아온 오류 응답에는 같은 정책이 없었다. 브라우저에서 정상 화면만 열어 본 배포 점검으로는 이 차이를 발견할 수 없었다.

검색 기능을 살펴보니 또 다른 문제도 있었다. 한글과 문장부호가 섞인 검색어를 받기 위해 입력 제한을 느슨하게 두었고, 화면 제목에 검색어를 그대로 붙였다. 검색어에는 책 제목 외에 고객이 실수로 붙여 넣은 이메일 주소나 주문번호가 들어올 수 있었다. 오류 원인을 찾으려고 요청 사전을 통째로 기록하자 검색어와 연락처가 운영 로그에도 남았다. 한편 운영용 키를 어떤 경로에서 읽어 오는지, 다음 교체 때 누가 기존 키를 폐기하는지는 배포 담당자만 알고 있었다.

이런 설정은 화면이 잘 뜨는지만 확인해서는 검토하기 어렵다. 검색어를 처리하는 함수에는 경계값을 넣어 보고, 응답에는 공통 정책이 붙었는지 검사하며, 운영 설정에는 점검 증거가 있는지 확인해야 한다. 이 장에서는 두 구성을 같은 검사에 넣는다. 개선 전 구성은 빠진 항목을 보여 주고, 개선 후 구성은 이 서점이 정한 기준을 충족하는 모습을 보여 준다.

브라우저가 받는 보안 정책

콘텐츠 보안 정책(Content Security Policy, CSP)은 브라우저가 문서에서 어떤 출처의 스크립트나 스타일을 불러올 수 있는지 정한다. 작은 서점은 스크립트와 스타일을 자기 출처에서만 제공한다. 그래서 예제 정책은 default-src 'self'를 기본으로 두고 script-src 'self'를 명시한다. object-src 'none'으로 객체 삽입을 막고, base-uri 'none'으로 문서 안에서 기준 URL을 바꾸는 기능을 사용하지 않도록 한다. 화면에 스크립트가 추가되면 실제 자산이 이 정책 아래에서 정상적으로 불러와지는지도 확인한다.

같은 헤더에 들어가는 frame-ancestors 'none'은 서점 문서를 다른 문서의 프레임 안에 넣지 못하게 한다. 스크립트의 출처와 서점 화면을 감쌀 수 있는 문서의 출처는 서로 다른 질문이다. 기본 출처를 정하는 default-src를 적어도 frame-ancestors까지 설정되지는 않는다. 완성 코드는 그래서 두 항목을 따로 채점한다. 프레임 제한은 HTTP 응답 헤더에 직접 둔다.

HTTP 엄격한 전송 보안(HTTP Strict Transport Security, HSTS)은 브라우저가 해당 호스트에 이후 접속할 때 HTTPS를 사용하도록 한다. 브라우저는 유효한 HTTPS 응답에서 받은 Strict-Transport-Security 헤더를 처리한다. max-age는 정책을 기억하는 시간을 초 단위로 지정한다. 예제의 31536000은 이 서점이 검사에 사용하는 고정 설정값이다. 처음 방문한 브라우저에 저장된 정책이 없다면 헤더를 받기 전의 접속에는 그 정책이 적용되지 않는다. 하위 도메인까지 적용하는 옵션은 해당 호스트들의 HTTPS 운영 상태를 확인한 뒤 결정한다.

X-Content-Type-Options: nosniff는 브라우저가 스크립트와 스타일을 불러올 때 선언된 미디어 유형을 기준으로 검사하도록 한다. 그래서 헤더를 켜는 작업과 파일의 Content-Type을 정확히 보내는 작업을 함께 확인해야 한다. 예를 들어 검색 페이지에는 text/html; charset=utf-8을 붙인다. 별도로 제공하는 스타일에는 해당 자산에 맞는 유형을 붙인다.

서점의 응답 헤더에서 확인하는 브라우저 동작
항목결정하는 것확인할 응답
Content-Security-Policy의 자원 지시어스크립트 등 문서 자원의 출처를 제한한다.검색 성공 화면과 HTML 오류 화면에서 정책 값과 자산 동작을 확인한다.
frame-ancestors서점 문서를 프레임에 담을 수 있는 출처를 제한한다.프레임 삽입을 허용할 요구가 없다면 문서 응답에서 'none'을 확인한다.
Strict-Transport-Security브라우저가 HTTPS 사용을 기억하게 한다.사용자가 실제로 받는 HTTPS 응답에서 설정값을 확인한다.
X-Content-Type-Options스크립트와 스타일의 미디어 유형 검사를 적용한다.nosniff와 각 응답의 미디어 유형을 함께 확인한다.

응답을 만드는 함수가 공통 헤더를 붙이더라도, 운영에서는 앞단이 직접 만드는 오류 페이지나 리디렉션이 따로 있을 수 있다. 애플리케이션 안에서는 각 반환 경로의 헤더를 비교하고, 배포 환경에서는 브라우저에 도착한 최종 응답을 확인한다. 이 장의 프로그램은 첫 번째 작업을 재현한다.

입력을 받는 경계와 출력을 만드는 경계

입력 검증은 검색 기능이 받아들이는 값의 형태를 정한다. 이 서점에서는 문자열만 받고, 제어 문자를 거부한 다음, 앞뒤 공백을 제거한 결과가 1자 이상 60자 이하여야 한다. 공백이 끼어 있는 책 제목과 문장부호는 허용한다. 유효하지 않은 요청은 검색을 수행하기 전에 오류로 돌려준다. 제어 문자를 공백 제거 전에 검사하는 이유는 줄바꿈이나 탭이 앞뒤에 붙었을 때 조용히 사라지는 경우까지 거부하기 위해서다.

출력 이스케이프(escaping)는 값이 들어갈 문맥에서 값의 의미를 보존한다. 검색어 A & B <개정판>을 HTML 제목에 넣을 때에는 앰퍼샌드와 꺾쇠를 문자 참조로 바꾼다. 브라우저 화면에는 원래 검색어가 표시된다. Python의 html.escape는 이 예제의 HTML 텍스트에 쓴다. 검색이나 비교에 쓰는 값은 원래 문자열 형태로 유지해서, 화면에 내보낼 때에만 한 번 변환한다.

검증을 통과한 값도 출력 문맥에 따라 처리해야 한다. 예를 들어 같은 검색어를 주소의 쿼리 매개변수에 넣는다면 먼저 URL의 매개변수 값으로 인코딩한다. 그 주소를 HTML 속성에 넣는다면 다시 HTML 속성 문맥에 맞게 처리한다. HTML의 제목에 들어가는 값과 주소에 들어가는 값에 같은 문자열 연결 방법을 복사하면 이 경계가 흐려진다. 완성 코드는 제목 한 곳만 다루고, 그 제목에 기대한 문자 참조가 들어갔는지 비교한다.

검색어는 요청 경계에서 검증하고 HTML을 만드는 경계에서 이스케이프한다.

유효하지 않은 검색어를 받았을 때에는 사용자에게 수정 기준을 알려 준다. 예제는 입력 원문 대신 정해진 안내 문구만 돌려준다. 이때 성공 응답과 오류 응답이 같은 응답 생성 함수를 사용하면 상태가 달라져도 공통 헤더를 적용할 수 있다.

설정과 운영 기록에서 확인할 것

비밀값은 읽는 경로와 교체 결과를 확인한다

운영용 키는 소스, 샘플 설정, 테스트 데이터, 배포 이미지에 값으로 넣지 않는다. 실행 환경에서는 접근 권한을 제한한 비밀 저장소나 마운트 파일을 통해 주입할 수 있다. 환경 변수로 주입할 때에도 설정 전체를 덤프하는 진단 기능과 자식 프로세스에 전달되는 환경을 살핀다. 비밀값을 읽을 수 있는 실행 주체와 교체할 수 있는 운영 주체를 정해 두면 접근 범위를 검토할 수 있다.

교체는 새 키를 준비하는 일부터 이전 키의 사용을 끝내는 일까지 포함한다. 예를 들어 서점이 사용하는 외부 연동에서 제한된 중첩 기간을 지원한다면 새 키를 등록하고, 서점에 적용하고, 연동이 정상인지 확인한 뒤 이전 키를 폐기한다. 중첩이 불가능한 연동은 전환 순서와 실패 시 대응을 별도로 정한다. 값 자체를 기록하지 않고 키 버전, 반영 확인, 폐기 확인을 남긴다. 이 예제의 설정 사전에는 값 없이 참조 경로와 모의 교체 확인 기록만 들어간다.

키 교체는 새 키로 정상 동작을 확인하고 이전 키의 폐기까지 기록해야 끝난다.

의존성 목록과 검토 기록을 대조한다

점검의 출발점은 운영 환경에 들어가는 구성의 목록이다. 외부 패키지가 있다면 직접 설치한 것과 그 패키지가 끌어오는 간접 패키지의 이름과 버전을 확인한다. 실행 환경의 Python과 함께 제공되는 구성요소도 유지보수 대상이다. 검토할 때에는 목록을 해당 버전의 보안 공지와 대조하고, 수정 버전이 있다면 업데이트 후 검색 성공과 오류 응답을 다시 검사한다. 당장 업데이트할 수 없는 항목은 담당자와 재검토 조건을 기록한다.

이 실습은 외부 패키지를 설치하지 않고 보안 공지를 조회하지 않는다. 프로그램에는 예시 환경의 구성 식별자와 그 구성에 대응하는 모의 검토 기록이 있다. 목록을 바꾸고 기록을 그대로 두면 점수가 내려간다. 실제 운영에서 검토 기록은 결과를 가리키는 표식으로 쓰고, 배포된 버전의 목록과 실제 검토 결과를 함께 확인한다.

로그에는 운영에 필요한 항목을 골라 넣는다

검색 실패를 조사할 때에는 어떤 경로에서 어떤 결과가 나왔는지, 어느 요청에 해당하는지부터 알면 된다. 예제는 이벤트명, 고정된 경로, 상태 코드, 요청 식별자만 기록한다. 검색어, 연락처, 전체 주소, 요청 본문은 기록 항목에 넣지 않는다. 실제 요청 식별자는 서버가 정한 형식으로 생성하고 개인정보를 포함하지 않도록 한다. 오류 처리기와 앞단의 접근 로그에도 같은 원칙을 적용한다. 애플리케이션 로그만 바꾸면 앞단이 쿼리 문자열을 계속 남길 수 있기 때문이다.

AI에게 맡긴 변경을 확인한다

아래 요청문은 2026년 10월 기준 예시다. 저장소를 검토할 수 있는 AI에게는 실제 키나 운영 로그 대신 필요한 코드와 가상 입력을 준다. 요청에는 코드가 보여 줘야 할 동작과 사람이 확인할 증거를 같이 적는다.

표준 라이브러리만 사용하는 서점 검색 코드에서 성공 응답과 입력 오류 응답의 헤더를 비교하라. 검색어 검증은 요청 경계에 두고 HTML 제목의 이스케이프는 출력을 만드는 함수에 두어라. 운영용 비밀값과 실제 고객 데이터 없이 모의 설정과 테스트 입력을 사용하라. 실행 결과와 변경 차이(diff), 사람이 따로 확인해야 할 배포 항목을 제시하라.

AI가 보안 코드를 바꾼 뒤 사람이 확인할 증거
맡긴 작업실행해서 확인할 것변경 차이에서 볼 것
응답 헤더 공통화정상 검색과 입력 오류에서 정책 값이 같은지 확인한다.예외를 처리하는 반환 경로에서도 공통 응답 함수를 거치는지 본다.
검증과 이스케이프빈 값, 60자, 61자, 제어 문자, 문장부호가 섞인 제목을 넣는다.검색에 쓰는 값이 유지되고 HTML을 만드는 줄에서 한 번만 변환되는지 본다.
비밀값과 의존성 설정참조를 지우거나 구성 목록을 바꿨을 때 해당 항목이 실패하는지 본다.값 대신 참조가 들어갔는지, 교체와 검토 기록이 실제 운영 증거를 가리키는지 본다.
로그 항목 제한가상 연락처를 넣어도 성공과 오류의 로그 항목 및 값이 기대와 같은지 본다.요청 전체를 기록하는 호출과 예외 메시지에 원문을 덧붙이는 코드가 있는지 본다.

완성 코드

다음 코드를 main.py에 저장한다. 두 구성은 같은 요청 처리 함수를 사용한다. 성공과 오류의 응답 헤더를 모으고, 입력 경계와 HTML 출력 및 로그를 직접 검사한다. 비밀값과 의존성 체크는 예제 설정에 남긴 증거를 비교한다. 항목 하나를 통과할 때마다 1점을 더하며, 결과는 전체 9개 기준 가운데 몇 개를 충족했는지 보여 준다.

main.py

from dataclasses import dataclass
from html import escape
from typing import Callable
from unicodedata import category


CSP_RESOURCES = {
    "default-src": "'self'",
    "script-src": "'self'",
    "object-src": "'none'",
    "base-uri": "'none'",
}
CSP_POLICY = "; ".join(
    f"{name} {value}" for name, value in CSP_RESOURCES.items()
) + "; frame-ancestors 'none'"

SECURE_HEADERS = {
    "Content-Security-Policy": CSP_POLICY,
    "Strict-Transport-Security": "max-age=31536000",
    "X-Content-Type-Options": "nosniff",
}
LOG_FIELDS = ("event", "path", "status", "request_id")
SAMPLE_TITLE = "A & B <개정판>"
RUNTIME_COMPONENTS = ("python-3.12-demo",)


@dataclass
class Configuration:
    headers: dict[str, str]
    validate_query: Callable[[object], str]
    render_title: Callable[[str], str]
    log_fields: tuple[str, ...]
    secret_ref: str
    rotation_verified: bool
    components: tuple[str, ...]
    reviewed_components: tuple[str, ...]


@dataclass
class Response:
    status: int
    headers: dict[str, str]
    body: str
    log: dict[str, str | int]


def loose_query(value: object) -> str:
    return str(value)


def validate_query(value: object) -> str:
    if not isinstance(value, str):
        raise ValueError("검색어는 문자열이어야 한다")
    if any(category(char) == "Cc" for char in value):
        raise ValueError("검색어에 제어 문자를 넣을 수 없다")
    query = value.strip()
    if not 1 <= len(query) <= 60:
        raise ValueError("검색어는 1자 이상 60자 이하여야 한다")
    return query


def raw_title(query: str) -> str:
    return f"<h1>검색 결과 {query}</h1>"


def escaped_title(query: str) -> str:
    return f"<h1>검색 결과 {escape(query)}</h1>"


def handle_search(config: Configuration, raw_query: object) -> Response:
    try:
        query = config.validate_query(raw_query)
    except ValueError:
        status = 400
        body = "<h1>검색어를 확인해 주세요</h1>"
    else:
        status = 200
        body = config.render_title(query)

    headers = {
        "Content-Type": "text/html; charset=utf-8",
        **config.headers,
    }
    event = {
        "event": "book_search",
        "path": "/search",
        "status": status,
        "request_id": "req-demo-01",
        "query": str(raw_query),
    }
    log = {field: event[field] for field in config.log_fields}
    return Response(status, headers, body, log)


def read_csp(headers: dict[str, str]) -> dict[str, str]:
    directives = {}
    for part in headers.get("content-security-policy", "").split(";"):
        tokens = part.split()
        if tokens:
            name, *values = tokens
            directives.setdefault(name.lower(), " ".join(values))
    return directives


def expected_log(status: int) -> dict[str, str | int]:
    return {
        "event": "book_search",
        "path": "/search",
        "status": status,
        "request_id": "req-demo-01",
    }


def inspect(config: Configuration) -> list[tuple[str, bool]]:
    title = handle_search(config, SAMPLE_TITLE)
    contact = handle_search(config, "reader@example.test")
    blank = handle_search(config, " ")
    longest = handle_search(config, "책" * 60)
    too_long = handle_search(config, "책" * 61)
    control = handle_search(config, "책\n")
    non_text = handle_search(config, 42)
    responses = (title, contact, blank, longest, too_long, control, non_text)
    headers = [
        {name.lower(): value for name, value in response.headers.items()}
        for response in responses
    ]
    policies = [read_csp(header) for header in headers]
    return [
        ("CSP 자원 제한", all(
            all(policy.get(name) == value for name, value in CSP_RESOURCES.items())
            for policy in policies
        )),
        ("프레임 제한", all(
            policy.get("frame-ancestors") == "'none'" for policy in policies
        )),
        ("HSTS", all(
            header.get("strict-transport-security") == "max-age=31536000"
            for header in headers
        )),
        ("미디어 유형 검사", all(
            header.get("x-content-type-options") == "nosniff"
            and header.get("content-type") == "text/html; charset=utf-8"
            for header in headers
        )),
        ("입력 검증", (
            title.status == longest.status == 200
            and blank.status == too_long.status == control.status == non_text.status == 400
        )),
        ("HTML 출력 이스케이프", (
            title.status == 200
            and title.body == "<h1>검색 결과 A &amp; B &lt;개정판&gt;</h1>"
        )),
        ("비밀값 참조와 교체 기록", (
            config.secret_ref == "secret-ref:bookshop/search-service"
            and config.rotation_verified
        )),
        ("의존성 검토 기록", (
            bool(config.components)
            and config.components == config.reviewed_components
        )),
        ("로그 개인정보 최소화", all(
            response.log == expected_log(response.status)
            for response in responses
        )),
    ]


def show_report(label: str, checks: list[tuple[str, bool]]) -> None:
    score = sum(passed for _, passed in checks)
    print(f"[{label}] {score}/{len(checks)}점")
    for name, passed in checks:
        result = "통과" if passed else "미충족"
        print(f"  {name}: {result}")


def main() -> None:
    before = Configuration(
        headers={},
        validate_query=loose_query,
        render_title=raw_title,
        log_fields=(*LOG_FIELDS, "query"),
        secret_ref="",
        rotation_verified=False,
        components=RUNTIME_COMPONENTS,
        reviewed_components=(),
    )
    after = Configuration(
        headers=SECURE_HEADERS,
        validate_query=validate_query,
        render_title=escaped_title,
        log_fields=LOG_FIELDS,
        secret_ref="secret-ref:bookshop/search-service",
        rotation_verified=True,
        components=RUNTIME_COMPONENTS,
        reviewed_components=RUNTIME_COMPONENTS,
    )

    show_report("개선 전", inspect(before))
    print()
    show_report("개선 후", inspect(after))


if __name__ == "__main__":
    main()

줄별 해설

  1. from dataclasses import dataclass로 설정과 응답에 어떤 필드가 들어가는지 선언한다. Callable[[object], str]은 한 값을 받아 문자열을 돌려주는 함수가 설정에 들어간다는 뜻이다. 덕분에 같은 경로를 두고 검증과 렌더링 함수만 바꿔 실행할 수 있다.

  2. CSP_RESOURCES에 자원 관련 지시어를 모으고 CSP_POLICY를 만드는 줄에서 세미콜론으로 이어 붙인다. 프레임 제한은 마지막에 추가한다. 뒤에서 검사하는 출처 제한과 프레임 제한의 범위가 이 구성에도 드러난다.

  3. loose_query는 받은 값을 문자열로 바꾼다. 이 처리만 있으면 정수도 검색 요청으로 들어가고 공백만 있는 검색어도 적용된다. validate_query는 자료형, 제어 문자, 공백 제거 후 길이를 순서대로 본다. 각 조건이 실패할 때 같은 예외 종류를 사용하므로 요청 처리 함수에서 한 자리에서 처리할 수 있다.

  4. raw_title은 문자열을 바로 제목에 끼워 넣고 escaped_title은 끼워 넣기 직전에 escape를 호출한다. 검사에 쓰는 제목에는 앰퍼샌드와 꺾쇠가 모두 들어 있어, 어느 하나를 빠뜨리거나 두 번 변환하면 기대한 HTML과 달라진다.

  5. handle_search의 try에서는 입력 검증을 호출한다. except에서는 상태 코드 400과 고정된 안내 문구를 정하고, else에서는 상태 코드 200과 제목을 정한다. 두 경로가 합쳐진 다음에 헤더와 로그를 만든다. 검색 결과의 본문을 고른 뒤 공통 응답 정책을 적용하는 위치다.

  6. event는 비교 실습에 쓰는 후보 항목이다. 이 사전에는 원문이 들어 있지만 응답이나 터미널에 이 사전을 통째로 쓰지 않는다. 실제 로그로 검사하는 것은 다음 줄에서 config.log_fields에 있는 키를 골라 만든 log다. 운영 코드에서는 후보 사전에도 수집할 필요가 없는 원문이 들어가지 않도록 만드는 편이 단순하다.

  7. read_csp는 정책을 세미콜론으로 나누고 지시어 이름과 값을 읽는다. 중복된 이름은 setdefault로 첫 값을 유지한다. inspect는 헤더 이름을 소문자로 통일한 뒤 이 서점의 고정된 정책 값과 비교한다. 다양한 정책의 브라우저 동작을 판정하는 범용 파서는 다루지 않는다.

  8. inspect의 처음 일곱 호출은 모두 같은 검색 경로를 지난다. 검증 점수는 성공과 거부의 경계에 달려 있고, 헤더 점수는 모은 응답 전체에 달려 있다. 로그 점수는 키뿐 아니라 값까지 비교한다. 예를 들어 검색어를 request_id에 잘못 넣어도 이 비교는 실패한다.

  9. secret_ref는 예상한 참조 문자열인지 검사하고 rotation_verified는 모의 교체 결과를 읽는다. components가 비어 있거나 검토 목록과 다르면 의존성 점수가 내려간다. 두 점수는 샘플의 설정 자료를 근거로 계산하며 저장소나 운영 환경에 접근하지 않는다.

  10. show_report는 참과 거짓을 각각 1과 0으로 더하고 검사 순서대로 결과를 표시한다. main은 개선 전과 개선 후를 비교한다. 요청 식별자, 제목, 구성 목록이 고정되어 있어 실행할 때마다 같은 결과를 얻는다.

실행 결과

파일을 저장한 디렉터리에서 먼저 경고를 오류로 취급해 컴파일한 다음 실행한다. 첫 명령은 성공하면 출력이 없다. 두 번째 명령은 비교 결과를 출력하고 종료한다.

python3 -W error -m py_compile main.py
python3 main.py
[개선 전] 0/9점
  CSP 자원 제한: 미충족
  프레임 제한: 미충족
  HSTS: 미충족
  미디어 유형 검사: 미충족
  입력 검증: 미충족
  HTML 출력 이스케이프: 미충족
  비밀값 참조와 교체 기록: 미충족
  의존성 검토 기록: 미충족
  로그 개인정보 최소화: 미충족

[개선 후] 9/9점
  CSP 자원 제한: 통과
  프레임 제한: 통과
  HSTS: 통과
  미디어 유형 검사: 통과
  입력 검증: 통과
  HTML 출력 이스케이프: 통과
  비밀값 참조와 교체 기록: 통과
  의존성 검토 기록: 통과
  로그 개인정보 최소화: 통과

개선 전에도 검색 결과의 미디어 유형은 선언한다. 이 항목은 nosniff까지 있어야 통과한다. 개선 후의 9점은 정해 둔 입력과 정책에 대한 결과다. 운영 판단에 쓰려면 최종 응답, 키 교체 기록, 배포 환경의 의존성 목록을 각각 확인한다. AI가 수정한 파일도 두 명령을 실행한 뒤 변경 차이에서 검사 조건 자체가 느슨해지지 않았는지 확인한다.

실무에서 자주 틀리는 것

다음 코드는 main.py를 저장한 디렉터리에서 각각 별도의 Python 파일로 실행할 수 있다. 각 예제는 같은 함수나 입력으로 개선 전후의 차이를 드러낸다.

자원 제한을 쓰고 프레임 제한을 빠뜨린다

두 설정 모두 스크립트의 출처를 제한한다. 첫 번째 정책에서 프레임 지시어를 읽으면 None이 나오고, 두 번째 정책에서는 'none'이 나온다. 문서가 어디에 포함될 수 있는지 별도 지시어로 확인한다.

from main import read_csp

before = {"content-security-policy": "default-src 'self'; script-src 'self'"}
after = {"content-security-policy": before["content-security-policy"]
         + "; frame-ancestors 'none'"}

print(read_csp(before).get("frame-ancestors"))
print(read_csp(after).get("frame-ancestors"))

입력 검사를 통과한 문자열을 제목에 바로 넣는다

검증 함수는 앰퍼샌드를 포함한 책 제목을 받아들인다. 첫 번째 출력은 앰퍼샌드를 그대로 끼워 넣는다. 두 번째 출력은 HTML에서 문자로 해석되도록 변환한다. 검색어를 저장하거나 비교할 때에는 query를 그대로 사용한다.

from main import escaped_title, raw_title, validate_query

query = validate_query("  A & B  ")
print(raw_title(query))
print(escaped_title(query))

새 키를 반영한 시점에 교체를 완료로 표시한다

새 키로 동작을 확인했더라도 이전 키가 계속 활성 상태일 수 있다. 첫 번째 판정은 새 키 확인만으로 True를 낸다. 두 번째 판정에서는 이전 키 폐기 기록까지 있어야 완료다. 여기서 두 변수는 실제 비밀값 없이 교체 작업 결과를 나타낸다.

new_key_verified = True
old_key_retired = False

before = new_key_verified
after = new_key_verified and old_key_retired

print(before)
print(after)

장애를 조사할 때 요청 사전을 그대로 기록한다

첫 번째 기록에는 가상 연락처가 검색어로 남는다. 두 번째 기록에는 운영자가 검색 실패를 집계하고 요청을 구별하는 데 쓰는 항목만 남는다. 로그 필드를 추가할 때는 그 값이 어디에서 들어오는지도 함께 본다.

from main import LOG_FIELDS

request_event = {
    "event": "book_search",
    "path": "/search",
    "status": 400,
    "request_id": "req-demo-01",
    "query": "reader@example.test",
}
before = request_event
after = {field: request_event[field] for field in LOG_FIELDS}

print(before)
print(after)

한눈에 보기

서점의 보안 책임을 두는 위치와 점검 근거
구성요소책임을 두는 위치점검 근거
보안 헤더공통 응답 생성부와 최종 응답을 내보내는 앞단성공·오류 응답의 헤더 값, 실제 자산 로딩 결과
입력 검증요청값을 검색에 넘기기 직전자료형, 길이 경계, 공백과 제어 문자 처리 결과
출력 이스케이프검색어를 HTML에 넣는 위치문장부호가 섞인 제목의 HTML 출력과 화면 표시
비밀값권한이 제한된 실행 환경과 운영 교체 절차참조 경로, 적용 확인과 이전 키 폐기 기록
의존성배포 구성 목록과 검토 기록배포 버전과 보안 검토 대상의 일치 여부
개인정보를 줄인 로그애플리케이션과 앞단의 로그 생성부성공·오류 시 수집 항목과 실제 기록 값

연습 문제

  1. 개선 후 설정에서 CSP의 마지막 프레임 지시어만 빼고 다시 실행한다. 두 CSP 관련 항목 가운데 어느 항목이 미충족이 되며 총점이 몇 점인지 확인한다.

  2. 개선 후 설정에서 검증 함수는 유지하고 제목 생성 함수만 raw_title로 바꾼다. 입력 검증 항목과 HTML 출력 항목의 점수를 예측한 뒤 실행한다. 두 동작을 따로 검사하는 이유를 설명한다.

  3. 가상의 런타임 구성요소가 추가되었다고 가정한다. 개선 후 설정의 components에 "runtime-extra-demo"를 더하고, 검토 목록에는 그대로 둔다. 어느 항목이 미충족이 되는지 확인하고 운영에서 검토 기록을 갱신할 근거를 적는다.

  4. 개선 후 설정에서 로그의 키는 그대로 유지하면서 handle_search의 request_id 값에 str(raw_query)를 넣는다. 로그 검사가 이 변화를 발견하는지 확인하고 요청 식별자에 적합한 값의 조건을 설명한다.

정답과 해설

  1. 총점은 8점이다. CSP_POLICY 끝의 프레임 지시어만 빼면 네 개의 자원 지시어는 원래 값과 일치한다. policy.get("frame-ancestors")는 None을 돌려주므로 프레임 제한 항목만 미충족이다.

  2. 입력 검증은 통과하고 HTML 출력 이스케이프가 미충족이 되어 8점이다. 검증 기준과 상태 코드는 그대로다. 제목에 원문이 들어가면 기대한 문자 참조와 일치하지 않는다. 입력 검사와 동일한 테스트에서 렌더링 회귀를 놓치지 않도록 본문의 예상값도 별도로 비교한다.

  3. components=(*RUNTIME_COMPONENTS, "runtime-extra-demo")로 바꾸면 검토 목록과 서로 달라져 8점이다. 실습에서는 그 항목을 검토 목록에도 넣으면 일치 검사를 통과한다. 운영에서는 배포될 구성요소의 정확한 버전을 파악하고 관련 보안 공지 및 필요한 조치를 검토한 결과에 근거해 기록을 갱신한다.

  4. 출력된 로그 사전의 키는 같아도 값 비교에서 실패하므로 8점이다. 요청 식별자는 원본 요청 데이터와 별개로 생성하고, 문의나 장애를 조사할 때 여러 기록에서 같은 요청을 연결할 수 있어야 한다. 검색어를 바꿔도 이 예제의 로그는 서버가 정한 req-demo-01을 담아야 한다.

이 장에서는 응답을 만드는 코드와 설정 자료에서 서점의 보안 정책을 확인했다. 다음 장에서는 이 코드가 운영 환경에서 어떤 프로세스로 실행되고, 어떤 경로로 설정을 전달받는지 살펴본다.

오탈자·오류 제보 비공개로 접수되어 원고 수정에 반영됩니다

이메일 등 개인정보는 받지 않습니다. 답변이 필요한 질문은 아래 댓글을 이용해 주세요.

READER FEEDBACK

질문·의견

내용에 관한 질문이나 더 나은 설명을 위한 의견을 남겨 주세요. 오탈자는 위의 제보 양식이 더 빨리 반영됩니다. 이 댓글은 원래 게시글과 같은 자리에 쌓입니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

댓글을 남기려면 로그인이 필요합니다.