OpenAI 로그(베타)

Panther는 OpenAI에서 직접 로그를 가져오는 것을 지원합니다

개요

OpenAI 로그 수집은 오픈 베타 Panther 버전 1.117부터 시작되며 모든 고객이 사용할 수 있습니다. 버그 보고나 기능 요청이 있으면 Panther 지원팀에 공유해 주세요.

Panther는 다음을 쿼리하여 OpenAI 감사 로그를 가져올 수 있는 기능이 있습니다 OpenAI 감사 로그 API입니다. Panther는 감사 로그 API를 1분마다 쿼리합니다. Panther가 API에 액세스하려면 적절한 권한이 있는 새 OpenAI API 키를 생성해야 합니다.

일반적인 OpenAI 감사 로그 이벤트 유형

감사 로그 이벤트 유형 전체 목록 보기 여기입니다. 일반적인 이벤트는 다음과 같습니다:

• api_key.created

• api_key.updated

• api_key.deleted

• project.created

• project.updated

• project.deleted

• user.added

• user.updated

• user.deleted

• service_account.created

• service_account.updated

• service_account.deleted

OpenAI 로그를 Panther에 온보딩하는 방법

전제 조건

• 이 단계를 완료하려면 조직 소유자 또는 관리자로 OpenAI에 로그인되어 있어야 합니다. 이는 1단계를 완료하는 데 필요합니다.

• 감사 로그가 데이터 제어 설정 페이지에서 OpenAI에 활성화되어 있습니다.

1단계: 새 OpenAI API 키 생성

최소 권한 원칙에 따라 감사 로그에 대해 읽기 전용 권한을 가진 API 키 사용을 권장합니다.

1. OpenAI 계정에서 다음으로 이동하세요 설정 > 조직 > API 키.

2. 클릭 새 비밀 키 생성.

3. 키에 대한 설명 이름을 입력하세요. 예: Panther 감사 로그 액세스.

4. 키 권한을 구성하세요:

   • 권한: 다음으로 설정 읽기 전용 (또는 키가 감사 로그에 대한 읽기 권한을 가지고 있는지 확인하세요).

   • 키가 감사 로그 리소스에 액세스할 수 있는지 확인하세요.

5. 다음을 복사하세요 API 키 값 을 안전한 장소에 저장하세요. 다음 단계에서 필요합니다.

   • OpenAI는 이 값을 다시 표시하지 않습니다.

2단계: Panther에서 새 OpenAI 소스 생성

1. Panther 콘솔의 왼쪽 탐색 바에서 클릭하십시오 구성 > 로그 소스.

2. 클릭 새로 만들기.

3. "OpenAI"를 검색한 다음 해당 타일을 클릭하세요.

4. 슬라이드 아웃 패널에서, 클릭하세요 설정 시작.

5. 페이지에서 구성 페이지에서 설명적인 이름을 입력하세요. 예: 내 OpenAI 감사 로그.

   • 설정은 로그 유형 읽기 전용 드롭다운에는 OpenAI.Audit 값을 복사하세요.

6. 클릭 설정.

7. 페이지에서 자격 증명 페이지에서 1단계에서 생성한 키로 API 키 필드를 채우세요.

8. 클릭 설정.

   • Panther가 OpenAI API에 성공적으로 연결할 수 있는지 확인하는 검증 화면으로 이동됩니다.

     • 선택적으로 하나 이상의 탐지 팩을 활성화할 수 있습니다.

     • 설정은 이벤트가 처리되지 않을 때 경고 트리거 기본값은 예입니다. 로그 소스에서 일정 기간 이후 데이터 흐름이 중단되면 알림을 받으므로 이 기능을 활성화된 상태로 두는 것을 권장합니다. 시간 범위는 구성 가능하며 기본값은 24시간입니다.

사용자 정의 탐지 패턴

API 키 생성 모니터링 예시

OpenAI 조직에서 새 API 키가 생성될 때 모니터링:

def rule(event):
    return event.get('type') == 'api_key.created'

def title(event):
    actor_email = event.deep_get('actor', 'user', 'email', default='Unknown')
    return f'New OpenAI API key created by {actor_email}'

관리자 사용자 변경 예시

사용자가 추가되거나 역할이 변경될 때 감지:

def rule(event):
    event_type = event.get('type', '')
    return event_type in ['user.added', 'user.updated']

def severity(event):
    # 역할 변경에 대해 더 높은 심각도
    if event.get('type') == 'user.updated':
        return 'MEDIUM'
    return 'INFO'

프로젝트 삭제 모니터링 예시

