Project

General

Profile

Actions

Feature #913

open
길문 수황

Feature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축

Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증

[INT-08] Auth / Security / Operations — 권한·비밀정보·감사·비용·복구 검증

Feature #913: [INT-08] Auth / Security / Operations — 권한·비밀정보·감사·비용·복구 검증

Added by 길래 문 22 days ago. Updated 22 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
02/24/2027
Due date:
03/02/2027 (Due in about 4 months)
% Done:

0%

Estimated time:

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 파일 입력 및 경로 보안

다음 사항을 검증한다.

  1. Path Traversal 차단
  2. Symbolic Link를 통한 비허용 경로 접근 차단
  3. 허용된 파일 확장자·크기·형식 검증
  4. 위험하거나 비정상적인 DXF/문서 입력 처리
  5. 원본과 Candidate 출력 경로 분리
  6. 미승인 Authorized Delta 적용 차단
  7. 출력 파일 이름 충돌 방지
  8. 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. 보안 및 오류 테스트

다음 시나리오를 검증한다.

  1. 인증되지 않은 사용자 요청
  2. 권한 없는 Source 접근
  3. 권한 없는 CAD 다운로드
  4. 권한 없는 Knowledge 승인
  5. 철회된 승인정보 사용
  6. 만료된 OAuth Token
  7. Path Traversal
  8. 비허용 파일 경로 접근
  9. 고객 CAD 외부 전송 승인 누락
  10. APS Budget Limit 초과
  11. 비승인 Authorized Delta
  12. 중복 실행 및 재시도
  13. Source Revision 변경
  14. 비밀정보가 로그에 포함되는 경우

STEP 11. 보안·운영 정책 문서 작성

예상 산출물:

  • auth_security_operations_policy.md
  • security_test_matrix.csv
  • access_control_matrix.csv
  • audit_log_schema.json
  • budget_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. 제출 산출물

  1. 인증 및 최소 권한 정책
  2. 사용자·관리자·설계 전문가 접근 제어
  3. Source·CAD·Knowledge 접근권한 매트릭스
  4. 인증정보 및 Token 보호 정책
  5. 감사 로그 Schema 및 실행 Evidence
  6. Autodesk APS 비용·Quota·외부 전송 Gate
  7. 장애 복구 및 재실행 보안 검증 결과
  8. Security Golden Fixture 및 pytest 결과
  9. 보안·운영 정책 문서
  10. INT-09/10 인계 자료
  11. 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

전체 통합 계획

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-team-knowledge-integration-plan-20261025.md

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 동작, 회귀 테스트, 성능 및 사용자 인수 테스트를 수행한다.

길문 Updated by 길래 문 22 days ago Actions #1

  • Assignee changed from 상재 이 to 수아 황
Actions

Also available in: PDF Atom