207 Star 1.3K Fork 507

GVPofdrw / ofdrw

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 6.57 KB
一键复制 编辑 原始数据 按行查看 历史
Cliven 提交于 2024-04-16 19:29 . 2.2.12

签名签章 验证 快速入门

免责:电子文档的电子签章流程需要符合国家相关标准和规范。要产生具有效力的电子签名/签章,请使用符合国家密码局要求具有相关认证证书的密码设备进行。

ofdrw-sign已经对OFD文档的电子签章过程完成比较高程度的封装, 开发者只需要关注如何实现签章即可。

引入依赖

<dependency>
    <groupId>org.ofdrw</groupId>
    <artifactId>ofdrw-sign</artifactId>
    <version>2.2.12</version>
</dependency>
  • 若您没有采用Maven管理项目,请参阅项目中pom.xml文件中的依赖,手动解决三方依赖包问题。

实现电子签章你需要下面步骤:

  1. 通过OFD解析器创建OFDSigner(签名引擎)。
  2. 实现扩展数字签名容器
  3. 设置签名模式。
  4. 设置签名使用的扩展签名容器。
  5. 执行签名。
  6. 关闭签名引擎,生成文档。
public static void main() throws Exception {
     Path src = Paths.get("src/test/resources", "helloworld.ofd");
     Path out = Paths.get("target/DigitalSign.ofd");
     // 1. 构造签名引擎
     try (OFDReader reader = new OFDReader(src);
          OFDSigner signer = new OFDSigner(reader, out)) {
         // 2. 实现电子签章容器
         ExtendSignatureContainer signContainer = new YouImpContainer();
         // 3. 设置签名模式
         //  signer.setSignMode(SignMode.WholeProtected);
         signer.setSignMode(SignMode.ContinueSign);
         // 4. 设置签名使用的扩展签名容器
         signer.setSignContainer(signContainer);
         // 5. 执行签名
         signer.exeSign();
         // 6. 关闭签名引擎,生成文档。
     }
     System.out.println(">> 生成文件位置: " + out.toAbsolutePath().toAbsolutePath());
 }

为了便于测试的需要OFD R&W Sign模块中提供几个用于测试的签名扩展实现

实现自定义的扩展数字签名容器

请参考 扩展数字签名容器接口 实现电子签章功能。

假如你有一台符合国家标准规范具有型号证书的签章服务器,那么你可以这样实现:

public class MySESV4ontainer implements ExtendSignatureContainer {
    @Override
    public MessageDigest getDigestFnc() {
        return new SM3.Digest();
    }

    @Override
    public ASN1ObjectIdentifier getSignAlgOID() {
        return GMObjectIdentifiers.sm2sign_with_sm3;
    }

    @Override
    public byte[] sign(InputStream inData, String propertyInfo) throws IOException, GeneralSecurityException {
        MessageDigest md = getDigestFnc();
        // 签名原文杂凑值,也就是Signature.xml 文件的杂凑值
        byte[] dataHash = md.digest(IOUtils.toByteArray(inData));
        // TODO 调用电子签章服务器提供的电子签章接口完成电子签章。
    }
    @Override
    public byte[] getSeal() throws IOException {
        // TODO 从电子签章服务器上获取电子印章
    }
    @Override
    public SigType getSignType() {
        return SigType.Seal;
    }
}

OFD 签名签章验证

免责声明:为了合法验证OFD的电子签章有效性,请根据电子签章版本按照下面规范章节实现验证流程:

  • 《GM/T 0031-2014》 6.2.3 电子签章验证流程
  • 《GB/T 38540-2020》 7.3 电子签章验证流程

证书的验证也请由独立合法第三方机构进行验证!

OFD的签名签章验证过程有一下几步:

  1. 使用OFD解析器构造一个验证引擎。
  2. 实现验证容器
  3. 设置验证容器。
  4. 执行验签验章。
  5. 如果没有异常抛出说明验证成功。
// 1. 构造一个验证引擎。
try (OFDReader reader = new OFDReader(src);
     OFDValidator validator = new OFDValidator(reader)) {
    // 2. 实现验证容器。
    SignedDataValidateContainer dsc = new YouImpContainer(cert);
    // 3. 实现验证容器。
    validator.setValidator(dsc);
    // 4. 执行验签验章。
    validator.exeValidate();
    // 5. 如果没有异常抛出说明验证成功。
}

如果想返还更多验证信息,请在SignedDataValidateContainer中对电子签章数据进行解析。

OFD R&W Sign模块中提供几个用于参考的验证容器实现,这些容器均只是验证签名值是否正确:

签章定位

Java
1
https://gitee.com/ofdrw/ofdrw.git
git@gitee.com:ofdrw/ofdrw.git
ofdrw
ofdrw
ofdrw
master

搜索帮助