Feature #1499
open
희채
희채
[T15] 인증·인가 API 구현
Feature #1499:
[T15] 인증·인가 API 구현
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%로 두며 실제 착수 시 갱신한다.
참고:
- T15 작업지시서: https://github.com/ai-career-platform/ai-career-platform/blob/docs/initial-30-work-orders-20261106/docs/work-orders/initial-30/T15.md
- API 계약 초안: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/API_CONTRACT.md
- 신청 시트: https://docs.google.com/spreadsheets/d/1TFB-aYbzmk0wdUFvBeieiK-hemY0KeFQc_PVY76t2sA/edit
- 운영 기준: 저장소 docs/REDMINE.md
Subtasks