Dropbox 로그

Dropbox 로그를 Panther 콘솔에 연결

개요

Panther는 다음을 쿼리하여 Dropbox 이벤트를 가져올 수 있습니다 Dropbox Business API. Panther는 다음 Dropbox 팀 이벤트를 구체적으로 모니터링합니다:

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

• Dropbox에서 사용자의 역할 변경

• 파일과 폴더의 추가, 편집, 보기, 공유 및 이를 수행한 사람

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

사전 요구 사항

이 통합을 승인하는 Dropbox 사용자는 "Team Admin" 역할 자격 증명을 보유해야 합니다.

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

1단계: Panther에 새 Dropbox 로그 소스 만들기

1. Panther Console의 왼쪽 탐색 모음에서 로그 소스.

2. 클릭합니다 새로 만들기.

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

4. 클릭합니다 소스 설정 시작.

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

6. 클릭합니다 설정.

7. "Set Credentials" 페이지에서 제공된 URL을 복사하여 안전한 위치에 저장하세요. 다음 단계에서 필요합니다.

2단계: Dropbox에서 새 앱 만들기

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

2. 클릭합니다 앱 만들기.

3. "Create a new app on the DBX Platform" 페이지에서 다음 필드를 채우세요:

   • API 선택: 선택하세요 Scoped Access.

   • 필요한 액세스 유형 선택: 선택하세요 Full Dropbox.

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

   • 클릭합니다 앱 만들기.

4. 앱 Settings 패널로 리디렉션되면 앞서 이 문서의 이전 단계에서 Panther Console에서 복사한 Redirect URI 를 붙여넣고 추가 옆에 있는

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

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

7. 클릭합니다 제출 페이지 하단의 표시줄에서.

8. 다시 다음으로 이동하세요. Settings 탭 페이지 상단에서.

9. Settings 탭에서 다음을 복사하세요. 앱 키 및 앱 시크릿 값을 복사하여 안전한 위치에 저장하세요. 다음 단계에서 필요합니다.

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

1. 이전 단계에서 작업을 중단한 "Set Credentials" 페이지의 Panther Console로 다시 이동하세요.

2. Dropbox의 App Key를 다음에 붙여넣으세요. Client ID 필드.

3. Dropbox의 App Secret를 다음에 붙여넣으세요. Client Secret 필드.

4. 클릭합니다 설정.

