Amazon Kendra용 Dropbox 커넥터를 사용하여 Dropbox 콘텐츠 인덱싱

아마존 켄드라 기계 학습(ML)으로 구동되는 매우 정확하고 사용이 간편한 지능형 검색 서비스입니다. Amazon Kendra는 위치에 관계없이 콘텐츠를 수집하고 인덱싱하는 프로세스를 단순화하는 데이터 소스 커넥터 제품군을 제공합니다.

조직의 가치 있는 데이터는 정형 및 비정형 리포지토리 모두에 저장됩니다. 엔터프라이즈 검색 솔루션은 여러 정형 및 비정형 리포지토리에서 데이터를 함께 가져와 인덱싱하고 검색할 수 있어야 합니다.

그러한 데이터 저장소 중 하나가 Dropbox입니다. 기업 사용자는 Dropbox를 사용하여 문서를 클라우드에 업로드, 전송 및 저장합니다. Dropbox는 문서 저장 기능과 함께 사용자가 한 곳에서 협업하고 콘텐츠를 만들 수 있는 공동 편집 도구인 Dropbox Paper를 제공합니다. Dropbox Paper는 선택적으로 템플릿을 사용하여 문서에 구조를 추가할 수 있습니다. 파일과 종이 외에도 Dropbox를 사용하면 폴더에 웹페이지 바로가기를 저장할 수 있습니다.

이제 Dropbox용 Amazon Kendra 커넥터를 사용하여 Dropbox 계정에 저장된 정보를 검색할 수 있음을 알려드리게 되어 기쁩니다. 이 포스트에서는 Dropbox에 저장된 정보를 인덱싱하고 Amazon Kendra 지능형 검색 기능을 사용하는 방법을 보여줍니다. 또한 Amazon Kendra의 ML 기반 지능형 검색은 키워드 검색이 그다지 효과적이지 않은 자연어 내러티브 콘텐츠가 있는 구조화되지 않은 문서에서 정보를 정확하게 찾을 수 있습니다.

솔루션 개요

Amazon Kendra를 사용하면 문서 리포지토리 전체에서 검색할 중앙 위치를 제공하도록 여러 데이터 원본을 구성할 수 있습니다. 우리 솔루션에서는 Dropbox용 Amazon Kendra 커넥터를 사용하여 Dropbox 리포지토리 또는 폴더를 인덱싱하는 방법을 보여줍니다. 솔루션은 다음 단계로 구성됩니다.

1. Dropbox에서 앱을 구성하고 연결 세부 정보를 얻으세요.
2. 에 세부 정보 저장 AWS 비밀 관리자.
3. Amazon Kendra 콘솔을 통해 Dropbox 데이터 원본을 만듭니다.
4. Dropbox 리포지토리에서 데이터를 인덱싱합니다.
5. 샘플 쿼리를 실행하여 정보를 가져옵니다.

사전 조건

Dropbox용 Amazon Kendra 커넥터를 사용해 보려면 다음이 필요합니다.

Dropbox 앱 구성 및 연결 세부정보 수집

Dropbox 데이터 소스를 설정하기 전에 Dropbox 리포지토리에 대한 몇 가지 세부 정보가 필요합니다. 미리 모아두자.

1. We Buy Orders 신청서를 클릭하세요. www.dropbox.com/developers.
2. 왼쪽 메뉴에서 앱 콘솔.
   
3. 자격 증명으로 로그인합니다(Enterprise 계정에 로그인해야 함).
   
4. 왼쪽 메뉴에서 앱 만들기.
   
5. 선택 범위 액세스.
6. 선택 전체 Dropbox (또는 색인을 생성하려는 특정 폴더의 이름).
7. 앱의 이름을 입력합니다.
8. 왼쪽 메뉴에서 앱 만들기.
   
   일련의 탭이 있는 구성 화면을 볼 수 있습니다.
9. 권한을 설정하려면 권한 탭.
   
10. 다음 스크린샷과 같이 최소 권한 집합을 선택합니다.
    
11. 왼쪽 메뉴에서 문의하기.
    
    권한 변경이 성공했다는 메시지가 나타납니다.
    
12. 에 설정 탭에서 앱 키를 복사합니다.
13. 왼쪽 메뉴에서 쇼 옆에 앱 비밀 그리고 비밀을 복사합니다.
14. $XNUMX Million 미만 생성된 액세스 토큰선택한다. 생성 토큰을 복사합니다.
    

