Feature #913
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[INT-08] Auth / Security / Operations — 권한·비밀정보·감사·비용·복구 검증
0%
Description
INT-08. Auth / Security / Operations — 권한·비밀정보·감사·비용·복구 검증¶
1. 작업 개요¶
본 작업은 ICN Solar CAD Agent의 사용자·관리자 기능, MCP 서버, CAD Backend 및 Engineering Knowledge 시스템에 대한 인증·접근권한·데이터 보호·감사로그·비용 통제·운영 복구 정책을 통합 검증하는 작업이다.
INT-07의 사용자 Workflow, INT-05의 CAD Backend 및 INT-04의 장애 복구 정책을 연결한다.
핵심 목표는 고객 설계자료와 승인되지 않은 CAD 변경을 보호하고, 시스템의 모든 중요한 작업을 안전하고 추적 가능한 방식으로 수행하는 것이다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/174
상위 Redmine 일감: #867
담당: 이상재
PM 및 검토: 문길래
협력: 황수아, 조영우
계획 기간: 2027-02-24 ~ 2027-03-02
2. 세부 작업¶
STEP 1. 시스템 보안 및 권한 구조 조사¶
- 사용자·관리자·설계 전문가 역할 조사
- MCP Client 및 Server의 신뢰 경계 확인
- Source Manager와 CAD Backend 권한 구조 검토
- Engineering Knowledge 승인 정책 확인
- 기존 인증 및 파일 접근 제어 구현 조사
- 단일 사용자 로컬 MVP와 향후 다중 사용자 환경 구분
STEP 2. 사용자·관리자 권한 모델 정의¶
| 역할 | 주요 권한 |
|---|---|
| 일반 사용자 | 허용된 Source 및 설계 결과 조회·실행 |
| 프로젝트 관리자 | 프로젝트·실행 이력·오류·검토 대상 관리 |
| 설계 전문가 | 권한 범위 내 설계 규칙 및 결과 검토·승인 |
| 시스템 운영자 | 시스템 설정·로그·운영 상태 관리 |
| MCP Service | 명시적으로 허용된 Tool과 리소스 접근 |
승인 권한과 일반 실행 권한을 구분하며, 서버에서 실제로 권한을 검사한다.
STEP 3. Source 및 CAD 파일 접근권한 검증¶
- Source ID 기반 접근권한 확인
- Source SHA·Revision 검증
- 프로젝트별 파일 접근 범위 확인
- 원본 DWG/DXF 파일 읽기 권한 관리
- Candidate CAD 파일 조회·다운로드 권한 관리
- Evidence 및 BOQ 문서 접근 제어
- 다른 프로젝트의 파일 접근 차단
- 원본 파일 덮어쓰기 방지
STEP 4. Engineering Knowledge 승인 보안¶
- Rule 등록·승인·철회 권한 구분
- 승인자 및 승인 이력 확인
- Rule ID 및 Version 불변성 검증
- 미승인 규칙의 실제 Solver 적용 차단
- 철회·대체된 규칙의 사용 차단
- 승인 기록 위변조 방지
- Human Decision Evidence 기록
STEP 5. API 인증정보 및 비밀정보 관리¶
- APS OAuth 인증정보 관리
- Client ID 및 Client Secret 보호
- Access Token·Refresh Token 관리
- 환경변수 또는 승인된 Secret Manager 활용
- GitHub 비밀정보 커밋 방지
- 로그·보고서의 비밀정보 마스킹
- 토큰 만료·회수·교체 절차
- 인증정보 접근권한 제한
STEP 6. CAD 파일 입력 및 경로 보안¶
다음 사항을 검증한다.
- Path Traversal 차단
- Symbolic Link를 통한 비허용 경로 접근 차단
- 허용된 파일 확장자·크기·형식 검증
- 위험하거나 비정상적인 DXF/문서 입력 처리
- 원본과 Candidate 출력 경로 분리
- 미승인 Authorized Delta 적용 차단
- 출력 파일 이름 충돌 방지
- Source·Candidate SHA 추적
STEP 7. 감사 로그 및 실행 이력 구축¶
예상 산출물: audit_log_schema.json
주요 필드:
- Audit Event ID
- Actor ID / Role
- Action
- Run ID / Request ID
- Project / Site ID
- Source ID / Revision
- Rule ID / Version
- CAD Candidate ID
- Authorization Decision
- Execution Result
- Timestamp
- Evidence Locator
- Error / Warning
감사 로그는 변경·승인·조회·실행 등 주요 작업을 추적하되 인증정보와 민감한 고객자료를 노출하지 않는다.
STEP 8. Autodesk APS 비용 및 외부 전송 Gate¶
- APS API별 접근 승인 확인
- 고객 CAD 파일 전송 허용 여부 검증
- 무료·유료 API 구분
- API 사용량 및 Quota 관리
- 월간 Budget Limit 설정
- 예상 비용과 실제 비용 구분
- 한도 초과 시 실행 중단
- 승인되지 않은 유료 호출 차단
- API 실패 시 안전한 로컬 Fallback 정책 검증
STEP 9. 운영 장애 및 복구 정책 연결¶
INT-04의 복구 정책을 통합한다.
- MCP 서버 장애 처리
- 실행 Timeout 및 Retry
- 중복 Request 차단
- Authorized Delta 중복 적용 방지
- Source·Rule 승인 재검증
- 중간 산출물 격리
- 기존 승인 결과 보호
- 장애 발생 시 감사 로그 기록
- 서비스 재시작 후 상태 복구 확인
실제 운영환경의 백업·롤백·배포 시연은 INT-10에서 수행한다.
STEP 10. 보안 및 오류 테스트¶
다음 시나리오를 검증한다.
- 인증되지 않은 사용자 요청
- 권한 없는 Source 접근
- 권한 없는 CAD 다운로드
- 권한 없는 Knowledge 승인
- 철회된 승인정보 사용
- 만료된 OAuth Token
- Path Traversal
- 비허용 파일 경로 접근
- 고객 CAD 외부 전송 승인 누락
- APS Budget Limit 초과
- 비승인 Authorized Delta
- 중복 실행 및 재시도
- Source Revision 변경
- 비밀정보가 로그에 포함되는 경우
STEP 11. 보안·운영 정책 문서 작성¶
예상 산출물:
auth_security_operations_policy.mdsecurity_test_matrix.csvaccess_control_matrix.csvaudit_log_schema.jsonbudget_gate_report.md
실제 경로는 레포지토리 구조에 맞춰 결정한다.
STEP 12. GitHub 반영 및 결과 제출¶
- 서버 측 인증·권한 검증
- Source 및 파일 접근 제어 테스트
- 비밀정보 보호 및 마스킹 검증
- 감사 로그·비용 Gate 연계
- Golden Security Fixture 및 pytest 테스트
- 장애·복구 관련 회귀 테스트
- Windows PowerShell 실행 가이드 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
- INT-09 및 INT-10에 보안·운영 검증 결과 인계
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 이상재 | 인증·권한·CAD/MCP 보안 및 운영 기능 |
| 황수아 | Source ACL·Knowledge 승인·Evidence 보안 |
| 조영우 | Solver·Candidate·재실행 및 결과 접근권한 검증 |
| 문길래 | 보안·비용 승인 기준 및 GitHub PR 최종 검토 |
4. 제출 산출물¶
- 인증 및 최소 권한 정책
- 사용자·관리자·설계 전문가 접근 제어
- Source·CAD·Knowledge 접근권한 매트릭스
- 인증정보 및 Token 보호 정책
- 감사 로그 Schema 및 실행 Evidence
- Autodesk APS 비용·Quota·외부 전송 Gate
- 장애 복구 및 재실행 보안 검증 결과
- Security Golden Fixture 및 pytest 결과
- 보안·운영 정책 문서
- INT-09/10 인계 자료
- GitHub PR 및 PM 검토 결과
5. 완료 기준 (PASS)¶
- 시스템 신뢰 경계 및 역할별 권한 정의
- 사용자·관리자 서버 측 권한 검증
- 비허용 Source·CAD·Evidence 접근 차단
- Knowledge 승인·철회 권한 검증
- Authorized Delta 승인 범위 보호
- Client Secret·Token·API Key 노출 방지
- Path Traversal 및 비허용 파일 접근 차단
- Source SHA 및 Revision 무결성 유지
- 감사 로그 및 Evidence 추적 가능
- 고객 CAD 외부 전송 승인 Gate
- APS 비용·Quota 제한 검증
- 승인 없는 유료 API 호출 0건
- Timeout·Retry·복구 안전성 확인
- 중복 실행 및 출력 중복 방지
- Security Negative Test PASS
- 비밀정보가 로그·보고서에 포함되지 않음
- 개발자별 교차검토
- GitHub PR 제출 및 PM 검토
- main 병합 및 후속 INT 단계 인계 완료
6. 개발 및 검증 원칙¶
- 사용자의 화면 접근 제한만으로 보안을 구현했다고 판단하지 않는다.
- 모든 핵심 승인과 파일 접근은 서버 측에서 검증한다.
- Source·Knowledge·CAD Candidate 권한을 구분한다.
- 원본 DWG/DXF 및 기존 승인 산출물을 보호한다.
- 인증정보와 고객자료를 GitHub·로그에 노출하지 않는다.
- 비용 승인 없이 Autodesk APS 유료 API를 호출하지 않는다.
- 고객 도면을 승인 없이 외부 클라우드에 전송하지 않는다.
- 장애 복구 과정에서도 승인·보안 Gate를 우회하지 않는다.
- 테스트 및 기술 검증 결과를 실제 운영 보안 승인과 구분한다.
7. 참고 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/174
전체 통합 계획
INT-05 CAD Backend
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/171
INT-07 User Workflow / Admin
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/173
8. 후속 작업¶
INT-09 — E2E / Regression / Performance / UAT
INT-08에서 확인한 권한·보안·비용·복구 정책을 포함하여 전체 시스템의 End-to-End 동작, 회귀 테스트, 성능 및 사용자 인수 테스트를 수행한다.