> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/data-onboarding/supported-logs/dropbox.md). # Dropbox 로그 ## 개요 Panther는 다음을 쿼리하여 Dropbox 이벤트를 가져올 수 있습니다 [Dropbox Business API](https://www.dropbox.com/developers/documentation/http/teams#team_log-get_events). 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 앱 콘솔](https://www.dropbox.com/developers/apps). 2. 클릭합니다 **앱 만들기**. 3. "Create a new app on the DBX Platform" 페이지에서 다음 필드를 채우세요: * API 선택: 선택하세요 **Scoped Access**. * 필요한 액세스 유형 선택: 선택하세요 **Full Dropbox**. * 앱 이름 지정: 애플리케이션에 대한 설명적인 이름을 입력하세요. * 클릭합니다 **앱 만들기**.\ ![The top of the image has a header that says "Create a new app on the DBX Platform." Under "1. Choose an API" the option "Scoped access" is selected. Under "2. Choose the type of access you need," the option "Full Dropbox" is selected. Under "3. Name your app" there is a field to enter a name.](/files/6353c0e6c90627aa79e9b3f396b07cda422e8f80) 4. 앱 Settings 패널로 리디렉션되면 앞서 이 문서의 이전 단계에서 Panther Console에서 복사한 **Redirect URI** 를 붙여넣고 **추가** 옆에 있는 5. 다음으로 이동하세요: **권한** 페이지 상단의 탭**.** 6. "Team Scopes" 섹션에서 다음 옆의 확인란을 선택하세요. `team_data.member` 및 `events.read`.\ ![The "Team Data" section in Dropbox displays the permission options. The boxes are checked next to "team\_data.member" and "events.read".](/files/c0b9ca044719ee56e9e246b7f736ff42a9eaa32c) 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에서는 성공 화면으로 이동하게 됩니다:\\
The success screen reads, "Everything looks good! Panther will now automatically pull & process logs from your account"
* 선택적으로 하나 이상의 [디택션 팩](https://docs.panther.com/detections/panther-managed/packs). * 다음 **이벤트가 처리되지 않으면 알러트를 발생시키기** 설정의 기본값은 **예**. 일정 시간이 지난 후 로그 소스에서 데이터 흐름이 멈추면 알러트를 받게 되므로 이 설정을 활성화한 상태로 두는 것을 권장합니다. 이 시간 범위는 구성 가능하며 기본값은 24시간입니다.\\
The "Trigger an alert when no events are processed" toggle is set to YES. The "How long should Panther wait before it sends you an alert that no events have been processed" setting is set to 1 Day
## 지원되는 로그 유형 ### Dropbox.TeamEvent 전체 팀 활동의 이벤트를 포함하며, 팀이 Dropbox를 어떻게 사용하고 있는지에 대한 정보를 제공합니다. 자세한 내용은 다음을 참조하세요: [팀 로그 이벤트에 대한 Dropbox 문서.](https://www.dropbox.com/developers/documentation/http/teams#team_log-get_events) ```yaml 스키마: 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 ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.panther.com/ko/data-onboarding/supported-logs/dropbox.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.