시스템 구성 안내

AIMON이 어떤 계층으로 구성되는지, 고객·연동 담당자가 알아야 할 범위만 정리합니다.

한눈에
데이터 계층, API 계층, 웹 애플리케이션(랜딩·데모·운영 콘솔·관리)으로 구성됩니다. 외부 연동은 Public API와 서명된 웹훅만 사용하세요.

구성

계층	역할
데이터	조직·사이트·탐지·사건·감사 기록 저장
API	인증, Public API, 운영 콘솔용 API, 웹훅 전송
웹	랜딩, 데모, 운영 콘솔, 조직 관리, 플랫폼 관리

프론트엔드에서 쓰는 공개 설정

변수	용도
NEXT_PUBLIC_API_URL	API Gateway 주소 (예: https://api-gateway-production-20f8.up.railway.app)
NEXT_PUBLIC_CONSOLE_URL	운영 콘솔 URL
NEXT_PUBLIC_DEMO_URL	데모 사이트 URL
NEXT_PUBLIC_DEMO_MODE	콘솔 데모 배너 표시 여부

외부 연동 시 원칙

파트너·VMS·업무 시스템은 /v1 Public API만 사용합니다.
웹훅 수신 시 서명을 검증하고 멱등 처리를 적용합니다.
테스트 키와 운영 키를 구분합니다.
내부 서비스 주소·배포 스크립트·환경 변수 전체 목록은 공개 문서에 두지 않습니다.

관련 문서