Dropbox 통합

Dropbox 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 직접 Dropbox 플랫폼에 액세스할 수 있습니다. Amazon Quick을 벗어나지 않고도 파일을 업로드하고, 폴더 구조를 관리하고, 공유 링크를 생성하고, 콘텐츠를 검색할 수 있습니다.

Amazon Quick은 Dropbox에 대한 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.

• 기본 OAuth 앱 AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. Dropbox 계정으로 직접 인증합니다.

• 사용자 지정 OAuth 앱 - Dropbox에 등록된 고객 관리형 OAuth 애플리케이션을 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.

• API 키 - 인증에 Dropbox 액세스 토큰을 사용합니다. 이 방법은 개별 사용 또는 테스트에 적합합니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

• 사용하려는 파일 및 폴더에 액세스할 수 있는 활성 Dropbox 계정입니다.

• 사용자 지정 OAuth 앱의 경우: Dropbox 웹 사이트의 Dropbox 앱 콘솔에 액세스하여 앱을 생성합니다.

• API 키의 경우: Dropbox 웹 사이트의 Dropbox 앱 콘솔에서 생성되는 액세스 토큰입니다.

• Amazon Quick 구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.

Dropbox 구성

기본 OAuth 앱 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다Amazon Quick에서 커넥터 설정.

사용자 지정 OAuth 앱 또는 API 키 인증의 경우 Amazon Quick을 구성하기 전에 Dropbox에서 해당 단계를 완료합니다.

사용자 지정 OAuth 앱용 Dropbox 앱 생성

Dropbox 앱 콘솔에서 앱을 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명을 가져옵니다.

1. Dropbox 계정에 로그인하고 Dropbox 웹 사이트의 Dropbox 앱 콘솔로 이동합니다.

2. 앱 생성을 선택합니다.

3. API 선택에서 범위가 지정된 액세스를 선택합니다.

4. 필요한 액세스 유형을 선택합니다.

   • 앱 폴더 - 특정 폴더에 대한 액세스 권한만 제공합니다.

   • 전체 Dropbox - 모든 파일 및 폴더에 대한 액세스를 제공합니다.

5. 앱 이름을 입력하고 앱 생성을 선택합니다.

6. 앱 설정 페이지에서 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.

   • 앱 키 - 클라이언트 ID입니다.

   • 앱 보안 암호 - 클라이언트 보안 암호입니다.

7. OAuth 2의 리디렉션 URIs 섹션에서 Amazon Quick 콜백 URL을 추가합니다. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. 권한 탭을 선택하고 통합에 필요한 범위를 선택합니다. 권장 범위는 섹션을 참조하세요권장 범위.

API 키에 대한 액세스 토큰 생성

API 키 인증을 위해 Dropbox 앱 콘솔에서 액세스 토큰을 생성합니다.

1. Dropbox 계정에 로그인하고 Dropbox 웹 사이트의 Dropbox 앱 콘솔로 이동합니다.

2. 앱을 선택하거나 필요한 경우 새 앱을 생성합니다.

3. OAuth 2에서 생성을 선택하여 액세스 토큰을 생성합니다.

4. 생성된 토큰을 복사하고 안전하게 저장합니다. 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 콘솔에서 커넥터를 선택합니다.

2. 사용 가능 탭에서 Dropbox를 찾아 연결을 선택합니다.

3. Dropbox 로그인 흐름을 완료하고 요청된 권한을 부여합니다.

대신 사용자 지정 OAuth 앱 또는 API 키로 커넥터를 구성하려면 아래 설명과 같이 팀에 대해 생성 탭을 사용합니다.

팀에 대해 생성 탭에서 생성

필요한 Dropbox 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.

1. Amazon Quick 콘솔에서 커넥터를 선택합니다.

2. 팀에 대해 생성 탭을 선택합니다.

3. Dropbox를 찾아 선택합니다.

   참고

   Dropbox 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 해당 커넥터를 선택합니다. 새로 생성하려면 아니요, 새로 생성을 선택합니다.

