Communitygithub.com

공개 클라이언트 유출 감사

AI 에이전트가 공개 클라이언트 (확장, 앱, SPA, CLI, SDK)의 내부 백엔드 정보, 비밀, 남용 가능 정보 노출을 감사하고, 오픈소스 또는 스토어 제출 전에 강화합니다.

공개 클라이언트 유출 감사란 무엇인가요?

이 기술은 AI 에이전트가 공개 클라이언트 코드베이스의 보안 감사를 수행하도록 설계되었습니다. 주요 목표는 클라이언트가 필요한 최소한의 정보(호출하는 엔드포인트, 요청/응답 형식, 자신의 재시도/백오프 정책 등)만 노출하고, 서버 내부 동작, 인프라 식별자, 비밀, 남용을 가능하게 하는 세부 정보는 완전히 제거하는 것입니다. 에이전트는 6단계 워크플로우를 따르며, 공개/비공개 경계 설정, 유출 검색 (ripgrep 스윕 및 컨텍스트 분석), 클라이언트 강화 (참조 문서 사용), 수정, 검증 (타입체크, 테스트, 빌드), 보고서 작성을 수행합니다. 특히 .env 파일의 비밀 누출과 테스트 코드의 서버 내부 설명에 주의하며, 불가피한 정보와 과도한 공개를 엄격히 구분하여 사용자 신뢰를 유지합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add khasky/public-client-leak-audit

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

공개 클라이언트 유출 감사은(는) 무엇을 하나요?

비공개 백엔드와 통신하는 공개 클라이언트 코드베이스를 감사합니다. 목표: 공개 표면은 자체 포함되어야 하며, 클라이언트가 수행하는 호출과 교환하는 데이터 형태(출시된 모든 클라이언트에 불가피함)는 드러낼 수 있지만 그 외의 정보는 드러내지 않아야 합니다. 서버 작동 방식에 대한 모든 추가 세부 정보는 공격자에게 무료 정찰이며 남용을 위한 지렛대입니다.

이 기술은 세 가지 결과물을 생성합니다: 결과 목록(누출 + 클라이언트 측 보안 허점, 각각 file:line 및 심각도 포함), 일련의 적용된 수정, 그리고 잔여 권장 사항이 포함된 보고서입니다.

참조 파일(필요할 때 로드하여 읽고, 모두 인라인하지 마세요):

핵심 사고 모델

모든 공개를 두 가지 버킷 중 하나로 분류합니다:

  • 필요 최소한(유지): 클라이언트가 호출하는 엔드포인트, 실제로 보내고 받는 요청/응답 형태, 자체 재시도/백오프/디바운스 선택, 입력 유효성 검사 한도, 그리고 상태 → 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단계 — 수정

수정 사항을 적용하세요. 영향 순서:

  1. 먼저 비밀 누출 채널을 차단하십시오 (소스 번들에서 .env*/비밀 파일 제외; 커밋된 인접 파일에서 실제 값 제거).
  2. 누출되는 주석/문자열/문서에 재작성 규칙을 적용하세요; 주석을 다시 작성하는 것보다 주석이 불필요해지도록 코드 이름을 바꾸는 것을 선호하세요.
  3. 서버 정책(세션 TTL, 할당량, 제거된 엔드포인트)을 하드코딩하는 죽은 코드를 삭제하세요.
  4. 테스트/문서를 클라이언트 관찰 가능 계약으로 트리밍하세요; 흐름을 유지하고, 설명을 줄이세요.
  5. 변경 사항을 테스트와 함께 강화하세요.

동작 보존이 기본값입니다: 작업이 명시적으로 기능 변경을 원하지 않는 한 공개 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분 후 만료")은 유지하세요; 그 옆에 있는 보이지 않는 설명/주석에서 내부 프레임을 제거하세요.
  • 이 기술은 공격 표면을 줄이기 위해 자체/승인된 코드를 감사합니다. 방어적입니다: 공개를 줄이고 클라이언트를 강화하는 것이지, 익스플로잇을 구축하는 것이 아닙니다.

관련 스킬