기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Dropbox 통합
Dropbox 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 Dropbox 플랫폼에 액세스할 수 있습니다. Amazon Quick을 벗어나지 않고도 파일을 업로드하고, 폴더 구조를 관리하고, 공유 링크를 생성하고, 콘텐츠를 검색할 수 있습니다.
Amazon Quick은 Dropbox에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.
+ **기본 OAuth 앱** AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. Dropbox 계정으로 직접 인증합니다.
+ **사용자 지정 OAuth 앱** - Dropbox에 등록된 고객 관리형 OAuth 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.
+ **API 키** - 인증에 Dropbox 액세스 토큰을 사용합니다. 이 방법은 개별 사용 또는 테스트에 적합합니다.
Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).
## 시작하기 전 준비 사항
통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ 사용하려는 파일 및 폴더에 액세스할 수 있는 활성 Dropbox 계정입니다.
+ **사용자 지정 OAuth 앱**의 경우: [Dropbox 웹 사이트의 Dropbox 앱 콘솔](https://www.dropbox.com/developers/apps)에 액세스하여 앱을 생성합니다.
+ **API 키**의 경우: [Dropbox 웹 사이트의 Dropbox 앱 콘솔](https://www.dropbox.com/developers/apps)에서 생성되는 액세스 토큰입니다.
+ Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).
## Dropbox 구성
**기본 OAuth 앱** 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다[Amazon Quick에서 커넥터 설정](#dropbox-quicksuite-setup).
사용자 지정 OAuth 앱 또는 API 키 인증의 경우 Amazon Quick을 구성하기 전에 Dropbox에서 해당 단계를 완료합니다.
### 사용자 지정 OAuth 앱용 Dropbox 앱 생성
Dropbox 앱 콘솔에서 앱을 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명을 가져옵니다.
1. Dropbox 계정에 로그인하고 [Dropbox 웹 사이트의 Dropbox 앱 콘솔](https://www.dropbox.com/developers/apps)로 이동합니다.
1. **앱 생성**을 선택합니다.
1. **API 선택에서** **범위가 지정된 액세스를** 선택합니다.
1. 필요한 액세스 유형을 선택합니다.
+ **앱 폴더** - 특정 폴더에 대한 액세스 권한만 제공합니다.
+ **전체 Dropbox** - 모든 파일 및 폴더에 대한 액세스를 제공합니다.
1. 앱 이름을 입력하고 **앱 생성을** 선택합니다.
1. 앱 설정 페이지에서 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.
+ **앱 키** - 클라이언트 ID입니다.
+ **앱 보안 암호** - 클라이언트 보안 암호입니다.
1. **OAuth 2**의 **리디렉션 URIs** 섹션에서 Amazon Quick 콜백 URL을 추가합니다. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. **권한** 탭을 선택하고 통합에 필요한 범위를 선택합니다. 권장 범위는 섹션을 참조하세요[권장 범위](#dropbox-oauth-scopes).
### API 키에 대한 액세스 토큰 생성
API 키 인증을 위해 Dropbox 앱 콘솔에서 액세스 토큰을 생성합니다.
1. Dropbox 계정에 로그인하고 [Dropbox 웹 사이트의 Dropbox 앱 콘솔](https://www.dropbox.com/developers/apps)로 이동합니다.
1. 앱을 선택하거나 필요한 경우 새 앱을 생성합니다.
1. **OAuth 2**에서 **생성을** 선택하여 액세스 토큰을 생성합니다.
1. 생성된 토큰을 복사하고 안전하게 저장합니다. Amazon Quick을 구성할 때 필요합니다.
### 권장 범위
Dropbox 앱을 생성할 때 사용하려는 작업을 기반으로 **권한** 탭에서 다음 범위를 구성합니다.
**Dropbox 권장 범위**
| Scope | 설명 |
| --- | --- |
| account\_info.read | 계정 정보를 읽습니다. |
| account\_info.write | 계정 정보를 업데이트합니다. |
| contacts.read | 연락처 정보를 읽습니다. |
| contacts.write | 연락처 정보를 업데이트합니다. |
| events.read | 이벤트 로그 항목을 읽습니다. |
| events.write | 이벤트 로그 항목을 생성합니다. |
| file\_requests.read | 파일 요청을 읽습니다. |
| file\_requests.write | 파일 요청을 생성하고 관리합니다. |
| files.content.read | 파일 콘텐츠를 읽습니다. |
| files.content.write | 파일을 생성, 수정 및 삭제합니다. |
| files.metadata.read | 파일 및 폴더 메타데이터를 읽습니다. |
| files.metadata.write | 파일 및 폴더 메타데이터를 편집합니다. |
| files.permanent\_delete | 파일을 영구적으로 삭제합니다. |
| files.team\_metadata.read | 팀 파일 메타데이터를 읽습니다. |
| files.team\_metadata.write | 팀 파일 메타데이터를 편집합니다. |
| groups.read | 그룹 정보를 읽습니다. |
| groups.write | 그룹을 관리합니다. |
| members.delete | 팀원을 제거합니다. |
| members.read | 팀원 정보를 읽습니다. |
| members.write | 팀원을 관리합니다. |
| sessions.list | 활성 세션을 나열합니다. |
| sessions.modify | 활성 세션을 수정합니다. |
| sharing.read | 공유 설정 및 공유 링크를 읽습니다. |
| sharing.write | 공유 링크 및 폴더 공유를 생성하고 관리합니다. |
| team\_data.content.read | 팀 콘텐츠를 읽습니다. |
| team\_data.content.write | 팀 콘텐츠를 관리합니다. |
| team\_data.governance.read | 팀 데이터 거버넌스 설정을 읽습니다. |
| team\_data.governance.write | 팀 데이터 거버넌스 설정을 관리합니다. |
| team\_data.team\_space | 팀 공간 데이터에 액세스합니다. |
| team\_info.read | 팀 정보를 읽습니다. |
| team\_info.write | 팀 정보를 업데이트합니다. |
## Amazon Quick에서 커넥터 설정
### 사용 가능 탭에서 연결
기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 **사용 가능** 탭에서 직접 연결할 수 있습니다.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **사용 가능** 탭에서 **Dropbox**를 찾아 **연결을** 선택합니다.
1. Dropbox 로그인 흐름을 완료하고 요청된 권한을 부여합니다.
대신 사용자 지정 OAuth 앱 또는 API 키로 커넥터를 구성하려면 아래 설명과 같이 **팀에 대해 생성** 탭을 사용합니다.
### 팀에 대해 생성 탭에서 생성
필요한 Dropbox 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **팀에 대해 생성** 탭을 선택합니다.
1. **Dropbox**를 찾아 선택합니다.
**참고**
Dropbox 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 해당 커넥터를 선택합니다. 새로 생성하려면 **아니요, 새로 생성을** 선택합니다.
1. 커넥터의 **이름을** 입력합니다. 선택적으로 **\+ 설명 추가**를 선택하여 설명을 추가합니다.
1. **연결 유형**에서 **퍼블릭 네트워크를** 선택합니다.
1. **OAuth 구성**에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.
1. **기본 OAuth 앱**의 경우:
추가 자격 증명은 필요하지 않습니다. **다음**을 선택하여 계속 진행합니다.
1. **사용자 지정 OAuth 앱**의 경우 다음 필드를 구성합니다.
+ **기본 URL**(선택 사항) - Dropbox API 기본 URL입니다. 예시: `https://api.dropboxapi.com`
+ **클라이언트 ID** - Dropbox 앱의 앱 키입니다.
+ **클라이언트 보안 암호** - Dropbox 앱의 앱 보안 암호입니다.
+ **토큰 URL** - 토큰 엔드포인트입니다. 예시: `https://api.dropboxapi.com/oauth2/token`
+ **권한 부여 URL** - 권한 부여 엔드포인트입니다. 예시: `https://www.dropbox.com/oauth2/authorize`
+ **리디렉션 URL** - Amazon Quick 콜백 URL로 미리 채워집니다.
1. **API 키**에서 다음 필드를 구성합니다.
+ **기본 URL**(선택 사항) - Dropbox API 기본 URL입니다. 예시: `https://api.dropboxapi.com`
+ **API 키** - Dropbox 액세스 토큰입니다.
+ **이메일**(선택 사항) - Dropbox 계정과 연결된 이메일 주소입니다.
1. **다음**을 선택합니다.
1. **기본 OAuth 앱** 또는 **사용자 지정 OAuth 앱을** 선택한 경우 Dropbox 권한 부여 창이 열립니다. 요청된 권한을 검토하고 **허용**을 선택합니다.
1. **검토** 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. **다음**을 선택합니다.
1. **게시** 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사용자에 대해 액세스를 켜거나 특정 팀 또는 그룹을 검색할 수 있습니다.
1. **게시**를 선택합니다.
## 사용 가능한 작업
커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.
**Dropbox 사용 가능한 작업**
| 카테고리 | 작업 | 설명 |
| --- | --- | --- |
| 파일 | 파일 나열 | 폴더의 파일을 나열합니다. |
| 파일 | 파일 가져오기 | 파일의 콘텐츠를 읽습니다. |
| 파일 | 파일 가져오기 | 파일을 Dropbox에 업로드합니다. |
| 파일 | 파일 검색 | 이름 또는 콘텐츠별로 파일 또는 폴더를 검색합니다. |
| 파일 | 파일 위치 업데이트 | 파일 또는 폴더를 다른 위치로 이동합니다. |
| 파일 | 임시 링크 가져오기 | 파일에 대한 임시 다운로드 링크를 생성합니다. |
| 파일 | 메타데이터 가져오기 | 파일 또는 폴더의 메타데이터를 검색합니다. |
| 파일 | URL에서 파일 저장 | URL에서 Dropbox에 파일을 저장합니다. |
| 폴더 | Create Folder | 새 폴더를 생성합니다. |
| 폴더 | 폴더 나열 | 사용자가 액세스할 수 있는 폴더 목록입니다. |
| 배치 작업 | 배치 이동 상태 가져오기 | 배치 이동 작업의 상태를 확인합니다. |
| 공유 중 | 공유 링크 생성 | 파일 또는 폴더에 대한 공유 링크를 생성합니다. |
| 공유 중 | 공유 링크 나열 | 파일 또는 폴더의 공유 링크를 나열합니다. |
| 공유 중 | 폴더 공유 업데이트 | 폴더를 다른 사용자와 공유합니다. |
| 공유 중 | 수신된 파일 나열 | 다른 사용자가 공유한 파일을 나열합니다. |
| 파일 요청 | 파일 요청 생성 | 다른 사용자가 파일을 업로드하도록 파일 요청을 생성합니다. |
| Account | 사용자 가져오기 | 인증된 사용자에 대한 정보를 검색합니다. |
| Account | 스페이스 사용량 가져오기 | 계정의 스토리지 공간 사용량을 검색합니다. |
**참고**
사용할 수 있는 작업은 인증된 사용자가 액세스할 수 있는 파일과 폴더에 따라 다릅니다.
## 관리 및 문제 해결
커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).
### 인증 문제
+ **로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱)** - Dropbox 계정이 활성 상태이고 [Dropbox 웹 사이트에](https://www.dropbox.com) 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Dropbox 앱의 리디렉션 URL이 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
+ **잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱)** - 클라이언트 ID와 클라이언트 보안 암호가 Dropbox 앱의 앱 키 및 앱 보안 암호 값과 일치하는지 확인합니다. 앱 보안 암호를 다시 생성한 경우 Amazon Quick에서 값을 업데이트합니다.
+ **API 키 거부**됨 - 액세스 토큰이 활성 상태인지 확인합니다. 토큰은 Dropbox 앱 콘솔에서 만료되거나 취소될 수 있습니다.
+ **권한 부족 **- Dropbox 앱에 사용하려는 작업에 필요한 권한 범위가 있는지 확인합니다.