146 lines
6 KiB
Markdown
146 lines
6 KiB
Markdown
# AA 역할 레거시 분석 감사 추적 문서
|
|
|
|
**문서 ID**: AUDIT-ROLE-AA-001
|
|
**버전**: 1.0
|
|
**작성일**: 2026-07-14
|
|
**분석 대상**: role-aa
|
|
**문서 유형**: Smoke Analysis Report
|
|
|
|
---
|
|
|
|
## 1. 개요
|
|
|
|
본 문서는 AA 역할(ROLE-AA)의 레거시 전환 분석을 위한 감사 추적 보고서이다. 입력 소스, 업무 규칙, 위험 영역, 증적 위치를 체계적으로 식별하고 문서화한다.
|
|
|
|
---
|
|
|
|
## 2. 입력 소스 (Input Sources)
|
|
|
|
| ID | 소스 유형 | 소스 명칭 | 위치 | 마지막 갱신 | 신뢰도 |
|
|
|----|----------|----------|------|------------|--------|
|
|
| IS-001 | 데이터베이스 | role_master_table | /db/role/role_master | 2026-06-30 | 높음 |
|
|
| IS-002 | 설정 파일 | aa_role_config.xml | /config/role/aa_role_config.xml | 2026-07-01 | 높음 |
|
|
| IS-003 | API 문서 | AA_Role_API_Spec | /docs/api/aa-role-api.yaml | 2026-06-15 | 중간 |
|
|
| IS-004 | 스키마 | role_permission_schema | /schema/role_permission.xsd | 2026-05-20 | 높음 |
|
|
| IS-005 | 로그 | aa_audit_log | /logs/audit/aa_*.log | 2026-07-14 | 높음 |
|
|
|
|
---
|
|
|
|
## 3. 업무 규칙 (Business Rules)
|
|
|
|
### 3.1 역할 생성 규칙
|
|
|
|
| 규칙 ID | 규칙 설명 | 조건 | 결과 | 우선순위 |
|
|
|---------|----------|------|------|----------|
|
|
| BR-001 | AA 역할 생성 시 최소 권한 부여 | role_type = 'AA' AND user_level >= 3 | 기본 권한 세트 자동 할당 | 높음 |
|
|
| BR-002 | 중복 역할 방지 | 동일한 user_id에 동일한 role_id 존재 시 | 오류 반환 (ERR_DUP_ROLE) | 높음 |
|
|
| BR-003 | 역할 만료 관리 | expiration_date < 현재일 | 역할 자동 비활성화 | 중간 |
|
|
|
|
### 3.2 권한 검증 규칙
|
|
|
|
| 규칙 ID | 규칙 설명 | 조건 | 결과 | 우선순위 |
|
|
|---------|----------|------|------|----------|
|
|
| BR-004 | AA 역할 권한 범위 | permission_level <= 5 | 접근 허용 | 높음 |
|
|
| BR-005 | 감사 로그 필수 기록 | 모든 AA 역할 操作 | 로그 테이블 INSERT | 높음 |
|
|
| BR-006 | 역할 위임 제한 | delegator_role = 'AA' AND delegate_role = 'ADMIN' | 위임 거부 | 중간 |
|
|
|
|
### 3.3 데이터 무결성 규칙
|
|
|
|
| 규칙 ID | 규칙 설명 | 조건 | 결과 | 우선순위 |
|
|
|---------|----------|------|------|----------|
|
|
| BR-007 | 참조 무결성 | role_id 삭제 시 | 관련 permission 레코드 CASCADE 삭제 | 높음 |
|
|
| BR-008 | 변경 이력 추적 | 모든 role 수정 | audit_history 테이블 기록 | 높음 |
|
|
|
|
---
|
|
|
|
## 4. 위험 영역 (Risk Areas)
|
|
|
|
### 4.1 높은 위험 (High Risk)
|
|
|
|
| 위험 ID | 위험 설명 | 영향 | 발생 가능성 | 완화 조치 |
|
|
|---------|----------|------|-------------|----------|
|
|
| RA-001 | 역할 권한 상승 공격 | 비인가 데이터 접근 | 중간 | 다단계 인증 구현 |
|
|
| RA-002 | 레거시 인증 우회 | 시스템 침입 | 낮음 | 레거시 API 폐기 계획 |
|
|
| RA-003 | 권한 불일치 상태 | 데이터 불일치 | 중간 | 주기적 정합성 검사 |
|
|
|
|
### 4.2 중간 위험 (Medium Risk)
|
|
|
|
| 위험 ID | 위험 설명 | 영향 | 발생 가능성 | 완화 조치 |
|
|
|---------|----------|------|-------------|----------|
|
|
| RA-004 | 동시성 제어 부재 | 데이터 손상 | 낮음 | 낙관적 잠금 적용 |
|
|
| RA-005 | 감사 로그 누락 | 규정 위반 | 중간 | 로그 전송 확인机制 |
|
|
| RA-006 | 역할 만료 처리 지연 | 접근 제어 공백 | 중간 | 스케줄러 최적화 |
|
|
|
|
### 4.3 낮은 위험 (Low Risk)
|
|
|
|
| 위험 ID | 위험 설명 | 영향 | 발생 가능성 | 완화 조치 |
|
|
|---------|----------|------|-------------|----------|
|
|
| RA-007 | 설정 파일 형식 오류 | 서비스 시작 실패 | 낮음 | 스키마 검증 |
|
|
| RA-008 | 문서 불일치 | 유지보수 어려움 | 중간 | 자동 문서 생성 |
|
|
|
|
---
|
|
|
|
## 5. 증적 위치 (Evidence Locations)
|
|
|
|
### 5.1 역할 정의 증적
|
|
|
|
| 위치 ID | 위치 경로 | 설명 | 접근 권한 |
|
|
|---------|----------|------|----------|
|
|
| EL-001 | /db/role/role_master | 역할 마스터 테이블 | DBA, Auditor |
|
|
| EL-002 | /db/role/role_permission | 권한 매핑 테이블 | DBA, Auditor |
|
|
| EL-003 | /config/role/aa_role_config.xml | 역할 설정 파일 | Admin, Auditor |
|
|
|
|
### 5.2 감사 로그 증적
|
|
|
|
| 위치 ID | 위치 경로 | 설명 | 보존 기간 |
|
|
|---------|----------|------|----------|
|
|
| EL-004 | /logs/audit/aa_create.log | 역할 생성 로그 | 7년 |
|
|
| EL-005 | /logs/audit/aa_modify.log | 역할 수정 로그 | 7년 |
|
|
| EL-006 | /logs/audit/aa_delete.log | 역할 삭제 로그 | 7년 |
|
|
| EL-007 | /logs/audit/aa_access.log | 접근 시도 로그 | 3년 |
|
|
|
|
### 5.3 변경 이력 증적
|
|
|
|
| 위치 ID | 위치 경로 | 설명 | 접근 권한 |
|
|
|---------|----------|------|----------|
|
|
| EL-008 | /db/audit/role_audit_history | 역할 변경 이력 테이블 | Auditor |
|
|
| EL-009 | /db/audit/permission_audit_history | 권한 변경 이력 테이블 | Auditor |
|
|
| EL-010 | /version/role-aa/changelog.md | 역할 변경 이력 문서 | All |
|
|
|
|
### 5.4 테스트 증적
|
|
|
|
| 위치 ID | 위치 경로 | 설명 | 테스트 유형 |
|
|
|---------|----------|------|-------------|
|
|
| EL-011 | /test/role-aa/unit | 단위 테스트 | Unit |
|
|
| EL-012 | /test/role-aa/integration | 통합 테스트 | Integration |
|
|
| EL-013 | /test/role-aa/security | 보안 테스트 | Security |
|
|
|
|
---
|
|
|
|
## 6. 의존성 매트릭스
|
|
|
|
| 역할 | 의존 역할 | 의존 유형 | 전환 영향도 |
|
|
|------|----------|----------|-------------|
|
|
| ROLE-AA | ROLE-BASE | 상속 | 높음 |
|
|
| ROLE-AA | ROLE-USER | 위임 | 중간 |
|
|
| ROLE-AA | ROLE-AUDITOR | 참조 | 낮음 |
|
|
|
|
---
|
|
|
|
## 7. 전환 체크리스트
|
|
|
|
- [ ] 입력 소스 데이터 마이그레이션 계획 수립
|
|
- [ ] 업무 규칙 호환성 검증 완료
|
|
- [ ] 위험 영역 보안 감사 완료
|
|
- [ ] 증적 위치 접근 권한 검증 완료
|
|
- [ ] 롤백 계획 수립 및 테스트 완료
|
|
|
|
---
|
|
|
|
## 8. 결론
|
|
|
|
본 감사 추적 문서는 AA 역할 레거시 전환 분석에 필요한 모든 요소를 식별하고 문서화하였다. 높은 위험 영역(RA-001 ~ RA-003)에 대한 완화 조치를 우선적으로 적용하고, 모든 증적 위치를 안전하게 보관하여 규정 준수 및 감사 준비를 완료해야 한다.
|
|
|
|
---
|
|
|
|
**문서 종료**
|