!3883 【OpenHarmony开源贡献者计划2022】修正格式效果

Merge pull request !3883 from Mr_YX/master

zh-cn/contribute/OpenHarmony-security-design-guide.md

@@ -6,17 +6,17 @@
 
 1-1	为了防止系统和资源被非法访问，除非标准协议约定，所有能对系统进行管理的接口，应具备接入认证机制并缺省启用。
 
-**说明：**为减少系统攻击面，对于可对系统进行管理(包括配置、升级、调试等)的接口必须要启用认证机制，避免未授权的访问。
+**说明**：为减少系统攻击面，对于可对系统进行管理(包括配置、升级、调试等)的接口必须要启用认证机制，避免未授权的访问。
 
 1-2	只保留运行维护所必需的对外通信连接，关闭不需要连接、端口。
 
-**说明：**关闭不必要的通信端口，可大大降低安全威胁，是系统安全防护的基础手段。
+**说明**：关闭不必要的通信端口，可大大降低安全威胁，是系统安全防护的基础手段。
 
 ## 2.应用安全
 
 2-1	对于每一个需要授权访问的请求都需核实请求方的会话标识是否合法、请求方是否被授权执行此操作。
 
-**说明：**避免越权访问。
+**说明**：避免越权访问。
 
 2-2	认证处理过程在客户端实现是不可靠的，可被轻易绕过，因此对用户的最终认证处理过程必须放到服务端进行。
 
@@ -24,9 +24,9 @@
 
 3-1	应该使用经过验证的、安全的、公开的加密算法。
 
-**说明：**算法的安全性不在于算法本身的机密性。
+**说明**：算法的安全性不在于算法本身的机密性。
 
-**示例：**推荐使用的密码算法：
+**示例**：推荐使用的密码算法：
 1）分组密码算法：AES（密钥长度在128位及以上）
 2）流密码算法：AES（密钥长度在128位及以上）（OFB或CTR模式）
 3）非对称加密算法：RSA（推荐3072位)
@@ -38,9 +38,9 @@
 
 3-3	密码算法中使用到的随机数必须是密码学意义上的安全随机数。
 
-**说明：**使用了不安全的随机数，容易导致密码算法的强度降低甚至算法的失效。
+**说明**：使用了不安全的随机数，容易导致密码算法的强度降低甚至算法的失效。
 
-**示例：**可使用以下的安全随机数生成接口：
+**示例**：可使用以下的安全随机数生成接口：
 1) OpenSSL的RAND_bytes或RAND_priv_bytes；
 2) OpenSSL FIPS模块中实现的DRBG；
 3) JDK的java.security.SecureRandom；
@@ -48,37 +48,37 @@
 
 3-4	默认使用安全的密码算法，关闭或者禁用不安全的密码算法。在选择密码算法库时，应使用通过认证的或业界开源公认的或经评估认可的密码算法库。
 
-**说明：**随着密码技术的发展以及计算能力的提升，一些密码算法变得不再安全，使用不安全的密码算法，有可能为用户的数据带来风险。同时非专业人员实现的密码算法，在技术上未经业界分析验证，有可能存在未知的缺陷，因此应使用通过认证的或业界开源公认的或经评估认可的密码算法库。
+**说明**：随着密码技术的发展以及计算能力的提升，一些密码算法变得不再安全，使用不安全的密码算法，有可能为用户的数据带来风险。同时非专业人员实现的密码算法，在技术上未经业界分析验证，有可能存在未知的缺陷，因此应使用通过认证的或业界开源公认的或经评估认可的密码算法库。
 
-**示例：**密码算法相关示例请参考3-1。
+**示例**：密码算法相关示例请参考3-1。
 
 3-5	使用分组密码算法时，应优先选择GCM模式。	
 
 3-6	使用RSA算法进行加密操作时，应优先选择OAEP填充方式。
 
