# iText-GM

**Repository Path**: BossDing_admin/iText-GM

## Basic Information

- **Project Name**: iText-GM
- **Description**: IText国密PDF电子签章，基于《GB/T 38540-2020 安全电子签章规范》开发
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 227
- **Created**: 2023-07-29
- **Last Updated**: 2023-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iText-GM

#### 免责声明
1. 对使用本软件所产生的风险自行承担。作者不承担与使用本软件相关的任何责任。
2. 代码包含第三方软件和组件，这些软件和组件受到其自身的许可证限制。应遵守这些许可证的要求。
3. 代码可能存在错误、缺陷或安全漏洞。应自行评估和管理使用风险，并采取适当的安全措施。
4. 作者保留随时更改或终止本软件的权利，并不承担因此而产生的任何责任。
5. 测试用例中的证书，电子印章数据，印章图片均为测试数据，如名称等信息侵权，请联系我进行删除。
6. 在使用本代码之前，请确保您已详细阅读并理解了免责声明中的条款。如果您不同意本免责声明的任何部分，请立即停止使用本代码。

IText国密电子签章，基于《GB/T 38540-2020 安全电子签章规范》  
准备条件：  
1.签名验签服务器    2.SM2证书    3.电子印章数据（需SM2证书绑定在印章数据里，完成制章）  4.签名验签服务器SDK（调用服务器进行签名）


##### PDF 《GB/T 38540-2020》 签署
```
		GetPdfHashParamVo paramVo = new GetPdfHashParamVo();
		Path pdf = Paths.get("src/main/resources", "test.pdf");
		paramVo.setPdf(Files.readAllBytes(pdf));
		paramVo.setPageNo(1);
		paramVo.setLlx(240);
		paramVo.setLly(290);
		paramVo.setUrx(paramVo.getLlx() + 120);
		paramVo.setUry(paramVo.getLly() + 120);
		Path seal = Paths.get("src/main/resources", "深圳测试科技有限公司.seal");
		paramVo.setSeal(SESeal.getInstance(Files.readAllBytes(seal)));
		paramVo.setLocation("深圳");
		paramVo.setReason("国密电子签章测试");

		// 创建签名域，获取pdf文件摘要
		GetPdfHash getPdfHash = ITextGM.getPdfHash(paramVo);

		TSAClient tsaClient = new GMTSAClient(new URL("https://gateway.ca.jiedanba.cn/tsa/sign?type=SM2"), null, null,
				new SM3.Digest());

		PrivateKey prvKey = PkiUtil.getPrivateKey(Base64.decodeBase64(privateKey));

		X509Certificate signCert = PkiUtil.readX509Certificate(Base64.decodeBase64(cert));

		// 签署摘要》》》下面方法仅用于测试，按照合规方面，需要使用国家认可的签名验签服务器以及国家认可的CA机构的SM2证书
		SESV4Container signature = new SESV4Container(prvKey, paramVo.getSeal(), signCert);
		GMTimeStampHook timeStampHook = new GMTimeStampHook(tsaClient);
		signature.setTimeStampHook(timeStampHook);
		byte[] p7 = signature.sign(getPdfHash.getDigesHash(), "Signature.xml");

		// 签署pdf
		byte[] signSuccess = ITextGM.signDeferred(getPdfHash.getEmptySignaturePdf(), p7, getPdfHash.getFieldName());

		FileUtils.writeByteArrayToFile(new File("src/main/resources/sign.pdf"), signSuccess);
```


