sign.sign(privateKey[, outputEncoding])

版本历史

版本	变更
v15.0.0	The privateKey can also be an ArrayBuffer and CryptoKey.
v13.2.0, v12.16.0	This function now supports IEEE-P1363 DSA and ECDSA signatures.
v12.0.0	This function now supports RSA-PSS keys.
v11.6.0	This function now supports key objects.
v8.0.0	Support for RSASSA-PSS and additional options was added.
v0.1.92	新增于: v0.1.92

privateKey <Object> | <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> | <KeyObject> | <CryptoKey>
- dsaEncoding <string>
- padding <integer>
- saltLength <integer>
outputEncoding <string> 返回值的编码。
返回: <Buffer> | <string>

使用 sign.update() 或 sign.write() 对传入的所有数据计算签名。

【Calculates the signature on all the data passed through using either sign.update() or sign.write().】

如果 privateKey 不是 KeyObject，则此函数的行为就像 privateKey 已被传递给 crypto.createPrivateKey()。如果它是一个对象，则可以传入以下附加属性：

【If privateKey is not a KeyObject, this function behaves as if privateKey had been passed to crypto.createPrivateKey(). If it is an object, the following additional properties can be passed:】

dsaEncoding <string> 对于 DSA 和 ECDSA，此选项指定生成签名的格式。可以是以下之一：
- 'der'（默认）：DER 编码的 ASN.1 签名结构编码 (r, s)。
- 'ieee-p1363'：签名格式 r || s，如 IEEE-P1363 所提议。
padding <integer> RSA 的可选填充值，可以是以下之一：
- crypto.constants.RSA_PKCS1_PADDING（默认）
- crypto.constants.RSA_PKCS1_PSS_PADDING
RSA_PKCS1_PSS_PADDING 将使用 MGF1，其使用的哈希函数与签名消息时使用的相同，如 RFC 4055 第 3.1 节所述，除非已按照 RFC 4055 第 3.3 节的规定，在密钥中指定了 MGF1 哈希函数。
saltLength <integer> 当填充方式为 RSA_PKCS1_PSS_PADDING 时的盐长度。特殊值 crypto.constants.RSA_PSS_SALTLEN_DIGEST 将盐长度设置为摘要大小，crypto.constants.RSA_PSS_SALTLEN_MAX_SIGN（默认）将其设置为最大允许值。

如果提供了 outputEncoding，则返回一个字符串；否则返回一个 Buffer。

【If outputEncoding is provided a string is returned; otherwise a Buffer is returned.】

Sign 对象在调用 sign.sign() 方法后不能再次使用。多次调用 sign.sign() 会导致抛出错误。

【The Sign object can not be again used after sign.sign() method has been called. Multiple calls to sign.sign() will result in an error being thrown.】