-**说明：**学术界和业界针对RSA的PKCS1填充方式的攻击已经比较成熟，如果不使用OAEP填充替换PKCS1填充，攻击者解密密文的难度将大大降低。
+**说明**：学术界和业界针对RSA的PKCS1填充方式的攻击已经比较成熟，如果不使用OAEP填充替换PKCS1填充，攻击者解密密文的难度将大大降低。
 
 3-7	使用非对称运算保护数据机密性时，避免使用私钥加密敏感数据。
 
-**说明：**私钥加密无法保护数据的机密性。	
+**说明**：私钥加密无法保护数据的机密性。	
 
 3-8	使用非对称算法时，加密和签名要使用不同的密钥对。
 
 3-9	在同时需要对数据进行对称加密和数字签名时，使用先签名后加密的方式。检查程序里的密码算法函数调用次序，避免对密文的hash值进行签名（即对密文的hash值进行私钥运算）。
 
-**说明：**如果对密文签名（即对密文的hash值签名），一旦攻击者可以通过网络嗅探的方式获得密文（也就可以获取密文hash值），就可以任意篡改密文消息的签名。
+**说明**：如果对密文签名（即对密文的hash值签名），一旦攻击者可以通过网络嗅探的方式获得密文（也就可以获取密文hash值），就可以任意篡改密文消息的签名。
 
 3-10  使用DH算法进行密钥协商的双方在接收到对方发送过来的“公钥”时，应判断公钥是不是0,1,p-1,p这样的特殊值并要求重新发起密钥协商。
 
-**说明：**如果使用DH算法进行密钥协商的双方在接收到的对方发送的“公钥是某些特殊值“，则协商出的密钥也一定是某些已知的值。在这种情况下，攻击者可以尝试最多5个可能的密钥就可以轻易的解密密文。	
+**说明**：如果使用DH算法进行密钥协商的双方在接收到的对方发送的“公钥是某些特殊值“，则协商出的密钥也一定是某些已知的值。在这种情况下，攻击者可以尝试最多5个可能的密钥就可以轻易的解密密文。	
 
 3-11	在SSL/TLS中协议中，如使用DH/ECDH算法进行密钥协商，出于前向安全考虑，选取包含DHE或ECDHE密钥交换算法的加密套件，避免选取仅包含DH/ECDH的加密套件。
 
 3-12	密码协议中不要使用截短的消息认证码。
 
-**说明：**密码协议中（如TLS、SSH、IKE等），使用消息认证码（MAC）验证消息的完整性，协议标准有时支持选取截短的消息认证码。此时，消息认证码安全性也因截短而降低，如针对多种密码协议（如TLS、SSH等）的SLOTH攻击就可以利用截短哈希值构造碰撞。
+**说明**：密码协议中（如TLS、SSH、IKE等），使用消息认证码（MAC）验证消息的完整性，协议标准有时支持选取截短的消息认证码。此时，消息认证码安全性也因截短而降低，如针对多种密码协议（如TLS、SSH等）的SLOTH攻击就可以利用截短哈希值构造碰撞。
 
-**示例：**截短消息认证码的配置举例：SSH协议中配置HMAC-MD5-96、HMAC-SHA1-96、HMAC-SHA2-256-96
+**示例**：截短消息认证码的配置举例：SSH协议中配置HMAC-MD5-96、HMAC-SHA1-96、HMAC-SHA2-256-96
 哈希算法的标准输出长度如下，低于标准长度可视为截短：
 1）SHA1/HMAC-SHA1，标准输出长度160比特
 2）SHA224/HMAC-SHA224，标准输出长度224比特
@@ -90,33 +90,33 @@
 
 3-13	使用HMAC保护数据完整性时，不能使用hash(key||message)或hash(message||key)的计算结果作为MAC值。
 
-**说明：**攻击者可以通过在原始明文后面追加任意信息的方式篡改明文，破坏数据的完整性。
+**说明**：攻击者可以通过在原始明文后面追加任意信息的方式篡改明文，破坏数据的完整性。
 
 3-14	同一笔业务中，若既需要加密运算也需要计算MAC时，加密操作和计算MAC操作不能使用同一个对称密钥。
 
