N8N中文教程
集成节点/Built in_nodes/Credentials

Dropbox 凭据#

你可以使用这些凭据来认证以下节点:

  • Dropbox

支持的认证方式#

  • API 访问令牌(API access token):Dropbox 推荐此方法用于使用你的用户账户进行测试,或授予少量用户访问权限。
  • OAuth2:Dropbox 推荐此方法用于生产环境,或在测试时涉及超过 50 个用户的情况。

应用复用(App reuse) 你可以在 n8n 中为同一应用创建一个新的 OAuth2 凭据,从而将应用从使用 API 访问令牌迁移到 OAuth2。

相关资源#

更多服务信息,请参考 Dropbox 开发者文档。

使用访问令牌#

要配置此凭据,你需要一个 Dropbox 开发者账户,并准备以下信息:

  • 访问令牌(Access Token):在创建 Dropbox 应用后生成。
  • 应用访问类型(App Access Type)

按照以下步骤创建 Dropbox 应用以设置凭据:

  1. 打开 Dropbox 开发者门户中的 应用控制台(App Console)。
  2. 选择 Create app(创建应用)。
  3. Choose an API(选择 API)中,选择 Scoped access(指定权限访问)。
  4. Choose the type of access you need(选择所需访问类型)中,根据你对 Dropbox 节点的使用需求选择合适的选项:
    • App Folder(应用文件夹):仅授予对你应用专用文件夹的访问权限。
    • Full Dropbox(完整 Dropbox):授予对你用户 Dropbox 中所有文件和文件夹的访问权限。
    • 更多信息请参阅 DBX 平台开发者指南。
  5. Name your app(为你的应用命名)中输入应用名称,例如 n8n integration
  6. 勾选同意 Dropbox API 条款与条件(Dropbox API Terms and Conditions) 的复选框。
  7. 选择 Create app(创建应用)。此时将打开应用的 Settings(设置)页面。
  8. OAuth 2 部分的 Generated access token(生成的访问令牌)处,点击 Generate(生成)。
  9. 复制生成的访问令牌,并将其填入 n8n 凭据中的 Access Token(访问令牌)字段。
  10. 在 n8n 中,选择与你在应用中设置相同的 App Access Type(应用访问类型)。

有关更多信息,请参考 Dropbox 应用控制台设置文档。 用户限制 在 设置(Settings) 选项卡中,即使使用访问令牌方式,你也可以为你的应用添加其他用户。一旦你的应用连接了 50 个 Dropbox 用户,你需要在两周内申请并获得生产状态(production status)批准,否则 Dropbox 将冻结你的应用,禁止其继续绑定更多用户。

使用 OAuth2#

n8n Cloud 用户注意事项 Cloud 用户无需提供连接详情。选择 Connect my account 即可通过浏览器完成连接。 Cloud 用户需要选择 App Access Type(应用访问类型):

  • App Folder(应用文件夹):授予对专为你的应用创建的单个文件夹的访问权限。
  • Full Dropbox(完整 Dropbox):授予对你用户 Dropbox 中所有文件和文件夹的访问权限。
  • 更多信息请参考 DBX 平台开发者指南。

如果你正在自行托管 n8n,则需要手动配置 OAuth2:

  1. 打开 Dropbox 开发者门户中的 App Console。
  2. 选择 Create app(创建应用)。
  3. Choose an API(选择 API)中,选择 Scoped access(按范围访问)。
  4. Choose the type of access you need(选择所需的访问类型)中,根据你对 Dropbox 节点的使用情况选择最合适的选项:
    • App Folder(应用文件夹):授予对专为你的应用创建的单个文件夹的访问权限。
    • Full Dropbox(完整 Dropbox):授予对你用户 Dropbox 中所有文件和文件夹的访问权限。
    • 更多信息请参考 DBX 平台开发者指南。
  5. Name your app(为你的应用命名)中,输入一个应用名称,例如 n8n integration
  6. 勾选同意 Dropbox API Terms and Conditions(Dropbox API 条款与条件)的复选框。
  7. 选择 Create app(创建应用)。此时将打开该应用的 Settings(设置)页面。
  8. 复制 App key(应用密钥),并在你的 n8n 凭据中将其填入 Client ID(客户端 ID)字段。
  9. 复制 Secret(密钥),并在你的 n8n 凭据中将其填入 Client Secret(客户端密钥)字段。
  10. 在 n8n 中复制 OAuth Redirect URL(OAuth 重定向 URL),并将其粘贴到 Dropbox 的 Redirect URIs(重定向 URI)字段中。
  11. 在 n8n 中,选择与你在 Dropbox 应用中设置相同的 App Access Type(应用访问类型)。

有关更多信息,请参考 Dropbox 实现 OAuth 文档 中的说明。 对于内部工具和有限使用场景,您可以将应用保持为私有状态。但如果您希望您的应用被超过 50 名用户使用,或打算公开分发,则需要完成 Dropbox 的生产环境审批流程。更多信息请参阅 DBX 平台开发者指南 中的 Production Approval(生产审批)

用户数量限制 在 Settings(设置) 选项卡中,您可以向您的应用添加其他用户。一旦您的应用关联了 50 个 Dropbox 用户,您将有两周时间申请并获得生产状态批准,否则 Dropbox 将冻结您的应用,禁止其继续关联更多用户。

与文档交流 本页面是否对您有帮助?!Thumbs up有帮助 !Thumbs down没有帮助 感谢您的反馈! 提交 上一页 Drift 凭据 下一页 Dropcontact 凭据 由 Material for MkDocs Insiders 提供支持