上传文件至BIM360/ACC是否需3-Legged认证?能否用2-Legged认证?
关于BIM 360文件上传使用2-Legged认证的可行性
结论是可以使用2-Legged认证,以下是具体说明:
- 接口标注的“user context optional”明确表示该接口支持两种认证模式:既可以带用户上下文(3-Legged认证)调用,也可以不带用户上下文(2-Legged认证)调用,只要权限配置到位即可。
- 使用2-Legged认证的前提是你的应用已被授予BIM 360 Document Management的对应权限(比如
data:write、data:create等核心权限),并且调用接口时必须显式指定项目ID、文件夹ID等必要参数——因为没有用户上下文,接口无法自动关联到用户默认的项目或文件夹。 - 需要注意的差异点:
- 用2-Legged上传的文件,创建者会显示为你的应用主体,而非具体的BIM 360用户;如果业务需要关联到特定用户的操作记录,建议还是使用3-Legged认证。
- 某些涉及用户专属资源(比如个人文件夹)或依赖用户角色权限继承的场景,2-Legged认证可能无法正常操作,这类情况仍需使用3-Legged。
- 快速验证方式:用2-Legged流程获取访问令牌后,尝试调用指南中的接口(比如获取目标文件夹信息、请求上传预签名URL),如果能成功返回数据,就说明配置没问题。
内容的提问来源于stack exchange,提问作者Jonathan
相关产品推荐
相关产品推荐

