개요
Moss는 규정 준수와 보안 사고 조사를 위해 감사 이벤트를 기록하고, 선택적으로 상세 요청 로그를 수집합니다.로깅되는 내용
아래 표는 상세 요청 로깅을 켰을 때의 기록입니다.인바운드 요청 (SDK에서 백엔드로)
아웃바운드 요청 (백엔드에서 외부 서비스로)
민감한 데이터 편집
요청 로그의 정제기는 저장 전에 아래 자격 증명 필드를 가립니다:편집되는 필드
다음 필드는 자동으로 편집됩니다:api_key,apiKeyauthorizationpasswordsecrettokenx-api-key
편집 예시
자격증명 필드는 중첩된 객체와 배열에서도 가립니다. 상세 요청 로깅은 계측된
경로를 대상으로 합니다.
애플리케이션별 제어
상세 요청 로깅은 애플리케이션별로 활성화 또는 비활성화할 수 있습니다: 이 설정은 상세 요청 로그에 적용되며, 관리 작업의 감사 이벤트 기록과는 별개입니다.대시보드 설정
설정 > 개발자 옵션 > 감사 로깅으로 이동하여 애플리케이션의 로깅을 활성화하거나 비활성화합니다.고려 사항
감사 로그 접근
대시보드 접근
구성 > 감사 로그에서 대시보드의 감사 로그를 봅니다. 기능:- 날짜 범위별 필터
- 사용자 또는 세션별 필터
- 엔드포인트 또는 상태별 필터
- CSV로 내보내기
API 접근
감사 API를 사용하여 프로그래밍 방식으로 감사 로그를 쿼리합니다:page와 page_size로 페이지네이션되며, actor_id, action, target_type, outcome, start_date, end_date로 범위를 좁힐 수 있습니다.
감사 API 키
감사 로그 접근에는 별도의 API 키가 사용됩니다:- 격리된 접근 - 감사 키는 SDK API 키와 별도
- 읽기 전용 - 로그나 다른 데이터 수정 불가
- 폐기 가능 - 독립적으로 폐기 가능
로그 보존
실제 적용 기간은 계약, 문서화된 고객 지시 및 적법한 보존 의무에 따라 결정됩니다.
최소 보존 의무가 있으면 삭제 시점과 충돌하지 않도록 먼저 맞춰야 합니다.
해당 배포의 활성화된 삭제 일정은 Moss에 확인하세요.
사용 사례
규정 준수 보고
감사자를 위한 보고서 생성:- 날짜 범위별 로그 필터
- CSV로 내보내기
- 규정 준수 문서에 포함
보안 조사
의심스러운 활동 조사:- 사용자 또는 세션 식별
- 모든 관련 요청 검토
- 비정상적인 패턴 확인
- 사고 대응을 위한 증거 내보내기
성능 분석
API 사용 패턴 분석:- 요청 기간 검토
- 느린 엔드포인트 식별
- LLM 토큰 사용량 추적
- 데이터 기반 최적화
비용 분석
LLM 사용 비용 추적:- 모델별 토큰 수 검토
- 높은 사용량 세션 식별
- 프롬프트 및 컨텍스트 최적화
로그 무결성
감사 이벤트의 수정·삭제 제한
- 애플리케이션 사용자는 대시보드나 감사 API에서 기존 감사 이벤트를 수정하거나 삭제할 수 없습니다.
- 보존 기간이 지난 감사 이벤트는 보존 정책에 따른 정리 작업으로 삭제합니다.
타임스탬프
감사 이벤트 시각은 서버에서 UTC로 생성합니다.모범 사례
프로덕션에 활성화
다음 목적에 맞게 운영 감사·요청 로깅을 설정하세요:- 규정 준수 요구 사항 충족
- 사고 조사 가능
- 사용 패턴 추적
정기적 검토
다음을 위해 감사 로그를 주기적으로 검토하세요:- 비정상적인 접근 패턴
- 접근 권한 변경과 기록된 보안 이벤트
- 예기치 않은 API 사용
API 키 보안
감사 API 키 보호:- 안전하게 저장 (코드에 포함하지 않음)
- 주기적으로 로테이션
- 무단 사용 모니터링
다음 단계
규정 준수
GDPR, 데이터 삭제 및 인증
인증
SDK 통합 보안