<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>SM2 - tag - 沐木</title><link>https://oldletter.cn/tags/sm2/</link><description>SM2 - tag - 沐木</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><lastBuildDate>Thu, 25 May 2023 00:00:00 +0000</lastBuildDate><atom:link href="https://oldletter.cn/tags/sm2/" rel="self" type="application/rss+xml"/><item><title>密码学基础：Hash、对称加密、非对称加密</title><link>https://oldletter.cn/posts/crypto-01-fundamentals/</link><pubDate>Thu, 05 Jan 2023 00:00:00 +0000</pubDate><author>mumu</author><guid>https://oldletter.cn/posts/crypto-01-fundamentals/</guid><description><![CDATA[<blockquote>
<p>作者：林 | 系列：密码学 | 适合读者：后端开发 / 对密码学感兴趣的工程师</p></blockquote>
<hr>
<h2 id="一为什么要懂密码学">一、为什么要懂密码学</h2>
<p>作为开发者，你可能每天都在用密码学而不自知：</p>
<ul>
<li>HTTPS 连接 → TLS 握手（非对称 + 对称加密）</li>
<li>用户密码存储 → BCrypt/Argon2（散列函数）</li>
<li>JWT Token → HMAC-SHA256（消息认证码）</li>
<li>支付接口签名 → RSA/SM2（数字签名）</li>
<li>数据库敏感字段 → AES/SM4（对称加密）</li>
</ul>
<p>密码学并非安全团队的专属，重点是每个后端工程师的基本功。本文用下限的篇幅把三大支柱讲清楚，后续每篇深入一个方向。</p>
<hr>
<h2 id="二三大分类总览">二、三大分类总览</h2>
<table>
  <thead>
      <tr>
          <th>能力</th>
          <th>散列函数</th>
          <th>对称密码</th>
          <th>公钥密码</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>主要用途</td>
          <td>完整性、派生、消息认证的组成部分</td>
          <td>数据机密性与认证加密</td>
          <td>密钥协商、签名，部分算法支持加密</td>
      </tr>
      <tr>
          <td>是否可逆</td>
          <td>不可逆</td>
          <td>持有密钥可解密</td>
          <td>取决于具体算法与用途</td>
      </tr>
      <tr>
          <td>密钥</td>
          <td>普通散列无密钥，HMAC 有密钥</td>
          <td>双方共享密钥</td>
          <td>公钥与私钥成对</td>
      </tr>
      <tr>
          <td>常见算法</td>
          <td>SHA-2、SHA-3、SM3</td>
          <td>AES、SM4、ChaCha20</td>
          <td>RSA、ECC、SM2</td>
      </tr>
  </tbody>
</table>
<p>核心区别一句话：</p>
<ul>
<li><strong>Hash</strong>：单向压缩，不能解密，用于验证完整性</li>
<li><strong>对称加密</strong>：一把钥匙，能加能解，用于加密数据</li>
<li><strong>非对称加密</strong>：两把钥匙，公私配对，用于密钥交换和签名</li>
</ul>
<hr>
<h2 id="三散列函数hash">三、散列函数（Hash）</h2>
<h3 id="31-特征">3.1 特征</h3>
<table>
  <thead>
      <tr>
          <th>特征</th>
          <th>说明</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>单向性</td>
          <td>从哈希值无法反推出原文</td>
      </tr>
      <tr>
          <td>固定长度</td>
          <td>无论输入多长，输出长度固定</td>
      </tr>
      <tr>
          <td>雪崩效应</td>
          <td>输入改一个 bit，输出变化超过 50%</td>
      </tr>
      <tr>
          <td>抗碰撞</td>
          <td>找到两个不同输入产生相同输出，计算上不可行</td>
      </tr>
  </tbody>
</table>
<h3 id="32-常见算法">3.2 常见算法</h3>
<table>
  <thead>
      <tr>
          <th>算法</th>
          <th>输出长度</th>
          <th>状态</th>
          <th>用途</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>MD5</td>
          <td>128 bit</td>
          <td>❌ 已破解</td>
          <td>仅用于文件校验（非安全场景）</td>
      </tr>
      <tr>
          <td>SHA-1</td>
          <td>160 bit</td>
          <td>❌ 已破解</td>
          <td>不应再使用</td>
      </tr>
      <tr>
          <td>SHA-256</td>
          <td>256 bit</td>
          <td>✅ 安全</td>
          <td>数字签名、证书、区块链</td>
      </tr>
      <tr>
          <td>SHA-3</td>
          <td>可变</td>
          <td>✅ 安全</td>
          <td>SHA-2 的备选方案</td>
      </tr>
      <tr>
          <td>SM3</td>
          <td>256 bit</td>
          <td>✅ 安全</td>
          <td>国密体系，对标 SHA-256</td>
      </tr>
  </tbody>
