跳到主要内容

Dropbox 凭据#

您可以使用以下凭据为下列节点进行身份验证:

支持的认证方式#

  • API访问令牌:Dropbox推荐使用此方法进行个人账户测试及有限用户访问授权
  • OAuth2:Dropbox推荐在生产环境或需要超过50个用户测试时使用此方法

应用复用

通过为同一应用在n8n中创建新的OAuth2凭据,您可以将应用从API访问令牌认证迁移至OAuth2认证。

相关资源#

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

使用访问令牌#

配置此凭据需要具备Dropbox开发者账户及以下要素:

  • 访问令牌:创建Dropbox应用后生成
  • 应用访问类型

设置凭据需创建Dropbox应用:

  1. 在Dropbox开发者门户中打开应用控制台
  2. 选择创建应用
  3. 选择API中选取范围化访问
  4. 选择所需访问类型中根据Dropbox节点的使用场景选择:
    • 应用文件夹仅授权访问为应用创建的专属文件夹
    • 完整Dropbox授权访问用户Dropbox中的所有文件和文件夹
    • 更多信息请参阅DBX平台开发指南
  5. 命名应用中输入应用名称,例如n8n集成
  6. 勾选同意Dropbox API服务条款
  7. 选择创建应用,应用设置页面将打开
  8. OAuth 2部分的生成访问令牌中点击生成
  9. 复制访问令牌并粘贴到n8n凭据的访问令牌字段
  10. 在n8n中选择与应用设置相同的应用访问类型

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

用户限制

设置标签页中,即使采用访问令牌方式也可添加其他用户。当应用关联50个Dropbox用户后,您需在两周内申请并通过生产状态审核,否则Dropbox将冻结应用的新用户关联功能。

使用OAuth2#

n8n云端用户须知

云端用户无需提供连接详情。通过浏览器选择连接我的账户即可建立连接。

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

  • 应用文件夹仅授权访问为应用创建的专属文件夹
  • 完整Dropbox授权访问用户Dropbox中的所有文件和文件夹
  • 更多信息请参阅DBX平台开发指南

若您正在自托管n8n,需手动配置OAuth2:

  1. 在Dropbox开发者门户中打开应用控制台
  2. 选择创建应用
  3. 选择API中选取范围化访问
  4. 选择所需访问类型中根据Dropbox节点的使用场景选择:
    • 应用文件夹仅授权访问为应用创建的专属文件夹
    • 完整Dropbox授权访问用户Dropbox中的所有文件和文件夹
    • 更多信息请参阅DBX平台开发指南
  5. 命名应用中输入应用名称,例如n8n集成
  6. 勾选同意Dropbox API服务条款
  7. 选择创建应用,应用设置页面将打开
  8. 复制应用密钥并填入n8n凭据的客户端ID字段
  9. 复制应用秘钥并填入n8n凭据的客户端密钥字段
  10. 在n8n中复制OAuth重定向URL并填入Dropbox的重定向URI字段
  11. 在n8n中选择与应用设置相同的应用访问类型

更多实施细节请参考Dropbox OAuth实施文档中的说明。

对于内部工具和有限使用场景,您可将应用保持为私有状态。若需要超过50个用户使用或进行分发,则需完成Dropbox的生产环境审核流程。详情请参阅DBX平台开发指南中的生产环境审核章节。

用户限制

设置标签页中可添加其他用户。当应用关联50个Dropbox用户后,您需在两周内申请并通过生产状态审核,否则Dropbox将冻结应用的新用户关联功能。