프로젝트가 삭제되었을 때 경보:

def rule(event):
    return event.get('type') == 'project.deleted'

가 반환됩니다.
    return {
        'actor_email': event.deep_get('actor', 'user', 'email'),
        'project_id': event.deep_get('project', 'id'),
        'project_name': event.deep_get('project', 'name'),
        'timestamp': event.get('effective_at')
    }

지원되는 로그 유형

OpenAI.AuditLogs

OpenAI 감사 로그는 API 키 관리, 프로젝트 변경, 사용자 활동 및 접근 제어 수정 등 조직 내의 관리 및 보안 관련 이벤트를 추적합니다.

참조: OpenAI 감사 로그 API 문서

스키마: OpenAI.Audit
설명: |
    OpenAI 감사 로그는 조직 내의 관리 작업 및 보안 이벤트에 대한 가시성을 제공합니다. 이 로그들은 API 키 사용, 프로젝트 관리 및 사용자 접근 제어를 추적하는 데 도움이 됩니다.
참조 URL: https://platform.openai.com/docs/api-reference/audit-logs
필드:
    - 이름: id
      required: true
      설명: 감사 로그 이벤트의 고유 식별자
      type: string
    - 이름: type
      required: true
      설명: 발생한 이벤트의 유형
      type: string
    - 이름: effective_at
      required: true
      설명: 이벤트가 발생한 유닉스 타임스탬프(초 단위)
      type: timestamp
      시간 형식: unix
      isEventTime: true
    - 이름: actor
      설명: 작업을 수행한 엔터티
      type: object
      필드:
        - 이름: type
          설명: 행위자의 유형(예: user, service_account, system)
          type: string
        - name: user
          설명: 작업을 수행한 사용자에 대한 세부 정보
          type: object
          필드:
            - 이름: id
              설명: 사용자의 고유 식별자
              type: string
            - 이름: email
              설명: 사용자의 이메일 주소
              type: string
              지표:
                - 이메일
        - 이름: service_account
          설명: 작업을 수행한 서비스 계정에 대한 세부 정보
          type: object
          필드:
            - 이름: id
              설명: 서비스 계정의 고유 식별자
              type: string
        - 이름: api_key
          설명: 작업 수행에 사용된 API 키에 대한 세부 정보
          type: object
          필드:
            - 이름: id
              설명: API 키의 고유 식별자
              type: string
            - 이름: type
              설명: API 키의 유형
              type: string
            - name: user
              설명: API 키와 연결된 사용자
              type: object
              필드:
                - 이름: id
                  설명: 사용자의 고유 식별자
                  type: string
                - 이름: email
                  설명: 사용자의 이메일 주소
                  type: string
                  지표:
                    - 이메일
            - 이름: service_account
              설명: API 키와 연결된 서비스 계정
              type: object
              필드:
                - 이름: id
                  설명: 서비스 계정의 고유 식별자
                  type: string
    - 이름: project
      설명: 작업의 영향을 받은 프로젝트에 대한 세부 정보
      type: object
      필드:
        - 이름: id
          설명: 프로젝트의 고유 식별자
          type: string
        - 이름: name
          설명: 프로젝트의 이름
          type: string
    - 이름: api_key
      설명: 작업의 영향을 받은 API 키에 대한 세부 정보
      type: object
      필드:
        - 이름: id
          설명: API 키의 고유 식별자
          type: string
        - 이름: type
          설명: API 키의 유형
          type: string
        - name: user
          설명: API 키와 연결된 사용자
          type: object
          필드:
            - 이름: id
              설명: 사용자의 고유 식별자
              type: string
            - 이름: email
              설명: 사용자의 이메일 주소
              type: string
              지표:
                - 이메일
        - 이름: service_account
          설명: API 키와 연결된 서비스 계정
          type: object
          필드:
            - 이름: id
              설명: 서비스 계정의 고유 식별자
              type: string
    - name: user
      설명: 작업의 영향을 받은 사용자에 대한 세부 정보
      type: object
      필드:
        - 이름: id
          설명: 사용자의 고유 식별자
          type: string
        - 이름: email
          설명: 사용자의 이메일 주소
          type: string
          지표:
            - 이메일
        - name: role
          설명: 조직에서 사용자의 역할
          type: string
    - 이름: service_account
      설명: 작업의 영향을 받은 서비스 계정에 대한 세부 정보
      type: object
      필드:
        - 이름: id
          설명: 서비스 계정의 고유 식별자
          type: string
        - 이름: name
          설명: 서비스 계정의 이름
          type: string