</table>
<h3 id="33-代码示例">3.3 代码示例</h3>
<div class="code-block code-line-numbers open" style="counter-reset: code-block 0">
    <div class="code-header language-java">
        <span class="code-title"><i class="arrow fas fa-angle-right" aria-hidden="true"></i></span>
        <span class="ellipses"><i class="fas fa-ellipsis-h" aria-hidden="true"></i></span>
        <span class="copy" title=""><i class="far fa-copy" aria-hidden="true"></i></span>
    </div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-java" data-lang="java"><span class="line"><span class="cl"><span class="kn">import</span><span class="w"> </span><span class="nn">java.security.MessageDigest</span><span class="p">;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="c1">// SHA-256</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="kt">byte</span><span class="o">[]</span><span class="w"> </span><span class="n">hash</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">MessageDigest</span><span class="p">.</span><span class="na">getInstance</span><span class="p">(</span><span class="s">&#34;SHA-256&#34;</span><span class="p">)</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="p">.</span><span class="na">digest</span><span class="p">(</span><span class="s">&#34;hello&#34;</span><span class="p">.</span><span class="na">getBytes</span><span class="p">());</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="c1">// SM3（需要 BouncyCastle）</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="kt">byte</span><span class="o">[]</span><span class="w"> </span><span class="n">sm3Hash</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">MessageDigest</span><span class="p">.</span><span class="na">getInstance</span><span class="p">(</span><span class="s">&#34;SM3&#34;</span><span class="p">)</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="p">.</span><span class="na">digest</span><span class="p">(</span><span class="s">&#34;hello&#34;</span><span class="p">.</span><span class="na">getBytes</span><span class="p">());</span></span></span></code></pre></div></div>
<h3 id="34-典型应用">3.4 典型应用</h3>
<table>
  <thead>
      <tr>
          <th>场景</th>
          <th>做法</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>密码存储</td>
          <td>BCrypt/Argon2（带盐的慢哈希）</td>
      </tr>
      <tr>
          <td>文件完整性校验</td>
          <td>SHA-256 摘要比对</td>
      </tr>
      <tr>
          <td>消息认证（HMAC）</td>
          <td>HMAC-SHA256(key, message)</td>
      </tr>
      <tr>
          <td>数字签名</td>
          <td>先 Hash 再用私钥签 Hash 值</td>
      </tr>
      <tr>
          <td>区块链</td>
          <td>SHA-256 链式哈希</td>
      </tr>
  </tbody>
</table>
<div class="details admonition warning open">
    <div class="details-summary admonition-title">
        <i class="icon fas fa-exclamation" aria-hidden="true"></i>别用 MD5/SHA-1 做安全用途<i class="details-icon fas fa-angle-right" aria-hidden="true"></i>
    </div>
    <div class="details-content">
        <div class="admonition-content">MD5 碰撞攻击成本已低至几秒，SHA-1 也在 2017 年被 Google 实际碰撞。密码存储、签名验证等安全场景，必须用 SHA-256+ 或 SM3。</div>
    </div>
</div>
<hr>
<h2 id="四对称加密symmetric-encryption">四、对称加密（Symmetric Encryption）</h2>
<h3 id="41-原理">4.1 原理</h3>
<p>加密和解密使用<strong>同一把密钥</strong>：</p>]]></description></item><item><title>非对称加密与签名：RSA、ECC、SM2</title><link>https://oldletter.cn/posts/crypto-04-asymmetric/</link><pubDate>Thu, 20 Apr 2023 00:00:00 +0000</pubDate><author>mumu</author><guid>https://oldletter.cn/posts/crypto-04-asymmetric/</guid><description><![CDATA[<blockquote>
<p>作者：林 | 系列：密码学 | 适合读者：后端开发 / 安全工程师</p></blockquote>
<hr>
<h2 id="一非对称加密原理">一、非对称加密原理</h2>
<p>对称加密用一把钥匙，非对称加密用一对钥匙：</p>
<div class="code-block code-line-numbers open" style="counter-reset: code-block 0">
    <div class="code-header language-text">
        <span class="code-title"><i class="arrow fas fa-angle-right" aria-hidden="true"></i></span>
        <span class="ellipses"><i class="fas fa-ellipsis-h" aria-hidden="true"></i></span>
        <span class="copy" title=""><i class="far fa-copy" aria-hidden="true"></i></span>
    </div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">公钥（Public Key）：可以公开，任何人都能拿到
