탐색으로 건너뛰기

감사 로그

워크스페이스 내 관리 작업의 구조화된 기록을 조회합니다.

개요

감사 로그는 워크스페이스 내에서 수행된 관리 작업을 시간순으로 기록하며, 보안 모니터링, 규정 준수 보고, 인시던트 조사에 활용할 수 있습니다. 사용자 프로비저닝, 인증, API 키 관리 및 기타 관리 기능 전반의 100개 이상 엔드포인트를 지원합니다.

로그는 datetime 및 host 프로필이 적용된 OCSF v1.6.0 스키마로 생성되므로, 대부분의 항목을 최소한의 정규화만으로 SIEM에 수집할 수 있습니다.

액세스 요구 사항

로그 조회를 위해서는 다음 두 가지 조건을 모두 충족해야 합니다.

요구 사항세부 정보
워크스페이스 요금제엔터프라이즈
API 키 권한audit_log_read

요청은 워크스페이스 API 키로 인증됩니다. 키와 연결된 사용자 또는 서비스 계정에는 audit_log_read 권한이 있어야 합니다.

로그 조회

감사 로그는 GET /v1/workspace/audit-logs로 반환됩니다. 전체 쿼리 매개변수 목록과 페이지네이션 세부 정보는 API 레퍼런스를 참조하세요.

from dotenv import load_dotenv
import os
from elevenlabs import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
page = elevenlabs.workspace.audit_logs.list(limit=50)
for entry in page.entries:
print(entry.time_dt, entry.class_name, entry.activity_name)

속도 제한

요청은 사용자당 분당 30회로 제한됩니다. 최대 limit 값인 100과 함께 적용되므로, 분당 최대 3,000개 항목을 조회할 수 있습니다.

스키마

감사 로그는 OCSF v1.6.0 사양을 따릅니다. 공통 기본 필드에 이벤트 클래스별 필드가 추가되며, 필드별 응답 스키마는 API 레퍼런스를 참조하세요.

이벤트 클래스

현재 다음 OCSF 클래스가 생성됩니다.

클래스UID예시
Account Change3001사용자 생성, 비밀번호 변경, MFA 요소 활성화.
Authentication3002로그인, 로그아웃, 계정 전환.
Entity Management3004리소스 생성, 업데이트, 삭제 또는 이동.
User Access Management3005권한 부여 또는 취소.
Group Management3006그룹 생성, 사용자 추가 또는 삭제, 하위 그룹 추가 또는 삭제.

OCSF 준수는 최선의 노력으로 제공됩니다. 표준 OCSF 필드가 있는 경우 감사 항목에서 해당 필드를 사용하며, unmapped 필드에는 표준에 맞지 않는 ElevenLabs 고유 속성이 포함됩니다.

활동 이름

각 항목의 activity_name은 API Key Creation과 같이 감사된 특정 작업을 설명합니다. 활동 이름의 전체 목록은 OpenAPI 사양의 AuditActivityName 열거형으로 제공됩니다. GET /v1/workspace/audit-logs의 activity_name 필터를 참조하세요.

마스킹

URL 경로나 쿼리 매개변수에 포함될 수 있는 민감한 정보는 감사 항목이 기록되기 전에 마스킹됩니다. 비밀번호 재설정 토큰이 그 예이며, URL 구조에 비밀 정보를 포함하는 감사 관련 요청에도 동일한 마스킹이 적용됩니다.