瑞_Java开发手册_（四）安全规约

news2025/2/27 5:00:22

🙊前言：本文章为瑞_系列专栏之《Java开发手册》的安全规约篇。由于博主是从阿里的《Java开发手册》学习到Java的编程规约，所以本系列专栏主要以这本书进行讲解和拓展，有需要的小伙伴可以点击链接下载。本文仅供大家交流、学习及研究使用，禁止用于商业用途，违者必究！

本系列第一篇链接：（一）编程规约
本系列第二篇链接：（二）异常日志
本系列第三篇链接：（三）单元测试

在这里插入图片描述

安全规约的意义

安全规约主要是为了保障代码的安全性，从而减少系统被攻击的风险。安全规约包括但不限于防止SQL注入、XSS攻击、CSRF攻击、文件上传漏洞、文件包含漏洞等方面的安全问题。制定这些规则的目的并不是为了约束和禁锢开发者的创造力，而是为了帮助大家能够在正确的道路上，尽可能的避免踩坑和跑偏。规则可能会对代码实现造成影响，但是制定规则的主要目标是为了让大多数程序员小伙伴可以得到更多的好处。如果在团队实际运作中认为某个规则无法遵循或有更好的做法，希望大家可以共同改进该规范。

安全规约的意义在于：

防止安全漏洞：安全规约提供了一系列的安全实践和建议，帮助开发者避免常见的安全漏洞，如SQL注入、跨站脚本攻击（XSS）等。
提高代码质量：遵循安全规约可以促使开发者编写更加健壮、可靠的代码。通过避免不安全的代码实践，可以提高代码的整体质量，减少潜在的错误和问题。
增强安全性意识：安全规约强调了安全在软件开发中的重要性，促使开发者更加关注安全性问题。通过学习和遵守安全规约，可以提高开发者的安全意识，使安全性成为整个开发团队共同关注的问题。
统一安全标准：安全规约可以作为统一的安全标准，确保所有开发人员遵循相同的最佳实践和准则。这有助于在整个项目中保持一致的安全水平，并减少安全相关的风险。
减少维护成本：遵循安全规约可以降低软件维护成本。安全的代码更易于维护、调试和使用，减少了对安全问题的修复和加固的成本。
合规性：对于一些特定行业或应用场景，可能需要遵循特定的安全标准和法规。遵循安全规约可以帮助开发者确保其代码符合这些标准和法规要求，避免因不合规导致的法律风险和责任。

安全规约

【强制】隶属于用户个人的页面或者功能必须进行权限控制校验。
说明：防止没有做水平权限校验就可随意访问、修改、删除别人的数据，比如查看他人的私信内容。

瑞：水平权限校验是指对用户个人页面或功能的访问权限进行校验，以确保只有经过授权的用户才能访问或修改特定的数据。这种校验通常用于防止未授权的用户随意访问、修改或删除他人的数据，以保护数据的隐私和安全性

【强制】用户敏感数据禁止直接展示，必须对展示数据进行脱敏。
说明：中国大陆个人手机号码显示为:137****0969，隐藏中间 4 位，防止隐私泄露。

瑞：手机号脱敏代码如下（正则表达式参考）：

    public static String maskPhoneNumber(String input) {
        // 匹配手机号的正则表达式
        String phonePattern = "(\\d{3})\\d{4}(\\d{4})";
        // 数据脱敏，将匹配到的手机号中间四位替换为星号
        return input.replaceAll(phonePattern, "$1****$2");
    }

【强制】用户输入的 SQL 参数严格使用参数绑定或者 METADATA 字段值限定，防止 SQL 注入，禁止字符串拼接 SQL 访问数据库。
反例：某系统签名大量被恶意修改，即是因为对于危险字符 # --没有进行转义，导致数据库更新时，where后边的信息被注释掉，对全库进行更新。

瑞：❗️本条为神坑 ❗️ 有小可爱在使用 JDBC 编写SQL时为了方便调试❌选择用如String.format的方式拼接SQL语句❌，拼接出的SQL语句如下所示，假设现在用户使用Ray ' -- （注意要空格，SQL注入）为需要修改的用户名，直接导致where语句之后的信息全部被注释，导致了全表更新❗️ ❗️ ❗️
UPDATE `user` SET nick_name = 'Ray '-- ’ WHERE is_deleted = 0 and id = 1
如果是使用MyBatis等框架，请使用：#{}，#param# 。不要使用${} 此种方式容易出现 SQL 注入。

【强制】用户请求传入的任何参数必须做有效性验证。
说明：忽略参数校验可能导致：
- page size 过大导致内存溢出
- 恶意 order by 导致数据库慢查询
- 缓存击穿
- SSRF
- 任意重定向
- SQL 注入，Shell 注入，反序列化注入
- 正则输入源串拒绝服务 ReDoS
  
  Java 代码用正则来验证客户端的输入，有些正则写法验证普通用户输入没有问题，但是如果攻击人员使用的是特殊构造的字符串来验证，有可能导致死循环的结果。

瑞：本条建议配合测试使用

【强制】禁止向 HTML 页面输出未经安全过滤或未正确转义的用户数据。

瑞：为了防止跨站脚本攻击（XSS）

【强制】表单、AJAX 提交必须执行 CSRF 安全验证。
说明：CSRF(Cross-site request forgery)跨站请求伪造是一类常见编程漏洞。对于存在 CSRF 漏洞的应用/网站，攻击者可以事先构造好 URL，只要受害者用户一访问，后台便在用户不知情的情况下对数据库中用户参数进行相应修改。
【强制】URL 外部重定向传入的目标地址必须执行白名单过滤。