Project

General

Profile

Actions

Feature #903

open
길문 상이

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

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

[PoC-23] Autodesk APS 인증·API 비용·보안 검증

Feature #903: [PoC-23] Autodesk APS 인증·API 비용·보안 검증

Added by 길래 문 23 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
01/04/2027
Due date:
01/15/2027 (Due in 59 days)
% Done:

0%

Estimated time:

Description

PoC-23. Autodesk APS 인증·API 비용·보안 검증

1. 작업 개요

본 PoC는 Autodesk Platform Services(APS)를 ICN Solar CAD Agent 플랫폼에 연동하기 위한 인증, API 기능, 비용, 보안 및 실제 사용 가능성을 검증하는 작업이다.

현재 Python·ezdxf 기반 로컬 CAD 엔진과 FastMCP 서버를 중심으로 개발 중이며, Autodesk APS는 DWG 처리, 도면 변환, 자동화 및 시각화 기능을 보완할 수 있는 선택적 외부 서비스로 검토한다.

APS를 무조건 도입하는 것이 아니라, 로컬 엔진과 비교하여 실제로 필요한 기능과 추가적인 비용·보안 부담을 확인한 후 연동 여부를 결정한다.

GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/164

상위 Redmine 일감: #867

담당: 이상재

PM 및 검토: 문길래

협력: 황수아, 조영우

계획 기간: 2027-01-04 ~ 2027-01-15

2. 세부 작업

STEP 1. Autodesk APS 서비스 구조 조사

다음 서비스의 실제 제공 기능과 적용 가능성을 조사한다.

서비스 검토 내용
Authentication API 애플리케이션·사용자 인증
Data Management / OSS Autodesk 데이터 및 파일 접근·보관
Model Derivative API 지원되는 CAD 형식의 변환·시각화 데이터 생성
Automation API 지원 환경에서 CAD 작업 자동화
Viewer 웹 기반 모델·도면 시각화

각 서비스의 API 지원 범위, 입력·출력 형식, 요구사항 및 제약조건을 공식 문서로 확인한다.

STEP 2. APS 인증 방식 조사

다음 방식을 검토한다.

① Two-Legged OAuth (2LO)

  • 애플리케이션 단위 인증
  • 서버 간 API 호출에 적합한 사용 사례 확인
  • 애플리케이션이 허용받은 리소스 접근 범위 확인

② Three-Legged OAuth (3LO)

  • Autodesk 사용자 단위 인증
  • 사용자 동의 및 권한 범위 확인
  • 사용자별 프로젝트·파일 접근 처리

③ PKCE 및 Secure Service Account

  • 로컬 애플리케이션 인증에 적합한지 검토
  • 백엔드 자동화에 필요한 서비스 계정 적용 가능성 확인
  • 권한과 지원 서비스의 제약조건 검토

인증 방식은 API별 요구조건과 실제 데이터 접근 권한에 맞게 결정한다.

STEP 3. APS Developer Hub 및 테스트 앱 검토

  • APS 개발자 계정 및 Developer Hub 접근 확인
  • 테스트용 애플리케이션 생성 필요 여부 확인
  • App 유형 및 권한 범위 조사
  • Client ID 및 인증 정보 관리 방식 설계
  • 최소 API Scope 검토
  • 로컬 개발환경과 인증 설정 연결
  • 운영 계정과 테스트 계정 분리 방안 검토

Client Secret, Access Token 및 Refresh Token은 GitHub와 Redmine에 저장하지 않는다.

STEP 4. API 비용 및 사용량 정책 검증

다음 항목을 최신 공식 자료 기준으로 조사한다.

  • APS Free Tier 가입 및 사용 조건
  • API별 무료 사용량
  • 사용량 기반 과금 대상
  • 유료 서비스 전환 조건
  • 월별 API 사용량 확인 방법
  • 무료 한도 초과 시 동작
  • 호출 수·처리시간·변환 작업별 과금 기준
  • 결제 및 예산 제한 가능 여부

2026년 기준 APS는 Free/Paid 모델을 제공하며, 일부 API는 무료 월간 사용량 한도가 있는 과금 대상 서비스다.

주의: 실제 적용 요금과 한도는 API 및 계정 유형에 따라 달라질 수 있으므로 작업 시점의 공식 요율표를 확인한다.

