[{"data":1,"prerenderedAt":204},["ShallowReactive",2],{"blog:zh:contractor-separation":3},{"id":4,"title":5,"author":6,"body":7,"date":190,"description":191,"extension":192,"meta":193,"navigation":194,"path":195,"seo":196,"stem":197,"tags":198,"__hash__":203},"blog_zh/blog/contractor-separation/zh.md","承包商分离：两层而非一层","Aptli",{"type":8,"value":9,"toc":179},"minimark",[10,14,18,21,24,27,34,40,46,52,55,58,61,64,67,70,73,76,92,95,98,101,108,125,132,135,138,141,144,147,150],[11,12,13],"h2",{"id":13},"情况",[15,16,17],"p",{},"我们合作的组织中，越来越多地采用共享平台，多个主体在同一套基础资产数据上开展工作。例如，一家公用事业公司可能有内部团队、一家总承包商以及两三家分包商，它们都在使用同一个网络。一个市政部门可能既有自己的员工，也有外部工程公司。竞争对手最终在同一个应用程序内协作，这种情况已司空见惯，且日益难以避免。",[15,19,20],{},"显而易见的问题是：如何防止这些用户看到彼此的工作内容。最直观的第一个答案是“给每个人分配一个登录账号”。这样虽然实现了身份验证——这是必要的，但还不够。身份验证只是告诉系统你是谁，却无法告知系统你被允许查看哪些内容。如果没有第二层控制，那么每个登录的用户都能看到所有内容。",[11,22,23],{"id":23},"那些不太站得住脚的方法",[15,25,26],{},"有四种常见的方法，每种都有其适用之处。但每种方法也都有其局限性，这一点值得坦诚面对。",[15,28,29,33],{},[30,31,32],"strong",{},"独立租户部署。"," 为每位承包商提供应用程序的独立副本、独立数据库以及独立环境。这才是真正的隔离，在某些情况下这是最佳方案——通常是当各方之间没有任何共享内容且永远不会进行协作时。但这种方式成本会迅速攀升，如果平台的初衷是协作、汇总报告或建立单一数据源，那么这种做法就违背了平台存在的意义。 如果大部分数据是共享的，只有一小部分是敏感的，那么独立租户方案就显得过度了。",[15,35,36,39],{},[30,37,38],{},"仅隐藏用户界面。"," 这是最常见的应对措施。隐藏按钮、跳过菜单项、过滤列表视图。这不过是“安全表演”。任何掌握浏览器开发者工具、能直接发起 API 请求或进行精准导出的人，都能获取这些“隐藏”的数据。记录依然存在，依然在网络中传输，依然会出现在批量导出中。这只能防止诚实的用户无意中发现某些内容；对于真正想找的人来说，这根本起不到阻挡作用。",[15,41,42,45],{},[30,43,44],{},"应用层过滤，逐个端点实施。"," 这确实是一个进步：在代码中强制执行过滤规则，凡是查询数据的地方都如此。这种方法确实有效——直到某天失效为止。如今，安全机制分散在数十个查询点中。每个新功能都可能成为漏洞，每次重构都可能遗漏某个点。这种方法在发布之初往往是正确的，但随着代码库的增长，正确性会逐渐偏离。",[15,47,48,51],{},[30,49,50],{},"导出到独立的工作区。"," 将每位承包商所需的数据复制到只有他们可见的工作区中。这种做法确实实现了数据隔离，但副本在生成的一瞬间就会过时。此时，问题就从可见性问题变成了同步问题，现场工作人员最终看到的将是今天工作的昨日版本。",[15,53,54],{},"这些方法并非在所有情况下都是错误的。但作为共享平台上多方访问的通用解决方案，它们是不合适的。",[11,56,57],{"id":57},"双层模型",[15,59,60],{},"我们的方法将授权分为两个相互独立的层，它们共同构成系统。",[15,62,63],{},"**管理员权限具有开放性。**它们规定了用户被允许执行的操作——例如创建工单、编辑报告、删除库存商品。如果没有相应的管理员权限，默认情况下您只能查看数据，而无法对其进行修改。",[15,65,66],{},"**角色限制具有排他性。**它们规定了用户完全无法查看或操作的内容。每条限制都指定了一个模型（点、报告、任务）、该模型上的一个字段（所有者、状态、类别）、一个比较条件以及一个值。对于该角色的成员而言，匹配的记录在执行指定操作（读取、编辑、创建、删除）时会被独立隐藏。",[15,68,69],{},"这些层之间互不干扰。一名现场工作人员可以拥有编辑报告的权限，而角色限制会隐藏任何非其本人编写的报告——因此他们可以进行编辑，但仅限于自己的报告。管理员权限授予了该能力；角色限制则缩小了范围。这两层之间无需相互关联，而正是这种独立性，才是该模型经久不衰的主要原因。",[11,71,72],{"id":72},"为什么服务器端字段级强制执行至关重要",[15,74,75],{},"角色限制是在数据离开数据库之前，由服务器端执行的。这在实际应用中至关重要：",[77,78,79,83,86,89],"ul",{},[80,81,82],"li",{},"该过滤器适用于所有查询路径——详情页、列表视图、API 调用、批量导出、地图图块。",[80,84,85],{},"用户若在 URL 中输入其偶然知晓的记录 ID，将收到 404 Not Found 错误，因为对系统而言该记录确实不存在。",[80,87,88],{},"其他用户的屏幕截图毫无用处；当受限用户尝试访问该页面时，数据将无法加载。",[80,90,91],{},"新功能会自动继承这些限制，因为它们都经过相同的服务器数据层。",[15,93,94],{},"UI 层面的隐藏功能在所有这些测试中均告失败。应用层过滤仅在开发者记得在每个新的查询位置应用过滤器时才能通过测试。而在服务器端实施的字段级限制，则将问题从“我们是否记得？”转变为“数据是否符合规则？”——这正是我们真正希望系统能够回答的问题。",[11,96,97],{"id":97},"具体示例",[15,99,100],{},"同一光纤建设项目中有两家承包商。两家都使用同一张地图，都调用相同的共享底图，并各自针对自己的工作生成日志报告。",[15,102,103,104,107],{},"创建一个名为 ",[30,105,106],{},"承包商 A"," 的角色，并设置以下唯一限制：",[77,109,110,113,116,119,122],{},[80,111,112],{},"模型：Point",[80,114,115],{},"字段：owner",[80,117,118],{},"比较条件：=",[80,120,121],{},"筛选值：承包商 B",[80,123,124],{},"被阻止的权限：读取、编辑、创建、删除",[15,126,127,128,131],{},"将承包商 A 的用户添加为成员。对 ",[30,129,130],{},"承包商 B"," 执行相同的操作。这就是全部配置。",[15,133,134],{},"承包商A的团队现在只能看到自己的点位、共享图层，而看不到承包商B的任何内容。如果他们打开点位列表，其中不会包含承包商B的记录。如果他们导出为CSV格式，导出文件会被过滤。如果他们猜测承包商B某个点位的数字ID并将其粘贴到URL中，会收到404错误。承包商B的情况则完全相反。 双方均无法知晓对方已完成多少工作、工作位置以及更新时间。",[15,136,137],{},"双方都能看到这些共享的基础设施——电缆线路、电线杆、管道设施——因为这些设施不受任何限制。在需要协作的地方保持协作；在需要隔离的地方强制隔离。该平台无需在这两者之间做出选择。",[11,139,140],{"id":140},"何时选择独立租户仍是最佳方案",[15,142,143],{},"两层模型并非万能之策。如果双方没有任何资源共享，从不合作，从未发布过联合报告，且出于监管原因必须使用物理上分离的基础设施，那么采用独立租户是明智之选。两层模型所替代的，是更为常见的情况：即各方共享平台的大部分资源，但需要隐藏特定部分。在这种情况下，采用独立租户不仅会浪费资金、破坏报告机制并拖慢工作进度，而仅在用户界面层面进行隐藏则会导致信息泄露。",[15,145,146],{},"我们的判断标准很简单：如果各方能够通过查看相同的底图、运行相同的报表以及在同一张地图上协作而受益，那么他们就应该使用同一个平台——同时确保在实际可行的层面上严格实现功能隔离。",[11,148,149],{"id":149},"摘要",[77,151,152,155,158,161,164,167,170,173,176],{},[80,153,154],{},"在公用事业、电信和市政运营领域，多方在共享平台上的协作日益普遍，且参与方中越来越多地包含彼此竞争的各方。",[80,156,157],{},"仅靠身份验证无法隔离用户；它只能识别用户身份。除非增加第二层防护，否则所有登录用户仍能查看所有内容。",[80,159,160],{},"独立租户部署虽能实现真正的隔离，但在各方需要就大部分数据进行协作时，却违背了共享平台的初衷。",[80,162,163],{},"仅在用户界面层隐藏数据只是“安全作秀”——数据依然存在，且可通过开发者工具、API 或导出功能获取。",[80,165,166],{},"应用层过滤效果虽好，但随着代码库的增长和新功能的添加，往往会逐渐偏离正确性。",[80,168,169],{},"双层模型将授权分为宽松的管理员权限（可执行操作）和严格的角色限制（不可查看的内容），并在服务器端以字段为单位进行强制执行。",[80,171,172],{},"服务器端的字段级强制执行意味着，从受限用户的视角来看，受限数据确实不存在——无论是在 UI 中、API 中、导出文件中，还是在猜测的 URL 中。",[80,174,175],{},"实际配置方案是每位承包商仅分配一个角色，从而在需要隔离的地方实现隔离，同时在需要协作的地方保留共享层。",[80,177,178],{},"当各方没有任何共享内容时，独立租户仍有其存在的价值；但在更常见的情况下——即各方共享大部分内容但需要隐藏其中一部分时，两层模型才是更好的解决方案。",{"title":180,"searchDepth":181,"depth":181,"links":182},"",2,[183,184,185,186,187,188,189],{"id":13,"depth":181,"text":13},{"id":23,"depth":181,"text":23},{"id":57,"depth":181,"text":57},{"id":72,"depth":181,"text":72},{"id":97,"depth":181,"text":97},{"id":140,"depth":181,"text":140},{"id":149,"depth":181,"text":149},"2026-04-16","当多个主体共享一个平台时——无论是员工、分包商，甚至是竞争对手——仅靠身份验证并不足以实现隔离。以下是我们关于如何构建这种隔离机制的思路，这种机制能够真正经得起考验。","md",{},true,"/blog/contractor-separation/zh",{"title":5,"description":191},"blog/contractor-separation/zh",[199,200,201,202],"authorization","multi-tenant","contractor-separation","security","8pxBFQcq1fUw_Nbq4YGqY-6O6-ibmnr8XtufO6qdExM",1780338686066]