-**说明：**如果加密和MAC密钥相同，一旦密钥泄露，攻击者可以有针对性的篡改机密信息。	
+**说明**：如果加密和MAC密钥相同，一旦密钥泄露，攻击者可以有针对性的篡改机密信息。	
 3-15	加密时避免使用固定的IV（如：硬编码，或固定在配置文件中）。
 
-**说明：**CBC模式的随机IV值可确保相同的明文、相同的密钥加密出的密文完全不同，如果IV无法确保每次加密都不同，对于CBC模式，攻击者可以轻易的进行密文替换攻击；CBC模式之外的其他分组密码运算模式（如：OFB、CRT等），攻击者可以非常容易的解密密文。	
+**说明**：CBC模式的随机IV值可确保相同的明文、相同的密钥加密出的密文完全不同，如果IV无法确保每次加密都不同，对于CBC模式，攻击者可以轻易的进行密文替换攻击；CBC模式之外的其他分组密码运算模式（如：OFB、CRT等），攻击者可以非常容易的解密密文。	
 
 3-16	密码协议中避免选择匿名认证、无加密、弱身份认证、弱密钥交换、弱对称加密算法和弱消息认证算法的加密算法套件。
 
-**说明：**容易造成安全上的薄弱环节从而降低系统的安全性。
+**说明**：容易造成安全上的薄弱环节从而降低系统的安全性。
 
-**示例：**匿名认证举例：TLS_DH_anon_WITH_3DES_EDE_CBC_SHA、TLS_DH_anon_WITH_AES_256_CBC_SHA
+**示例**：匿名认证举例：TLS_DH_anon_WITH_3DES_EDE_CBC_SHA、TLS_DH_anon_WITH_AES_256_CBC_SHA
 弱身份认证举例：密钥长度小于2048比特的RSA/DSA密钥
 
 3-17	推荐仅选择使用ECDHE作为密钥交换算法的加密套件。		
 
 3-18	用于数据加解密的密钥不能硬编码在代码中，应采用根密钥等加密保护，同时根密钥也需采用适当的安全机制进行保护(如仅对部分密钥组件进行硬编码)。
 
-**说明：**硬编码密钥容易被逆向分析破解。
+**说明**：硬编码密钥容易被逆向分析破解。
 
 3-19	功能设计中建议支持工作密钥更新方法（密钥更新方式：手动更新、自动更新等），并规定工作密钥更新规则（在线更新、离线更新、更新时间等）。
 
-**说明：**密钥使用时间越长，密钥被破解的风险也越大；密钥加密的数据量越多，攻击者能够获取到密文的数据机会也越大，而对被同一个密钥加密的多个密文进行密码学分析相对比较容易，导致密钥越容易被破解；如果密钥已经泄露，那么密钥被使用的时间越久，损失越大。
+**说明**：密钥使用时间越长，密钥被破解的风险也越大；密钥加密的数据量越多，攻击者能够获取到密文的数据机会也越大，而对被同一个密钥加密的多个密文进行密码学分析相对比较容易，导致密钥越容易被破解；如果密钥已经泄露，那么密钥被使用的时间越久，损失越大。
 
-**示例：**当密钥需要更新时，根据密钥生成的规则，重新生成新密钥，同时使用旧密钥解密已加密的数据，并使用新生成的密钥重新加密，同时销毁旧密钥；对于加密数据量很大的场景，可以考虑保留旧密钥，用于解密旧密钥加密的数据，同时使用更新后的密钥加密新数据。
+**示例**：当密钥需要更新时，根据密钥生成的规则，重新生成新密钥，同时使用旧密钥解密已加密的数据，并使用新生成的密钥重新加密，同时销毁旧密钥；对于加密数据量很大的场景，可以考虑保留旧密钥，用于解密旧密钥加密的数据，同时使用更新后的密钥加密新数据。
 
 3-20	密钥材料及密钥组件在保存时须限定其权限（如权限600或400）。		
 
@@ -128,7 +128,7 @@
 
 4-2	认证凭据不需要还原的场景，应使用PBKDF2等不可逆的算法加密，对于性能敏感且安全性要求不高的场景可使用HMAC（认证凭据，盐值）（注：认证凭据、盐值位置可以互换）。
 