STEP 5. 비용 통제 및 사용 승인 Gate 정의

다음 원칙을 적용한다.

  1. 무료 또는 비용이 발생하지 않는 검증 우선
  2. 유료 API 실행 전 PM 승인
  3. 자동 Paid Tier 전환 금지
  4. API 호출 범위 및 예상 사용량 기록
  5. 월간 사용량 및 비용 확인
  6. 무료 한도 초과 위험 시 실행 중단
  7. 승인되지 않은 반복 호출 차단
  8. 비용 발생 시 실행 Evidence 및 사용 목적 기록

API 사용 비용이 확인되지 않은 상태에서는 유료 호출을 수행하지 않는다.

STEP 6. 고객 CAD 도면 보안 및 데이터 관리 검토

  • DWG/DXF 외부 전송 필요 여부 확인
  • Autodesk 클라우드 저장 위치 및 처리 방식 조사
  • 고객 자료 외부 전송 승인 조건 확인
  • 파일 보관 및 삭제 정책 검토
  • API 접근 권한과 최소 권한 정책 검토
  • 로그에 포함될 수 있는 민감정보 확인
  • Source SHA 및 Revision 추적 방식 정의
  • 외부 서비스 장애 시 로컬 처리 전환 방안 검토

실제 인천공항 설계자료는 별도 승인 없이 APS에 업로드하지 않는다.

STEP 7. APS API 연결 검증

사전 승인된 개발자 계정과 테스트 환경이 있는 경우 다음을 검증한다.

  • 인증 토큰 발급
  • 최소 API 호출
  • API 응답 상태 확인
  • 권한 및 Scope 검증
  • 토큰 만료 처리
  • 인증 실패 처리
  • 호출 제한 및 오류 메시지 확인
  • 실행 로그 및 Evidence 기록

초기 검증에는 합성 테스트 데이터 또는 공개·사용 허가된 자료만 사용한다.

계정이나 인증정보 또는 사용 승인이 없다면 실제 연동 결과를 PASS로 표시하지 않는다.

STEP 8. 오류 및 예외 처리 검증

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

상황 검증 내용
401 Unauthorized 인증 실패
403 Forbidden 권한 부족
429 Too Many Requests 호출 제한
Expired Token 토큰 만료
Invalid Scope 권한 범위 오류
Missing Credential 인증정보 없음
API Unavailable 외부 서비스 장애
Usage Limit 무료 사용량 한도
Cost Approval Missing 유료 호출 승인 없음
Source Not Approved 고객 파일 업로드 승인 없음

STEP 9. APS와 로컬 CAD 엔진의 역할 구분

구분 로컬 CAD 엔진 Autodesk APS
DXF 분석 Python·ezdxf 지원 API별 확인
DXF 생성 Python·ezdxf 필요 기능별 지원 확인
DWG 처리 로컬 변환·도구에 의존 적합한 APS API 검토
시각화 로컬 Viewer/PDF Autodesk Viewer 등 검토
외부 전송 기본적으로 불필요 클라우드 이용 시 발생 가능
비용 자체 환경 운영비 서비스·사용량에 따라 추가 가능

최종 도입 여부는 기능, 정확도, 보안, 비용 및 운영 복잡도를 비교하여 판단한다.

STEP 10. 검증 보고서 작성

예상 산출물

  • aps_feasibility_report.md
  • auth_matrix.json
  • cost_security_gate.md

보고서에는 다음을 포함한다.

  • 조사한 API 및 기능
  • 인증 방식별 사용 조건
  • 확인된 무료·유료 정책
  • 보안 및 데이터 전송 위험
  • 실제 API 연동 결과
  • 미검증 항목
  • 도입 여부에 대한 권고
  • PoC-24에서 비교할 기능 및 테스트 조건

STEP 11. GitHub 반영 및 결과 제출

  • APS 기술 조사 및 검증 문서 작성
  • 필요 시 안전한 인증 테스트 코드 작성
  • 인증·오류 처리 테스트 작성
  • 비용·보안 Gate 문서화
  • 실제 API 실행 여부와 Mock 결과 구분
  • 실행 Evidence 및 제한사항 기록
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
이상재 Autodesk APS 조사, 인증·API 테스트, 비용·보안 기술 검증
황수아 고객 Source 접근 정책 및 Evidence 관리 검토
조영우 CAD Solver와 APS 연계 필요 기능 및 입력·출력 계약 검토
문길래 비용·보안·서비스 도입 판단 및 GitHub PR 검토