</span></span><span class="line"><span class="cl">私钥（Private Key）：必须保密，只有自己持有
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">加密：用对方的公钥加密 → 只有对方的私钥能解
</span></span><span class="line"><span class="cl">签名：用自己的私钥签名 → 任何人用公钥都能验证</span></span></code></pre></div></div>
<p>非对称加密的数学基础是&quot;单向陷门函数&quot;，正向计算容易，反向计算极难，但持有特定信息（私钥）可以轻松反向。</p>
<hr>
<h2 id="二三大主流算法">二、三大主流算法</h2>
<h3 id="21-rsa">2.1 RSA</h3>
<p>基于<strong>大整数分解难题</strong>：给定两个大素数 p、q，计算 n = p × q 容易；但给定 n，分解出 p 和 q 极难。</p>
<div class="code-block code-line-numbers open" style="counter-reset: code-block 0">
    <div class="code-header language-text">
        <span class="code-title"><i class="arrow fas fa-angle-right" aria-hidden="true"></i></span>
        <span class="ellipses"><i class="fas fa-ellipsis-h" aria-hidden="true"></i></span>
        <span class="copy" title=""><i class="far fa-copy" aria-hidden="true"></i></span>
    </div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">密钥生成：
</span></span><span class="line"><span class="cl">  1. 选两个大素数 p, q（各 1024 bit）
</span></span><span class="line"><span class="cl">  2. 计算 n = p × q（2048 bit）
</span></span><span class="line"><span class="cl">  3. 计算 φ(n) = (p-1)(q-1)
</span></span><span class="line"><span class="cl">  4. 选择 e（通常 65537），满足 gcd(e, φ(n)) = 1
</span></span><span class="line"><span class="cl">  5. 计算 d = e⁻¹ mod φ(n)
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">  公钥 = (n, e)
</span></span><span class="line"><span class="cl">  私钥 = (n, d)
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">加密：C = M^e mod n
</span></span><span class="line"><span class="cl">解密：M = C^d mod n</span></span></code></pre></div></div>
<p>RSA 的问题：密钥太长。2048 bit 才提供 112 bit 安全强度，4096 bit 才提供 128 bit。</p>]]></description></item><item><title>数字信封与密钥协商：SM2+SM4、ECDH、TLS</title><link>https://oldletter.cn/posts/crypto-05-key-exchange/</link><pubDate>Thu, 25 May 2023 00:00:00 +0000</pubDate><author>mumu</author><guid>https://oldletter.cn/posts/crypto-05-key-exchange/</guid><description><![CDATA[<blockquote>
<p>作者：林 | 系列：密码学 | 适合读者：后端开发 / 安全工程师</p></blockquote>
<hr>
<h2 id="一问题对称密钥怎么安全传递">一、问题：对称密钥怎么安全传递</h2>
<p>对称加密速度快，但面临一个核心问题：通信双方怎么共享同一把密钥？</p>
<table>
  <thead>
      <tr>
          <th>方案</th>
          <th>问题</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>线下交换</td>
          <td>不可能每次通信都见面</td>
      </tr>
      <tr>
          <td>明文传输密钥</td>
          <td>等于没加密</td>
      </tr>
      <tr>
          <td>预共享密钥</td>
          <td>不灵活，N 方通信需要 N×(N-1)/2 个密钥</td>
      </tr>
  </tbody>
</table>
<p>解决方案有两种：</p>
<ul>
<li><strong>数字信封</strong>：用非对称加密传递对称密钥</li>
<li><strong>密钥协商</strong>：双方各出一部分，协商出共享密钥（不传输密钥本身）</li>
</ul>
<hr>
<h2 id="二数字信封">二、数字信封</h2>
<h3 id="21-原理">2.1 原理</h3>
<div class="code-block code-line-numbers open" style="counter-reset: code-block 0">
    <div class="code-header language-text">
        <span class="code-title"><i class="arrow fas fa-angle-right" aria-hidden="true"></i></span>
        <span class="ellipses"><i class="fas fa-ellipsis-h" aria-hidden="true"></i></span>
        <span class="copy" title=""><i class="far fa-copy" aria-hidden="true"></i></span>
    </div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">发送方                                   接收方