4. 커넥터의 이름을 입력합니다. 선택적으로 + 설명 추가를 선택하여 설명을 추가합니다.

5. 연결 유형에서 퍼블릭 네트워크를 선택합니다.

6. OAuth 구성에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.

   1. 기본 OAuth 앱의 경우:

      추가 자격 증명은 필요하지 않습니다. 다음을 선택하여 계속 진행합니다.

   2. 사용자 지정 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로 미리 채워집니다.

   3. API 키에서 다음 필드를 구성합니다.

      • 기본 URL(선택 사항) - Dropbox API 기본 URL입니다. 예시: https://api.dropboxapi.com

      • API 키 - Dropbox 액세스 토큰입니다.

      • 이메일(선택 사항) - Dropbox 계정과 연결된 이메일 주소입니다.

7. 다음을 선택합니다.

8. 기본 OAuth 앱 또는 사용자 지정 OAuth 앱을 선택한 경우 Dropbox 권한 부여 창이 열립니다. 요청된 권한을 검토하고 허용을 선택합니다.

9. 검토 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. 다음을 선택합니다.

10. 게시 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사용자에 대해 액세스를 켜거나 특정 팀 또는 그룹을 검색할 수 있습니다.

11. 게시를 선택합니다.

사용 가능한 작업

커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.

Dropbox 사용 가능한 작업

카테고리	작업	설명
파일	파일 나열	폴더의 파일을 나열합니다.
파일	파일 가져오기	파일의 콘텐츠를 읽습니다.
파일	파일 가져오기	파일을 Dropbox에 업로드합니다.
파일	파일 검색	이름 또는 콘텐츠별로 파일 또는 폴더를 검색합니다.
파일	파일 위치 업데이트	파일 또는 폴더를 다른 위치로 이동합니다.
파일	임시 링크 가져오기	파일에 대한 임시 다운로드 링크를 생성합니다.
파일	메타데이터 가져오기	파일 또는 폴더의 메타데이터를 검색합니다.
파일	URL에서 파일 저장	URL에서 Dropbox에 파일을 저장합니다.
폴더	Create Folder	새 폴더를 생성합니다.
폴더	폴더 나열	사용자가 액세스할 수 있는 폴더 목록입니다.
배치 작업	배치 이동 상태 가져오기	배치 이동 작업의 상태를 확인합니다.
공유 중	공유 링크 생성	파일 또는 폴더에 대한 공유 링크를 생성합니다.
공유 중	공유 링크 나열	파일 또는 폴더의 공유 링크를 나열합니다.
공유 중	폴더 공유 업데이트	폴더를 다른 사용자와 공유합니다.
공유 중	수신된 파일 나열	다른 사용자가 공유한 파일을 나열합니다.
파일 요청	파일 요청 생성	다른 사용자가 파일을 업로드하도록 파일 요청을 생성합니다.
Account	사용자 가져오기	인증된 사용자에 대한 정보를 검색합니다.
Account	스페이스 사용량 가져오기	계정의 스토리지 공간 사용량을 검색합니다.

참고

사용할 수 있는 작업은 인증된 사용자가 액세스할 수 있는 파일과 폴더에 따라 다릅니다.

관리 및 문제 해결

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

인증 문제

• 로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱) - Dropbox 계정이 활성 상태이고 Dropbox 웹 사이트에 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Dropbox 앱의 리디렉션 URL이 Amazon Quick 콜백 URL과 일치하는지 확인합니다.

• 잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱) - 클라이언트 ID와 클라이언트 보안 암호가 Dropbox 앱의 앱 키 및 앱 보안 암호 값과 일치하는지 확인합니다. 앱 보안 암호를 다시 생성한 경우 Amazon Quick에서 값을 업데이트합니다.

• API 키 거부됨 - 액세스 토큰이 활성 상태인지 확인합니다. 토큰은 Dropbox 앱 콘솔에서 만료되거나 취소될 수 있습니다.

• 권한 부족 - Dropbox 앱에 사용하려는 작업에 필요한 권한 범위가 있는지 확인합니다.