# Rapid7 로그

## 개요

Panther는 Rapid7의 [감사 로그](https://docs.rapid7.com/insight/audit-logging/) 을 통해 가져올 수 있습니다 [InsightIDR](https://www.rapid7.com/products/insightidr/).

## Rapid7 감사 로그를 Panther에 온보딩하는 방법

### 1단계: Rapid7에서 감사 로깅 활성화

* 다음을 따르세요 [감사 로깅을 활성화하는 방법에 대한 Rapid7 지침](https://docs.rapid7.com/insight/audit-logging/#enable-audit-logging).
  * 다음 값을 복사하세요 **데이터 저장 지역** 값을 복사하여 이후 단계에서 필요하므로 안전한 위치에 저장하세요.

### 2단계: Rapid7에서 API 키 생성

* 다음을 따르세요 [API 키를 생성하는 방법에 대한 Rapid7 지침](https://docs.rapid7.com/insight/managing-platform-api-keys). 조직 키(사용자 키 대신)를 생성하는 것이 권장됩니다. 이는 [관리자 권한을 가져야 합니다](https://docs.rapid7.com/insight/audit-logging/) 감사 로그 이벤트를 적절히 조회하고 확인하려면.
  * API 키 값을 복사하여 이후 단계에서 필요하므로 안전한 위치에 저장하세요.

### 3단계: Panther에서 새로운 Rapid7 로그 소스 생성

1. Panther 콘솔의 왼쪽 탐색 바에서 클릭하세요 **구성** > **로그 소스.**
2. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. **새로 만들기**.
3. “Rapid7”을 검색한 다음 해당 타일을 클릭하세요.
4. 슬라이드 아웃 패널에서 클릭하세요 **설정 시작**.

   <figure><img src="https://2400888838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-458d266ecd68749c6237d2547169c32aadfc8a1e%2FScreenshot%202024-06-12%20at%2012.58.19%20PM.png?alt=media" alt="In the Panther Console, the Configure > Log Sources > Add New Source page is shown. There is an arrow drawn from the Rapid7 tile to the Start Setup button on its slide-out panel."><figcaption></figcaption></figure>
5. 다음 화면에서 소스에 대한 설명 이름을 입력합니다. 예: `내 Rapid7 로그`.
6. 페이지에서 **자격증명 설정** 페이지에서 필드를 입력하세요:

   * **저장 지역**: 1단계에서 Rapid7에서 기록한 축약된 버전의 **데이터 저장 지역** 값을 입력하세요. 예를 들어 지역이 `미국 - 3`입력하세요 `us3`.
     * 이 값을 다시 찾아야 하는 경우 Rapid7 플랫폼 콘솔의 **홈** 섹션에서 확인할 수 있습니다 **설정** 페이지. Rapid7 콘솔 URL에서도 확인할 수 있습니다.
   * **API 키**: 2단계에서 Rapid7에서 생성한 API 키를 입력하세요.

   ![“아래 양식에 자격 증명을 입력하세요” 아래에는 두 개의 빈 필드가 있습니다: 저장 지역과 API 키.](https://2400888838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-f3cb3f73476bc2ac7c51654f3feada1b5ed2975d%2FScreenshot%202024-06-12%20at%201.00.21%20PM.png?alt=media)
7. 를 선택하고 Panther가 설치된 계정 ID를 입력하십시오. **설정**. 성공 화면으로 이동합니다:

   <figure><img src="https://2400888838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-e55cedf82c6a6adc66ec5c14ebdcb164c3b1dcca%2FScreenshot%202023-08-03%20at%204.33.30%20PM.png?alt=media" alt="The success screen reads, &#x22;Everything looks good! Panther will now automatically pull &#x26; process logs from your account&#x22;" width="281"><figcaption></figcaption></figure>

   * 성공 화면으로 이동됩니다: [선택적으로 하나 이상의](https://docs.panther.com/detections/panther-managed/packs).
   * 사용자를 사용할 것이며, **가 활성화될 수 있습니다** "이벤트가 처리되지 않을 때 알러트를 트리거" **설정의 기본값은**. 로그 소스에서 일정 기간 동안 데이터 흐름이 중단되면 알림을 받으므로 이 옵션을 활성화 상태로 두는 것을 권장합니다. 시간 범위는 구성 가능하며 기본값은 24시간입니다.\\

     <figure><img src="https://2400888838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2Fgit-blob-c48119abd559990173004bde99ff4907fdd2ded2%2FScreenshot%202023-08-03%20at%204.26.54%20PM.png?alt=media" alt="The &#x22;Trigger an alert when no events are processed&#x22; toggle is set to YES. The &#x22;How long should Panther wait before it sends you an alert that no events have been processed&#x22; setting is set to 1 Day" width="320"><figcaption></figcaption></figure>

## 지원되는 로그 유형

### Rapid7.AuditLog

```yaml
스키마: Rapid7.AuditLog
설명: Rapid7 InsightIDR 감사 로그
참조 URL: https://docs.rapid7.com/insightidr/audit-logging/
필드:
    - 이름: action
      required: true
      설명: 수행된 작업.
      type: string
    - 이름: audit_id
      required: true
      설명: 감사 로그 항목의 고유 식별자.
      type: string
    - 이름: result
      설명: 수행된 작업의 결과.
      type: string
    - 이름: access_method
      설명: 서비스에 액세스하는 데 사용된 방식.
      type: string
    - 이름: product
      설명: 로그 항목과 관련된 제품.
      type: string
    - 이름: description
      설명: 작업에 대한 추가 세부 정보 또는 컨텍스트.
      type: string
    - 이름: service_info
      설명: 서비스 및 이벤트에 대한 정보.
      type: object
      필드:
        - 이름: previousEntry
          설명: 로그의 이전 항목에 대한 정보.
          유형: json
        - name: event
          설명: 로그 항목을 유발한 이벤트에 대한 세부 정보.
          type: object
          필드:
            - 이름: type
              설명: 이벤트의 유형.
              type: string
            - name: correlationId
              설명: 추적을 위한 상관 식별자.
              type: string
            - 이름: customerId
              설명: 고객 식별자.
              type: string
            - 이름: updatedBy
              설명: 항목을 업데이트한 주체의 식별자.
              type: string
              지표:
                - 이메일
            - 이름: initiatorIdentification
              설명: 시작자의 식별 정보.
              type: object
              필드:
                - 이름: email
                  설명: 시작자의 이메일.
                  type: string
                  지표:
                    - 이메일
                - name: userId
                  설명: 시작자의 사용자 ID.
                  type: string
                - 이름: apiKeyId
                  설명: 해당되는 경우 시작자의 API 키 ID.
                  type: string
                - 이름: automatedFlowName
                  설명: 해당되는 경우 자동화 플로우의 이름.
                  type: string
                - 이름: customerId
                  설명: 시작자의 고객 ID.
                  type: string
            - 이름: timestamp
              설명: 이벤트 타임스탬프.
              type: timestamp
              timeFormats:
                - unix_ms
              isEventTime: true
        - 이름: type
          설명: 서비스 정보의 유형.
          type: string
    - 이름: time
      required: true
      설명: 감사 로그의 타임스탬프.
      type: timestamp
      timeFormats:
        - rfc3339
      isEventTime: true
    - name: request
      설명: 사용자 정보를 포함한 요청 세부 사항.
      type: object
      필드:
        - name: user
          설명: 요청의 사용자 세부 정보.
          type: object
          필드:
            - 이름: email
              설명: 사용자의 이메일.
              type: string
              지표:
                - 이메일
            - 이름: name
              설명: 사용자의 이름.
              type: string
              지표:
                - username
```