Feature #1258
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1235: [MDGU-02] 보안·개인정보 (김예주, P0)
[MDGU-02-06] 보안 점검·자동 테스트 모음 정리
0%
Description
목적¶
각 기능 PR에 포함된 보안 테스트를 모아 운영 공개 전 필수 게이트(가이드 6절)를 통과하는지 확인합니다.
쉬운 설명¶
각 기능 PR에 포함된 보안 테스트를 모아, 운영 공개 전 필수 관문(개발 가이드 6절)을 통과하는지 확인합니다.
기술 스택¶
pytest, Django check --deploy, 정적 분석(ruff, bandit 후보), 수동 점검표.
예상 결과(산출물)¶
보안 점검 보고서와 자동 테스트 목록, 인수 테스트 1·3·4·5·6·8 결과표, 남은 위험 목록.
개발 작업 상세¶
- 무단 URL·내보내기·API 접근 차단 테스트가 모두 CI에 있는지 확인한다.
- SQL Injection·XSS·CSRF·파일 업로드·대량 추출·권한 우회 테스트를 보강한다.
- 로그·오류 보고·임시 파일에 개인정보 평문이 없는지 점검한다.
check --deploy와 보안 헤더를 점검한다.- 결과와 남은 위험을 보고서로 작성한다.
완료 기준¶
- 인수 테스트 결과표가 작성되었다.
- 치명 취약점이 0건이거나 해결 계획이 있다.
충돌 방지(소유 범위)¶
테스트 파일은 각 앱 tests/ 안에서 소유자가 관리하고, 이 일감은 security/tests와 docs/security에서만 신규 작성합니다.
선행·후행·위험¶
선행: 02-04 역할·권한(RBAC) 구현(김예주, 11/24 종료) / 02-05 감사 로그 구현(김예주, 11/26 종료) / 12-01 증빙 파일 업로드·암호화 저장·접근통제·다운로드 이력(김예주, 12/18 종료)
후행: 15-03 UAT 결함 대응(보안·권한 관련)(김예주) / 15-04 인수 체크리스트·운영 인계(최종)(우섭)
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 인수 테스트 결과표가 작성되었다.
- 치명 취약점이 0건이거나 해결 계획이 있다.
- pytest가 모두 통과한다.
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
시작 전 준비¶
- 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
- 저장소를 최신으로 맞춘다: 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/1258-<짧은영문설명>
- "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
- 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
- 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
- git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
- 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.
막힐 때 확인¶
테스트가 실패하면 해당 앱 소유자에게 일감 메모로 알리고, 본인이 다른 앱의 코드를 직접 고치지 마세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- CI(지속적 통합): 코드를 올릴 때마다 자동으로 테스트·검사를 돌리는 장치입니다. 여기서는 GitHub Actions를 씁니다.
- pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.
- PR(풀 리퀘스트): 내 브랜치의 변경을 main에 합쳐 달라고 요청하고 리뷰를 받는 절차입니다.
- CSRF: 다른 사이트가 사용자 몰래 요청을 보내는 공격입니다. Django 기본 토큰으로 막습니다.