> 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 콘솔의 왼쪽 탐색 표시줄에서 다음을 클릭합니다: **구성** > **로그** **소스**. 2. 다음을 클릭합니다: **새로 만들기.** 3. 선택 **Dropbox** 사용 가능한 로그 소스 목록에서 4. 다음을 클릭합니다: **소스 설정 시작.** 5. 다음을 입력하세요 **이름** 을 소스 이름으로 입력하세요. 예: `내 Dropbox 로그`. 6. 다음을 클릭합니다: **설정.** 7. "자격 증명 설정" 페이지에서 제공된 URL을 복사하여 안전한 위치에 저장하세요. 다음 단계에서 필요합니다. ### 2단계: Dropbox에 새 앱 생성 1. 별도의 브라우저 탭이나 창에서 비즈니스 Dropbox 계정에 로그인한 후 다음으로 이동합니다. [Dropbox 앱 콘솔](https://www.dropbox.com/developers/apps). 2. 다음을 클릭합니다: **앱 만들기**. 3. "DBX Platform에서 새 앱 만들기" 페이지에서 다음 필드를 입력합니다: * API 선택: **범위 지정 액세스**. * 필요한 액세스 유형 선택: **전체 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. 앱 설정 패널로 리디렉션되면 이전에 이 문서의 Panther 콘솔에서 복사한 다음을 붙여넣고 **리디렉션 URI** 를 입력한 뒤 다음을 클릭합니다. **추가** 페이지 상단의 5. 다음으로 이동하세요: **권한** 탭**.** 6. "팀 범위" 섹션에서 다음 옆의 확인란을 선택합니다. `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. 다음으로 돌아갑니다. **설정 탭** 페이지 상단에서. 9. 설정 탭에서 다음을 복사합니다. **앱 키** 그리고 **앱 시크릿** 값을 안전한 위치에 저장하세요. 다음 단계에서 필요합니다. ### 3단계: Panther에서 로그 소스 마무리 1. 이전 단계에서 중단한 "자격 증명 설정" 페이지의 Panther 콘솔로 돌아갑니다. 2. Dropbox의 앱 키를 다음에 붙여넣습니다. **클라이언트 ID** 필드에 붙여넣습니다. 3. Dropbox의 앱 시크릿을 다음에 붙여넣습니다. **클라이언트 시크릿** 필드에 붙여넣습니다. 4. 다음을 클릭합니다: **설정**. 5. "설정 확인" 페이지에서 다음을 클릭합니다. **액세스 허용**. * 앱을 설치하기 위해 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). * 해당 **이벤트가 처리되지 않을 때 알러트를 트리거** 설정의 기본값은 **YES**. 일정 시간이 지나 로그 소스에서 데이터 흐름이 중지되면 알림을 받게 되므로 이 기능을 활성화한 상태로 두는 것을 권장합니다. 기간은 구성 가능하며 기본값은 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 schema: Dropbox.TeamEvent 파서: native: name: Dropbox.TeamEvent description: Dropbox 이벤트는 파일과 전체 Dropbox 환경에서 무슨 일이 일어나고 있는지 모니터링하는 데 도움이 됩니다. referenceURL: https://www.dropbox.com/developers/documentation/http/teams#team_log-get_events fields: - 이름: timestamp required: true description: 이벤트의 타임스탬프 type: timestamp timeFormat: rfc3339 isEventTime: true - name: event_category required: true description: 이 유형의 작업이 속한 범주 type: object fields: - name: .tag required: true description: 범주의 태그 type: string - 이름: event_type required: true description: 수행된 작업의 특정 유형 type: object fields: - name: .tag required: true description: 작업의 태그 type: string - 이름: description description: 작업 설명 type: string - 이름: details required: true description: 이 유형의 작업에 적용되는 가변 이벤트 스키마로, 이 특정 작업에 맞게 인스턴스화됨 유형: json - 이름: actor description: 실제로 작업을 수행한 엔터티 type: object fields: - name: .tag description: 행위자의 태그 type: string - name: admin description: 작업을 수행한 관리자 type: object fields: - name: .tag description: 멤버 유형의 태그 type: string - 이름: account_id description: 사용자 고유 ID type: string - name: display_name description: 사용자 표시 이름 type: string 표시자: - 사용자명 - 이름: email description: 사용자 이메일 주소 type: string 표시자: - 이메일 - name: team_member_id description: 팀 멤버 ID type: string - name: member_external_id description: 팀 멤버 외부 ID type: string - name: team description: 엔터프라이즈 이벤트를 위한 이 사용자의 팀에 대한 세부 정보 type: object fields: - name: display_name description: 팀 표시 이름 type: string - name: trusted_non_team_member_type description: Dropbox 팀의 일부는 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자 type: object fields: - name: .tag description: 유형의 태그 type: string - name: app description: 작업을 수행한 애플리케이션 type: object fields: - name: app_id description: 앱 고유 ID type: string - name: display_name description: 앱 표시 이름 type: string - name: reseller description: 리셀러가 수행한 작업 type: object fields: - name: reseller_name description: 리셀러 이름 type: string 표시자: - 사용자명 - name: reseller_email description: 리셀러 이메일 type: string 표시자: - 이메일 - 이름: user description: 작업을 수행한 사용자 type: object fields: - name: .tag description: 멤버 유형의 태그 type: string - 이름: account_id description: 사용자 고유 ID type: string - name: display_name description: 사용자 표시 이름 type: string 표시자: - 사용자명 - 이름: email description: 사용자 이메일 주소 type: string 표시자: - 이메일 - name: team_member_id description: 팀 멤버 ID type: string - name: member_external_id description: 팀 멤버 외부 ID type: string - name: team description: 엔터프라이즈 이벤트를 위한 이 사용자의 팀에 대한 세부 정보 type: object fields: - name: display_name description: 팀 표시 이름 type: string - name: trusted_non_team_member_type description: Dropbox 팀의 일부는 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자 type: object fields: - name: .tag description: 유형의 태그 type: string - name: origin description: 행위자가 작업을 수행한 출처 type: object fields: - name: access_method description: 작업이 수행된 방식을 나타냄 유형: json - name: geo_location description: 지리적 위치 세부 정보 type: object fields: - 이름: ip_address description: IP 주소 type: string 표시자: - ip - name: city description: 도시 이름 type: string - 이름: region description: 지역 이름 type: string - name: country description: 국가 코드 type: string - name: involve_non_team_member description: 작업에 비팀 멤버가 행위자 또는 영향받은 사용자 중 하나로 포함된 경우 true 유형: boolean - 이름: context description: 행위자가 그를 대신해 작업을 수행한 사용자 또는 팀 type: object fields: - name: .tag description: 멤버 유형의 태그 type: string - 이름: account_id description: 사용자 고유 ID type: string - name: display_name description: 사용자 표시 이름 type: string 표시자: - 사용자명 - 이름: email description: 사용자 이메일 주소 type: string 표시자: - 이메일 - name: team_member_id description: 팀 멤버 ID type: string - name: member_external_id description: 팀 멤버 외부 ID type: string - name: team description: 엔터프라이즈 이벤트를 위한 이 사용자의 팀에 대한 세부 정보 type: object fields: - name: display_name description: 팀 표시 이름 type: string - name: trusted_non_team_member_type description: Dropbox 팀의 일부는 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자 type: object fields: - name: .tag description: 유형의 태그 type: string - name: participants description: 작업의 영향을 받는 0개 이상의 사용자 및/또는 그룹. 이 목록에는 행위자나 컨텍스트 내 사용자는 포함되지 않습니다. type: array element: type: object fields: - name: group description: 그룹 세부 정보 type: object fields: - name: display_name description: 이 그룹의 이름 type: string - name: group_id description: 이 그룹의 고유 ID type: string - name: external_id description: 외부 그룹 ID type: string - 이름: user description: Dropbox 계정을 가진 사용자 type: object fields: - name: .tag description: 멤버 유형의 태그 type: string - 이름: account_id description: 사용자 고유 ID type: string - name: display_name description: 사용자 표시 이름 type: string 표시자: - 사용자명 - 이름: email description: 사용자 이메일 주소 type: string 표시자: - 이메일 - name: team_member_id description: 팀 멤버 ID type: string - name: member_external_id description: 팀 멤버 외부 ID type: string - name: team description: 엔터프라이즈 이벤트를 위한 이 사용자의 팀에 대한 세부 정보 type: object fields: - name: display_name description: 팀 표시 이름 type: string - name: trusted_non_team_member_type description: Dropbox 팀의 일부는 아니지만 신뢰되는 사용자, 즉 엔터프라이즈 관리자 type: object fields: - name: .tag description: 유형의 태그 type: string - name: assets description: 작업에 관련된 0개 이상의 콘텐츠 자산 type: array element: 유형: 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: ``` GET https://docs.panther.com/ko/data-onboarding/supported-logs/dropbox.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.