Project

General

Profile

Feature #1499

open
희채 희채

[T15] 인증·인가 API 구현

Feature #1499: [T15] 인증·인가 API 구현

Added by 희주 채 11 days ago. Updated 11 days ago.

Status:
In Progress
Priority:
High
Assignee:
Start date:
11/11/2026
Due date:
11/17/2026 (Due in 0 days)
% Done:

90%

Estimated time:

Description

목표 및 사용자 시나리오:
로그인한 사용자만 비공개 API를 사용할 수 있도록 하고, 역할·permission·소유자 검사를 서버에서 일관되게 수행하는 공통 인증·인가 계층을 구현한다.

범위:

  • 현재 사용자 확인 의존성: 토큰 없음/무효 → 401
  • 역할·permission 검사 의존성: 권한 없음 → 403
  • 소유자 검사: 타인 리소스 접근 시 404로 존재 은닉
  • GET /me, GET /me/permissions
  • auth router / service / schemas
  • 익명·일반 사용자·관리자 시나리오 pytest
  • 응답·로그에 토큰 원문 노출 0건

비범위:

  • 로그인 제공자 확정(자체 인증 vs 외부 OIDC): 승인 전까지 교체 가능한 mock 토큰 검증만 둠
  • 실제 토큰·세션 저장 방식 확정
  • FastAPI 골격: T13 (#1498)
  • DB 연결·세션 수명주기: T14
  • 공유 Staging DB·서비스 변경

담당자:
채희주 (Redmine: 희주 채 / GitHub: kixxuya)

선행조건:

  • T06 API·DTO 계약 확정: 미신청
  • T13 FastAPI 골격 (#1498): 진행 전
  • T14 PostgreSQL 연결: 진행 전
  • auth provider 및 개인정보 정책 결정
  • 작업지시서 6항에 따라 위 결정 전에는 mock 스캐폴드만 진행 (HOLD 조건)

관련 화면/API/DB:

  • API: POST /auth/login, GET /auth/callback, POST /auth/logout, GET /me, GET /me/permissions
  • DB: users, auth_identities, auth_sessions, roles, permissions, user_roles, role_permissions

완료조건(테스트·증빙 포함):

  • 미인증 401 / 비인가 403·404 / 정상 200 테스트 통과
  • 토큰 원문 노출 0건
  • PR 설명에 실행 명령·테스트 SHA·영향 범위·미해결 항목 기록
  • PR 리뷰 및 CI 확인. CI가 범위를 검증하지 못하면 PARTIAL로 표기

예상 일정:
PM 확정 필요. 완료일·추정시간 미정.

브랜치 / PR / Merge SHA:

  • 브랜치: task/t15-auth (예정)
  • PR: 미생성 / Merge SHA: 없음

Staging 검증 결과:
미수행. 비밀번호·토큰 등 민감정보는 본 일감이나 저장소에 기록하지 않음.

다음 행동:
담당 확정 → T13 구조 및 auth provider 결정 상태 확인 → mock 기반 인가 계층·테스트 작성 → Redmine 번호 포함 PR 생성.
등록 상태는 New / 0%로 두며 실제 착수 시 갱신한다.

참고:


Add

Subtasks


Add

Related issues 3 (0 open — 3 closed)

Precedes Feature #1548: [T35] 목표 직무 관리 APIClosed지나 팡11/18/202611/23/2026

Remove relationActions
Precedes Feature #1551: [T37] 개인 경력·프로젝트 이력 APIClosed지나 팡11/18/202611/23/2026

Remove relationActions
Precedes Feature #1553: [T39] 관심 채용공고 북마크 APIClosed지나 팡11/23/202611/26/2026

Remove relationActions

Updated by Anonymous 11 days ago Actions #1

Updated by Anonymous 11 days ago Actions #2

  • Precedes Feature #1551: [T37] 개인 경력·프로젝트 이력 API added

Updated by Anonymous 11 days ago Actions #3

  • Precedes Feature #1553: [T39] 관심 채용공고 북마크 API added

길문 Updated by 길래 문 11 days ago Actions #4

  • Due date set to 11/17/2026
  • Start date set to 11/11/2026

희채 Updated by 희주 채 11 days ago Actions #5

  • Status changed from New to In Progress
  • % Done changed from 0 to 10

착수 (2026-11-06 KST).

선행 상태: T13(#14)·T04(#13)·T05(#17)·T06(#29) merge 완료, T14(#25)는 HOLD(T07·T08 대기)라 T14 브랜치 위에 쌓아 작업.
D-01 자체 로그인 확정에 따라 설명의 "mock 토큰 검증만" 범위 대신 실제 구현으로 진행.

  • 브랜치: task/t15-auth (로컬 커밋, push·PR 전)
  • 구현: POST /auth/signup·login·refresh·logout, GET /consent-policies, GET /me, /me/permissions, GET·DELETE /me/sessions
  • 인가: get_current_user(401) / require_roles·require_permissions(403) / ensure_owner(404)
  • 로컬 pytest 59 passed (PostgreSQL 통합 테스트 2건은 로컬 DB 준비 후 실행 예정)
  • 비범위: 비밀번호 재설정(T93), PATCH /me(T16), 동의 변경(T31)

희채 Updated by 희주 채 11 days ago Actions #6

  • % Done changed from 10 to 90

개발·자체 테스트 완료, PR 생성 및 리뷰 요청 (2026-11-06 KST) → 90%

  • PR: https://github.com/ai-career-platform/ai-career-platform/pull/48 (리뷰어: Crasnec)
  • 브랜치/SHA: task/t15-auth @ ceec104 — T14 PR #25 위에 쌓은 stacked PR (#25 merge 후 base가 main으로 변경)
  • 팀 공통 에러 계약(T06 #41, AppError {code,status,message})·T14 SQLAlchemy Session 기준으로 구현
  • pytest 110 passed (postgres:16 + T05 검증용 DDL + T10 Seed 실DB 통합 테스트 3건 포함)
  • uvicorn 실서버 시나리오 18건 PASS, DB·로그에 비밀번호·토큰 원문 없음
  • T15_STATUS=PARTIAL: 현재 CI가 backend pytest를 돌리지 않음(T28), 공유 Staging 검증은 T14 HOLD(T07·T08)로 불가
  • 확인 필요: T10 Seed에 consent_policies 없음, Retry-After 계약 maximum 60 vs 로그인 잠금 900초, JWT HS256 결정

Also available in: PDF Atom