보안 점검 결과에 CSP가 없다는 항목이 보이면 헤더 한 줄을 추가하고 싶어집니다. 그런데 배포한 뒤 로그인 버튼이나 원고 저장 기능이 멈춘다면 보안 설정과 서비스 복구를 함께 처리해야 합니다. 처음 화면이 정상이라는 사실만으로 모든 기능이 정책에 맞는다고 판단하기도 어렵습니다.
혼자 서비스를 운영하는 관점에서는 설정을 넣는 속도보다 문제가 생긴 기능을 설명할 수 있는지가 중요합니다. 이 글은 2026년 11월 1일 확인한 MDN 문서를 바탕으로 CSP를 관찰 단계에서 차단 단계로 옮기는 점검 순서를 제안합니다. 실제 서비스에 적용해 검증한 기록은 아니며, 원고 편집 서비스는 설명을 위한 가상 사례입니다.
1. 보고 전용 정책과 실제 차단을 먼저 구분합니다
CSP는 브라우저가 페이지의 자원을 어떤 조건으로 사용할지 제한하는 정책입니다. 처음부터 강한 제한을 적용하기 전에 Content-Security-Policy-Report-Only 응답 헤더로 위반을 관찰할 수 있습니다. 이름 그대로 이 정책 자체는 위반 동작을 차단하지 않습니다. 보고가 쌓인다는 사실을 보안 조치가 이미 시행되고 있다는 뜻으로 읽으면 안 됩니다.
MDN의 보고 전용 헤더 설명은 이를 HTTP 응답 헤더로 제공하고 보고 목적지를 설정하는 방법을 안내합니다. HTML의 메타 요소에 같은 이름을 넣어 대신할 수 없습니다. 보고 수집에는 Reporting-Endpoints와 report-to의 연결을 확인해야 하며, 대상 브라우저의 지원 범위에 따라 보고 경로를 검토해야 합니다.
가령 원고 화면의 외부 편집기 스크립트가 새 정책에 맞지 않는 상황을 생각해 볼 수 있습니다. 관찰 단계에서는 편집기가 동작하면서 위반 사실을 찾는 것이 목적입니다. 차단 전환 뒤에는 같은 의존성이 실제 기능 장애로 이어질 수 있습니다. 두 단계에서 저장 버튼을 눌렀을 때 기대하는 결과를 작업표에 다르게 적어 두는 편이 좋습니다.
이미 시행 중인 CSP가 있다면 보고 전용 헤더를 추가했다고 기존 제한이 풀리는 것은 아닙니다. MDN의 CSP 배포 안내처럼 시행 정책과 보고 정책은 각각 적용됩니다. 기존 정책, 새 후보 정책, 실제 응답에 실린 값을 구분해 기록해야 어느 쪽의 결과를 보고 있는지 혼동하지 않습니다.
2. 보고 건수를 화면과 사용자 동작에 연결합니다
보고 수집을 시작한 다음에는 총건수보다 재현 가능한 묶음을 만드는 것이 우선입니다. 같은 원인으로 페이지를 열 때마다 보고가 발생할 수도 있습니다. 반대로 방문자가 거의 없는 설정 화면은 문제가 있어도 조용할 수 있습니다. 보고가 없다는 이유만으로 전체 서비스가 준비됐다고 결론내리지 않도록 기능 목록을 따로 만듭니다.
- 진입 조건: 로그인 전후, 계정 권한, 페이지 주소와 배포 버전을 기록합니다.
- 사용자 동작: 화면 열기뿐 아니라 저장, 파일 선택, 미리보기처럼 필요한 흐름을 적습니다.
- 위반 단서: 문제가 된 지시문과 자원 출처를 같은 유형끼리 묶습니다.
- 처리 판단: 필요한 의존성인지, 제거할 코드인지, 추가 조사가 필요한지 나눕니다.
가상 원고 서비스라면 로그인 화면, 편집 화면, 이미지 첨부, 저장 완료, 다시 열기를 하나의 흐름으로 묶을 수 있습니다. 첫 화면만 열어 보는 점검에서는 늦게 불러오는 기능을 놓칠 수 있으므로 동작별 결과를 남깁니다. 특정 브라우저에서만 보고가 들어왔다면 다른 브라우저도 정상이라고 확대하지 않고 확인한 환경을 표기합니다.
보고 수집 경로 자체도 확인 대상입니다. 관리하는 점검 환경에서 예상 위반 한 건을 만들고 수신 여부를 대조하는 절차를 마련할 수 있습니다. 이것은 실제 사용자 자료를 외부에 보내는 실험과 구분해야 합니다. 이 글에서는 수집 서버를 실행하거나 브라우저별 전송을 시험하지 않았습니다.
운영 설계에서는 보고 내용을 믿을 수 있는 내부 명령으로 취급하지 않는 편이 안전합니다. 수신 크기와 보관 기간을 정하고, 화면 주소에 개인 식별값이나 민감한 내용이 섞일 여지도 검토합니다. 모든 원문을 무기한 쌓기보다 원인 구분에 필요한 항목을 정하는 것이 목적입니다. 외부 수집 서비스를 쓴다면 전송되는 필드와 접근 권한을 먼저 확인합니다.
3. 위반 출처를 모두 허용 목록에 넣지는 않습니다
보고를 없애는 가장 쉬운 방법처럼 보이는 것은 발견한 출처를 계속 허용하는 일입니다. 하지만 보고에는 사용자가 꼭 필요한 기능과 정리해야 할 코드가 함께 나타날 수 있습니다. 각 출처에 대해 어떤 기능이 요구하는지, 누가 관리하는지, 지금도 필요한지를 확인한 뒤 정책을 수정해야 합니다.
예를 들어 예전 통계 스크립트와 현재 이미지 편집기가 모두 보고에 나타났다고 가정해 보겠습니다. 전자는 제거할 대상일 수 있고 후자는 유지해야 할 의존성일 수 있습니다. 둘을 한꺼번에 넓은 허용 규칙으로 감싸면 원인을 분리할 기회를 잃습니다. 자원 목록에 담당 기능과 제거 가능 여부를 붙이면 다음 배포에서도 같은 결정을 반복하기 쉽습니다.
인라인 스크립트를 정리하는 경우에는 단순히 경고를 없애는 설정만 찾지 말고 코드 배치와 허용 방식을 함께 검토합니다. MDN은 nonce 방식에서 응답마다 예측하기 어려운 값을 사용하도록 설명합니다. 고정 문자열 하나를 계속 붙이는 것으로 같은 목적을 달성한다고 가정하면 안 됩니다. 구체적인 nonce·해시 정책은 서비스의 렌더링 방식에 맞춰 별도로 설계해야 합니다.
정책을 고쳤다면 어떤 보고 묶음을 해결하려는 변경인지 함께 남깁니다. 편집기 공급자의 출처를 추가한 것인지, 사용하지 않는 스크립트를 제거한 것인지 구별합니다. 보고 수가 줄어든 이유가 기능 제거인지 수집 중단인지도 다를 수 있으므로 숫자 하나만 성과로 쓰지 않습니다.
여기서 제안하는 작업표는 보안 정책의 완성본이 아닙니다. 자원 출처를 정리했어도 입력 처리, 권한 확인, 의존성 취약점 같은 다른 문제는 남을 수 있습니다. CSP 하나로 모든 스크립트 공격이나 서비스 보안을 해결했다고 표현하지 않는 이유입니다. 적용 범위를 좁혀 설명해야 다음 점검에서 무엇이 남았는지 보입니다.
4. 차단 전환에는 통과 조건과 되돌릴 조건이 필요합니다
차단 전환 시점은 며칠 동안 보고가 없었다는 달력만으로 정하기 어렵습니다. 서비스에 중요한 사용자 흐름을 수행했고, 그때 나타난 위반을 설명할 수 있으며, 보고 수집도 동작하는지 확인해야 합니다. 확인하지 못한 브라우저나 기능이 있다면 통과 범위에서 분리해 두어야 합니다.
가상 원고 서비스에서는 저장과 다시 열기를 가장 중요한 흐름으로 정할 수 있습니다. 실제 정책을 시행할 점검 환경에서 로그인, 새 원고 작성, 저장, 재진입을 확인하는 절차가 필요합니다. 정상 화면만 보는 것으로 끝내지 않고 실패 안내와 사용자 수정본 보존도 함께 살펴봅니다. 이는 수행할 검사 제안이며 이 글에서 성공을 확인했다는 의미는 아닙니다.
배포 전에는 정책 변경을 되돌리는 담당자와 기준도 정합니다. 핵심 기능 실패가 확인됐을 때 어떤 설정을 이전 상태로 복구할지, 어떤 증거를 남길지 기록합니다. 모든 위반을 없애겠다는 이유로 허용 범위를 급하게 넓히기보다 문제가 생긴 변경과 기능을 먼저 연결하는 편이 원인 분석에 도움이 됩니다.
배포 후에도 외부 편집기 교체, 인증 방식 변경, 분석 도구 추가처럼 자원 사용이 바뀌면 정책을 다시 검토해야 합니다. 이전 버전에서의 통과 결과를 새 의존성에 그대로 적용하지 않습니다. 관찰용 정책은 다음 개정안을 확인하는 데도 쓸 수 있지만, 그 기록과 실제 시행 중인 정책은 계속 분리해 관리합니다.
지금 시작한다면 헤더를 복사하기 전에 중요한 화면 하나를 고르는 것부터 권합니다. 그 화면의 사용자 동작, 발견한 위반, 필요한 출처, 수정 계획을 한 줄씩 적어 보십시오. 보고 전용 단계의 성과는 경고 숫자가 사라지는 일이 아니라, 차단했을 때 어떤 기능이 왜 영향을 받는지 설명할 수 있게 되는 것입니다.
'개발 노트 > 배포와 운영' 카테고리의 다른 글
| 작은 서비스의 효율 개선, 전력 절감이라고 말하기 전에 (0) | 2026.10.28 |
|---|---|
| AI 보안 스캔과 자동 수정 PR을 어디까지 믿을까 (0) | 2026.10.24 |
| 1인 서비스의 OpenTelemetry Collector export topology (0) | 2026.10.03 |
| OpenTelemetry가 기본으로 들어온 시대 — 1인 서비스의 관측 구성 최소안 (0) | 2026.09.08 |
| 아차! Branch를 깜빡했네! 방금전 Commit을 새 Branch로 옮기기 (0) | 2024.03.14 |