이 값을 안전한 장소에 저장하십시오. 나중에 참조해야 합니다.

세션 토큰은 최대 4시간 동안 유효합니다. 콘텐츠를 인덱싱할 때마다 새 세션 토큰을 생성해야 합니다.

Secrets Manager에 Dropbox 자격 증명 저장

Secrets Manager에 Dropbox 자격 증명을 저장하려면 다음 단계를 따르세요.

1. Secrets Manager 콘솔에서 새로운 비밀을 저장.
2. 왼쪽 메뉴에서 다른 유형의 비밀.
3. 에 대한 세 개의 키-값 쌍을 만듭니다. appKey, appSecret및 refreshToken 드롭박스에서 저장한 값을 입력합니다.
4. 왼쪽 메뉴에서 찜하기.
   
5. 럭셔리 비밀 이름, 이름을 입력하십시오 (예 : AmazonKendra-dropbox-secret).
6. 선택적 설명을 입력합니다.
7. 왼쪽 메뉴에서 다음 보기.
   
8. . 순환 구성 섹션에서 모든 설정을 기본값으로 유지하고 다음 보기.
   
9. 에 검토 페이지에서 선택 스토어.
   

Dropbox용 Amazon Kendra 커넥터 구성

Amazon Kendra 커넥터를 구성하려면 다음 단계를 완료하십시오.

1. Amazon Kendra 콘솔에서 인덱스 생성.
   
2. 럭셔리 색인 이름, 색인 이름을 입력합니다(예: my-dropbox-index).
3. 선택적 설명을 입력합니다.
4. 럭셔리 역할 이름, IAM 역할 이름을 입력합니다.
5. 선택적 암호화 설정 및 태그를 구성합니다.
6. 왼쪽 메뉴에서 다음 보기.
   
7. . 사용자 액세스 제어 구성 섹션에서 설정을 기본값으로 두고 다음을 선택합니다. 다음 보기.
   
8. 럭셔리 프로비저닝 에디션, 고르다 개발자 에디션.
9. 왼쪽 메뉴에서 만들기.
   
   이렇게 하면 IAM 역할이 생성 및 전파된 다음 Amazon Kendra 인덱스가 생성되며 최대 30분이 소요될 수 있습니다.
10. 왼쪽 메뉴에서 데이터 소스 탐색 창에서
    
11. $XNUMX Million 미만 드롭 박스선택한다. 커넥터 추가.
    
12. 럭셔리 데이터 소스 이름, 이름을 입력하십시오 (예 : my-dropbox-connector).
13. 선택적 설명을 입력합니다.
14. 왼쪽 메뉴에서 다음 보기.
    
15. 럭셔리 인증 토큰 유형, 고르다 액세스 토큰(임시 사용).
16. 럭셔리 AWS Secrets Manager 암호, 이전에 생성한 비밀을 선택합니다.
17. 럭셔리 IAM 역할선택한다. 새 역할 만들기.
18. 럭셔리 역할 이름, 이름을 입력하십시오 (예 : AmazonKendra-dropbox-role).
19. 왼쪽 메뉴에서 다음 보기.
    
20. 럭셔리 엔터티 또는 콘텐츠 유형 선택, 콘텐츠 유형을 선택합니다.
21. 럭셔리 진동수선택한다. 주문형 실행.
22. 왼쪽 메뉴에서 다음 보기.
    
23. 선택적 필드 매핑을 설정하고 다음 보기.
24. 왼쪽 메뉴에서 검토 및 생성 선택하고 데이터 소스 추가.
25. 왼쪽 메뉴에서 지금 동기화.
    
26. 동기화가 완료될 때까지 기다립니다.
    

솔루션 테스트

이제 Dropbox 계정의 콘텐츠를 Amazon Kendra 인덱스로 수집했으므로 몇 가지 쿼리를 테스트할 수 있습니다.

색인으로 이동하여 선택하십시오. 인덱싱된 콘텐츠 검색. 샘플 검색 쿼리를 입력하고 검색 결과를 테스트합니다(쿼리는 계정 내용에 따라 다름).

Dropbox 커넥터는 Dropbox에서 로컬 ID 정보도 크롤링합니다. 사용자의 경우 사용자 이메일 ID를 주체로 설정합니다. 그룹의 경우 그룹 ID를 주체로 설정합니다. 사용자/그룹별로 검색 결과를 필터링하려면 Search Console로 이동하세요.

