内置安全可靠的框架是双赢
Google 内部 Web 框架让开发者省去常见配置和部署杂务,同时通过一致性检查、组件隔离、监控和健康检查提供安全可靠能力。这些能力是框架团队与 SRE、安全团队在设计和实施阶段刻意融入的,并非偶然副产品。默认安全的工具路径可降低犯错机会,与规范和培训相互补充;开发便利与系统安全因而可以同时提高。
主题对照
比较借助类型系统、安全库、编译器与语言选择把错误挡在编码阶段的方法。
Google 内部 Web 框架让开发者省去常见配置和部署杂务,同时通过一致性检查、组件隔离、监控和健康检查提供安全可靠能力。这些能力是框架团队与 SRE、安全团队在设计和实施阶段刻意融入的,并非偶然副产品。默认安全的工具路径可降低犯错机会,与规范和培训相互补充;开发便利与系统安全因而可以同时提高。
每个服务自行拼装身份认证、授权和审计等横切能力,容易漏配授权策略。应用程序框架可确保每个服务有有效策略,并默认拒绝未明确允许的客户端,从而减少重复实现的审查负担。但审查仍须核对框架默认行为、各服务的授权配置和业务逻辑;集中实现不能让审查量只由框架数量决定。参见[[内置安全可靠的框架是双赢]]。
处理 URL 或拼接 SQL 的代码若依赖调用者自行校验,审查就要追溯所有输入路径。可把“已校验 URL”或“可安全拼接的 SQL 字符串”设计成独立类型,仅由构造函数校验后创建。下游只接受该类型,安全不变量主要在构造处核对;这以代码不能绕过类型约束为前提,并不免除对其他业务逻辑的审查。
Tink 等安全库可防止 GCM 随机数重用等实现错误,却不能替开发者判断设计是否适用。对信用卡号等取值空间有限的数据直接哈希,结果仍可能被枚举;应按数据特性选择合适的保护方式。审查时既要核对是否使用可靠的库,也要核对所选机制能否覆盖当前威胁。
直接解析互联网证书签名请求等不可信输入的模块可优先使用 Go 等内存安全语言,减少内存类漏洞。必须使用 C++ 的组件,则配合 W^X、Scudo、SafeStack 等防护;还可让不同实现分别解析请求并比较结果。语言与缓解措施应随输入信任程度和基础设施约束选择。
现成 CA 软件支持大量不需要的证书属性和扩展字段,每种多余功能都会增加审计与故障面。只实现面向 Web 服务的实际证书用例,可让系统更易理解、验证和维护。实现标准时应从真实需求确定功能子集,而非把规范中的所有可选能力都视为必须支持。
同样是发现”这段代码使用了不安全的API”,编译器当场报错和提交审查时才被指出,修复成本天差地别——审查时代码已写完并能跑,这时才被要求重构会让开发者沮丧;编译期报错时开发者对上下文记忆最新鲜,能快速处理。这提示把安全检查往左移到编译期(用类型系统或Error Prone、Tsetse这类插件强制),比依赖事后人工审查更有效,是反馈时机决定了修复的心理成本和质量。
给历史遗留的不安全函数(如接受裸字符串的SQL查询接口)新增一个只接受安全类型参数的重载版本,给存量调用点标注注解,再引入Git hooks阻止增量代码继续使用字符串类型重载,或用可见性白名单限制不安全API只能经安全团队审批调用。存量不安全调用被冻结不再增长,新代码被迫走安全路径。随项目活跃开发,安全调用比例会自然向安全API收拢,直到旧调用少到可人工清理,代码从设计机制上彻底摆脱这类漏洞。
想做一个能应对所有场景的安全库(比如处理HTML单引号、JS作用域、HTML属性三层嵌套上下文的模板引擎)往往极其复杂,难以正确使用。更实际的策略是反过来:先做一个只覆盖最常见场景、简单到易于解释和正确使用的小库,帮助说服其他人采纳”默认安全”的函数库;不同场景(复杂页面模板与短代码片段)再提供不同库。这是用真实使用频率反向驱动库的复杂度增长,而非一开始追求大而全。
为“以防万一”预先实现的分支增加文档、测试和维护负担,也常因缺少真实调用场景而未被充分验证。一旦意外触发,可能暴露安全或可靠性缺陷。YAGNI 原则要求只实现当前需要的功能;减少未使用路径,既节省维护成本,也缩小待审查和测试的行为范围。
普通数字无法让编译器区分秒与分钟、磅与千克;单位混淆可能造成严重后果。把时长、重量等量封装为带单位的强类型,只允许有意义的运算,并明确进行单位换算,可在编译或构造阶段发现错误,避免让无单位数字跨接口传播。
RPC 框架可把鉴权拦截器验证过的调用方信息放进请求上下文,让下游拦截器使用同一份可信身份;上下文还追踪请求执行时间,发生明显超时时自动取消后续工作并尽快通知客户端。身份和时限随请求传递,能减少各层重复验证或继续处理已无效请求。
迁移大量接受裸字符串的遗留 API 时,可把“任意字符串→安全类型”的临时豁免集中到一个转换函数,先让调用点改用受类型约束的新 API。集中入口便于审查和统计剩余依赖,但它本身不证明输入安全;存量迁完后必须删除该入口,才能真正关闭绕过路径。这补充了[[给不安全API判类型实现渐进式退场]]的收尾步骤。
Go 的隐式转换主要服务常量,而不是让变量之间自由互转。这样避免了 C 系语言常见的静默截断和符号错误;发散:少一点便利,换来更少隐藏 bug。
数组长度是类型的一部分,编译器能在部分场景提前发现越界或优化边界检查。固定形状的数据结构让编译期掌握更多事实,也给运行时少留一点不确定性。
JSLint 是一个 JavaScript 代码质量工具,扫描源文本并对发现的问题给出描述和大致位置;被发现的问题多是语法错误,但也包括代码风格惯例和结构上的问题。它”不会证明你的程序是否正确,只是提供了另一种视角帮助你辨认问题”——静态检查工具的定位是发现高风险信号,而不是给出正确性证明。发散:工具的价值不是替代思考,而是把重复性警觉自动化,让人把注意力留给工具无法判断的语义问题。
JSLint 定义了比当时 ECMAScript 第3版更严格的 JS 子集,与第9章代码风格密切相关;检查未声明变量、危险特性和代码块等约定,把“更好子集”从文字建议变成自动化规则。具体 JSLint 选项随版本变化,原则是用工具持续执行团队选定的规则。关联:[[好语言可取子集]];发散:工具能稳定提醒,但取舍仍需解释业务语义。
加锁模式最怕有人漏写加锁代码,而离线并发问题极难测试。隐含锁把不能跳过的加锁动作下沉到框架、层超类型或代码生成中。应自动化的是乐观锁的版本存储、检查与递增,以及悲观锁中为读取获取锁、事务结束释放所有锁;唯独为编辑获取写锁不该自动化:否则写锁失效时用户无从提前知道、无法尽早止损,并发度也被压到最低。框架只需在提交前检查写锁是否已显式获取,没有就抛出并发异常,而不是依赖可能被关闭的断言。
Java泛型以类型擦除实现通用实例,不能把T直接当成运行时可具体化的类来 new T()、new T[] 或 instanceof T。擦除不表示类文件里完全没有泛型签名元数据。发散:泛型提升编译期表达力,但运行期能力仍受语言实现策略约束。
Java虚拟机规范的Signature属性说明泛型声明可保存为签名元数据;这与运行时不能直接实例化类型变量并不矛盾。
给抽象概念主动施加约束,反而能增强对系统的推理能力,而不是限制自由。例如把”作业”限定为无副作用,就更容易推理同一作业的重复运行及多个作业的并行执行,减少作业通过共享副作用彼此干扰;无副作用本身并不保证进程或集群绝不故障;反之,对随意编写、没有约束的代码块,开发者很难判断它”不会做什么”,因为缺乏约束意味着无法排除任何可能性。发散:这解释了为什么类型系统、不可变数据结构、纯函数这类”限制自由”的设计,长期看反而降低了系统的认知负担。
约束像导轨,限制不希望出现的设计,使质量目标更易分析;它同时排除了其他人可能提出的方案,因此要说明收益和代价。
“从无约束开始”是思考新增约束的基线,不是移除既有安全要求的操作建议。原书Android权限案例是历史说明,不作为当前平台授权机制的描述。
设计和构图会被嵌套,之后还可能出新版本或被删掉。如果订单只保存引用,新版本会改到旧订单,删除则会留下悬空引用。
两条规则一起用:创建之后不再修改;选用时复制完整副本,不保留引用。从复制那一刻起,新旧构图互不影响,订单里的描述也带上完整副本。
图像文件太大,是唯一不复制的东西。每张图分配一个 GUID,也就是全局唯一标识;一旦分配,这张图就不再修改。订单只收集这些标识,把对应文件放进 DVD。
无类型常量能按赋值目标隐式获得整数或浮点类型,但必须满足目标类型的可表示性规则:整数目标不能截去小数部分;浮点目标允许按其精度舍入。它是 [[隐式转换很窄]] 的具体边界;检查赋值错误时,要区分整数截断与浮点舍入。
类型若把零值设计为有效状态,调用者就可直接声明变量而不必调用构造器。bytes.Buffer 的零值是空缓冲,sync.Mutex 的零值是未锁定状态;把二者放进结构体后,外层结构体也能继承这种开箱即用的性质。设计类型时考虑零值,可减少初始化步骤。
若接口使用只在运行时发生,编译器可能没有机会检查某个类型是否具备预期方法。包内可写 var _ json.Marshaler = (*RawMessage)(nil)。(*RawMessage)(nil) 是一个空指针,不分配对象;把它赋给接口,只为了让编译器确认 *RawMessage 实现了 Marshaler。接口以后改了,这一行会编译失败。_ 表明这里只要检查、不保留变量。已有静态使用能完成检查时,不必重复声明。
Kotlin 把可空性放进类型系统,让“可能为 null”在编译期暴露,而不是等运行时抛异常。可空类型、非空类型和安全调用把空值处理从隐性约定变成显性契约。发散:越早暴露约束,越少依赖测试和运气兜底。
密封类用有限子类表达受限继承结构,适合建模“状态只有这几种”的业务结果。调用方处理分支时能围绕已知状态展开,减少遗漏未知类型的风险。发散:比起散落的字符串状态码,密封类让状态空间更接近领域模型。
点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。
来源书籍
编程语言类
书籍类型:未标注
清单覆盖 6/9
80 张卡片
来源书籍
系统架构类
书籍类型:未标注
类别清单尚未核对
384 张卡片
来源书籍
编程语言类
书籍类型:经典原理
清单覆盖 8/9
182 张卡片
来源书籍
编程语言类
书籍类型:未标注
类别清单尚未核对
106 张卡片
来源书籍
系统架构类
书籍类型:经典原理
清单覆盖 3/6
177 张卡片
来源书籍
代码可读性与重构类
书籍类型:经典原理
清单覆盖 7/7
109 张卡片
来源书籍
书籍类型:速查手册
39 张卡片
来源书籍
书籍类型:未标注
240 张卡片
来源书籍
系统架构类
书籍类型:未标注
清单覆盖 5/7
194 张卡片
主题索引
比较 HTTP 认证方案、OAuth2 与 JWT、会话状态,以及摘要、加密、签名、证书与 TLS 的密码学基础。
主题索引
系统事务的隔离与锁,以及跨越多个请求的业务事务如何用乐观/悲观离线锁、粗粒度锁和隐含锁保持一致。
主题索引
比较内部与外部质量、多准则权衡以及“先满足当前需求”在不同质量目标之间的取舍方法。
主题索引
业务事务比系统事务长得多,中间隔着用户思考时间:乐观离线锁与悲观离线锁怎么选、粗粒度锁与隐含锁的代价、版本号与条件更新怎样防止覆盖、预留与冻结怎样替代事后校验,以及离线并发为什么能免则免。
主题索引
比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。
主题索引
比较如何从语言中划出可靠子集、以编码约定和工具约束规避语言缺陷。
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类