Dropbox 로그

Dropbox 로그를 Panther 콘솔에 연결하기

개요

Panther는 다음을 쿼리하여 Dropbox 이벤트를 가져올 수 있습니다 Dropbox Business API. Panther는 특히 다음의 Dropbox 팀 이벤트를 모니터링합니다:

• 사용자가 Dropbox에 로그인하거나 로그아웃함(장치 정보 포함)

• 사용자의 Dropbox 역할 변경

• 누가 파일 및 폴더를 추가, 편집, 보기 및 공유했는지

• 팀 내에서 링크 생성 및 공유

전제 조건

이 통합을 승인하는 Dropbox 사용자는 "팀 관리자(Team Admin)" 역할 자격 증명을 가져야 합니다.

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

1단계: Panther에서 새 Dropbox 로그 소스 생성

1. Panther 콘솔의 왼쪽 탐색 바에서 구성 > 로그 소스.

2. 를 클릭하세요 새로 만들기.

3. 다음 선택: Dropbox 사용 가능한 로그 소스 목록에서.

4. 를 클릭하세요 소스 설정 시작.

5. 다음을 입력하세요 이름 소스의 예: 다음과 같이 내 Dropbox 로그.

6. 를 클릭하세요 설정.

7. "자격 증명 설정" 페이지에서 제공된 URL을 복사하여 안전한 위치에 보관하세요. 다음 단계에서 필요합니다.

2단계: Dropbox에서 새 앱 생성

1. 별도의 브라우저 탭이나 창에서 비즈니스 Dropbox 계정에 로그인하고 다음으로 이동하세요 Dropbox 앱 콘솔.

2. 를 클릭하세요 앱 생성.

3. "DBX 플랫폼에서 새 앱 생성" 페이지에서 필드를 작성하세요:

   • API 선택: 선택 범위 접근(Scoped Access).

   • 필요한 접근 유형 선택: 선택 전체 Dropbox(Full Dropbox).

   • 앱 이름 지정: 애플리케이션에 대한 설명적인 이름을 입력하세요.

   • 를 클릭하세요 앱 생성.

4. 앱 설정 패널로 리디렉션되면 이전에 Panther 콘솔에서 복사한 리디렉트 URI 를 붙여넣고, 그 옆에 있는 추가(Add) 을(를) 클릭하세요.

5. 다음으로 이동하세요 권한 페이지 상단의 탭.

6. "팀 범위(Team Scopes)" 섹션에서 다음 옆의 확인란을 선택하세요 team_data.member 및 events.read.

7. 를 클릭하세요 제출 페이지 하단의 바에서.

8. 다시 이동하세요 설정 탭 페이지 상단에.

9. 설정 탭에서 다음을 복사하세요 앱 키(App Key) 및 앱 시크릿(App Secret) 값을 복사하여 안전한 위치에 보관하세요. 다음 단계에서 필요합니다.

3단계: Panther에서 로그 소스 마무리

1. 이전 단계에서 중단한 "자격 증명 설정" 페이지의 Panther 콘솔로 다시 이동하세요.

2. Dropbox에서 복사한 앱 키를 클라이언트 ID 필드에 붙여넣으세요.

3. Dropbox에서 복사한 앱 시크릿을 클라이언트 시크릿 필드에 붙여넣으세요.

4. 를 클릭하세요 설정.

5. "설정 검증" 페이지에서 액세스 허용(Grant Access).

   • 앱을 설치하기 위한 Dropbox 페이지로 리디렉션됩니다.

6. 를 클릭하세요 허용하세요.

7. Panther에서 성공 화면으로 안내됩니다:\

   

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

   • 와 같이 반환할 수 있습니다(스타일 취향에 따라). 이벤트가 처리되지 않을 때 경고 트리거 설정은 기본값으로 예로 설정됩니다. 데이터가 일정 기간 후에 로그 소스에서 흐르지 않으면 경고를 받으므로 이 설정을 그대로 두는 것을 권장합니다. 시간 범위는 구성 가능하며 기본값은 24시간입니다.\

     

지원되는 로그 유형

Dropbox.TeamEvent

팀 전체 활동에 대한 이벤트를 포함하며 팀이 Dropbox를 어떻게 사용하는지에 대한 정보를 제공합니다.