</span></span><span class="line"><span class="cl">  │                                       │
</span></span><span class="line"><span class="cl">  │ 1. 随机生成对称密钥 K                   │
</span></span><span class="line"><span class="cl">  │ 2. 用 K 加密业务数据：C = Enc(K, Data) │
</span></span><span class="line"><span class="cl">  │ 3. 用接收方公钥加密 K：EK = Enc(PubB, K)│
</span></span><span class="line"><span class="cl">  │ 4. 发送 (EK, C) ─────────────────────→│
</span></span><span class="line"><span class="cl">  │                                       │
</span></span><span class="line"><span class="cl">  │                 5. 用私钥解密：K = Dec(PriB, EK)
</span></span><span class="line"><span class="cl">  │                 6. 用 K 解密数据：Data = Dec(K, C)
</span></span><span class="line"><span class="cl">  │                                       │</span></span></code></pre></div></div>
<p>好处：</p>]]></description></item><item><title>国密实战（一）：SM2 密钥格式与 PFX 证书解析全指南</title><link>https://oldletter.cn/posts/guomi-01-sm2-key-cert/</link><pubDate>Thu, 10 Mar 2022 00:00:00 +0000</pubDate><author>mumu</author><guid>https://oldletter.cn/posts/guomi-01-sm2-key-cert/</guid><description><![CDATA[<blockquote>
<p>作者：林 | 系列：国密实战 | 适合读者：Java 后端/架构师</p></blockquote>
<hr>
<h2 id="一背景与问题">一、背景与问题</h2>
<p>随着《密码法》的实施和信创（信息技术应用创新）要求的推进，越来越多的政府、央企、金融项目要求使用<strong>国密算法</strong>替代 RSA/ECDSA。SM2 作为国密体系中的非对称加密算法，对标 RSA-2048 和 ECDSA P-256，已广泛应用于数字证书、签名验签、密钥交换等场景。</p>
<p>然而，在实际项目中接入 SM2 时，第一个拦路虎往往并非算法本身，重点是，<strong>密钥格式和证书解析</strong>。不同厂商输出的密钥格式不一致（hex、DER、PEM），PFX 证书里封装的 SM2 密钥对解析方式与 RSA 也有差异，稍不注意就会踩坑。</p>
<p>本文将系统梳理 SM2 密钥格式，并给出从 PFX 证书中提取 SM2 公私钥的完整 Java 实现。</p>
<hr>
<h2 id="二sm2-算法简介">二、SM2 算法简介</h2>
<p>SM2 是国家密码管理局发布的椭圆曲线公钥密码算法，标准编号 <strong>GM/T 0003</strong>，包含：</p>
<table>
  <thead>
      <tr>
          <th>部分</th>
          <th>内容</th>
          <th>对标国际标准</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>GM/T 0003.1</td>
          <td>总则</td>
          <td>—</td>
      </tr>
      <tr>
          <td>GM/T 0003.2</td>
          <td>数字签名算法</td>
          <td>ECDSA</td>
      </tr>
      <tr>
          <td>GM/T 0003.3</td>
          <td>密钥交换协议</td>
          <td>ECDH</td>
      </tr>
      <tr>
          <td>GM/T 0003.4</td>
          <td>公钥加密算法</td>
          <td>ECIES</td>
      </tr>
      <tr>
          <td>GM/T 0003.5</td>
          <td>参数定义</td>
          <td>—</td>
      </tr>
  </tbody>