4. 제출 산출물

  1. Autodesk APS 서비스별 기능 조사 결과
  2. OAuth 인증 방식 및 권한 검토 자료
  3. Developer Hub 및 테스트 앱 설정 가이드
  4. Free/Paid Tier와 API 사용량 조사 결과
  5. API 비용 및 사용 승인 Gate
  6. 고객 CAD 도면 보안·데이터 전송 검토 보고서
  7. 인증 및 API 연결 테스트 Evidence
  8. 오류·권한·사용량 제한 테스트 결과
  9. aps_feasibility_report.md
  10. auth_matrix.json
  11. cost_security_gate.md
  12. PoC-24 비교 테스트 계약
  13. GitHub PR 및 PM 검토 결과

5. 완료 기준 (PASS)

  • APS 주요 CAD 관련 서비스 기능 및 한계 조사
  • 인증 방식별 적용 조건 확인
  • 최소 Scope 및 권한 정책 정의
  • 테스트 앱 및 인증정보 관리 방식 문서화
  • API별 무료·유료 정책 공식 근거 확인
  • 비용 발생 가능성 및 사용 승인 Gate 정의
  • 고객 도면 외부 전송·보관 위험 검토
  • 승인된 테스트 환경에서 최소 인증·호출 검증
  • 인증 실패·권한 부족·한도 오류 처리 테스트
  • 실제 API 호출과 Mock 검증 결과 구분
  • 비밀정보 및 고객자료 노출 없음
  • 승인되지 않은 유료 API 호출 없음
  • APS 도입·보류에 대한 판단 근거 작성
  • PoC-24 비교 대상 API 및 입출력 계약 확정
  • 기술문서와 테스트 Evidence 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

판정 주의: 실제 인증·API 호출이 계정 또는 승인 문제로 불가능한 경우 해당 항목은 AUTH_LIVE_PENDING 또는 HOLD로 남긴다. 문서 조사만으로 실제 APS 연결 PASS를 선언하지 않는다.

6. 개발 및 보안 원칙

  • APS는 로컬 MCP 서버와 구분되는 외부 Autodesk 서비스다.
  • Autodesk APS를 필수 아키텍처로 확정하지 않는다.
  • 로컬 DXF 기능으로 해결 가능한 작업은 우선 재사용한다.
  • API 비용과 사용량을 확인하지 않고 유료 호출하지 않는다.
  • 고객 DWG/DXF는 명시적 승인 없이 외부로 전송하지 않는다.
  • API Key, Client Secret, Access Token 등은 GitHub에 커밋하지 않는다.
  • 테스트용 자료와 실제 고객자료를 구분한다.
  • 인증 또는 사용량 제한을 우회하지 않는다.
  • 외부 서비스가 불가능하더라도 로컬 CAD 기능을 유지한다.
  • 설계 결과의 최종 엔지니어링 승인은 별도 절차로 관리한다.

7. GitHub 관련 문서

GitHub Issue

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/164

25개 PoC 상세계획

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-poc-roadmap-20261025.md

전체 업무계획

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

업무분장 및 시스템 통합계획

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

Autodesk APS 공식 참고자료

https://aps.autodesk.com/en/docs/data/v2/developers_guide/authentication

https://aps.autodesk.com/blog/authentication-patterns-aps-mcp-servers

https://aps.autodesk.com/blog/aps-business-model-evolution

8. 후속 개발 연계

다음 작업: PoC-24 — Autodesk APS와 로컬 CAD 엔진 정확도·호환성 비교

PoC-23에서 확인한 지원 API와 인증·보안·비용 조건을 바탕으로 Autodesk APS와 로컬 CAD 엔진의 도면 처리 결과를 비교한다.

비용 또는 고객자료 전송 승인이 확보되지 않은 경우에는 승인된 합성 데이터를 사용하거나 APS 실호출을 HOLD 처리한다.

PoC-24 결과를 바탕으로 PoC-25 통합 MCP 워크플로에서 Autodesk APS의 선택적 사용 여부를 결정한다.

No data to display

Actions

Also available in: PDF Atom