UniTutor BYOK: browser custody + one-shot header

Product lock

  • Eric 승인: BYOK 지금 노출 (유료 루프 후 미룸 아님). 마커 <!-- byok:approved -->.
  • 키 보관: 브라우저 only (localStorage unitutor:byok-gemini). 서버 DB/KV 영속 금지.
  • 전달: POST /api/tutor/turn 헤더 X-UniTutor-Byok-Key one-shot. BYOK 있으면 앱 GEMINI_API_KEY보다 우선·미사용.
  • BYOK 활성 시 무료 일일 쿼ota 미과금(앱 추론 원가 $0).

Security / QA

  • 응답·SSE error에 키 미포함; CORS allowHeaders에 헤더명 명시.
  • UniTutor에 .factory/quality.yaml security.command 없음 → mechanical SAST skip; AA는 tip↔merge 범위 리뷰 (Tenant-Quality-Yaml-Gate-Skip-Pattern.md).
  • Residual: XSS → localStorage 탈취 가능(브라우저 custody 고유).
  • QA: vitest byok/tutorStream + remote Worker fake-key → llm_failed without echo. Live Gemini 완결은 env 의존.

Sequencing

Stage1–3 done 후 SoR 다음 문장 = BYOK·추론 라우팅. SSE 라우팅 Intent 뒤 BYOK kickoff.