Feature #1259
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1236: [MDGU-03] 로그인·계정 (서현)
[MDGU-03-01] 승인 계정 ID/PW 로그인·세션·로그인 제한
100%
Description
목적¶
사전 승인된 직원만 일반 로그인하게 하고, 비밀번호는 안전하게 해시하며 로그인 실패 제한·세션 만료·로그아웃을 적용합니다. (USR-001, FR-AUTH-001, 006, NFR-SEC-010 일부)
쉬운 설명¶
승인된 계정만 ID/비밀번호로 로그인하고, 비밀번호를 여러 번 틀리면 잠깐 잠그는 기능입니다.
기술 스택¶
Django Auth(커스텀 User), Django Sessions, 비밀번호 해시(Argon2 또는 기본 PBKDF2, 후보), django-axes 또는 직접 구현한 실패 제한(후보), Django Templates·Bootstrap 5.
예상 결과(산출물)¶
로그인·로그아웃 화면, 실패 횟수 제한과 잠금, 세션 만료 설정, 로그인 이력 모델, 테스트.
개발 작업 상세¶
- 01-01에서 만든 User stub을 확장한다(직원 구분, 활성 여부, 마지막 로그인).
- 로그인·로그아웃 뷰와 화면을 만든다. 로그인 후 이동 규칙(next)은 열린 리디렉션이 되지 않도록 검증한다.
- 비밀번호 해시 알고리즘을 확정하고 비밀번호 규칙을 적용한다.
- 로그인 실패 횟수 제한과 일정 시간 잠금을 구현한다.
- 세션 만료 시간, 로그아웃 시 세션 폐기를 설정한다.
- 로그인 성공·실패 이력을 저장한다(IP는 개인정보 정책에 맞게 저장 여부 확인).
- 테스트: 미승인 계정 거부, 잠금, 세션 만료.
완료 기준¶
- 직원 계정으로 로그인·로그아웃이 된다.
- 실패 제한과 잠금 테스트가 통과한다.
충돌 방지(소유 범위)¶
accounts/는 서현 소유. config/settings는 우섭 소유이므로 AUTH 관련 설정은 settings/base.py의 지정 구역(AUTH 블록)만 서현이 수정합니다(01-01에서 구역을 만들어 둠).
선행·후행·위험¶
선행: 01-01 저장소·Django 골격·앱 스텁·설정 분리(우섭, 11/06 종료)
후행: 02-04 역할·권한(RBAC) 구현(김예주) / 03-02 계정 승인·비활성화·직원 계정 관리 화면(서현)
위험: User 모델 변경은 첫 migrate 전에만 안전하므로 01-01의 stub과 필드 합의 필요.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 직원 계정으로 로그인·로그아웃이 된다.
- 실패 제한과 잠금 테스트가 통과한다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- 확정: 직원의 이름·이메일은 accounts에 저장하지 않고 security PersonRef를 참조한다. accounts는 username·상태 등 최소 항목만 둔다.
- ERD 검수 반영: 로그인 이력(login_history: user_id, 결과, IP, 시각), 직원 계정의 failed_count·locked_until·approved_at/approved_by 필드를 추가한다. django-axes를 쓰면 자체 테이블로 갈음할 수 있다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: git switch main 후 git pull --ff-only origin main
- 저장소 README 8번과 팀 로컬 세팅 안내 순서대로 환경을 준비한다. 보통 py -3.12 -m venv .venv, 가상환경 켜기, python -m pip install -r requirements-dev.txt, Windows에 설치한 PostgreSQL 18에서 개인 로컬 DB(university_dev) 생성, .env.local 설정(DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_PORT), python manage.py check, python manage.py migrate 순서이다. 최초 실행에 makemigrations는 필요 없고, .env.local과 비밀번호는 공유·커밋하지 않는다.
- #1226의 폴더 소유 표에서 내가 고칠 수 있는 폴더를 확인한다.
작업 진행 순서¶
- 브랜치를 만든다: git switch -c feature/1259-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
비밀번호를 평문으로 저장하거나 로그에 남기지 마세요. Django 기본 해시 기능을 사용합니다.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 세션: 로그인한 상태를 서버가 기억하는 방식입니다. 일정 시간이 지나면 만료됩니다.
성양 Updated by 성용 양 19 days ago
- Due date changed from 11/12/2026 to 11/09/2026
- Start date changed from 11/09/2026 to 11/04/2026
- Follows Feature #1249: [MDGU-01-01] 저장소·Django 골격·앱 스텁·설정 분리 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1260: [MDGU-03-02] 계정 승인·비활성화·직원 계정 관리 화면 added
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1256: [MDGU-02-04] 역할·권한(RBAC) 구현 added
성양 Updated by 성용 양 4 days ago
- Status changed from New to Resolved
- % Done changed from 0 to 100
[성용] 진행 기록 (2026-11-13)
[한 일]
- PR #53 병합(main 76709b1): https://github.com/GilbertMoon/university-academic-system/pull/53
- 직원 로그인 화면, 승인(approved_at)·활성 계정만 로그인
- 15분 안에 5회 실패 시 15분 잠금, 성공 시 초기화, 세션 30분(요청마다 연장)·로그아웃
- 로그인 이력(성공·실패·잠금, IP는 날짜 포함 HMAC 해시만 저장. 운영은 Nginx X-Real-IP 사용), 로그인 실패 감사 auth.login_fail 연결
- 초기 관리자 승인 명령 bootstrap_admin_approval(관리자 1명·승인 계정 0개일 때만 1회)
- 리뷰 반영: createsuperuser로 만든 관리자도 bootstrap으로 활성화, 운영 IP 해시가 프록시 주소로 고정되던 문제 수정
[남은 것]
- 운영 반영은 배포 직전에 진행(로그인 IP 해시 키, migration, bootstrap, 기존 직원 승인)
- 직원 person_ref_id 채우기는 03-02에서