감사 로그

조직에서 상태를 변경한 작업의 이력을 확인하세요. 새 기록만 추가할 수 있고 변조 흔적을 확인할 수 있어, 누가 언제 어디서 무엇을 했는지 파악할 수 있습니다.

감사 로그는 역할 할당, 엔진 수정, API 키 발급 등 지원 대상인 조직 내 관리 작업을 검색과 필터링이 가능한 타임라인으로 보여줍니다. 지원 범위의 제한 사항을 확인하세요. 역할 및 권한과 함께 Enterprise 요금제에서 사용할 수 있습니다.

로그는 데이터베이스 수준에서 새 기록 추가만 허용합니다. 애플리케이션의 연결로는 감사 로그 행을 수정하거나 삭제하거나 테이블을 비울 수 없습니다. 한 번 기록된 내용은 그대로 남습니다.

기록되는 정보 #

각 이벤트에는 수행자, 작업, 대상과 함께 요청 수신 당시의 HTTP 컨텍스트가 기록됩니다.

필드설명
수행자작업을 수행한 사용자 또는 API 키
작업engine.created 또는 member.role_changed처럼 유형이 지정된 값
대상작업의 영향을 받은 개체(예: 엔진, 역할, 용어집 항목)
메타데이터관련 개체의 식별자만 기록하며 이름, 이메일, 콘텐츠 일부는 기록하지 않음
요청 컨텍스트request_id, IP 주소, 사용자 에이전트 — HTTP로 호출이 수신될 때 기록
타임스탬프UTC 시각과 누락 감지를 위한 단조 증가 순번

식별자만 기록하도록 설계

메타데이터 열에는 사람이 읽을 수 있는 값 대신 식별자를 저장합니다. 화면에서는 조회 시점의 현재 이름을 연결해 표시하므로, 엔진이나 사용자 이름을 바꿔도 이력이 다시 작성되지 않습니다. 삭제할 콘텐츠 자체가 없어 감사 로그 행이 GDPR의 삭제권과 충돌하는 문제도 방지합니다.

기록 대상 작업 #

이벤트는 대시보드 필터에 맞는 범주로 분류됩니다.

범주현재 기록되는 작업
조직org.created, org.settings_updated, org.deleted
구성원member.invited, member.removed, member.role_changed
역할role.created, role.updated, role.deleted
엔진engine.created, engine.updated, engine.deleted
API 키api_key.created, api_key.revoked
콘텐츠glossary_item.*, instruction.*, brand_voice.* (단건 작업만 해당)

로그 확인하기 #

감사 로그 항목은 설정의 관리 아래에 항상 표시됩니다. 이용 자격이 없으면 타임라인 대신 "현재 요금제에서는 감사 로그를 사용할 수 없습니다"라는 메시지가 표시됩니다. 페이지에서는 다음 기능을 사용할 수 있습니다.

  • 목록 필터링 — 작업, 수행자, 기간으로 범위를 좁힐 수 있습니다. 기간은 최근 7일 같은 사전 설정이나 시작일 / 종료일 날짜 범위로 지정합니다. 미래 날짜는 선택할 수 없습니다.
  • 이전 이벤트 불러오기 — 최신 이벤트부터 표시됩니다. 목록 하단의 이전 이벤트 불러오기를 클릭하면 다음 페이지를 불러옵니다.
  • 이벤트 세부 정보 — 행을 클릭하면 해당 위치에서 펼쳐지며 전체 메타데이터, 요청 식별자, IP 주소, 사용자 에이전트를 확인할 수 있습니다.
  • 뷰 공유 — 필터와 열려 있는 이벤트가 URL에 반영되므로 어떤 뷰든 공유할 수 있습니다.

조회할 수 있는 사용자 #

페이지에 접근하려면 두 가지 조건을 충족해야 합니다.

  1. 이용 자격 — 조직에 감사 로그 기능이 활성화되어 있어야 합니다(Enterprise 요금제).
  2. 권한 — 조회자의 역할에 org:view_audit_logs 권한이 포함되어 있어야 합니다. 기본으로 생성되는 전체 액세스 역할에는 이 권한이 포함되어 있으며, 소유자는 항상 이 권한을 가집니다.

