fix(byok): keep the operator's environment key out of an own-credential client

[Eomdahyeon]

Refs #990

문제

environment_keys=False 로 만든 클라이언트가 환경변수 키를 막지 못한다. provider_keys 에서 운영자 키를 빼도, kpubdata 클라이언트는 사용 시점에 없는 키를 환경에서 찾는다. 자기 키가 없는 사용자의 요청이 운영자 키로 실행된다.

이 PR 이 하는 것 — kpubdata 릴리스 없이 지금 할 수 있는 부분

• _create_client(environment_keys=False) 가 Client(..., env_keys=False) 로 만든다.
• kpubdata 0.8.0 에는 env_keys 가 없고 **extra 가 조용히 삼키므로, 시그니처를 먼저 확인한다(client_keeps_environment_keys_out()). 없으면:
  • 그런 클라이언트를 만들려는 시도는 RuntimeError — 환경 키로 내려가지 않는다.
  • serve 는 이 모드(및 이를 함의하는 멀티유저 모드)에서 기동을 거부한다 (종료 코드 1, 사유 출력). 완료 조건의 "조용한 무시 방지".
• 기존 테스트의 구멍을 메웠다: "operator-key" not in repr(vars(client._config)) 는 폴백이 _config 에 저장되지 않으므로 항상 통과했다. 동작으로 바꿨다 — get_provider_key("datago") is None.
• docs/deployment.md 의 설정 표, CHANGELOG [Unreleased] Security.

이 PR 이 하지 않는 것 — 그래서 Refs

• 핀 상향. env_keys 를 담은 kpubdata 릴리스가 없다(chore(release): ship env_keys=False — Builder's own-credential gate cannot work on 0.8.0 kpubdata#780, 사람의 일). 핀은 >=0.8.0,<0.9 그대로다.
• 그 결과 지금 설치되는 kpubdata(0.8.0)로는 own-credential/멀티유저 모드를 serve 할 수 없다. 이전에는 뜨기는 했지만 약속을 지키지 못했다. 이것이 의도한 실패이지만 배포에는 영향이 있다 — 현재 운영은 API 키 단일 사용자 모드라 해당하지 않는다(이슈 본문).
• 완료 조건 3(운영자 키가 요청·로그·매니페스트에 없다는 누출 테스트)은 env_keys 가 있는 kpubdata 에서만 의미가 있어 넣지 않았다.

검증

• uv run pytest (kpubdata 0.8.0): 4377 passed, 11 skipped, 16 deselected.
• 새 테스트: env_keys 없는 Client → RuntimeError 이고 클라이언트가 만들어지지 않음 / 있는 Client → env_keys=False 가 전달됨 / serve 가 기동 거부.
• test_the_real_client_cannot_reach_the_operators_key 는 설치된 kpubdata 에 env_keys 가 있을 때만 돈다 — 로컬(0.8.0)에서는 skip 됐다. kpubdata main ↔ Builder CI 잡에서 실행되는지는 이 PR 의 CI 에서 확인해야 한다.
• ruff, mypy 통과

review:R3 — 작성자가 아닌 사람의 승인이 필요하다.

🤖 Generated with Claude Code

[yeongseon]

리뷰 (코멘트, 승인 아님 — R3).

diff 를 읽었고 걸리는 점이 없습니다. 시그니처를 먼저 확인해 조용한 무시를 막은 것, 저장 여부가 아니라 동작(get_provider_key("datago") is None)으로 테스트를 바꾼 것이 핵심입니다.

• 머지되면 kpubdata 0.8.0 에서는 own-credential·멀티유저 모드의 serve 가 기동을 거부합니다. 의도된 실패이고, 멀티유저는 이 PR 과 #1008, 그리고 env_keys 를 담은 kpubdata 릴리스가 모두 있은 뒤에 켭니다.
• 그 kpubdata 릴리스(kpubdata#780)는 10월 정기 릴리스에 싣기로 했습니다 — 별도로 앞당기지 않습니다. 핀 상향은 그 뒤에.

[yeongseon]

승인합니다. 앞선 리뷰 코멘트 그대로입니다.