Amazon Kendra 是一个由机器学习 (ML) 提供支持的、高度准确且易于使用的智能搜索服务。Amazon Kendra 提供了一套数据源连接器，简化了从任何位置提取和索引内容的过程。本文介绍了如何使用 Amazon Kendra 连接器 for Dropbox 来索引存储在 Dropbox 帐户中的信息，并使用 Amazon Kendra 智能搜索功能。

😊 **Amazon Kendra 连接器 for Dropbox**：该连接器允许用户将存储在 Dropbox 帐户中的信息索引到 Amazon Kendra 中，从而实现对 Dropbox 文件和内容的统一搜索。

😁 **配置 Dropbox 应用程序并获取连接详细信息**：首先，用户需要在 Dropbox 开发者网站上创建一个应用程序，并获取应用程序密钥、应用程序机密和会话令牌。这些信息将用于在 Amazon Kendra 中配置 Dropbox 数据源。

🤩 **将 Dropbox 凭据存储在 Secrets Manager 中**：为了安全地存储 Dropbox 凭据，用户可以将其存储在 AWS Secrets Manager 中。Secrets Manager 允许用户存储和管理敏感信息，例如应用程序密钥、密码和数据库连接字符串。

🥳 **创建 Dropbox 数据源**：在 Amazon Kendra 控制台中，用户需要创建一个新的数据源，并指定 Dropbox 连接器类型。然后，他们需要提供从 Secrets Manager 获取的 Dropbox 凭据，以及要索引的 Dropbox 存储库或文件夹的路径。

😉 **索引数据**：一旦数据源被配置，用户就可以开始索引存储在 Dropbox 存储库中的数据。Amazon Kendra 将自动扫描 Dropbox 存储库，并提取所有相关信息，例如文件内容、元数据和文件结构。

😎 **运行查询**：一旦数据被索引，用户就可以使用 Amazon Kendra 的搜索功能来查询存储在 Dropbox 存储库中的信息。Amazon Kendra 的智能搜索功能可以理解自然语言查询，并返回与查询相关的最相关结果。

😮 **Amazon Kendra 的优势**：Amazon Kendra 的智能搜索功能可以准确地从非结构化文档中查找信息，而这些文档包含自然语言叙述内容，对于关键字搜索来说并不十分有效。

🤯 **结论**：使用 Amazon Kendra 连接器 for Dropbox，用户可以轻松地将存储在 Dropbox 帐户中的信息索引到 Amazon Kendra 中，并使用 Amazon Kendra 的智能搜索功能来查找信息。

😎 **示例**：本文还提供了一个示例，展示了如何使用 Amazon Kendra 连接器 for Dropbox 来搜索存储在 Dropbox 帐户中的信息。

🤩 **其他功能**：Amazon Kendra 还提供了其他功能，例如安全性和访问控制，以及与其他 AWS 服务的集成，例如 Amazon CloudWatch 和 Amazon S3。

