用途:在 Procore 中安全地传输文档、图片与附件,把文件字节、上传会话、返回的存储指令、资源关联和安全下载视为彼此独立的契约,不推断永久公开 URL,也不把客户文档放入日志或诊断包。
主要能力:覆盖直接、分段、统一或资源专属上传流程;上传后按文档化的上传标识或附件引用形状关联目标资源;安全下载时把返回的文件 URL 视为不透明且可能变化;通过校验和或经批准的内容断言验证,并按保留策略删除临时字节与 URL。
使用方式:先盘点传输,记录源校验和、媒体类型、大小、逻辑所有者、目标资源和重复策略,拒绝不支持或未分类内容。选择目标当前文档化的上传流程,不因旧契约返回标识就复用。严格按返回的存储请求执行,包括方法、字段、分段顺序和完成步骤;除非文档明确要求,不把 Procore Bearer 令牌发送到无关存储主机。关联后核对资源,下载时按安全文件指引提供 Bearer 令牌,不持久化签名或重定向 URL。最后比对校验和、记录关联 ID,并按保留策略清理临时字节和 URL。
认证:Procore 资源与安全文件请求使用 OAuth 2.0 Bearer 令牌及所需公司上下文;存储上传授权遵循提供方返回的上传契约,不跨主机泄露 Procore 令牌。
适用场景:需要受治理文件传输的 Procore 项目,例如图纸导入、附件上传与安全下载。
限制:需事先获得批准的公司、项目、目标资源、文件分类和保留期;需具备所需工具访问权限的 OAuth 主体和加密暂存存储。错误处理方面,存储上传失败时保留上传会话引用并按契约允许方式重试;关联返回 422 时验证目标资源、上传 ID 和端点专属请求体,不盲目重传;下载 URL 变化或重定向时按当前安全文件指引处理;校验和或内容断言失败时隔离结果,不向下游发布。输出为传输与分类清单、上传/关联/下载/校验和证据、临时存储删除与保留回执,只返回标识符和哈希,不返回文件内容或签名 URL。