공개 클라이언트 유출 감사은(는) 무엇을 하나요?
비공개 백엔드와 통신하는 공개 클라이언트 코드베이스를 감사합니다. 목표: 공개 표면은 자체 포함되어야 하며, 클라이언트가 수행하는 호출과 교환하는 데이터 형태(출시된 모든 클라이언트에 불가피함)는 드러낼 수 있지만 그 외의 정보는 드러내지 않아야 합니다. 서버 작동 방식에 대한 모든 추가 세부 정보는 공격자에게 무료 정찰이며 남용을 위한 지렛대입니다.
이 기술은 세 가지 결과물을 생성합니다: 결과 목록(누출 + 클라이언트 측 보안 허점, 각각 file:line 및 심각도 포함), 일련의 적용된 수정, 그리고 잔여 권장 사항이 포함된 보고서입니다.
참조 파일(필요할 때 로드하여 읽고, 모두 인라인하지 마세요):
references/leak-taxonomy.md— 찾아야 할 공개 범주, 각각이 중요한 이유, 시작 검색 패턴.references/rewrite-rules.md— 주석/문자열 재작성 규칙과 전후 예제; 유지 대 제거 결정 방법.references/client-hardening.md— 클라이언트 측 보안 체크리스트 (권한, IPC, 토큰, DOM, 네트워크, 빌드 구성, 공급망).references/report-template.md— 출력 보고서 구조.scripts/leak-sweep.sh— 매개변수화된 ripgrep 스윕으로 검색 시드 (제품별로 패턴 배열 사용자 정의).
핵심 사고 모델
모든 공개를 두 가지 버킷 중 하나로 분류합니다:
- 필요 최소한(유지): 클라이언트가 호출하는 엔드포인트, 실제로 보내고 받는 요청/응답 형태, 자체 재시도/백오프/디바운스 선택, 입력 유효성 검사 한도, 그리고
상태 → UI 동작매핑. 공개 클라이언트는 이를 숨길 수 없습니다; 그렇지 않은 척하는 것은 보안 쇼에 불과합니다. - 과도 공개(수정): 서버가 요청으로 무엇을 하는지 설명하는 모든 것, 클라이언트가 엄격히 필요로 하지 않는 서버 측 한도/할당량, 출시된 클라이언트가 호출하지 않는 엔드포인트, 내부 서버 논리를 반영하는 오류 분기, 남용 방지 메커니즘, 인프라/기술 스택 식별자, 비공개 저장소/경로, 그리고 백엔드 동작을 인코딩하는 테스트 스캐폴딩.
재작성 규칙. 클라이언트 코드와 테스트는 계약을 명시할 수 있습니다("HTTP 422 → 지원되지 않는 제공자 메시지 표시"). 서버가 왜 그렇게 하는지("서버가 임시 도메인 확인을 실행하고 422로 거부함")를 설명해서는 안 됩니다. 주석이 서버 동작을 설명하는 경우, 삭제하거나 클라이언트가 관찰 가능한 계약으로 축소하세요. references/rewrite-rules.md를 참조하세요.
워크플로우
요청에 따라 노력을 조정하세요: 빠른 "이것이 뭔가를 누출합니까"는 1-2단계; "오픈소스 전에 정리" 또는 "전체 감사"는 6단계 모두입니다. 대규모 코드베이스의 경우 2단계를 병렬 읽기 전용 에이전트(분류 클러스터당 하나)에 분산하고 file:line 결과를 병합하세요 — 하지만 1단계에서 범위 설정은 직접 먼저 수행하세요.
1단계 — 공개/비공개 경계 설정
검색 전에 이 제품에 대해 "비공개"가 무엇을 의미하는지 설정하세요. 이 단계를 건너뛰지 마세요 — 전체 감사는 이 경계에 상대적입니다.
- 감사 대상 공개 아티팩트와 비공개 대응물(백엔드, 관리 도구, 인프라, 모노레포 형제)을 식별하세요. 분할이 명확하지 않으면 사용자에게 묻거나
AGENTS.md/README/CONTRIBUTING에서 유추하세요. - 제품의 백엔드 스택, 호스팅, DB, 남용 방지 메커니즘 및 모든 테스트/스테이징 편의 사항을 나열하여 누출을 인식할 수 있도록 하세요. 이를 모르면 사용자에게 첫 번째 질문입니다.
- 이 클라이언트에 대해 무엇이 필요 최소한인지(실제 엔드포인트 및 페이로드) 기록하여 불가피한 것을 플래그 지정하는 데 시간을 낭비하지 않도록 하세요.
2단계 — 누출 검색
references/leak-taxonomy.md의 분류를 따라 걸으세요. src/뿐만 아니라 저장소 전체를 다루세요: tests/e2e, docs, README/CHANGELOG, CI/workflow 파일, .env* 및 .example 쌍둥이, 빌드/설정 파일, 패키지 매니페스트(스크립트, postinstall), 및 로케일/i18n 문자열(패키지 내부에 포함됨). scripts/leak-sweep.sh <target-dir>를 시작 스윕으로 실행한 다음 컨텍스트에서 히트를 읽으세요 — 패턴 일치는 단서일 뿐 최종 판단이 아닙니다. 각 실제 발견에 대해 file:line, 짧은 인용문, 한 절 이유를 기록하세요. 또한 "확인, 깨끗함" 목록을 유지하여 보고서가 적용 범위를 보여주도록 하세요.
다음 두 가지 높은 가치, 놓치기 쉬운 클래스에 특별히 주의하세요:
- 게시 직전의 비밀 — 번들러가
.gitignore를 준수하지 않기 때문에 소스 번들(스토어/앱 스토어 "검토 가능 소스" zip,npm pack, 디렉터리 백업)이 포함할 git-무시된.env*파일의 실제 값. 추적되지 않음 ≠ 안전함. - 테스트/e2e 코드 — 결정론적 테스트 자격 증명, 특수 쿼리 매개변수, 출시된 클라이언트가 호출하지 않는 엔드포인트, 서버 내부를 설명하는 주석. 테스트는 예상 서버 응답을 문서화하기 때문에 백엔드 동작이 가장 자주 누출되는 곳입니다.
3단계 — 클라이언트 측 강화
references/client-hardening.md를 실행하세요. 이는 누출과 직교합니다: 공개하는 내용과 관계없이 클라이언트가 악용 가능한지에 관한 것입니다. 권한 있는 IPC의 송신자/발신자 검증, 인증 토큰 저장 및 송신, 페이지 또는 서버 파생 데이터에 의한 DOM/XSS 싱크, 과도하게 넓은 권한, 그리고 오염된 빌드가 백엔드를 재지정하거나 비밀을 번들로 묶을 수 있는 빌드 타임 구성을 우선시하세요.
4단계 — 수정
수정 사항을 적용하세요. 영향 순서:
- 먼저 비밀 누출 채널을 차단하십시오 (소스 번들에서
.env*/비밀 파일 제외; 커밋된 인접 파일에서 실제 값 제거). - 누출되는 주석/문자열/문서에 재작성 규칙을 적용하세요; 주석을 다시 작성하는 것보다 주석이 불필요해지도록 코드 이름을 바꾸는 것을 선호하세요.
- 서버 정책(세션 TTL, 할당량, 제거된 엔드포인트)을 하드코딩하는 죽은 코드를 삭제하세요.
- 테스트/문서를 클라이언트 관찰 가능 계약으로 트리밍하세요; 흐름을 유지하고, 설명을 줄이세요.
- 변경 사항을 테스트와 함께 강화하세요.
동작 보존이 기본값입니다: 작업이 명시적으로 기능 변경을 원하지 않는 한 공개 API 계약, 저장소 키, 메시지 이름, 요청/응답 형태를 안정적으로 유지하세요.
5단계 — 검증
아무것도 망가뜨리지 않았고 아무것도 놓치지 않았음을 증명하세요:
- 프로젝트의 타입체크, 단위 테스트, 린트, 프로덕션 빌드를 실행하세요. 실제 종료 코드를 캡처하세요 (
cmd | tail파이프는tail의 상태를 보고하여 실패한 빌드를 숨깁니다 — 파이프 없이 실행하거나PIPESTATUS/set -o pipefail을 사용하세요). - 누출 스윕을 다시 실행하세요; 의도된 패턴이 이제 0인지 확인하세요 (의도적인 패턴 제외).
- 빌드된 아티팩트와 모든 소스 번들에서 비밀, 소스맵, 내부 문자열을 검사하세요 —
dist//빌드 출력 및 소스 zip을 grep하세요. 소스 트리 청결에만 의존하지 마세요. - 합법적인 흐름이 여전히 작동하는지 확인하세요 (예: 다를 수 있는 스테이징/e2e 빌드가 여전히 올바르게 해결됨).
6단계 — 보고서
references/report-template.md에 따라 보고서를 작성하세요: 심각도별 결과, 적용된 변경 사항, 잔여 권장 사항(비밀 순환, git 기록 노출, 의식적으로 지연된 절충), 검증 증거. git 기록은 소급하여 수정할 수 없음에 유의하세요 — 제거된 비밀 또는 설명적인 커밋 제목이 로그에 남습니다. 공개 저장소 기록을 다시 쓰는 것보다 순환 및 향후 커밋 메시지 위생을 권장합니다.
가드레일
- 불가피한 것을 과도하게 플래그 지정하지 마세요. 엔드포인트, 페이로드 형태,
상태 → UI매핑은 필요 최소한입니다; 이를 플래그 지정하면 보고서에 대한 신뢰가 떨어집니다. - 패턴 히트는 단서입니다. 누출이라고 판단하기 전에 컨텍스트에서 읽으세요 — "epoch"는 일반적으로 타임스탬프, "worker"는 Web Worker, "durable"는 Durable Objects가 아닌 대기열일 수 있습니다.
- 사용자 관련 정책을 명시하는 사용자 대상 문자열(예: "코드는 10분 후 만료")은 유지하세요; 그 옆에 있는 보이지 않는 설명/주석에서 내부 프레임을 제거하세요.
- 이 기술은 공격 표면을 줄이기 위해 자체/승인된 코드를 감사합니다. 방어적입니다: 공개를 줄이고 클라이언트를 강화하는 것이지, 익스플로잇을 구축하는 것이 아닙니다.