보안 · 데이터 처리
MergeGate가 무엇에 접근하고, 무엇을 어디에 두고, 언제 지우는지입니다. 코드가 실제로 하는 것만 적었습니다. 보안 검토 질문은 fortenball@gmail.com로 보내 주세요.
GitHub App 권한
공식 앱은 MergeGate Checks입니다. 설치는 "Only select repositories"로 필요한 저장소만 고르는 걸 권합니다.
| 권한 | 수준 | 왜 |
|---|---|---|
| Checks | 쓰기 | PR마다 체크런(mergegate/spec-drift)을 만들고 결과를 씁니다. |
| Contents | 쓰기 | 스펙 초안 PR과 "갱신 PR 열기" 버튼의 PR을 위해 새 브랜치(mergegate/specs-scaffold, mergegate/update-…)를 만들고 그 브랜치에만 커밋합니다. 기본 브랜치나 다른 브랜치에는 쓰지 않습니다. PR 검사 자체는 읽기 전용 토큰으로 돕니다. |
| Pull requests | 쓰기 | 위 두 종류의 PR을 엽니다. PR 검사는 읽기만 합니다. |
| Issues | 쓰기 | 설치할 때 문서·코드 대조 결과 이슈 1개를 엽니다. |
| Metadata | 읽기 | 저장소 이름·공개 여부·기본 브랜치. |
작업마다 필요한 만큼만 좁힌 설치 토큰을 그때그때 받습니다. PR 검사 토큰은 Contents·Pull requests 읽기와 Checks 쓰기뿐이고, 웹 뷰어와 CLI·MCP는 읽기 전용 토큰을 씁니다.
코드는 어떻게 다루나
- PR 검사·뷰어·CLI 요청마다 필요한 커밋만 얕게(depth 1) 받아 임시 폴더에서 판정하고, 판정이 끝나면 바로 지웁니다. 프로세스가 비정상 종료돼도 2시간 넘은 임시 폴더는 매시간 지웁니다.
- 판정은 서버 비밀값이 없는 별도 자식 프로세스(허용 목록 환경 변수, 메모리 1.5GB, 시간 제한)에서 돕니다. 저장소 내용은 공격자 입력으로 취급합니다. 설치 토큰은 명령줄 인자로 넘기지 않습니다.
- 웹 뷰어는 같은 브랜치를 다시 열 때를 위해 스펙과 판정 결과를 서버 메모리에 최대 10분 둡니다(디스크에 쓰지 않음).
- CLI·MCP의
--worktree는 아직 푸시하지 않은 바뀐 파일만 보냅니다. 심볼릭 링크와 비밀처럼 보이는 파일(.env*, 키, credentials)은 보내지 않습니다. - 판정에 LLM을 쓰지 않습니다. 코드를 모델 학습에 쓰지 않습니다.
저장하는 것
서버의 데이터베이스(SQLite)에 다음만 둡니다.
- 계정: GitHub 계정 id·로그인, Google로 로그인했다면 이메일·이름·Google id
- 플랜·결제: 이용권 기간, 토스페이 주문번호·결제 토큰·금액·상태·영수증 링크 (카드번호 없음)
- 청구용 사용 기록: 이용권 기간에 검사한 비공개 저장소 id
- 검사 결과 요약(저장소 이름·PR 번호·🔴🟡✅ 개수 — Org 대시보드에 쓰임), 스펙 변경 감사 로그(누가·무엇을), 조직 정책
- API 토큰: SHA-256 해시와 앞 6자만 (원문은 발급할 때 한 번만 보여 줌)
- 체험 사용 기록: 계정 id·사람 id
로그인 세션은 AES-256-GCM으로 봉인한 쿠키(__Host-, HttpOnly, Secure, 8시간)입니다. 운영 로그에는 요청 경로·저장소 이름·오류가 남고, 토큰과 코드는 남기지 않습니다.
어디서 돌아가나
대한민국의 NHN Cloud 가상 서버(운영사 ㈜디엔에이클라우드) 한 대에서 돕니다. HTTPS(Let's Encrypt)만 받고, HSTS를 켰습니다.
밖으로 나가는 데이터
| 받는 곳 | 쓰는 곳 | 항목 | 언제 |
|---|---|---|---|
| GitHub (미국) | 저장소 읽기·체크런·PR·이슈, GitHub 로그인 | 설치한 저장소의 내용, GitHub 로그인·id | 서비스의 바탕(설치 시점부터) |
| Google (미국) | Google 로그인 | 이메일·이름·Google 계정 id | Google로 로그인할 때 |
| Google Gemini API (미국) | "갱신 PR 열기" 버튼 | 그 스펙 본문, 어긋난 코드 줄과 값 | 버튼을 누를 때만. 판정에는 쓰지 않음 |
| 비바리퍼블리카 · 토스페이 (한국) | 이용권 결제·환불 | 주문번호·금액·결제 토큰 (카드번호는 받지 않음) | 결제할 때 |
어뷰징과 장애
- 판정은 결정적입니다: 같은 입력에 같은 결과. 값을 확실히 읽지 못하면 🟡이고 막지 않습니다.
- 이용권이 없으면 체크는 neutral(통과)로 끝나고, 서버가 응답하지 않으면 체크가 만들어지지 않습니다(필수 체크는 대기, 관리자 우회 가능).
- 저장소·계정·서버 단위 일일 한도, 큐 한도, 시간 제한이 있어 한 계정이 서버를 차지할 수 없습니다.
사고가 나면
개인정보 유출을 확인하면 영향을 받은 계정에 72시간 안에 알리고, 법이 정한 곳에 신고합니다. 취약점을 발견하셨다면 공개 전에 fortenball@gmail.com로 알려 주세요. 확인되는 대로 답합니다.
아직 없는 것
SOC 2·ISMS 같은 인증, 상시 상태 페이지, SLA, 별도 DPA 서식은 아직 없습니다. 필요하시면 문의해 주세요.
English summary
The official app is MergeGate Checks. It asks for write access to Checks (check runs), Contents and Pull requests (only to create its own branches, mergegate/specs-scaffold and mergegate/update-…, and open PRs from them; never the default branch) and Issues (one install report). Each job mints a narrower installation token; the PR check runs read-only on contents. Code is fetched shallowly per check, judged in an isolated child process without server secrets, and deleted when the verdict is made (orphans swept hourly). The viewer keeps specs and verdicts in memory for up to 10 minutes. No LLM judges; the "Open update PR" button sends that spec and the drifted lines to the Google Gemini API. We store account ids, pass and payment records (no card numbers), private repository ids used for billing, Org check summaries and audit entries, and SHA-256 hashes of API tokens. Hosting: one NHN Cloud VM in South Korea, HTTPS only with HSTS. Personal data breaches are notified to affected accounts within 72 hours. No SOC 2 or ISO certification yet.