권한이 없는 구성원에게는 타임라인 대신 "접근 불가" 페이지가 표시됩니다. 이용 자격이 없는 조직의 구성원에게는 유료 이용 안내 화면이 표시됩니다.

Enterprise 요금제가 만료되면

감사 로그를 이용하려면 역할 기반 접근 제어와 동일한 등급의 이용 자격이 필요합니다. 기존 이벤트는 데이터베이스에 그대로 남지만, 요금제가 복구될 때까지 페이지에는 "현재 요금제에서는 감사 로그를 사용할 수 없습니다"라는 메시지가 표시되고 조회 엔드포인트는 403을 반환합니다.

변조 흔적 확인 #

감사 로그는 단순한 기록을 넘어, 사후 변경이 실질적으로 어렵도록 설계되어 있습니다.

  • 데이터베이스 수준에서 추가만 허용. 테이블을 설치하는 마이그레이션은 API 역할에 대해 REVOKE UPDATE, DELETE, TRUNCATE을 실행합니다. 이후 버그, 새 엔드포인트, 심지어 SQL 삽입 공격까지 어떤 코드 경로를 거치더라도 행을 변경하려는 시도는 포스트그레스에서 차단됩니다.
  • 단조 증가 순번. 모든 행에는 값이 엄격하게 증가하는 seq 열이 있습니다. 감사자는 순번을 살펴보고 중간에 빠진 번호로 삭제를 감지할 수 있습니다.

이는 SOC 2와 같은 통제 요건을 충족하기에 충분합니다. 다만 운영 데이터베이스에 직접 접근할 수 있는 자격 증명을 가진 공격자까지 방어하지는 못합니다. 별도의 소유자 역할이나 한 번 기록하면 읽기만 가능한 미러 등 더 강력한 보안 구성은 요청 시 제공됩니다.

보존 기간 #

감사 이벤트는 기본적으로 무기한 보존됩니다. Enterprise에서는 일반적으로 1년, 3년, 7년 등의 맞춤 보존 기간을 설정할 수 있습니다. 규정 준수나 보안 설문지 대응을 위해 특정 보존 정책이 필요하다면 문의해 주세요.

지원하지 않는 범위 #

1차 버전에서 의도적으로 정한 다음 제한 사항을 확인하세요.

  • 최대한 기록을 시도하지만 트랜잭션으로 보장하지는 않습니다. 트랜잭션 방식의 기록은 단기 개발 계획에 포함되어 있습니다. 감사 이벤트는 해당 작업과 동일한 데이터베이스 트랜잭션 안에서가 아니라 작업이 끝난 뒤에 기록됩니다. 드물게 작업은 성공했지만 이후 감사 이벤트 삽입이 실패하면, 작업에 해당하는 이벤트가 남지 않을 수 있습니다.
  • 아직 기록되지 않는 작업 유형이 있습니다. 엔진 구성원 변경, 연동 연결 / 수정 / 연결 해제, 모델 설정 수정, 결제 구독 변경, 콘텐츠 일괄 작업(CSV 업로드, createMany / updateMany / deleteMany)은 아직 이벤트를 생성하지 않습니다. 작업 유형 값은 미리 예약되어 있으므로 기록 기능이 연결되면 기존 필터 범주에 표시됩니다.
  • 조회는 감사 대상이 아닙니다. 감사 로그 자체를 보거나, 엔진 요청 로그를 살펴보거나, 용어집을 다운로드해도 이벤트가 생성되지 않습니다. 상태를 변경하는 작업만 이벤트를 생성합니다.
  • 아직 내보내기를 지원하지 않습니다. 감사 데이터는 대시보드에서 확인할 수 있습니다. CSV 내보내기, SIEM 웹훅, S3 미러는 개발 계획에 포함되어 있습니다. 필요하다면 알려주세요.
  • 엔진별 뷰는 없습니다. 조직의 모든 감사 이벤트는 하나의 타임라인에 표시됩니다. 작업이나 수행자로 필터링해 범위를 좁히세요.
  • 실시간 로그 추적은 지원하지 않습니다. 새로고침 버튼이나 웹소켓 스트림은 제공되지 않습니다. 최신 이벤트를 확인하려면 페이지를 새로고침하세요.

다음 단계 #