gws-client 0.6.4 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -33
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
用于web前端调用GZCA数字证书客户端UKEY证书应用接口,调用前需确保已安装GZCA数字证书客户端并启动,支持TypeScript。
|
|
4
4
|
|
|
5
|
-
## 快速开始
|
|
5
|
+
## 1 快速开始
|
|
6
6
|
|
|
7
|
-
### 安装
|
|
7
|
+
### 1.1 安装
|
|
8
8
|
|
|
9
9
|
#### 使用包管理器
|
|
10
10
|
|
|
@@ -26,7 +26,7 @@ Install with pnpm
|
|
|
26
26
|
pnpm add gws-client
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
### 使用
|
|
29
|
+
### 1.2 使用
|
|
30
30
|
|
|
31
31
|
#### ES Module
|
|
32
32
|
|
|
@@ -84,7 +84,7 @@ async function foo() {
|
|
|
84
84
|
| onError | 可选,socket错误时回调 | `(event: Event) => void` | -- |
|
|
85
85
|
| onClose | 可选,socket关闭时回调 | `(event: Event) => void` | -- |
|
|
86
86
|
| onMessage | 可选,socket收到消息时回调 | `(data: Record<string, any>) => void` | -- |
|
|
87
|
-
| onUkeyChange
|
|
87
|
+
| onUkeyChange | 可选,Ukey插入拔出时回调 | `(event: {type: 'remove' \| 'insert', data: CertType}) => void` | -- |
|
|
88
88
|
| theme | 可选,弹窗主题色 | `String` | `#409eff` |
|
|
89
89
|
|
|
90
90
|
#### 示例
|
|
@@ -124,9 +124,9 @@ async function pkcs1Sign() {
|
|
|
124
124
|
}
|
|
125
125
|
```
|
|
126
126
|
|
|
127
|
-
## API接口
|
|
127
|
+
## 2 API接口
|
|
128
128
|
|
|
129
|
-
### 销毁
|
|
129
|
+
### 2.1 销毁
|
|
130
130
|
|
|
131
131
|
断开socket连接
|
|
132
132
|
|
|
@@ -140,7 +140,7 @@ destroy
|
|
|
140
140
|
type Destroy = () => void;
|
|
141
141
|
```
|
|
142
142
|
|
|
143
|
-
### 重启
|
|
143
|
+
### 2.2 重启
|
|
144
144
|
|
|
145
145
|
重新连接socket,可重新传入新配置
|
|
146
146
|
|
|
@@ -154,7 +154,7 @@ restart
|
|
|
154
154
|
type Restart = (config?: GwsServiceConfigType) => void;
|
|
155
155
|
```
|
|
156
156
|
|
|
157
|
-
### 获取签名证书
|
|
157
|
+
### 2.3 获取签名证书
|
|
158
158
|
|
|
159
159
|
获取签名证书,可获取证书CN项,证书CertB64,sn
|
|
160
160
|
|
|
@@ -168,7 +168,7 @@ getSignatureCert
|
|
|
168
168
|
type GetSignatureCert = (cert?: CertType) => Promise<CertType>;
|
|
169
169
|
```
|
|
170
170
|
|
|
171
|
-
### 获取签名证书列表
|
|
171
|
+
### 2.4 获取签名证书列表
|
|
172
172
|
|
|
173
173
|
获取签名证书列表
|
|
174
174
|
|
|
@@ -182,7 +182,7 @@ getSignatureCertList
|
|
|
182
182
|
type GetSignatureCertList = () => Promise<CertType[]>;
|
|
183
183
|
```
|
|
184
184
|
|
|
185
|
-
### 获取加密证书
|
|
185
|
+
### 2.5 获取加密证书
|
|
186
186
|
|
|
187
187
|
获取加密证书,可获取证书CN项,证书CertB64,sn
|
|
188
188
|
|
|
@@ -196,7 +196,7 @@ getEncryptionCert
|
|
|
196
196
|
type GetEncryptionCert = (cert?: CertType) => Promise<CertType>;
|
|
197
197
|
```
|
|
198
198
|
|
|
199
|
-
### 获取加密证书列表
|
|
199
|
+
### 2.6 获取加密证书列表
|
|
200
200
|
|
|
201
201
|
获取加密证书列表
|
|
202
202
|
|
|
@@ -210,7 +210,7 @@ getEncryptionCertList
|
|
|
210
210
|
type GetEncryptionCertList = () => Promise<CertType[]>;
|
|
211
211
|
```
|
|
212
212
|
|
|
213
|
-
### 获取证书详情
|
|
213
|
+
### 2.7 获取证书详情
|
|
214
214
|
|
|
215
215
|
获取证书详情,可获取证书公钥CertPublicKey,证书序列号CertSerial,证书有效期CertValidTime
|
|
216
216
|
|
|
@@ -232,7 +232,7 @@ type GetCertInfo = (params: {
|
|
|
232
232
|
| ------- | ---------------- | -------- | ------ |
|
|
233
233
|
| CertB64 | 必填,证书Base64 | `String` | -- |
|
|
234
234
|
|
|
235
|
-
### PKCS1签名
|
|
235
|
+
### 2.8 PKCS1签名
|
|
236
236
|
|
|
237
237
|
PKCS1签名,返回签名值
|
|
238
238
|
|
|
@@ -256,7 +256,7 @@ type Pkcs1Sign = (
|
|
|
256
256
|
| Data | 必填,待签名原文 | `String` | -- |
|
|
257
257
|
| IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
|
|
258
258
|
|
|
259
|
-
### PKCS1验签
|
|
259
|
+
### 2.9 PKCS1验签
|
|
260
260
|
|
|
261
261
|
PKCS1验签,传入curCert时使用该证书,返回验签结果,`true`为验签成功,验签失败时返回`Promise.reject`
|
|
262
262
|
|
|
@@ -285,7 +285,7 @@ type Pkcs1VerifySignature = (
|
|
|
285
285
|
| SignData | 必填,Base64编码的签名值 | `String` | -- |
|
|
286
286
|
| CertB64 | 可选,Base64编码的签名证书 | `String` | -- |
|
|
287
287
|
|
|
288
|
-
### PKCS1 B64签名
|
|
288
|
+
### 2.10 PKCS1 B64签名
|
|
289
289
|
|
|
290
290
|
PKCS1 base64签名,传入curCert时使用该证书,返回签名值
|
|
291
291
|
|
|
@@ -311,7 +311,7 @@ type Pkcs1Base64Sign = (params: {
|
|
|
311
311
|
| DataB64 | 与Data二选一 , Base64编码的待签名原文,同时存在时使用DataB64 | `String` | -- |
|
|
312
312
|
| IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
|
|
313
313
|
|
|
314
|
-
### PKCS1 B64验签
|
|
314
|
+
### 2.11 PKCS1 B64验签
|
|
315
315
|
|
|
316
316
|
PKCS1 base64验签,返回验签结果,`true`为验签成功,验签失败时返回`Promise.reject`
|
|
317
317
|
|
|
@@ -339,7 +339,7 @@ type Pkcs1Base64VerifySignature = (params: {
|
|
|
339
339
|
| SignData | 必填,Base64编码的签名值 | `String` | -- |
|
|
340
340
|
| CertB64 | 可选,Base64编码的签名证书 | `String` | -- |
|
|
341
341
|
|
|
342
|
-
### PKCS1哈希签名
|
|
342
|
+
### 2.12 PKCS1哈希签名
|
|
343
343
|
|
|
344
344
|
PKCS1哈希签名,返回签名值
|
|
345
345
|
|
|
@@ -366,7 +366,7 @@ type Pkcs1HashSign = (
|
|
|
366
366
|
| HashAlg | 可选,哈希算法 | `sm3` \| `sha1`\| `sha256` | `sm3` |
|
|
367
367
|
| IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
|
|
368
368
|
|
|
369
|
-
### PKCS1哈希验签
|
|
369
|
+
### 2.13 PKCS1哈希验签
|
|
370
370
|
|
|
371
371
|
PKCS1哈希验签,返回验签结果,传入curCert时使用该证书,`true`为验签成功,验签失败时返回`Promise.reject`
|
|
372
372
|
|
|
@@ -394,7 +394,7 @@ type Pkcs1Base64VerifySignature = (params: {
|
|
|
394
394
|
| CertB64 | 可选,Base64编码的签名证书 | `String` | -- |
|
|
395
395
|
| HashAlg | 可选,哈希算法 | `sm3` \| `sha1`\| `sha256` | `sm3` |
|
|
396
396
|
|
|
397
|
-
### PKCS7签名
|
|
397
|
+
### 2.14 PKCS7签名
|
|
398
398
|
|
|
399
399
|
PKCS7签名,返回签名值
|
|
400
400
|
|
|
@@ -425,7 +425,7 @@ type Pkcs7Sign = (
|
|
|
425
425
|
| IsDetached | 必填,Y为detach,N为attach,attach模式签名值带了原文 | `Y` \| `N` | -- |
|
|
426
426
|
| IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
|
|
427
427
|
|
|
428
|
-
### PKCS7验签
|
|
428
|
+
### 2.15 PKCS7验签
|
|
429
429
|
|
|
430
430
|
PKCS7验签,返回验签结果,传入curCert时使用该证书,`true`为验签成功,验签失败时返回`Promise.reject`
|
|
431
431
|
|
|
@@ -451,7 +451,7 @@ type Pkcs7VerifySignature = (params: {
|
|
|
451
451
|
| DataB64 | 与Data二选一 , Base64编码的待签名原文,同时存在时使用DataB64 | `String` | -- |
|
|
452
452
|
| SignData | 必填,签名值 | `String` | -- |
|
|
453
453
|
|
|
454
|
-
### base64编码
|
|
454
|
+
### 2.16 base64编码
|
|
455
455
|
|
|
456
456
|
base64编码,返回base64编码内容
|
|
457
457
|
|
|
@@ -471,7 +471,7 @@ type Base64Encode = (params: { Data: string }) => string;
|
|
|
471
471
|
| ---- | ---------------------- | -------- | ------ |
|
|
472
472
|
| Data | 必填,base64待编码内容 | `String` | -- |
|
|
473
473
|
|
|
474
|
-
### base64解码
|
|
474
|
+
### 2.17 base64解码
|
|
475
475
|
|
|
476
476
|
base64解码,返回base64解码内容
|
|
477
477
|
|
|
@@ -491,7 +491,7 @@ type Base64Decode = (params: { DataB64: string }) => string;
|
|
|
491
491
|
| ------- | ---------------------- | -------- | ------ |
|
|
492
492
|
| DataB64 | 必填,base64待解码内容 | `String` | -- |
|
|
493
493
|
|
|
494
|
-
### SM3哈希
|
|
494
|
+
### 2.18 SM3哈希
|
|
495
495
|
|
|
496
496
|
SM3哈希,返回SM3哈希值
|
|
497
497
|
|
|
@@ -511,7 +511,7 @@ type Sm3Hash = (params: { Data: string }) => Promise<string>;
|
|
|
511
511
|
| ---- | ------------------------ | -------- | ------ |
|
|
512
512
|
| Data | 必填,待计算杂凑值的原文 | `String` | -- |
|
|
513
513
|
|
|
514
|
-
### SM3 B64哈希
|
|
514
|
+
### 2.19 SM3 B64哈希
|
|
515
515
|
|
|
516
516
|
SM3 B64哈希
|
|
517
517
|
|
|
@@ -531,7 +531,7 @@ type Sm3HexHash = (params: { DataB64: string }) => Promise<string>;
|
|
|
531
531
|
| ------- | ------------------------------ | -------- | ------ |
|
|
532
532
|
| DataB64 | 必填,待计算杂凑值的原文base64 | `String` | -- |
|
|
533
533
|
|
|
534
|
-
### SM3 文件哈希
|
|
534
|
+
### 2.20 SM3 文件哈希
|
|
535
535
|
|
|
536
536
|
SM3 文件哈希
|
|
537
537
|
|
|
@@ -551,7 +551,7 @@ type Sm3FileHash = (params: { SrcFile: string }) => Promise<string>;
|
|
|
551
551
|
| ------- | ------------------------------------------------------- | -------- | ------ |
|
|
552
552
|
| SrcFile | 必填,待计算杂凑值的本地文件全路径。建议使用正斜杠(/) | `String` | -- |
|
|
553
553
|
|
|
554
|
-
### SM3哈希加密
|
|
554
|
+
### 2.21 SM3哈希加密
|
|
555
555
|
|
|
556
556
|
SM3哈希加密
|
|
557
557
|
|
|
@@ -579,7 +579,7 @@ type Sm3HashEncryption = (params: {
|
|
|
579
579
|
| Key | 与KeyB64二选一,密钥 | `String` | -- |
|
|
580
580
|
| KeyB64 | 与Key二选一 , base64编码的密钥,同时存在时使用KeyB64 | `String` | -- |
|
|
581
581
|
|
|
582
|
-
### PKCS7加密
|
|
582
|
+
### 2.22 PKCS7加密
|
|
583
583
|
|
|
584
584
|
PKCS7加密,返回加密字符串
|
|
585
585
|
|
|
@@ -605,7 +605,7 @@ type Pkcs7Encryption = (params: {
|
|
|
605
605
|
| DataB64 | 与Data二选一 , Base64编码的待加密原文,同时存在时使用DataB64 | `String` | -- |
|
|
606
606
|
| CertB64List | 必填,加密证书base64,多个以\|连接 | `String` | -- |
|
|
607
607
|
|
|
608
|
-
### PKCS7解密
|
|
608
|
+
### 2.23 PKCS7解密
|
|
609
609
|
|
|
610
610
|
PKCS7解密,返回解密字符串
|
|
611
611
|
|
|
@@ -631,7 +631,7 @@ type Pkcs7Decryption = (params: {
|
|
|
631
631
|
| shouldDecodeBase64 | 可选,是否需要base64解码 | `Boolean` | -- |
|
|
632
632
|
| IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
|
|
633
633
|
|
|
634
|
-
### 非对称加密
|
|
634
|
+
### 2.24 非对称加密
|
|
635
635
|
|
|
636
636
|
非对称加密,返回加密字符串
|
|
637
637
|
|
|
@@ -653,7 +653,7 @@ type AsymmetricDecryption = (params: { Data: string;IsLogin?: string }) => Pro
|
|
|
653
653
|
| CertB64 | 可选,加密证书B64 | `String` | -- |
|
|
654
654
|
| IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
|
|
655
655
|
|
|
656
|
-
### 非对称解密
|
|
656
|
+
### 2.25 非对称解密
|
|
657
657
|
|
|
658
658
|
非对称解密,返回解密字符串
|
|
659
659
|
|
|
@@ -676,7 +676,7 @@ type AsymmetricDecryption = (
|
|
|
676
676
|
| ---- | ---------------- | -------- | ------ |
|
|
677
677
|
| Data | 必填,待解密原文 | `String` | -- |
|
|
678
678
|
|
|
679
|
-
### SM4对称加密
|
|
679
|
+
### 2.26 SM4对称加密
|
|
680
680
|
|
|
681
681
|
SM4对称加密,传入curCert时使用该证书,返回加密字符串,加密密钥
|
|
682
682
|
|
|
@@ -705,7 +705,7 @@ type Sm4Encryption = (params: {
|
|
|
705
705
|
| Data | 加密密文 | `String` |
|
|
706
706
|
| KeyB64 | Base64对称密钥 | `String` |
|
|
707
707
|
|
|
708
|
-
### SM4对称解密
|
|
708
|
+
### 2.27 SM4对称解密
|
|
709
709
|
|
|
710
710
|
SM4对称解密,返回解密字符串
|
|
711
711
|
|
|
@@ -729,7 +729,7 @@ type Sm4Decryption = (params: {
|
|
|
729
729
|
| Data | 必填,待解密原文 | `String` | -- |
|
|
730
730
|
| KeyB64 | 必填,Base64对称密钥 | `String` | -- |
|
|
731
731
|
|
|
732
|
-
### 获取印章列表
|
|
732
|
+
### 2.28 获取印章列表
|
|
733
733
|
|
|
734
734
|
获取印章列表,传入curCert时使用该证书,可获取印章SealId
|
|
735
735
|
|