# crypt.cert 库模块帮助文档 ## crypt 成员列表 # ### crypt.cert(证书数据) # 从 CER/CRT/DER/PEM 格式数据加载证书。参数也可以是 PCCERT_CONTEXT 句柄。 [返回对象:cryptCertObject](#cryptCertObject) ## crypt.cert 成员列表 # X.509 证书操作类。支持加载、创建、导出各种格式证书。 ### crypt.cert.createPfx(保存路径,密码,主题名称,有效期年数) # 创建自签名证书并保存为 PFX。返回完整路径和密码。 ### crypt.cert.createSelfSigned(主题名称,有效期年数,扩展) # 创建自签名证书。 @主题名称: 如 "CN=localhost" 或 "localhost"。 @有效期年数: 默认 10 年。 @扩展: 可选指用一个数组指定 OID 和原始 DER 数据。成功返回 crypt.cert 对象。 [返回对象:cryptCertObject](#cryptCertObject) ### crypt.cert.createSelfSignedFile(文件路径,密码,主题名称,有效期年数,扩展) # 创建自签名证书。 @文件路径: 指定输出的 pfx 文件路径。 @密码: 可选参数。 @主题名称: 如 "CN=localhost" 或 "localhost"。 @有效期年数: 默认 10 年。 @扩展: 可选指用一个数组指定 OID 和原始 DER 数据。成功返回 true，失败返回 false,错误信息 ### crypt.cert.createSelfSignedFileIf(文件路径,密码,主题名称,有效期年数,扩展) # 创建自签名证书。如果指定的证书文件已存在则直接返回true。 @文件路径: 指定输出的 pfx 文件路径。 @密码: 可选参数。 @主题名称: 如 "CN=localhost" 或 "localhost"。 @有效期年数: 默认 10 年。 @扩展: 可选指用一个数组指定 OID 和原始 DER 数据。成功返回 true，失败返回 false,错误信息 ### crypt.cert.find(存储名, 查找值,查找类型) # 从系统证书存储查找证书。 @存储名: 默认为 "MY" (个人证书)，可选 "ROOT", "CA" 等。 @查找值: 指纹(Hex字符串)或主题包含的文本。 @查找类型: 可省略。可选 "thumbprint" 或 "subject"。 [返回对象:cryptCertObject](#cryptCertObject) ### crypt.cert.fromPem(私钥PEM,证书PEM) # 从 PEM 格式的私钥和证书创建证书对象。 @私钥PEM: 支持 PKCS#1 或 PKCS#8 格式。 @证书PEM: 支持包含证书链，通常会自动识别第一个证书为叶子证书。返回包含私钥的证书对象，可用 exportPfx 导出。 [返回对象:cryptCertObject](#cryptCertObject) ### crypt.cert.loadPfx(pfx数据或路径,密码) # 从 PFX 文件或数据加载证书（含私钥）。 [返回对象:cryptCertObject](#cryptCertObject) ## cryptCertObject 成员列表 # ### cryptCertObject.algorithm # 签名算法 OID ### cryptCertObject.exportDer() # 导出为 DER 格式（纯证书） ### cryptCertObject.exportPem() # 导出为 PEM 格式（纯证书） ### cryptCertObject.exportPfx(密码, 保存路径) # 导出为 PFX 格式。 @保存路径: 可选，不指定则返回二进制数据。注意：仅当证书包含私钥时有效。 ### cryptCertObject.hasPrivateKey # 是否包含私钥信息（布尔值） ### cryptCertObject.isValid # 证书当前是否在有效期内（布尔值） ### cryptCertObject.issuer # 颁发者名称 ### cryptCertObject.pCertContext # PCCERT_CONTEXT 句柄 ### cryptCertObject.release() # 释放证书资源 ### cryptCertObject.serialNumber # 序列号（十六进制字符串） ### cryptCertObject.subject # 证书主题名称 ### cryptCertObject.thumbprint # 证书指纹（SHA1 十六进制） ### cryptCertObject.validFrom # 生效时间 [返回对象:timeObject](https://www.aardio.com/zh-cn/doc/library-reference/time/_.html#timeObject) ### cryptCertObject.validTo # 过期时间 [返回对象:timeObject](https://www.aardio.com/zh-cn/doc/library-reference/time/_.html#timeObject) ### cryptCertObject.verify() # 验证证书链可信度。成功返回 true，失败返回 false, 错误信息。