클릭 "사용자 이름 또는 그룹으로 쿼리 테스트"를 확장하고 "사용자 이름 또는 그룹 적용".

사용자 및/또는 그룹 이름을 입력하고 신청. 다음으로 검색어를 입력하고 Enter 키를 누릅니다. 이렇게 하면 기준에 따라 필터링된 결과 집합이 제공됩니다.

축하합니다! Amazon Kendra를 사용하여 Dropbox 계정에서 인덱싱된 콘텐츠를 기반으로 답변과 통찰력을 제공하는 데 성공했습니다.

오프라인 액세스를 위한 영구 토큰 생성

이 게시물의 지침은 임시 액세스 토큰을 생성, 구성 및 사용하는 방법을 안내합니다. 앱은 오프라인 액세스를 요청하여 장기 액세스 권한을 얻을 수도 있습니다. 이 경우 앱은 추가 수동 사용자 개입 없이 필요에 따라 새로운 단기 액세스 토큰을 검색하는 데 사용할 수 있는 새로 고침 토큰을 받습니다. 자세한 내용은 Dropbox OAuth 가이드 와 Dropbox 승인 문서. 다음 단계를 사용하여 영구 새로 고침 토큰을 생성합니다(예: 일정에 따라 동기화가 트리거되도록 설정).

1. 이전과 같이 앱 키와 앱 비밀을 가져옵니다.
2. 새 브라우저에서 https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. 기본값을 수락하고 선택 문의하기.
4. 왼쪽 메뉴에서 계속.
   
5. 왼쪽 메뉴에서 허용.
   
   액세스 코드가 생성됩니다.
6. 액세스 코드를 복사합니다.
   
   이제 액세스 코드에서 새로 고침 토큰을 받습니다.
7. 터미널 창에서 다음 curl 명령을 실행합니다.

   curl https://api.dropbox.com/oauth2/token -d code= -d grant_type=authorization_code -u :

   

이 새로 고침 토큰을 앱 키 및 앱 암호와 함께 저장하여 Amazon Kendra에 대한 데이터 원본 구성에서 영구 토큰을 구성할 수 있습니다. Amazon Kendra는 액세스 토큰을 생성하고 필요에 따라 액세스 토큰을 사용합니다.

제한 사항

이 솔루션에는 다음과 같은 제한 사항이 있습니다.

• 파일 주석은 색인으로 가져오지 않습니다.
• Dropbox에 사용자 지정 메타데이터를 추가할 수 있는 옵션이 없습니다.
• Google 문서, 시트 및 슬라이드에는 Google 작업 공간 또는 Google 계정이 필요하며 포함되지 않습니다.

결론

Amazon Kendra용 Dropbox 커넥터를 사용하면 조직은 Amazon Kendra에서 제공하는 지능형 검색을 사용하여 계정에 저장된 정보 저장소를 안전하게 활용할 수 있습니다.

이 게시물에서는 기본 사항을 소개했지만 다루지 않은 추가 기능이 많이 있습니다. 예를 들어:

• Amazon Kendra 인덱스에 대한 사용자 기반 액세스 제어를 활성화하고 구성한 사용자 및 그룹에 대한 액세스를 제한할 수 있습니다.
• 지정할 수 있습니다. allowedUsersColumn 와 allowedGroupsColumn 사용자 및 그룹에 따라 각각 액세스 제어를 적용할 수 있도록
• 추가 필드를 Amazon Kendra 인덱스 속성에 매핑하고 검색 결과에 패싯, 검색 및 표시를 위해 활성화할 수 있습니다.
• Dropbox 데이터 원본을 Amazon Kendra의 CDE(Custom Document Enrichment) 기능과 통합하여 추가 속성 매핑 로직을 수행하고 수집 중 사용자 지정 콘텐츠 변환까지 수행할 수 있습니다.

이러한 가능성 등에 대해 알아보려면 다음을 참조하십시오. Amazon Kendra 개발자 안내서.

저자,

아시시 라그완카르 AWS의 시니어 엔터프라이즈 솔루션 아키텍트입니다. 그의 핵심 관심사는 AI/ML, 서버리스 및 컨테이너 기술입니다. Ashish는 매사추세츠주 보스턴에 거주하며 독서, 야외 활동, 가족과 함께 시간 보내기를 즐깁니다.