<section class="blog-post-content"><p><a href="https://aws.amazon.com/kendra/&quot; target="_blank" rel="noopener noreferrer">Amazon Kendra</a> is a highly accurate and simple-to-use intelligent search service powered by machine learning (ML). Amazon Kendra offers a suite of data source connectors to simplify the process of ingesting and indexing your content, wherever it resides.</p><p>Valuable data in organizations is stored in both structured and unstructured repositories. An enterprise search solution should be able to pull together data across several structured and unstructured repositories to index and search on.</p><p>One such data repository is Dropbox. Enterprise users use Dropbox to upload, transfer, and store documents to the cloud. Along with the ability to store documents, Dropbox offers Dropbox Paper, a coediting tool that lets users collaborate and create content in one place. Dropbox Paper can optionally use templates to add structure to documents. In addition to files and paper, Dropbox also allows you to store shortcuts to webpages in your folders.</p><p>We’re excited to announce that you can now use the Amazon Kendra connector for Dropbox to search information stored in your Dropbox account. In this post, we show how to index information stored in Dropbox and use the Amazon Kendra intelligent search function. In addition, Amazon Kendra’s ML powered intelligent search can accurately find information from unstructured documents having natural language narrative content, for which keyword search is not very effective.</p><h2>Solution overview</h2><p>With Amazon Kendra, you can configure multiple data sources to provide a central place to search across your document repository. For our solution, we demonstrate how to index a Dropbox repository or folder using the Amazon Kendra connector for Dropbox. The solution consists of the following steps:</p><ol><li>Configure an app on Dropbox and get the connection details.</li><li>Store the details in <a href="https://aws.amazon.com/secrets-manager/&quot; target="_blank" rel="noopener noreferrer">AWS Secrets Manager</a>.</li><li>Create a Dropbox data source via the Amazon Kendra console.</li><li>Index the data in the Dropbox repository.</li><li>Run a sample query to get the information.</li></ol><h2>Prerequisites</h2><p>To try out the Amazon Kendra connector for Dropbox, you need the following:</p><h2>Configure a Dropbox app and gather connection details</h2><p>Before we set up the Dropbox data source, we need a few details about your Dropbox repository. Let’s gather those in advance.</p><ol><li>Go to <a href="http://www.dropbox.com/developers&quot; target="_blank" rel="noopener noreferrer">www.dropbox.com/developers</a>.</li><li>Choose <strong>App console</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image001.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43023 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image001.png&quot; alt="" width="2139" height="1425" /></a></li><li>Sign in with your credentials (make sure you’re signing in to an Enterprise account).<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image003.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43024 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image003.png&quot; alt="" width="1517" height="1010" /></a></li><li>Choose <strong>Create app</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image005.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43025 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image005.png&quot; alt="" width="2116" height="996" /></a></li><li>Select <strong>Scoped access</strong>.</li><li>Select <strong>Full Dropbox</strong> (or the name of the specific folder you want to index).</li><li>Enter a name for your app.</li><li>Choose <strong>Create app</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image007.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43026 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image007.png&quot; alt="" width="1955" height="1424" /></a>You can see the configuration screen with a set of tabs.</li><li>To set up permissions, choose the <strong>Permissions</strong> tab.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image009.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43027 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image009.png&quot; alt="" width="1378" height="520" /></a></li><li>Select a minimal set of permissions, as shown in the following screenshots.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image011.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43028 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image011.png&quot; alt="" width="1108" height="1043" /></a> <a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image013.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43029 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image013.png&quot; alt="" width="1108" height="457" /></a> <a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image015.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43030 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image015.png&quot; alt="" width="1113" height="1296" /></a> <a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image017.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43031 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image017.png&quot; alt="" width="1115" height="331" /></a></li><li>Choose <strong>Submit</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image019.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43032 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image019.png&quot; alt="" width="1070" height="78" /></a>A message appears saying that the permission change was successful.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image021.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43033 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image021.png&quot; alt="" width="1203" height="81" /></a></li><li>On the <strong>Settings</strong> tab, copy the app key.</li><li>Choose <strong>Show</strong> next to <strong>App secret</strong> and copy the secret.</li><li>Under <strong>Generated access token</strong>, choose <strong>Generate</strong> and copy the token.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image023.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43034 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image023.png&quot; alt="" width="1126" height="1532" /></a></li></ol><p>Store these values in a safe place—we need to refer to these later.</p><p>The session token is valid for up to 4 hours. You have to generate a new session token each time you index the content.</p><h2>Store Dropbox credentials in Secrets Manager</h2><p>To store your Dropbox credentials in Secrets Manager, compete the following steps:</p><ol><li>On the Secrets Manager console, choose <strong>Store a new secret</strong>.</li><li>Choose <strong>Other type of secret</strong>.</li><li>Create three key-value pairs for <code>appKey</code>, <code>appSecret</code>, and <code>refreshToken</code> and enter the values saved from Dropbox.</li><li>Choose <strong>Save</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image025.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43035 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image025.png&quot; alt="" width="1254" height="508" /></a></li><li>For <strong>Secret name</strong>, enter a name (for example, <code>AmazonKendra-dropbox-secret</code>).</li><li>Enter an optional description.</li><li>Choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image027.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43036 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image027.png&quot; alt="" width="1716" height="1146" /></a></li><li>In the <strong>Configure rotation</strong> section, keep all settings at their defaults and choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image029.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43037 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image029.png&quot; alt="" width="1733" height="1280" /></a></li><li>On the <strong>Review</strong> page, choose <strong>Store</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image031.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43039 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image031.png&quot; alt="" width="376" height="69" /></a></li></ol><h2>Configure the Amazon Kendra connector for Dropbox</h2><p>To configure the Amazon Kendra connector, complete the following steps:</p><ol><li>On the Amazon Kendra console, choose <strong>Create an Index</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image033.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43040 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image033.png&quot; alt="" width="1961" height="855" /></a></li><li>For <strong>Index name</strong>, enter a name for the index (for example, <code>my-dropbox-index</code>).</li><li>Enter an optional description.</li><li>For <strong>Role name</strong>, enter an IAM role name.</li><li>Configure optional encryption settings and tags.</li><li>Choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image035.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43041 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image035.png&quot; alt="" width="1091" height="1289" /></a></li><li>In the <strong>Configure user access control</strong> section, leave the settings at their defaults and choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image037.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43042 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image037.png&quot; alt="" width="1360" height="994" /></a></li><li>For <strong>Provisioning editions</strong>, select <strong>Developer edition</strong>.</li><li>Choose <strong>Create</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image039.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43043 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image039.png&quot; alt="" width="1349" height="693" /></a>This creates and propagates the IAM role and then creates the Amazon Kendra index, which can take up to 30 minutes.</li><li>Choose <strong>Data sources</strong> in the navigation pane.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image041.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43044 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image041.png&quot; alt="" width="1853" height="835" /></a></li><li>Under <strong>Dropbox</strong>, choose <strong>Add connector</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image043.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43045 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image043.png&quot; alt="" width="471" height="337" /></a></li><li>For <strong>Data source name</strong>, enter a name (for example, <code>my-dropbox-connector</code>).</li><li>Enter an optional description.</li><li>Choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image045.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43046 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image045.png&quot; alt="" width="1678" height="1019" /></a></li><li>For <strong>Type of authentication token</strong>, select <strong>Access Token (temporary use)</strong>.</li><li>For <strong>AWS Secrets Manager secret</strong>, choose the secret you created earlier.</li><li>For <strong>IAM role</strong>, choose <strong>Create a new role</strong>.</li><li>For <strong>Role name</strong>, enter a name (for example, <code>AmazonKendra-dropbox-role</code>).</li><li>Choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image047.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43047 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image047.png&quot; alt="" width="1366" height="1281" /></a></li><li>For <strong>Select entities or content types</strong>, choose your content types.</li><li>For <strong>Frequency</strong>, choose <strong>Run on demand</strong>.</li><li>Choose <strong>Next</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image049.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43048 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image049.png&quot; alt="" width="1678" height="1058" /></a></li><li>Set any optional field mappings and choose <strong>Next</strong>.</li><li>Choose <strong>Review and Create</strong> and choose <strong>Add data source</strong>.</li><li>Choose <strong>Sync now</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image051.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43050 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image051.png&quot; alt="" width="511" height="316" /></a></li><li>Wait for the sync to complete.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image053.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43051 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image053.png&quot; alt="" width="1061" height="561" /></a></li></ol><h2>Test the solution</h2><p>Now that you have ingested the content from your Dropbox account into your Amazon Kendra index, you can test some queries.</p><p>Go to your index and choose <strong>Search indexed content</strong>. Enter a sample search query and test out your search results (your query will vary based on the contents of your account).</p><p><a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image055.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43052 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image055.png&quot; alt="" width="646" height="735" /></a></p><p>The Dropbox connector also crawls local identity information from Dropbox. For users, it sets user email id as principal. For groups, it sets group id as principal. To filter search results by users/groups, go to the Search Console.</p><p><a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/26/ML-10906-image064.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43171" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/26/ML-10906-image064.png&quot; alt="" width="897" height="337" /></a></p><p>Click on “<strong>Test query with user name or groups</strong>” to expand it and click on the button that says “<strong>apply user name or groups</strong>”.</p><p><a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/26/ML-10906-image065.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43172" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/26/ML-10906-image065.png&quot; alt="" width="736" height="432" /></a></p><p>Enter the user and/or group names and click <strong>Apply</strong>. Next, enter the search query and hit enter. This brings you a filtered set of results based on your criteria.</p><p><a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/26/ML-10906-image066.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43173" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/26/ML-10906-image066.png&quot; alt="" width="902" height="704" /></a></p><p>Congratulations! You have successfully used Amazon Kendra to surface answers and insights based on the content indexed from your Dropbox account.</p><h2>Generate permanent tokens for offline access</h2><p>The instructions in this post walk you through creating, configuring, and using a temporary access token. Apps can also get long-term access by requesting offline access, in which case the app receives a refresh token that can be used to retrieve new short-lived access tokens as needed, without further manual user intervention. You can find more information in the <a href="https://developers.dropbox.com/oauth-guide&quot; target="_blank" rel="noopener noreferrer">Dropbox OAuth Guide</a> and <a href="https://www.dropbox.com/developers/documentation/http/documentation#authorization&quot; target="_blank" rel="noopener noreferrer">Dropbox authorization documentation</a>. Use the following steps to create a permanent refresh token (for example to set the sync to trigger on a schedule):</p><ol><li>Get the app key and app secret as before.</li><li>In a new browser, navigate to <code>https://www.dropbox.com/oauth2/authorize?token_access_type=offline&amp;amp;response_type=code&amp;amp;client_id=&amp;lt;appkey&amp;gt;&lt;/code&gt;.&lt;/li&gt;&lt;li&gt;Accept the defaults and choose <strong>Submit</strong>.</li><li>Choose <strong>Continue</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image057.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43053 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image057.png&quot; alt="" width="718" height="635" /></a></li><li>Choose <strong>Allow</strong>.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image059.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43054 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image059.png&quot; alt="" width="694" height="901" /></a>An access code is generated for you.</li><li>Copy the access code.<a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image061.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43055 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image061.png&quot; alt="" width="696" height="349" /></a>Now you get the refresh token from the access code.</li><li>In a terminal window, run the following curl command:<p><a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image063.png&quot;&gt;&lt;img class="alignnone size-full wp-image-43056 c4" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/09/22/ML-10906-image063.png&quot; alt="" width="1468" height="180" /></a></p></li></ol><p>You can store this refresh token along with the app key and app secret to configure a permanent token in the data source configuration for Amazon Kendra. Amazon Kendra generates the access token and uses it as needed for access.</p><h2>Limitations</h2><p>This solution has the following limitations:</p><ul><li>File comments are not imported into the index</li><li>You don’t have the option to add custom metadata for Dropbox</li><li>Google docs, sheets, and slides need a Google workspace or Google account and are not included</li></ul><h2>Conclusion</h2><p>With the Dropbox connector for Amazon Kendra, organizations can tap into the repository of information stored in their account securely using intelligent search powered by Amazon Kendra.</p><p>In this post, we introduced you to the basics, but there are many additional features that we didn’t cover. For example:</p><ul><li>You can enable user-based access control for your Amazon Kendra index and restrict access to users and groups that you configure</li><li>You can specify <code>allowedUsersColumn</code> and <code>allowedGroupsColumn</code> so you can apply access controls based on users and groups, respectively</li><li>You can map additional fields to Amazon Kendra index attributes and enable them for faceting, search, and display in the search results</li><li>You can integrate the Dropbox data source with the Custom Document Enrichment (CDE) capability in Amazon Kendra to perform additional attribute mapping logic and even custom content transformation during ingestion</li></ul><p>To learn about these possibilities and more, refer to the <a href="https://docs.aws.amazon.com/kendra/latest/dg/what-is-kendra.html&quot; target="_blank" rel="noopener noreferrer">Amazon Kendra Developer Guide</a>.</p><h3>About the author</h3><p class="c5"><a href="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/04/19/Ashish-Lagwankar.jpg&quot;&gt;&lt;img class="size-full wp-image-35479 alignleft" src="https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2022/04/19/Ashish-Lagwankar.jpg&quot; alt="" width="100" height="133" /></a><strong>Ashish Lagwankar</strong> is a Senior Enterprise Solutions Architect at AWS. His core interests include AI/ML, serverless, and container technologies. Ashish is based in the Boston, MA, area and enjoys reading, outdoors, and spending time with his family.</p></section>