-**示例：**1、认证凭据使用PBKDF2算法计算口令单向哈希时，迭代次数最低1000次。
+**示例**：1、认证凭据使用PBKDF2算法计算口令单向哈希时，迭代次数最低1000次。
 2、盐值Salt为密码学意义上的安全随机数，由系统随机生成，盐值salt至少16字节，并按用户区分。
 3、避免使用HASH(用户名||口令)、HMAC(用户名，口令)、HASH(口令 XOR salt)。
 
@@ -152,40 +152,40 @@
 
 5-4	应使用合适的安全协议，不安全协议应默认关闭。
 
-**示例：**安全协议举例：SSHv2/TLS1.2/TLS1.3/IPSec/SFTP/SNMPv3等协议，及其业界最新安全版本。对于流密码算法，建议使用AES的OFB和CTR模式或chacha20流加密算法替换RC4算法。
+**示例**：安全协议举例：SSHv2/TLS1.2/TLS1.3/IPSec/SFTP/SNMPv3等协议，及其业界最新安全版本。对于流密码算法，建议使用AES的OFB和CTR模式或chacha20流加密算法替换RC4算法。
 不安全协议举例：TFTP、FTP、Telnet、SSL2.0、SSL3.0、TLS1.0、TLS1.1、SNMP v1/v2和SSHv1.x。
 
 5-5	基于权限最小化原则，系统新建账号默认不授予任何权限，或者默认只指派最小权限（如：只读权限）的角色。
 
-**说明：**保证当授权机制出现问题或授权机制被绕过时非法用户获得的权限也是最少的。	
+**说明**：保证当授权机制出现问题或授权机制被绕过时非法用户获得的权限也是最少的。	
 
 ## 6.隐私保护
 
 6-1	收集或使用个人数据前以及将该个人数据发送给第三方之前，应明确提示用户，并获得用户的同意。
 
-**说明：**增加透明性及用户控制能力，满足GDPR等法律法规要求。
+**说明**：增加透明性及用户控制能力，满足GDPR等法律法规要求。
 
 6-2	正常业务需要的情况下，采集、处理、存储个人数据，应根据实际安全风险提供必要的安全保护机制（如认证、权限控制、日志记录等），以防止个人数据被泄漏、丢失、破坏。
 
 6-3	在说明文档中对产品涉及用户隐私的功能进行描述：该功能处理用户个人数据的目的、范围、处理方式、时限。要求使用该功能时遵从当地适用的法律法规。
 
-**说明：**增加透明性，满足GDPR等法律法规要求。
+**说明**：增加透明性，满足GDPR等法律法规要求。
 
 6-4	对于所涉及的个人数据，应支持在呈现界面上（如显示界面、文件存储/导出等）进行过滤或匿名化或假名化。
 
-**说明：**降低个人隐私泄露的风险。
+**说明**：降低个人隐私泄露的风险。
 
 6-5	为避免位置追踪，除了有明确的需求之外，不能出于故障定位等维护目的进行用户精确位置信息定位。
 
-**说明：**精确位置信息非常敏感，故障定位无需精确定位。
+**说明**：精确位置信息非常敏感，故障定位无需精确定位。
 
 6-6	收集个人数据需基于使用目的所必需，满足最小化原则。用于问题定位的日志中记录个人数据遵循最小化原则。
 
-**说明：**用于问题定位的日志如果出现个人数据，会引起用户的质疑。应避免打印个人数据，如果必须打印个人数据（如调试目的），必须对个人数据进行匿名化处理。
+**说明**：用于问题定位的日志如果出现个人数据，会引起用户的质疑。应避免打印个人数据，如果必须打印个人数据（如调试目的），必须对个人数据进行匿名化处理。
 
 6-7	涉及个人数据处理的场景，需要提供相关机制，确保数据主体能够查询、更新以及删除所有数据主体的个人数据。
 
-**说明：**确保数据主体的权利。
+**说明**：确保数据主体的权利。
 
 ## 术语说明