자세한 내용은 팀 로그 이벤트에 대한 Dropbox 문서.

스키마: Dropbox.TeamEvent
파서:
  네이티브:
    이름: Dropbox.TeamEvent
설명: Dropbox 이벤트는 파일 및 전체 Dropbox 환경에서 무슨 일이 일어나는지 모니터링하는 데 도움이 됩니다.
참고 URL: https://www.dropbox.com/developers/documentation/http/teams#team_log-get_events
필드:
  - 이름: timestamp
    필수: 예
    설명: 이벤트의 타임스탬프
    유형: 타임스탬프
    시간형식: rfc3339
    isEventTime: true
  - 이름: event_category
    필수: 예
    설명: 이 유형의 작업이 속한 범주
    유형: 객체
    필드:
      - 이름: .tag
        필수: 예
        설명: 범주의 태그
        유형: 문자열
  - 이름: event_type
    필수: 예
    설명: 수행된 특정 유형의 작업
    유형: 객체
    필드:
      - 이름: .tag
        필수: 예
        설명: 작업의 태그
        유형: 문자열
      - 이름: description
        설명: 작업에 대한 설명
        유형: 문자열
  - 이름: details
    필수: 예
    설명: 이 유형의 작업에 적용되는 가변 이벤트 스키마로, 이 특정 작업에 대해 인스턴스화된 것
    유형: json
  - 이름: actor
    설명: 실제로 작업을 수행한 주체
    유형: 객체
    필드:
      - 이름: .tag
        설명: 행위자의 태그
        유형: 문자열
      - 이름: admin
        설명: 작업을 수행한 관리자
        유형: 객체
        필드:
          - 이름: .tag
            설명: 멤버 유형의 태그
            유형: 문자열
          - 이름: account_id
            설명: 사용자 고유 ID
            유형: 문자열
          - 이름: display_name
            설명: 사용자 표시 이름
            유형: 문자열
            지표:
              - username
          - 이름: email
            설명: 사용자 이메일 주소
            유형: 문자열
            지표:
              - email
          - 이름: team_member_id
            설명: 팀 멤버 ID
            유형: 문자열
          - 이름: member_external_id
            설명: 팀 멤버 외부 ID
            유형: 문자열
          - 이름: team
            설명: 엔터프라이즈 이벤트에 대한 이 사용자의 팀에 대한 세부 정보
            유형: 객체
            필드:
              - 이름: display_name
                설명: 팀 표시 이름
                유형: 문자열
          - 이름: trusted_non_team_member_type
            설명: Dropbox 팀의 구성원은 아니지만 신뢰되는 사용자(예: 엔터프라이즈 관리자)
            유형: 객체
            필드:
              - 이름: .tag
                설명: 유형의 태그
                유형: 문자열
      - 이름: app
        설명: 작업을 수행한 애플리케이션
        유형: 객체
        필드:
          - 이름: app_id
            설명: 앱 고유 ID
            유형: 문자열
          - 이름: display_name
            설명: 앱 표시 이름
            유형: 문자열
      - 이름: reseller
        설명: 리셀러가 수행한 작업
        유형: 객체
        필드:
          - 이름: reseller_name
            설명: 리셀러 이름
            유형: 문자열
            지표:
              - username
          - 이름: reseller_email
            설명: 리셀러 이메일
            유형: 문자열
            지표:
              - email
      - 이름: user
        설명: 작업을 수행한 사용자
        유형: 객체
        필드:
          - 이름: .tag
            설명: 멤버 유형의 태그
            유형: 문자열
          - 이름: account_id
            설명: 사용자 고유 ID
            유형: 문자열
          - 이름: display_name
            설명: 사용자 표시 이름
            유형: 문자열
            지표:
              - username
          - 이름: email
            설명: 사용자 이메일 주소
            유형: 문자열
            지표:
              - email
          - 이름: team_member_id
            설명: 팀 멤버 ID
            유형: 문자열
          - 이름: member_external_id
            설명: 팀 멤버 외부 ID
            유형: 문자열
          - 이름: team
            설명: 엔터프라이즈 이벤트에 대한 이 사용자의 팀에 대한 세부 정보
            유형: 객체
            필드:
              - 이름: display_name
                설명: 팀 표시 이름
                유형: 문자열
          - 이름: trusted_non_team_member_type
            설명: Dropbox 팀의 구성원은 아니지만 신뢰되는 사용자(예: 엔터프라이즈 관리자)
            유형: 객체
            필드:
              - 이름: .tag
                설명: 유형의 태그
                유형: 문자열
  - 이름: origin
    설명: 행위자가 작업을 수행한 출처
    유형: 객체
    필드:
      - 이름: access_method
        설명: 작업이 수행된 방법을 나타냄
        유형: json
      - 이름: geo_location
        설명: 지리적 위치 세부 정보
        유형: 객체
        필드:
          - 이름: ip_address
            설명: IP 주소
            유형: 문자열
            지표:
              - ip
          - 이름: city
            설명: 도시 이름
            유형: 문자열
          - 이름: region
            설명: 지역 이름
            유형: 문자열
          - 이름: country
            설명: 국가 코드
            유형: 문자열
  - 이름: involve_non_team_member
    설명: 행위자이거나 영향을 받은 사용자 중 비팀 멤버가 포함된 경우 참
    유형: boolean
  - 이름: context
    설명: 행위자가 대신하여 작업을 수행한 사용자 또는 팀
    유형: 객체
    필드:
      - 이름: .tag
        설명: 멤버 유형의 태그
        유형: 문자열
      - 이름: account_id
        설명: 사용자 고유 ID
        유형: 문자열
      - 이름: display_name
        설명: 사용자 표시 이름
        유형: 문자열
        지표:
          - username
      - 이름: email
        설명: 사용자 이메일 주소
        유형: 문자열
        지표:
          - email
      - 이름: team_member_id
        설명: 팀 멤버 ID
        유형: 문자열
      - 이름: member_external_id
        설명: 팀 멤버 외부 ID
        유형: 문자열
      - 이름: team
        설명: 엔터프라이즈 이벤트에 대한 이 사용자의 팀에 대한 세부 정보
        유형: 객체
        필드:
          - 이름: display_name
            설명: 팀 표시 이름
            유형: 문자열
      - 이름: trusted_non_team_member_type
        설명: Dropbox 팀의 구성원은 아니지만 신뢰되는 사용자(예: 엔터프라이즈 관리자)
        유형: 객체
        필드:
          - 이름: .tag
            설명: 유형의 태그
            유형: 문자열
  - 이름: participants
    설명: 작업의 영향을 받는 0명 이상의 사용자 및/또는 그룹. 이 목록에는 행위자나 문맥의 사용자가 포함되지 않습니다
    유형: 배열
    요소:
      유형: 객체
      필드:
        - 이름: group
          설명: 그룹 세부 정보
          유형: 객체
          필드:
            - 이름: display_name
              설명: 이 그룹의 이름
              유형: 문자열
            - 이름: group_id
              설명: 이 그룹의 고유 ID
              유형: 문자열
            - 이름: external_id
              설명: 외부 그룹 ID
              유형: 문자열
        - 이름: user
          설명: Dropbox 계정을 가진 사용자
          유형: 객체
          필드:
            - 이름: .tag
              설명: 멤버 유형의 태그
              유형: 문자열
            - 이름: account_id
              설명: 사용자 고유 ID
              유형: 문자열
            - 이름: display_name
              설명: 사용자 표시 이름
              유형: 문자열
              지표:
                - username
            - 이름: email
              설명: 사용자 이메일 주소
              유형: 문자열
              지표:
                - email
            - 이름: team_member_id
              설명: 팀 멤버 ID
              유형: 문자열
            - 이름: member_external_id
              설명: 팀 멤버 외부 ID
              유형: 문자열
            - 이름: team
              설명: 엔터프라이즈 이벤트에 대한 이 사용자의 팀에 대한 세부 정보
              유형: 객체
              필드:
                - 이름: display_name
                  설명: 팀 표시 이름
                  유형: 문자열
            - 이름: trusted_non_team_member_type
              설명: Dropbox 팀의 구성원은 아니지만 신뢰되는 사용자(예: 엔터프라이즈 관리자)
              유형: 객체
              필드:
                - 이름: .tag
                  설명: 유형의 태그
                  유형: 문자열
  - 이름: assets
    설명: 작업에 관련된 0개 이상의 콘텐츠 자산
    유형: 배열
    요소:
      유형: json