5. "Verify Setup" 페이지에서 다음을 클릭하세요. 액세스 허용.

   • 앱을 설치하기 위해 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
    필수: true
    설명: 이벤트의 타임스탬프
    유형: timestamp
    시간 형식: rfc3339
    이벤트 시간 여부: true
  - 이름: event_category
    필수: true
    설명: 이 작업 유형이 속한 카테고리
    유형: object
    필드:
      - 이름: .tag
        필수: true
        설명: 카테고리의 태그
        유형: string
  - 이름: event_type
    필수: true
    설명: 수행된 작업의 특정 유형
    유형: object
    필드:
      - 이름: .tag
        필수: true
        설명: 작업의 태그
        유형: string
      - 이름: description
        설명: 작업에 대한 설명
        유형: string
  - 이름: details
    필수: true
    설명: 이 작업 유형에 적용되는 가변 이벤트 스키마로, 해당 특정 작업에 맞게 인스턴스화됨
    유형: json
  - name: actor
    설명: 실제로 작업을 수행한 엔터티
    유형: object
    필드:
      - 이름: .tag
        설명: 행위자의 태그
        유형: string
      - 이름: admin
        설명: 작업을 수행한 관리자
        유형: object
        필드:
          - 이름: .tag
            설명: 멤버 유형의 태그
            유형: string
          - 이름: account_id
            설명: 사용자 고유 ID
            유형: string
          - 이름: display_name
            설명: 사용자 표시 이름
            유형: string
            지표:
              - username
          - 이름: email
            설명: 사용자 이메일 주소
            유형: string
            지표:
              - email
          - 이름: team_member_id
            설명: 팀 멤버 ID
            유형: string
          - 이름: member_external_id
            설명: 팀 멤버 외부 ID
            유형: string
          - 이름: team
            설명: 엔터프라이즈 이벤트에서 이 사용자의 팀에 대한 세부 정보
            유형: object
            필드:
              - 이름: display_name
                설명: 팀 표시 이름
                유형: string
          - 이름: trusted_non_team_member_type
            설명: Dropbox 팀의 일원은 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자
            유형: object
            필드:
              - 이름: .tag
                설명: 유형의 태그
                유형: string
      - 이름: app
        설명: 작업을 수행한 애플리케이션
        유형: object
        필드:
          - name: app_id
            설명: 앱 고유 ID
            유형: string
          - 이름: display_name
            설명: 앱 표시 이름
            유형: string
      - 이름: reseller
        설명: 리셀러가 수행한 작업
        유형: object
        필드:
          - 이름: reseller_name
            설명: 리셀러 이름
            유형: string
            지표:
              - username
          - 이름: reseller_email
            설명: 리셀러 이메일
            유형: string
            지표:
              - email
      - 이름: user
        설명: 작업을 수행한 사용자
        유형: object
        필드:
          - 이름: .tag
            설명: 멤버 유형의 태그
            유형: string
          - 이름: account_id
            설명: 사용자 고유 ID
            유형: string
          - 이름: display_name
            설명: 사용자 표시 이름
            유형: string
            지표:
              - username
          - 이름: email
            설명: 사용자 이메일 주소
            유형: string
            지표:
              - email
          - 이름: team_member_id
            설명: 팀 멤버 ID
            유형: string
          - 이름: member_external_id
            설명: 팀 멤버 외부 ID
            유형: string
          - 이름: team
            설명: 엔터프라이즈 이벤트에서 이 사용자의 팀에 대한 세부 정보
            유형: object
            필드:
              - 이름: display_name
                설명: 팀 표시 이름
                유형: string
          - 이름: trusted_non_team_member_type
            설명: Dropbox 팀의 일원은 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자
            유형: object
            필드:
              - 이름: .tag
                설명: 유형의 태그
                유형: string
  - name: origin
    설명: 행위자가 작업을 수행한 출처
    유형: object
    필드:
      - 이름: access_method
        설명: 작업이 수행된 방법을 나타냄
        유형: json
      - 이름: geo_location
        설명: 지리적 위치 세부 정보
        유형: object
        필드:
          - 이름: ip_address
            설명: IP 주소
            유형: string
            지표:
              - ip
          - 이름: city
            설명: 도시 이름
            유형: string
          - 이름: region
            설명: 지역 이름
            유형: string
          - 이름: country
            설명: 국가 코드
            유형: string
  - 이름: involve_non_team_member
    설명: 작업에 비팀 멤버가 행위자 또는 영향을 받는 사용자 중 하나로 포함되었다면 True
    유형: boolean
  - 이름: context
    설명: 행위자가 대신 작업을 수행한 사용자 또는 팀
    유형: object
    필드:
      - 이름: .tag
        설명: 멤버 유형의 태그
        유형: string
      - 이름: account_id
        설명: 사용자 고유 ID
        유형: string
      - 이름: display_name
        설명: 사용자 표시 이름
        유형: string
        지표:
          - username
      - 이름: email
        설명: 사용자 이메일 주소
        유형: string
        지표:
          - email
      - 이름: team_member_id
        설명: 팀 멤버 ID
        유형: string
      - 이름: member_external_id
        설명: 팀 멤버 외부 ID
        유형: string
      - 이름: team
        설명: 엔터프라이즈 이벤트에서 이 사용자의 팀에 대한 세부 정보
        유형: object
        필드:
          - 이름: display_name
            설명: 팀 표시 이름
            유형: string
      - 이름: trusted_non_team_member_type
        설명: Dropbox 팀의 일원은 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자
        유형: object
        필드:
          - 이름: .tag
            설명: 유형의 태그
            유형: string
  - 이름: participants
    설명: 작업의 영향을 받는 0명 이상의 사용자 및/또는 그룹입니다. 이 목록에는 행위자나 컨텍스트의 사용자는 포함되지 않습니다.
    유형: array
    요소:
      유형: object
      필드:
        - 이름: group
          설명: 그룹 세부 정보
          유형: object
          필드:
            - 이름: display_name
              설명: 이 그룹의 이름
              유형: string
            - 이름: group_id
              설명: 이 그룹의 고유 ID
              유형: string
            - 이름: external_id
              설명: 외부 그룹 ID
              유형: string
        - 이름: user
          설명: Dropbox 계정을 가진 사용자
          유형: object
          필드:
            - 이름: .tag
              설명: 멤버 유형의 태그
              유형: string
            - 이름: account_id
              설명: 사용자 고유 ID
              유형: string
            - 이름: display_name
              설명: 사용자 표시 이름
              유형: string
              지표:
                - username
            - 이름: email
              설명: 사용자 이메일 주소
              유형: string
              지표:
                - email
            - 이름: team_member_id
              설명: 팀 멤버 ID
              유형: string
            - 이름: member_external_id
              설명: 팀 멤버 외부 ID
              유형: string
            - 이름: team
              설명: 엔터프라이즈 이벤트에서 이 사용자의 팀에 대한 세부 정보
              유형: object
              필드:
                - 이름: display_name
                  설명: 팀 표시 이름
                  유형: string
            - 이름: trusted_non_team_member_type
              설명: Dropbox 팀의 일원은 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자
              유형: object
              필드:
                - 이름: .tag
                  설명: 유형의 태그
                  유형: string
  - 이름: assets
    설명: 작업에 관련된 0개 이상의 콘텐츠 자산
    유형: array
    요소:
      유형: json