toki/appsok
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
appsok/agent-roadmap/phase/usable-mvp/milestones/jenkins-credential.md
toki 9d91b947c6 feat: usb install feature implementation 
- Add adb_service.dart with usb install capabilities
- Add adb_service_test.dart for testing
- Update project rules and phase documentation
- Update milestone documents for jenkins-credential and usb-install
- Add agent-task/m-usb-install/ directory with planning documents
2026-06-12 22:05:42 +09:00

3.5 KiB
Raw Blame History

Milestone: Jenkins 로그인과 credential 수명주기

위치

  • Roadmap: agent-roadmap/ROADMAP.md
  • Phase: agent-roadmap/phase/usable-mvp/PHASE.md

목표

AppSok이 Jenkins에 접근할 수 있는 사용자인지 확인하고, 사용자별 권한으로 Jenkins API를 호출할 credential을 안전하게 저장한다. MVP에서는 사용자가 직접 token을 발급하지 않도록 Jenkins WebView 로그인 후 사용자별 API token을 자동 발급하고 Keychain에 저장한다.

상태

[계획]

승격 조건

  • 없음

구현 잠금

  • 상태: 해제
  • 결정 필요: 없음

범위

  • Jenkins base URL 저장과 WebView 로그인 진입
  • WebView 로그인 세션에서 crumb와 사용자별 API token 자동 발급
  • 자동 발급한 username/API token을 macOS Keychain에 저장
  • 앱 시작 시 저장된 credential을 읽고 /whoAmI 또는 사용자 API 호출로 조용히 재검증
  • credential 삭제, 재로그인, token 폐기/권한 없음/네트워크 실패 상태 구분
  • macOS Keychain 저장과 로그 redaction

기능

Epic: [web-login] WebView 로그인과 자동 token 발급

사용자가 Jenkins 계정으로 로그인하면 AppSok이 같은 세션에서 API token을 자동 발급해 저장한다.

  • [login-webview] Jenkins 로그인 URL을 WebView로 열고 로그인 완료를 감지한다.
  • [crumb-token] WebView same-origin 요청으로 crumb를 받고 사용자별 API token을 자동 발급한다.
  • [keychain-store] 자동 발급한 username/API token을 TokenStore를 통해 macOS Keychain에 저장하고 삭제할 수 있다. 검증: mock storage 기반 unit test에서 save/read/clear가 통과한다.
  • [redaction] API token이 화면 오류, debug log, test fixture에 원문으로 남지 않도록 처리한다.

Epic: [session-restore] 로그인 상태 복원

앱을 다시 켤 때 매번 로그인하지 않고 저장된 credential을 검증해 Jenkins 접근 상태를 복원한다.

  • [startup-check] 앱 시작 시 Keychain credential을 읽고 Jenkins 사용자 확인 API로 조용히 검증한다.
  • [auth-state] 검증 성공 시 로그인 화면을 건너뛰고 build 목록으로 진입한다.
  • [reauth] token 폐기, 권한 없음, Jenkins URL 변경, 네트워크 실패를 구분해 재로그인 또는 재시도 흐름으로 안내한다.
  • [logout-clear] 사용자가 저장된 credential을 삭제하고 다시 로그인할 수 있다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 모든 기능 Task와 Task 안에 명시된 검증 충족 후 기록한다.
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • LDAP 직접 연동
  • 공용 Jenkins API token 내장
  • Auth Broker 또는 Jenkins plugin 구현
  • 사용자가 Jenkins에서 API token을 직접 발급해 복사하는 흐름을 기본 UX로 삼는 방식

작업 컨텍스트

  • 관련 경로: lib/src/features/settings/, lib/src/services/token_store.dart, lib/src/services/jenkins_client.dart, macos/Runner/*.entitlements
  • 표준선(선택): 사용자별 Jenkins 권한, WebView 로그인 기반 자동 token 발급, Keychain 저장을 기본 전제로 한다.
  • 표준선(선택): API token은 OAuth refresh token처럼 갱신하는 토큰이 아니라 저장 후 재검증하는 credential로 다룬다.
  • 선행 작업: 제품 골격 안정화
  • 후속 작업: Artifact 탐색과 다운로드
  • 확인 필요: 없음