##### PDF 《GB/T 38540-2020》 分离式签名，实际使用过程，只需对byte[] p1 = getPdfHash.getTBS_Sign().getEncoded() 从你的签名服务器获取p1签名结果，即可完成国密电子签章
```
	GetPdfHashParamVo paramVo = new GetPdfHashParamVo();
		Path pdf = Paths.get("src/main/resources", "test.pdf");
		paramVo.setPdf(Files.readAllBytes(pdf));
		paramVo.setPageNo(1);
		paramVo.setLlx(240);
		paramVo.setLly(290);
		paramVo.setUrx(paramVo.getLlx() + 120);
		paramVo.setUry(paramVo.getLly() + 120);
		Path seal = Paths.get("src/main/resources", "深圳测试科技有限公司.seal");
		paramVo.setSeal(SESeal.getInstance(Files.readAllBytes(seal)));
		paramVo.setLocation("深圳");
		paramVo.setReason("国密电子签章测试");

		// 创建签名域，获取pdf文件摘要,组装待签名数据
		GetPdfHash getPdfHash = ITextGM.getPdfHash(paramVo);

		TSAClient tsaClient = new GMTSAClient(new URL("https://gateway.ca.jiedanba.cn/tsa/sign?type=SM2"), null, null,
				new SM3.Digest());

		PrivateKey prvKey = PkiUtil.getPrivateKey(Base64.decodeBase64(privateKey));

		X509Certificate signCert = PkiUtil.readX509Certificate(Base64.decodeBase64(cert));
		GMTimeStampHook timeStampHook = new GMTimeStampHook(tsaClient);

		// 以下为模拟外部签名测试，电子签章请使用符合国家规范具有国家型号证书的设备进行
		SESV4ContainerV2 signV2 = new SESV4ContainerV2(paramVo.getSeal(), signCert, timeStampHook);

		/**
		 * 模拟签名服务器进行签名，实际使用过程，只需要使用签名服务器对getPdfHash.getTBS_Sign().getEncoded()
		 * 进行一个p1签名即可
		 */
		byte[] p1 = PkiUtil.sign(prvKey, "SM3WithSM2", getPdfHash.getTBS_Sign().getEncoded());

		// 组装电子签章数据
		byte[] p7 = signV2.sign(getPdfHash.getTBS_Sign(), p1);

		// 签署pdf
		byte[] signSuccess = ITextGM.signDeferred(getPdfHash.getEmptySignaturePdf(), p7, getPdfHash.getFieldName());

		FileUtils.writeByteArrayToFile(new File("src/main/resources/signPdf2.pdf"), signSuccess);
```

##### PDF 《GB/T 38540-2020》签署效果

![输入图片说明](src/main/resources/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20220805135415.png)


##### PDF 《GB/T 38540-2020》验签效果 验签地址：https://dzyz.sh.gov.cn/login?code=105
![输入图片说明](src/main/resources/image.png)


#### 感谢 

https://gitee.com/ofdrw/ofdrw

#### IText RSA分离式签名
##### 分离式签名，场景:从外部设备获取p1数据，例如ukey，签名验签服务器，KMS系统

```
		GetPdfHashParamVo paramVo = new GetPdfHashParamVo();
		Path pdf = Paths.get("src/main/resources", "test.pdf");
		paramVo.setPdf(Files.readAllBytes(pdf));
		paramVo.setPageNo(1);
		paramVo.setLlx(240);
		paramVo.setLly(290);
		paramVo.setUrx(paramVo.getLlx() + 120);
		paramVo.setUry(paramVo.getLly() + 120);
		paramVo.setLocation("深圳南山区");
		paramVo.setReason("分离式签名测试");
		paramVo.setHashAlgorithm("SHA256");
		Path sealImage = Paths.get("src/main/resources", "深圳测试科技有限公司_公章.png");
		paramVo.setSignImage(Files.readAllBytes(sealImage));

		// 创建签名域，获取pdf文件摘要
		GetPdfHash getPdfHash = ITextSignHashUtil.getPdfHash(paramVo);

		TSAClient tsaClient = new TSAClientBouncyCastle("https://gateway.ca.jiedanba.cn/tsa/sign?type=RSA", null, null, 4096,
				"SHA256");

		PrivateKey prvKey = PkiUtil.getPrivateKey(Base64.decodeBase64(pkStr));

		X509Certificate signCert = PkiUtil.readX509Certificate(Base64.decodeBase64(certStr));

		// 签署p1，以下为模拟外部签名测试
		byte[] p1 = PkiUtil.sign(prvKey, "SHA256WithRSA", getPdfHash.getSignHash());

		// 签署p7
		byte[] p7 = ITextSignHashUtil.signHash(getPdfHash.getDigesHash(), p1,
				PkiUtil.getCertificateChain(signCert.getEncoded()), "SHA256", tsaClient);

		// 签署pdf
		byte[] signSuccess = ITextGM.signDeferred(getPdfHash.getEmptySignaturePdf(), p7, getPdfHash.getFieldName());

		FileUtils.writeByteArrayToFile(new File("src/main/resources/sign_hash.pdf"), signSuccess);
```

#####  Adobe验签效果
![输入图片说明](src/main/resources/%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202022-08-09%20012047.png)