</table>
<p>SM2 使用的椭圆曲线参数为 <code>sm2p256v1</code>，其曲线方程为标准 Weierstrass 形式：y² = x³ + ax + b (mod p)。</p>]]></description></item><item><title>国密实战（二）：SM2 签名验签前后端对接全指南</title><link>https://oldletter.cn/posts/guomi-02-sm2-sign-verify/</link><pubDate>Wed, 15 Jun 2022 00:00:00 +0000</pubDate><author>mumu</author><guid>https://oldletter.cn/posts/guomi-02-sm2-sign-verify/</guid><description><![CDATA[<blockquote>
<p>作者：林 | 系列：国密实战 | 适合读者：Java 后端/架构师 + 前端开发者</p></blockquote>
<hr>
<h2 id="一背景与问题">一、背景与问题</h2>
<p>在很多业务场景中，前端需要对请求参数进行签名，后端进行验签，以确保数据完整性和防篡改。传统方案多使用 RSA 签名，但在信创项目中，SM2 签名验签成为必选项。</p>
<p><strong>典型场景</strong>：</p>
<ul>
<li>前端提交表单数据，附带 SM2 签名</li>
<li>后端验签通过后才处理业务逻辑</li>
<li>API 网关层面的请求签名校验</li>
<li>合同/文档电子签章</li>
</ul>
<p>前后端对接 SM2 签名验签的核心挑战：</p>
<ol>
<li><strong>库的选择</strong>：Java 端用什么库？前端用什么库？</li>
<li><strong>密钥格式约定</strong>：私钥和公钥的格式必须统一</li>
<li><strong>userId 的一致性</strong>：SM2 签名有一个独特的 <code>userId</code> 参数，两端必须一致</li>
<li><strong>hash 参数的一致性</strong>：是否对消息做预哈希，两端必须统一</li>
<li><strong>签名格式</strong>：<code>r || s</code> 拼接 vs DER 编码，两端必须约定</li>
</ol>
<p>本文将给出 Java（Hutool）+ TypeScript（sm-crypto）的完整对接方案。</p>
<hr>
<h2 id="二sm2-签名验签原理">二、SM2 签名验签原理</h2>
<h3 id="21-签名过程">2.1 签名过程</h3>
<p>SM2 签名过程比 ECDSA 多了一个 <strong>Z 值</strong>（用户标识哈希）的计算。完整流程如下：</p>
<p><strong>输入参数</strong>：</p>
<ul>
<li>待签名消息 M</li>
<li>用户标识 ID（默认 <code>&quot;1234567812345678&quot;</code>）</li>
<li>私钥 d（256 位整数）</li>
<li>公钥 P = d × G = (xA, yA）</li>
</ul>
<p><strong>步骤</strong>：</p>]]></description></item><item><title>国密实战（三）：SM2+SM4 数字信封完整实现（对接国企实战）</title><link>https://oldletter.cn/posts/guomi-03-sm2-sm4-envelope/</link><pubDate>Thu, 15 Dec 2022 00:00:00 +0000</pubDate><author>mumu</author><guid>https://oldletter.cn/posts/guomi-03-sm2-sm4-envelope/</guid><description><![CDATA[<blockquote>
<p>作者：林 | 系列：国密实战 | 适合读者：Java 后端/架构师</p></blockquote>
<hr>
<h2 id="一背景与问题">一、背景与问题</h2>
<p>在国企、央企、政府项目的接口对接中，数据传输的安全性要求通常采用<strong>数字信封</strong>（Digital Envelope）机制：使用非对称算法加密对称密钥，再用对称密钥加密业务数据。这既保证了密钥传输的安全性，又兼顾了大数据量加密的性能。</p>
<p>在国密体系中，这个组合就是 <strong>SM2 + SM4</strong>：</p>
<ul>
<li><strong>SM4</strong>：对称加密算法，负责加密业务数据（高效）</li>
<li><strong>SM2</strong>：非对称加密算法，负责加密 SM4 密钥（安全）</li>
</ul>
<h3 id="11-为什么需要数字信封">1.1 为什么需要数字信封？</h3>
<table>
  <thead>
      <tr>
          <th>方案</th>
          <th style="text-align: center">安全性</th>
          <th style="text-align: center">性能</th>
          <th>适用场景</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td>直接 SM2 加密数据</td>
          <td style="text-align: center">✅ 高</td>
          <td style="text-align: center">❌ 差（数据量受限）</td>
          <td>小数据（如密钥）</td>
      </tr>
      <tr>
          <td>直接 SM4 加密数据</td>
          <td style="text-align: center">❌ 密钥如何安全传输？</td>
          <td style="text-align: center">✅ 好</td>
          <td>需要解决密钥分发问题</td>
      </tr>
      <tr>
          <td><strong>SM2+SM4 数字信封</strong></td>
          <td style="text-align: center">✅ 高</td>
          <td style="text-align: center">✅ 好</td>
          <td><strong>大数据量 + 高安全性</strong></td>
      </tr>
  </tbody>
</table>
<p>SM2 加密的数据长度受限，上限明文长度约为 <strong>256 字节</strong>（受椭圆曲线参数限制）。不适合直接加密业务数据。而 SM4 虽然性能好，但密钥需要安全传输。数字信封完美结合了两者的优势。</p>
<p>SM2 加密数据长度计算：密文长度 = 65（C1，临时公钥点）+ 32（C3，SM3 哈希）+ n = 97 + n bytes。其中 n 为明文长度。加密 16 字节 SM4 密钥时，密文为 97 + 16 = 113 字节。</p>]]></description></item></channel></rss>