Feature #1267
openFeature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)
Feature #1237: [MDGU-04] 인프라·배포 (성용)
[MDGU-04-05] 암호화 백업·복원 훈련
90%
Description
목적¶
DB·보호 파일·증명서 산출물·감사 로그를 암호화 백업하고 분리된 환경에서 복원할 수 있는지 확인합니다. (NFR-SEC-007, NFR-OPS-004, 가이드 11절)
쉬운 설명¶
DB·보호 파일·증명서 산출물·감사 로그를 암호화해 백업하고, 분리된 환경에서 실제로 복원되는지 확인합니다.
기술 스택¶
pg_dump/pg_restore(PostgreSQL 18), 파일 백업, 암호화(gpg 등 후보), cron 또는 systemd timer, 별도 테스트 환경.
예상 결과(산출물)¶
백업 스크립트, 보관·파기 정책, 복원 절차서와 복원 훈련 결과(권한·암호화 복구 포함).
개발 작업 상세¶
- 일일 백업 대상과 보관 위치(오프사이트 포함)를 정한다.
- 백업을 암호화하고 암호화 키는 DB 백업과 별도 위치·권한에 둔다.
- 분리된 환경에서 복원해 앱 동작·권한·암호화 복구를 확인한다.
- RPO/RTO(복구 목표)를 대학과 확정한 값으로 기록한다(00-04 입력 필요).
완료 기준¶
- 복원 훈련이 성공했고 결과가 기록되었다(인수 테스트 8).
충돌 방지(소유 범위)¶
deploy/backup/ 폴더는 성용 소유.
선행·후행·위험¶
선행: 04-03 Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정(성용, 11/25 종료)
후행: 04-06 운영 매뉴얼·장애 대응표·배포 인수(성용) / 15-04 인수 체크리스트·운영 인계(최종)(우섭)
위험: 대학의 보존·RPO 정책 미확정 시 임시 값 사용.
결과 확인 방법¶
"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.
- 복원 훈련이 성공했고 결과가 기록되었다(인수 테스트 8).
- 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.
갱신 사항 (2026-11-04)¶
- pg_dump/pg_restore 클라이언트 버전은 PostgreSQL 18과 일치시킨다.
시작 전 준비¶
- 00-01·00-03 결정 내용과 팀 비밀 저장소(접속 정보 보관 위치)를 확인한다.
- 개발 가이드 7~9절을 읽는다.
- 서버 비밀번호·키·토큰은 일감, 저장소, 채팅에 적지 않는다.
작업 진행 순서¶
- "개발 작업 상세"를 순서대로 진행하며 각 단계의 명령과 결과를 기록한다.
- 한 단계가 끝날 때마다 "완료 기준"의 확인 항목을 점검한다.
- 설정 파일은 저장소에 올리고, 비밀 값은 비밀 저장소(GitHub Secrets 등)에만 둔다.
- PR로 올려 소유자 리뷰를 받고, 서버 작업 내용은 일감 메모에 남긴다.
막힐 때 확인¶
백업 암호 키는 서버와 다른 곳에 보관하세요. 복원 시간과 절차를 기록하세요.
그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.
용어 풀이¶
- 감사 로그: 누가 언제 무엇을 했는지 남기는 변경 불가 기록입니다. 문제가 생겼을 때 추적하는 근거가 됩니다.
- 암호화·키 관리: 데이터를 열쇠(키) 없이는 읽을 수 없게 바꾸는 일과, 그 키를 안전하게 보관·교체하는 일입니다. 키는 코드와 따로 보관합니다.
성양 Updated by 성용 양 19 days ago
- Precedes Feature #1302: [MDGU-15-04] 인수 체크리스트·운영 인계(최종) added
성양 Updated by 성용 양 14 days ago
- Due date changed from 12/25/2026 to 11/23/2026
- Start date changed from 12/24/2026 to 11/20/2026
- Follows Feature #1265: [MDGU-04-03] Dockerfile·Compose·/health/·Gunicorn·Nginx 연결·운영 설정 added
성양 Updated by 성용 양 14 days ago
- Precedes Feature #1268: [MDGU-04-06] 운영 매뉴얼·장애 대응표·배포 인수 added
성양 Updated by 성용 양 8 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 60
2026-11-09 진행 기록 (04-05 암호화 백업·복원)
[한 일]
- GitHub PR #15 생성(브랜치 feature/1267-encrypted-backup, 머지 전).
- deploy/backup/backup.sh: 학사 DB·개인정보 DB를 각각 다른 파일로 pg_dump → 바로 gpg 공개키 암호화. 평문 덤프 파일 없음, 비밀번호 미사용. 행 수·테이블/기본 권한·체크섬·manifest 기록, backup_ref 출력.
- deploy/backup/restore.sh: 체크섬 확인, 빈 DB에만 복원(이름 이중 확인), 기본 권한 정리+복원을 한 트랜잭션으로 적용, 행 수·권한 비교.
- deploy/backup/README.md: 키 관리(서버에는 공개키만, 개인키는 담당자 2명이 서버와 다른 곳에 보관), 교체·분실·유출 대응, 복원 훈련 절차와 기록 형식. systemd 일일 타이머 예시.
[확인한 것] — 로컬 Docker 복원 훈련(합성 데이터·테스트 값·훈련 전용 키)
- compose.prod.yml의 PostgreSQL 18.6 db를 원본·복원 두 벌로 띄워 운영과 같은 compose 모드로 백업→복원.
- 1차 훈련에서 문제 발견: 복원 대상의 초기 기본 권한이 붙어 감사 로그 테이블의 app 계정 UPDATE·DELETE 권한이 되살아남(권한 비교가 실패로 잡음). 대상 기본 권한을 먼저 비우고 한 트랜잭션으로 복원하도록 수정.
- 2차 훈련: 학사·개인정보 DB 모두 restore: ok (행 수·테이블 권한·기본 권한 일치, 각 1초 이내). app 계정의 감사 로그 UPDATE·DELETE 거부, 개인정보 DB 접속 거부, 비어 있지 않은 DB 재복원 거부, 암호문에 평문 없음 확인.
- pytest 52개·ruff·migration 검사 통과. 훈련 컨테이너·볼륨·키는 삭제.
[못 확인한 것]
- 실서버 백업 타이머·실서버 복원 훈련(04-01 서버 구축 이후).
- 복원 DB에 Django 앱 연결 확인, 암호화 필드 복호화 확인(02-03 #1255 이후).
[남은 일]
- PR #15 CI 확인·리뷰(배포 가이드 11절 링크 한 줄은 우섭 리뷰)·머지.
- 보호 파일 백업 추가(12-01 #1290에서 저장 위치 확정 후).
- 보존 기간·오프사이트 보관·RPO/RTO 확정(대학·#1245 결정 대기, 그 전에는 자동 삭제 없음).
- 백업 개인키 담당자 2명과 보관처 지정(대학 승인).
성양 Updated by 성용 양 8 days ago
- % Done changed from 60 to 70
2026-11-09 진행 기록: PR #15 머지
[한 일]
- GitHub PR #15 스쿼시 머지(main 40c8a92). 리뷰 반영 포함: 복원 COMMIT을 복호화·변환 성공 뒤에만 보냄, backup.sh·restore.sh 실행 권한(100755), CI 테스트 스텁 실행 권한.
[확인한 것]
- GitHub Actions CI 통과, Codex 리뷰 지적 3건 수정·스레드 해결.
- PostgreSQL 18 컨테이너 재훈련: 개인키 없이 복원하면 중단되고 대상 DB 불변(기본 권한 유지, 테이블 0개), 개인키로 복원하면 restore: ok, 감사 로그 테이블 app 계정 UPDATE 거부 유지.
[못 확인한 것]
- 실서버 백업 타이머·실서버 복원 훈련(서버 정보 수령 후).
- 복원 DB에 Django 앱 연결, 암호화 필드 복호화(02-03 #1255 이후).
[남은 일]
- 서버에 공개키·systemd 타이머 설치, 실서버 복원 훈련 1회와 기록.
- 보호 파일 백업(12-01 #1290 이후), 보존 기간·오프사이트·RPO/RTO 확정, 개인키 담당자 2명 지정.
성양 Updated by 성용 양 7 days ago
- % Done changed from 70 to 80
[성용] 진행 기록 (2026-11-11)
[한 일]
- 첫 운영 migration 전에 학사 DB 암호화 백업 생성. backup_ref: 20261111T004812Z-pre-migrate (약 45KB). 백업 파일은 서버 백업 경로에 보관.
- 백업 암호·DB 관리자 비밀번호는 문서·일감에 기록하지 않음.
[남은 일]
- Cloud SQL 구성 기준 실서버 복원 훈련 1회와 결과 기록(완료 기준).
- 매일 백업 타이머 설치, 개인정보 DB 백업 포함 여부 확정.
- 보존 기간·오프사이트 보관·RPO/RTO, 백업 개인키 담당자 2명 지정(대학·#1245 결정).
성양 Updated by 성용 양 7 days ago
[성용] 첫 운영 백업 방식 기록 (2026-11-11, 서버 root history 기준, 비밀값 없음)
[임시 수동 백업 20261111T004812Z-pre-migrate]
- 대상: 학사 DB g_dts만 (개인정보 DB 미포함). 접속: Cloud SQL 관리자 postgres, PGSSLMODE=require. 비밀번호·백업 암호는 read -s로 입력해 history에 남지 않음.
- 덤프: 임시 postgres:18-alpine 컨테이너의 pg_dump --format=custom
- 암호화: 파이프로 바로 openssl enc (gpg 아님). 평문 덤프 파일 없음.
docker run --rm -e PGHOST -e PGPORT -e PGUSER -e PGPASSWORD -e PGSSLMODE=require postgres:18-alpine \
pg_dump --format=custom --no-password --dbname=<DB 이름> \
| openssl enc -aes-256-cbc -salt -pbkdf2 -iter 200000 -pass env:backup_pass -out <backup_dir>/default.dump.enc
(실제 실행 때는 접속 값을 -e 인자에 값째로 붙여 넘김)
- 생성 직후 검증: 복호화 → pg_restore --list → default.contents. 함께 manifest(backup_ref·생성 시각·DB·git SHA d419824), SHA256SUMS 생성, umask 077·폴더 700.
- 복호화 명령(운영 매뉴얼 4.1.1): openssl enc -d -aes-256-cbc -md sha256 -pbkdf2 -iter 200000 -pass env:backup_pass -in default.dump.enc -out <메모리 경로>/default.dump
(-md는 생성 때 지정하지 않아 OpenSSL 기본값 사용. 서버 OpenSSL 3 기본은 sha256이므로 명시)
[한계]
- AES-256-CBC라 메시지 인증 없음(변조 탐지 불가). SHA256SUMS는 우연한 손상만 탐지.
- 대칭 암호(암호 하나에 의존), 관리자 계정 사용, 관리자 비밀번호가 실행 중 프로세스 목록에 보일 수 있음.
- 실제 DB 복원 시험 안 함. 이 백업은 첫 migration 전 임시 안전장치이며, 완전한 운영 백업 체계로 기록하지 않음.
[확인 필요]
- default.contents가 비어 있지 않은지: wc -l <backup_dir>/default.contents (0줄이면 이 백업은 사용 불가)
- file·od 결과가 history와 맞는지: 첫 8바이트 53 61 6c 74 65 64 5f 5f(Salted__)
- 서버 openssl version 기록
[정식 방식으로 전환할 일 — deploy/backup/backup.sh direct 모드]
- 서버에 GPG 공개키 설치, 개인키는 서버와 분리 보관(담당 2명)
- PostgreSQL 18 클라이언트 준비: 서버에 다른 사이트용 PostgreSQL 17이 있어 기본 pg_dump가 17이면 Cloud SQL 18을 덤프하지 못함(pg_dump --version 확인, 필요 시 PG_DUMP·PSQL 지정)
- Cloud SQL용 환경변수(PGHOST·PGSSLMODE=require 등, 비밀번호는 명령줄에 쓰지 않음), 접속 계정은 관리자 대신 migration 계정 검토
- default·pii 백업 실행, manifest·체크섬 확인
- 분리된 환경에서 실제 복원 시험(운영 매뉴얼 4.4절)
- 정기 실행 타이머와 보존 정책
운영 매뉴얼(deploy/OPERATIONS.md 4.1.1·4.4·7절)과 deploy/README.md에 같은 내용 반영(브랜치 docs/1268-ops-manual-cloudsql, PR 전).
성양 Updated by 성용 양 7 days ago
[성용] 첫 임시 백업 재검증 결과 (2026-11-11)
서버에서 실행(평문을 디스크에 쓰지 않음):
- sha256sum -c SHA256SUMS → default.dump.enc / default.contents / manifest 모두 OK
- openssl enc -d -aes-256-cbc -md sha256 -pbkdf2 -iter 200000 -pass env:backup_pass -in default.dump.enc | (postgres:18-alpine) pg_restore --list → default.contents와 일치("목록 일치")
- 확인 값: 첫 8바이트 Salted__, default.contents 131줄(약 9.9KB), 서버 OpenSSL 3.0.13, 백업에 쓴 pg_dump 18.6(Cloud SQL 18.3)
판정: 복호화 옵션과 보관 중인 백업 암호가 맞음을 확인. "복호화·목록 검증까지 완료된 암호화 백업, 실제 복원 시험 대기".
실제 DB 복원 시험 전에는 "복구 가능한 백업으로 최종 검증 완료"로 기록하지 않음.
추가 확인: 서버 기본 pg_dump는 17.11 → backup.sh direct 모드 전환 때 /usr/bin/pg_dump를 쓰지 않고 PostgreSQL 18 클라이언트(PG_DUMP·PSQL) 또는 18 컨테이너 방식 필요.
성양 Updated by 성용 양 6 days ago
- % Done changed from 80 to 90
[성용] 진행 기록 (2026-11-11) — 백업 구축·검증 완료 / 실제 DB 복원 훈련 보류
[한 일]
- PostgreSQL 18 백업 환경: VPS에 PostgreSQL 18 클라이언트 설치(기존 17 클라이언트 유지). Cloud SQL 학사 DB·개인정보 DB 각각 접속과 스키마 덤프 검증 성공
- GPG: MDGU 전용 키 생성. 공개키를 운영 서버
/etc/university-backup/backup-public.asc에 등록, 개인키는 운영 서버와 분리 보관. 서버 공개키 암호화 → Windows 개인키 복호화 테스트 성공 - 수동 백업:
deploy/backup/backup.shdirect모드로 학사 DB·개인정보 DB 백업 생성(DB별 접속 계정·실행 분리). SHA-256 검증 성공, 백업 폴더 700·파일 600·소유자 root 확인 - 외부 보관: 두 DB 백업을 별도 GPG 암호화 아카이브로 묶어 Google Drive에 수동 보관, 재다운로드 후 SHA-256 일치 확인. 개인키는 외부 백업 파일과 분리 보관
- 자동 백업: Cloud SQL 전용 실행기
/usr/local/sbin/mdgu-backup-daily.py,mdgu-backup.service·mdgu-backup.timer등록. 두 DB를 각각 GPG로 암호화. systemd 수동 실행 성공, 매일 02:30~02:35 KST 타이머 활성화 - 기존 환경 보호: 기존 OpenSSL 백업 보존, Cloud SQL 데이터·dbresting.com·Nginx·공유 Docker 환경 변경 없음
- 문서: 운영 매뉴얼 4.1.1절 등을 direct 모드 기준으로 갱신(PR #32, #1268)
[남은 것]
- 스테이징 환경에서 실제 DB 복원·권한 검증(스테이징 담당자 복귀 후)
- 자동 백업 첫 예약 실행·장기 안정성·실패 감지 검증
- VPS 전용 자동 실행기의 Git 관리·재배포 절차
- 백업 보존·파기 정책, 대학 인계 시 외부 저장소·키 관리 책임 확정
비고: 실제 학생 개인정보가 없는 개발 단계라 현행 자동 GPG 백업 + 수동 외부 보관을 유지. 정식 운영 인계 전에 백업 정책과 복원 절차를 별도 승인받음.
성양 Updated by 성용 양 6 days ago
[성용] 진행 기록 (2026-11-11)
- PR #35 병합(https://github.com/GilbertMoon/university-academic-system/pull/35): 운영 VPS에만 있던 Cloud SQL 자동 백업 실행기를
deploy/backup/mdgu-backup-daily.py로 Git 관리. 저장 경로(BACKUP_DIR)는/etc/university-backup/backup.env설정으로 분리해 학교 저장소 교체 시 한 줄만 변경. Cloud SQL용 서비스 예시·재배포 절차(backup/README 3.1절)·테스트 4개 - 운영 설치본 교체는 아직 하지 않음(승인 후 재배포)
[남은 것] 저장소 관리 실행기 운영 반영·정기 실행 확인, 스테이징 실제 복원 훈련, 보존·파기 정책, 인계 시 저장소·키 관리 책임