Skip to content

Dropbox 凭据#

¥Dropbox credentials

你可以使用以下凭据验证以下节点：

¥You can use these credentials to authenticate the following nodes:

支持的身份验证方法#

¥Supported authentication methods

  • API 访问令牌：Dropbox 建议使用此方法，通过你的用户账户进行测试，并授予有限数量的用户访问权限。

¥API access token: Dropbox recommends this method for testing with your user account and granting a limited number of users access.

  • OAuth2：Dropbox 建议在生产环境或超过 50 个用户的测试环境中使用此方法。

¥OAuth2: Dropbox recommends this method for production or for testing with more than 50 users.

App reuse

你可以使用同一应用在 n8n 中为 OAuth2 创建新的凭据，从而将应用从 API 访问令牌过渡到 OAuth2。

¥You can transition an app from the API access token to OAuth2 by creating a new credential in n8n for OAuth2 using the same app.

相关资源#

¥Related resources

有关服务的更多信息，请参阅 Dropbox 开发者文档。

¥Refer to Dropbox's Developer documentation for more information about the service.

使用访问令牌#

¥Using access token

要配置此凭据，你需要一个 Dropbox 开发者账户以及：

¥To configure this credential, you'll need a Dropbox developer account and:

  • 访问令牌：创建 Dropbox 应用后生成。

¥An Access Token: Generated once you create a Dropbox app.

  • 应用访问类型

¥An App Access Type

要创建 Dropbox 应用来设置凭据：

¥To set up the credential, create a Dropbox app:

  1. 在 Dropbox 开发者门户中打开 App 控制台。

¥Open the App Console within the Dropbox developer portal. 2. 选择“创建应用”。

¥Select Create app. 3. 在“选择 API”中，选择“范围访问”。

¥In Choose an API, select Scoped access. 4. 在“选择所需的访问类型”中，选择最适合你使用 Dropbox 节点的选项：

¥In Choose the type of access you need, choose whichever option best fits your use of the Dropbox node:

  • 应用文件夹允许访问专门为你的应用创建的单个文件夹。

    ¥App Folder grants access to a single folder created specifically for your app.

  • 完整 Dropbox 权限允许你访问用户 Dropbox 中的所有文件和文件夹。

    ¥Full Dropbox grants access to all files and folders in your user's Dropbox.

  • 更多信息，请参阅 DBX 平台开发者指南。

    ¥Refer to the DBX Platform developer guide for more information. 5. 在“命名应用”中，输入应用名称，例如 n8n integration。

¥In Name your app, enter a name for your app, like n8n integration. 6. 选中复选框以同意 Dropbox API 条款和条件。

¥Check the box to agree to the Dropbox API Terms and Conditions. 7. 选择“创建应用”。打开应用设置。

¥Select Create app. The app's Settings open. 8. 在“OAuth 2”部分的“生成的访问令牌”中，选择“生成”。

¥In the OAuth 2 section, in Generated access token, select Generate. 9. 复制访问令牌，并将其作为访问令牌输入到你的 n8n 凭据中。

¥Copy the access token and enter it as the Access Token in your n8n credential. 10. 在 n8n 中，选择与你为应用选择的相同的应用访问类型。

1
¥In n8n, select the same **App Access Type** you selected for your app.

更多信息，请参阅 Dropbox 应用控制台设置文档。

¥Refer to the Dropbox App Console Settings documentation for more information.

User limits

在“设置”选项卡中，你可以向应用添加其他用户，即使使用访问令牌方法也可以。应用关联 50 位 Dropbox 用户后，你将有两周时间申请并获得生产环境批准，否则 Dropbox 将暂停你的应用关联更多用户。

¥On the Settings tab, you can add other users to your app, even with the access token method. Once your app links 50 Dropbox users, you will have two weeks to apply for and receive production status approval before Dropbox freezes your app from linking more users.

使用 OAuth2#

¥Using OAuth2

Note for n8n Cloud users

Cloud users don't need to provide connection details. Select Connect my account to connect through your browser.

云端用户需要选择应用访问类型：

¥Cloud users need to select the App Access Type:

  • 应用文件夹允许访问专门为你的应用创建的单个文件夹。

¥App Folder grants access to a single folder created specifically for your app.

  • 完整 Dropbox 权限允许你访问用户 Dropbox 中的所有文件和文件夹。

¥Full Dropbox grants access to all files and folders in your user's Dropbox.

¥Refer to the DBX Platform developer guide for more information.

如果你使用的是 self-hosting n8n，则需要手动配置 OAuth2：

¥If you're self-hosting n8n, you'll need to configure OAuth2 manually:

  1. 在 Dropbox 开发者门户中打开 App 控制台。

¥Open the App Console within the Dropbox developer portal. 2. 选择“创建应用”。

¥Select Create app. 3. 在“选择 API”中，选择“范围访问”。

¥In Choose an API, select Scoped access. 4. 在“选择所需的访问类型”中，选择最适合你使用 Dropbox 节点的选项：

¥In Choose the type of access you need, choose whichever option best fits your use of the Dropbox node:

  • 应用文件夹允许访问专门为你的应用创建的单个文件夹。

    ¥App Folder grants access to a single folder created specifically for your app.

  • 完整 Dropbox 权限允许你访问用户 Dropbox 中的所有文件和文件夹。

    ¥Full Dropbox grants access to all files and folders in your user's Dropbox.

  • 更多信息，请参阅 DBX 平台开发者指南。

    ¥Refer to the DBX Platform developer guide for more information. 5. 在“命名应用”中，输入应用名称，例如 n8n integration。

¥In Name your app, enter a name for your app, like n8n integration. 6. 选中复选框以同意 Dropbox API 条款和条件。

¥Check the box to agree to the Dropbox API Terms and Conditions. 7. 选择“创建应用”。打开应用设置。

¥Select Create app. The app's Settings open. 8. 复制应用 ID、客户端 ID 和客户端密钥，并将它们输入到 n8n 的相应字段中。

¥Copy the App key and enter it as the Client ID in your n8n credential. 9. 复制密钥，并将其作为客户端密钥输入到你的 n8n 凭据中。

¥Copy the Secret and enter it as the Client Secret in your n8n credential. 10. 在 n8n 中，复制 OAuth 重定向 URL 并将其输入到 Dropbox 重定向 URI 中。

1
¥In n8n, copy the **OAuth Redirect URL** and enter it in the Dropbox **Redirect URIs**.

  1. 在 n8n 中，选择与你为应用选择的相同的应用访问类型。

    ¥In n8n, select the same App Access Type you selected for your app.

请参阅 Dropbox 实现 OAuth 文档 中的说明以获取更多信息。

¥Refer to the instructions in the Dropbox Implementing OAuth documentation for more information.

对于内部工具和有限的使用，你可以将应用设为私有。但如果你希望你的应用被超过 50 位用户使用，或者你想分发它，则需要完成 Dropbox 的生产审批流程。有关更多信息，请参阅 DBX 平台开发者指南 中的“生产审批”部分。

¥For internal tools and limited usage, you can keep your app private. But if you'd like your app to be used by more than 50 users or you want to distribute it, you'll need to complete Dropbox's production approval process. Refer to Production Approval in the DBX Platform developer guide for more information.

User limits

在“设置”选项卡中，你可以向应用添加其他用户。应用关联 50 位 Dropbox 用户后，你将有两周时间申请并获得生产环境批准，否则 Dropbox 将暂停你的应用关联更多用户。

¥On the Settings tab, you can add other users to your app. Once your app links 50 Dropbox users, you will have two weeks to apply for and receive production status approval before Dropbox freezes your app from linking more users.